Redigerer Mal:Navboks/dok (avsnitt)

==Parameterbeskrivelser==
Følgende er en fullstendig liste over parametre for bruk i {{malinfo|Navboks}}. I de fleste tilfeller er <code>navn</code>, <code>tittel</code> og <code>liste1</code> de eneste obligatoriske parametrene, men [[#Barnenavbokser (navbokser inni hverandre)|barnenavbokser]] trenger ikke at disse parametrene angis.

===Oppsettsparametre===
:; ''navn''
:: Navnet på malen; navnet trengs for at lenkene «v{{,}} d{{,}} r» («vis{{,}} disksjon{{,}} rediger») skal fungere på alle sider der malen brukes. Du kan skrive snarveien <code><nowiki>{{subst:PAGENAME}}</nowiki></code> for denne verdien. Navnet er bare obligatorisk hvis en <code>tittel</code> er angitt, og parameteren <code>kantlinje</code> ikke er angitt. For å se «v{{,}} d{{,}} r» må man slå på det i «Tilleggsfunksjoner» på [[Spesial:Innstillinger]], grunnet å ikke gjøre det enklere for vandaler å finne maler som brukes på mange sider.

:; ''status'' <span style="font-weight:normal;">[<code>autocollapse, uncollapsed, collapsed, plain, off</code>]</span>
:*Standardverdien er <code>autocollapse</code>. En navboks med <code>autocollapse</code> vil begynne som skjult hvis det er to eller flere tabeller på den samme siden som bruker skjulbare tabeller. Ellers vil navboksen være utvidet. For de teknisk interesserte, se [[MediaWiki:Common.js]].
:*Hvis den settes til <code>lukket</code>/<code>collapsed</code>, vil navboksen alltid begynne som skjult.
:*Hvis den settes til <code>vanlig</code>/<code>plain</code>, vil navboksen alltid være utvidet, uten en [skjul]-lenke til høyre, og tittelen vil forbli midtstilt (ved å bruke padding til å flytte  <small>v • d • r</small>-lenkene).
:*Hvis den settes til <code>av</code>/<code>off</code>, vil navboksen alltid være utvidet, uten en [skjul]-lenke til høyre, men det brukes ikke padding for å beholde tittelen midtstilt. Dette er bare for avansert bruk; alternativet «plain» burde være tilstrekkelig for de fleste formål der [vis]/[skjul]-knappen trenger å være skjult.
:*Hvis den settes til noe annet enn <code>auto</code>/<code>autocollapse</code>, <code>lukket</code>/<code>collapsed</code>, <code>vanlig</code>/<code>plain</code> eller <code>av</code>/<code>off</code> (som f.eks. «uncollapsed»), vil navboksen alltid begynne i en status der boksen er utvidet, men den har «skjul»-knappen.

: For å vise boksen når den er alenestående (ikke inkludert på en annen artikkel), men autoskjule boksen når den er i en artikkel, putt «autocollapse» inni &lt;noinclude>-tagger:
:* <code>status = </code><nowiki><noinclude>uncollapsed</noinclude></nowiki>
:* Den innstillingen vil tvinge boksen til å være synlig når den er alenestående (selv når den blir fulgt av andre bokser), og til å vise «[skjul]», men den blir autoskjult når den stables inni en artikkel.

: Personer som redigerer, ønsker ofte en standard startstatus for en navboks, som kan være overstyrt i en artikkel. Her er trikset for å gjøre det:
:*Lag en parameter som heter «status» som en pass-through på denne måten:
:*<code><nowiki>| status = {{{status<includeonly>|din_ønskede_startstatus</includeonly>}}}</nowiki></code>
:*Her vil <nowiki><includeonly>|</nowiki> gjøre malen synlig når selve malen vises alene.

::*Eksempel: {{[http://en.wikipedia.org/w/index.php?title=Template:Peso&oldid=186543013 en:Template:Peso]}} med autocollapse som standard startstatus. [[http://en.wikipedia.org/w/index.php?title=Bolivian_peso&direction=prev&oldid=167073595 en:Bolivian peso]] inkluderer den, og har bare en navboks. Så peso-navboksen vises. [[http://en.wikipedia.org/w/index.php?title=Chilean_peso&oldid=147935350 en:Chilean peso]] har to navbokser. Så peso-navboksen skjules.

::*Eksempel: {{[http://en.wikipedia.org/w/index.php?title=Template:Historical_currencies_of_Hungary&oldid=144872547 en:Template:Historical currencies of Hungary]}} med utvidet som standard startstatus. Alle inkluderende artikler viser innholdet som standard, unntatt hvis det var en hypotetisk artikkel som angir status = skjult ved inkludering.

:; ''navbar''
:: Standarden er <code>Tnavbar</code>. Hvis den settes til <code>plain</code>, vil ikke <small>v • d • r</small>-lenkene på venstre side av tittelfeltet bli vist, og padding vil automatisk bli brukt for å beholde tittelen midtstilt. Bruk <code>av</code> for å fjerne <small>v • d • r</small>-lenkene, men ikke bruke padding (dette er bare for avansert bruk; alternativet «plain» burde være tilstrekkelig for de fleste formål der en navbar ikke er ønskelig). Legg merke til det anbefales sterkt at man ikke skjuler navbaren; dette er for å gjøre det enklere for brukere å redigere malen, og for å beholde en standard stil på tvers av sider.

:; ''kantlinje''
:: ''Se avsnittet nedenfor om bruk av [[#Barnenavbokser (navbokser inni hverandre)|navbokser inni hverandre]] for eksempler og en mer fullstendig beskrivelse.''
:: Hvis den settes til <code>child</code> eller <code>subgroup</code>, så kan navboksen brukes som et kantlinjeløst barn (barn = underordnet objekt) som passer inn i en annen navboks. Kantlinjen er skjult, og det er ingen padding på sidene av tabellen, så den passer inn i ''liste''-området i sin foreldrenavboks. Hvis den settes til <code>none</code>, så er kantlinjen skjult og paddingen fjernes, og navboksen kan brukes som et barn av en annen container (ikke bruk alternativet <code>none</code> inni en annen navboks; på samme måte skal alternativet <code>child</code>/<code>subgroup</code> bare brukes inni en annen navboks). Hvis den settes til hva som helst annet (standard), så blir en vanlig navboks med en kantlinje på 1 piksel vist. Her er en alternativ måte å angi at kantlinjen skal være en undergruppestil på (altså bruke den første unavngitte parameteren i stedet for den navngitte ''kantlinje''-parameteren).

:::<code><nowiki>{{Navboks|child</nowiki></code>
::::<code>...</code>
:::<code><nowiki>}}</nowiki></code>

===Celler===
:; ''tittel''
:: Tekst som vises midtstilt i den øverste raden i tabellen. Denne teksten er vanligvis emnet for malen, dvs. en kortfattet beskrivelse av innholdet i boksen. Teksten bør være på en enkelt linje, men hvis det er behov for en andre linje, bruk <code><nowiki>{{-}}</nowiki></code> for å sikre riktig midtstilling. Denne parameteren er teknisk sett ikke obligatorisk, men å bruke {{malinfo|Navboks}} er ganske meningsløst uten en tittel.

:; ''gruppe<sub>n</sub>''
:: (dvs. ''gruppe1'', ''gruppe2'', etc.) Hvis angitt, vises teksten i en overskriftscelle til venstre for ''liste<sub>n</sub>''. Hvis utelatt, bruker ''liste<sub>n</sub>'' tabellen i full bredde.

:; ''liste<sub>n</sub>''
::  (dvs. ''liste1'', ''liste2'', etc.) Hovedinnholdet i malen, vanligvis en liste med lenker. Formatet er at de kommer etter hverandre på en linje; teksten kan imidlertid skrives på separate linjer hvis hele listen omgis av <code><nowiki><div> </div></nowiki></code>. Minst en ''liste''-parameter er påkrevd; hver ekstra ''liste'' blir vist i en egen rad i tabellen. Hver ''liste<sub>n</sub>'' kan settes etter en korresponderende ''gruppe<sub>n</sub>''-parameter, hvis den er oppgitt (se nedenfor).

:; ''bilde''
:: Et bilde som skal vises i en celle under tittelen og til høyre for hovedinnholdet (gruppene/listene). For at bildet skal vises ordentlig må parameteren ''liste1'' være angitt. Parameteren ''bilde'' godtar standard wikikode for visning av et bilde, dvs.
::: <code><nowiki>bilde = [[Bilde:Eksempel-no.jpg|100px]]</nowiki></code>

:; ''bildevenstre''
:: Et bilde som skal vises i en celle under tittelen og til venstre for hovedinnholdet (listene). For at bildet skal vises ordentlig må parameteren ''liste1'' være angitt, og ingen grupper kan være angitt. Parameteren ''bildevenstre'' godtar standard wikikode for visning av et bilde, dvs.
::: <code><nowiki>bildevenstre = [[Bilde:Eksempel-no.jpg|100px]]</nowiki></code>

:; ''over''
:: En celle i full bredde som vises mellom tittelfeltet og den første gruppen/listen, dvs. ''over'' hovedinnholdet i malen (grupper, lister og bilde). I en mal uten et bilde oppfører ''over'' seg på samme måte som parameteren ''liste1'' uten parameteren ''gruppe1''.

:; ''under''
:: En celle i full bredde som vises ''under'' hovedinnholdet i malen (grupper, lister og bilde). I en mal uten et bilde, oppfører ''under'' seg på samme måte som malens siste ''liste<sub>n</sub>''-parameter uten en ''gruppe<sub>n</sub>''-parameter. For et eksempel på bruk av parameteren ''under'', se {{[http://en.wikipedia.org/w/index.php?title=Template:Lists_of_the_provinces_and_territories_of_Canada&oldid=209856881 en:Template:Lists of the provinces and territories of Canada]}}.

===Stilparametre===
For å beholde en viss overensstemmelse blant maler og sider på Wikipedia, anbefales stiler generelt ikke. Muligheten til å endre stiler er imidlertid gitt. Hvis du vil angi flere stilegenskaper med den samme parameteren, må du skrive på denne måten:

: <code>stil = background:#''nnnnnn'';width:50em;</code>

Hvis du skriver som vist nedenfor, vil det bare bli tatt hensyn til den siste linjen.

: <code>stil = background:#''nnnnnn'';</code>
: <code>stil = width:50&nbsp;em;</code>

:; ''stil''
:: Angir [[Cascading Style Sheets|CSS]]-stiler som skal brukes på malens hovedinnhold. Parameteren ''innholdsstil'' gjør også det samme, og kan brukes i stedet for denne ''stil''-parameteren. Denne parameteren bør brukes med forsiktighet ettersom den kan føre til visuelle uoverensstemmelser. Eksempler:
::: <code>stil = background:#''nnnnnn'';</code>
::: <code>stil = width:''N''&nbsp;[em/%/px eller width:auto];</code>
::: <code>stil = float:[''left/right/none''];</code>
::: <code>stil = clear:[''right/left/both/none''];</code>

:; ''basisstil''
:: CSS-stiler som skal brukes på alle cellene ''tittel'', ''over'', ''under'' og ''gruppe'' på en gang. Stilen er ikke brukt på ''liste''-cellene. Dette er praktisk for enkel endring av hovedfargen på navboksen uten å måtte gjenta stilangivelsene for de forskjellige delene av navboksen. Eksempler:
::: <code>basisstil = background:lightskyblue;</code>

:; ''tittelstil''
:: [[Cascading Style Sheets|CSS]]-stiler som skal brukes på ''tittel'', oftest tittelfeltets bakgrunnsfarge:
::: <code><nowiki>tittelstil = background:</nowiki>''#nnnnnn'';</code>
::: <code><nowiki>tittelstil = background:</nowiki>''name'';</code>

:; ''gruppestil''
:: CSS-stiler som skal brukes på ''gruppe<sub>n</sub>''-cellene. Dette alternativet overstyrer alle stiler som er brukt på hele tabellen. Eksempler:
::: <code>gruppestil = background:#''nnnnnn'';</code>
::: <code>gruppestil = text-align:[''left/center/right''];</code>
::: <code>gruppestil = vertical-align:[''top/middle/bottom''];</code>

:; ''gruppe<sub>n</sub>stil''
:: CSS-stiler som skal brukes på en bestemt gruppe, i tillegg til alle stiler som er angitt av parameteren ''gruppestil''. Denne parameteren bør bare brukes når det er absolutt nødvendig for å opprettholde standardisering og enkelhet. Eksempler:
::: <code>gruppe3stil = background:red;color:white;</code>

:; ''listestil''
:: CSS-stiler som skal brukes på alle lister. Overstyres av parametrene ''oddetallsstil'' og ''partallsstil'' (hvis de er angitt) nedenfor.

:; ''liste<sub>n</sub>stil''
:: CSS-stiler som skal brukes på en bestemt liste, i tillegg til alle stiler som er angitt med parameteren ''listestil''. Denne parameteren bør bare brukes nå det er absolutt nødvendig for å opprettholde standardisering og enkelhet. Eksempler:
::: <code>liste5stil = background:#ddddff;</code>

:; ''listepadding''
:: Et tall og en enhet som angir paddingen i hver ''liste''-celle. ''liste''-cellene er utstyrt med en standardpadding på 0.25em på venstre og høyre side, og 0em over og under. På grunn av kompliserte, tekniske grunner virker det ikke å ganske enkelt angi ''listestil=padding:0.5em;'' (eller en hvilken som helst annen padding). Eksempler:
::: <code>listepadding = 0.5em 0em; </code> (angir 0.5em padding for venstre og høyre, og 0em padding over/under.)
::: <code>listepadding = 0em; </code> (fjerner all listepadding.)

:; ''oddetallsstil''
:; ''partallsstil''
::Brukes på oddetalls-/partallslistenummer. Overstyrer stiler definert av ''listestil''. Standardoppførselen er å legge på striper, henholdsvis hvit og grå, på oddetalls- og partallsrader for å øke lesbarheten. Disse bør ikke endres, bortsett fra i helt spesielle tilfeller.

:; ''partalloddetall'' <span style="font-weight:normal;"><code>[swap, even, odd, off]</code></span>
:: Hvis den settes til <code>swap</code>, blir de automatiske stripene for partalls- og oddetallsrader gjort omvendt. Vanligvis får partallsrader en lys grå bakgrunn; når denne parameteren brukes, får oddetallsradene den grå fargen i stedet. Hvis du setter parameteren til <code>even</code> eller <code>odd</code>, får alle radene den stripefargen. Hvis du setter parameteren til <code>off</code>, slår du av automatiske radstriper. Denne avanserte parameteren bør bare brukes for å fikse problemer når navboksen brukes som barn av en annen navboks, og stripene ikke stemmer. Eksempler og en nærmere beskrivelse finnes i [[#Barnenavbokser (navbokser inni hverandre)|avnsittet om barnenavbokser]] nedenfor.

:; ''overstil''
:; ''understil''
:: CSS-stiler som skal brukes på toppcellen (angitt med parameteren ''over'') og bunncellen (angitt med parameteren ''under''). Brukes vanligvis til å angi bakgrunnsfarge eller tekstjustering:
::: <code>overstil = background:#''nnnnnn'';</code>
::: <code>overstil = text-align:[''left/center/right''];</code>

:; ''bildestil''
:; ''bildevenstrestil''
:: CSS-stiler som skal brukes på cellene der bildet som er angitt med ''bilde'' eller ''bildevenstre'' er plassert. Disse stilene bør bare brukes unntaksvis, vanligvis for å fikse breddeproblemer hvis breddene på gruppene er angitt og bredden av bildecellen blir for stor. Eksempler:
::: <code>bildestil = width:5em;</code>

===== Standardstiler =====
Her er det listet opp stilinnstillingene som de fleste brukerne av navboksen oftest endrer. For å holde listen enkel er mer kompliserte stilinnstillinger er ikke tatt med. De fleste stilene er definert i [[MediaWiki:Common.css]].

:<code>innholdsstil&nbsp; = background:#fdfdfd; width:100%; vertical-align:middle;</code>
:<code>tittelstil&nbsp;&nbsp;&nbsp; = background:#ccccff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>overstil&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>understil&nbsp;&nbsp;&nbsp;&nbsp; = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>gruppestil&nbsp;&nbsp;&nbsp; = background:#ddddff; padding-left:1em; padding-right:1em; text-align:right;</code>
:<code>listestil&nbsp;&nbsp;&nbsp;&nbsp; = background:transparent; text-align:left/center;</code>
:<code>oddetallsstil = background:transparent;</code>
:<code>partallsstil&nbsp; = background:#f7f7f7;</code>

Siden ''listestil'' og ''oddetallsstil'' er transparente, har oddetallslister fargen definert i ''innholdsstil'', som er satt til #fdfdfd (hvit med en anelse grå) som standard. En liste har <code>text-align:left;</code> hvis den har en gruppe, hvis ikke har den <code>text-align:center;</code>. Siden bare ''innholdsstil'' har en vertical-align (justering i høyderetningen), arver alle andre dens <code>vertical-align:middle;</code>.

===Avanserte parametre===
:; ''tittelgruppe''
:: Denne putter en gruppe i tittelfeltet, med samme standardstiler som ''gruppe<sub>n</sub>''.  Den bør bare brukes unntaksvis (vanligvis i avanserte metamaler) og bruken krever noe kunnskap om den indre koden i {{malinfo|Navboks}}; du bør være klar til å manuelt sette opp CSS-stiler for å få alt til å virke ordentlig hvis du ønsker å bruke den. Hvis du tror du har bruk for denne parameteren, kan det være best å ombestemme seg, eller konsultere diskusjonssiden først.

:; ''tittelgruppestil''
:: Stilene for tittelgruppecellen.

:; ''indrestil''
:: En meget avansert parameter som ''bare'' skal brukes på avanserte metamaler som bruker navboksen. Internt bruker navboksen en ytre tabell for å tegne kantlinjen, og så en indre tabell for alt annet (tittel/over/grupper/lister/under/bilder etc.). Parametrene ''stil''/''innholdsstil'' angir parametrene for den ytre tabellen, som den indre tabellen arver, men i avanserte tilfeller (metamaler) kan det være nødvendig å direkte angi stilene for den indre tabellen. Denne parameteren gir tilgang til den indre tabellen så stiler kan angis. Brukes på eget ansvar.

====Mikroformater====

;innholdsklasse : Denne parameteren settes inn i «class»-attributtet for hele navboksen.
;tittelklasse : Denne parameteren settes inn i «class»-attributtet for navboksens tittelfelt.

Denne malen støtter innlegging av mikroformatinformasjon. Dette gjøres ved å legge til «class»-attributter til forskjellige dataceller for å indikere hva slags informasjon som befinner seg der. For å merke en navboks med at den inneholder [[hCard]]-informasjon om en person, for eksempel, legg til følgende parameter:

<pre>
| innholdsklasse = vcard
</pre>

''og''

<pre>
| tittelklasse = fn
</pre>

''eller'' (for eksempel):

<pre><nowiki>
| tittel = <span class="fn">[[Iain Banks]]</span>' bøker
</nowiki></pre>

...og så videre.

Se det engelske underprosjektet [[:en:Wikipedia:WikiProject Microformats]] for mer informasjon om innlegging av mikroformatinformasjon på Wikipedia og [[:en:microformat]] (norsk [[mikroformat]]) for mer informasjon om mikroformater generelt.