Redigerer Mal:Navboks/dok

{{dokumentasjonsunderside}}

{{mbox|image=[[Fil:Crystal_Clear_app_ktip.png|36px]]|text=For en kortere veiledning, se [[Mal:Navboks/dok/innføring]]}}

Denne malen lar deg sette opp en [[Wikipedia:Navigasjonsmaler|navigasjonsmal]] forholdsvis raskt ved å legge inn en eller flere lister med lenker. Den er utstyrt med standardstiler som burde fungere for de fleste navigasjonsmaler. Det anbefales å ikke endre standardstilene, men det er mulig. Bruk av denne malen anbefales sterkt på grunn av standardisering av navigasjonsmaler, og fordi den er lett å bruke.

==Bruk==
Vennligst fjern parametre som er blanke.

<pre style="overflow:scroll;">{{Navboks
| innholdsklasse = hlist
| navn = {{subst:PAGENAME}}
| tittel = 
| tittelklasse =
| bilde = 
| over = 

| gruppe1 = 
| liste1 = 

| gruppe2 = 
| liste2 = 
 ...
| gruppe30 = 
| liste30 = 

| under = 
}}</pre>

==Parameterliste==
{{Navboks
|navn = Navboks/dok
|status = uncollapsed
|bilde = {{{bilde}}}
|tittel = {{{tittel}}}
|over = {{{over}}}
|gruppe1 = {{{gruppe1}}}
|liste1 = {{{liste1}}}
|gruppe2 = {{{gruppe2}}}
|liste2 = {{{liste2}}}
|liste3 = {{{liste3}}} ''uten {{{gruppe3}}}''
|gruppe4 = {{{gruppe4}}}
|liste4 = {{{liste4}}}
|under = {{{under}}}<br/>Se alternative navboks-formater under [[#Tabellens utseende|Tabellens utseende]]
}}
Navboksen bruker parameternavn med små bokstaver, som vist i boksen. De obligatoriske ''navn'' og ''tittel'' vil lage en enlinjesboks hvis andre parametre er utelatt.
<br/>

Legg merke til at «gruppe1» (etc.) er valgfri, og det er også seksjonene «over/under».
{{-}}
De grunnleggende og vanligste parametrene er som følger (se under for den fulle listen):

:<code>innholdsklasse -</code> legger på et HTML class-attributt for hele navboksen.
:<code>navn -</code> navnet på malen (ikke tittelen). Hvis malen f.eks. heter Mal:Foo, blir navnet Foo.
:<code>tittel -</code> tekst i tittelfeltet, som f.eks. <nowiki>[[Dingser]]</nowiki>.
:<code>tittelklasse -</code> legger på et HTML class-attributt for tittelfeltet.
:<code>status - autocollapse, uncollapsed, collapsed</code>: om boksen skal være skjult eller ikke, der «autocollapse» skjuler stablede navbokser automatisk.

:<code>tittelstil - </code>en CSS-stil for tittelfeltet, som f.eks. <code>background:gray;</code>
:<code>gruppestil - </code>en CSS-stil for gruppecellene, som f.eks. <code>background:#eee;</code>

:<code>bilde - </code>et valgfritt bilde på høyre side (kodet som en hel bilde-tagg: <nowiki>[[Fil:XX.jpg|90px]]</nowiki> ).
:<code>bildevenstre - </code>et valgfritt bilde på venstre side (kodes på samme måte som «bilde»-parameteren).

:<code>over - </code> valgfri tekst som skal vises over gruppe-/listeseksjonen (kan være en liste med generelle lenker).

:<code>gruppe<sub>n</sub> - </code>teksten på venstre side før liste<sub>n</sub> (hvis gruppe<sub>n</sub> er utelatt, starter liste<sub>n</sub> til venstre i boksen).
:<code>liste<sub>n</sub> - </code>tekst som lister opp lenker, ofte adskilt av middot-maler, som f.eks. [<nowiki/>[A]]<code>{<nowiki/>{,}}</code> [<nowiki/>[B]]
:<code>under - </code>valgfri tekst som skal vises under gruppe-/listeseksjonen.

Ytterligere detaljer, og kompliserte restriksjoner, er forklart under i avsnittet [[#Parameterbeskrivelser|Parameterbeskrivelser]]. Se noen alternative navboks-formater under [[#Tabellens utseende|Tabellens utseende]].

==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.

== Tabellens utseende ==
Tabell generert av {{malinfo|Navboks}} '''uten''' parametrene ''bilde'', ''over'' og ''under'' (grå listebakgrunnsceller er tatt med bare for illustrasjon):
{{Navboks
|navn = Navboks/dok
|status = uncollapsed
|listestil = background:silver;
|tittel = {{{tittel}}}
|gruppe1 = {{{gruppe1}}}
|liste1 = {{{liste1}}}
|gruppe2 = {{{gruppe2}}}
|liste2 = {{{liste2}}}
|liste3 = {{{liste3}}} ''uten {{{gruppe3}}}''
|gruppe4 = {{{gruppe4}}}
|liste4 = {{{liste4}}}
}}


Tabell generert av {{malinfo|Navboks}} '''med''' parametrene ''bilde'', ''over'' og ''under'' (grå listebakgrunnsceller er tatt med bare for illustrasjon):
{{Navboks
|navn = Navboks/dok
|status = uncollapsed
|listestil = background:silver;
|bilde = {{{bilde}}}
|tittel = {{{tittel}}}
|over = {{{over}}}
|gruppe1 = {{{gruppe1}}}
|liste1 = {{{liste1}}}
|gruppe2 = {{{gruppe2}}}
|liste2 = {{{liste2}}}
|liste3 = {{{liste3}}} ''uten {{{gruppe3}}}''
|gruppe4 = {{{gruppe4}}}
|liste4 = {{{liste4}}}
|under = {{{under}}}
}}


Tabell generert av {{malinfo|Navboks}} '''med''' ''bilde'', ''bildevenstre'', ''lister'', og '''uten''' ''grupper'', ''over'', ''under'' (grå listebakgrunnsceller er tatt med bare for illustrasjon):
{{Navboks
|navn = Navboks/dok
|status = uncollapsed
|listestil = background:silver;
|bilde = {{{bilde}}}
|bildevenstre = {{{bildevenstre}}}
|tittel = {{{tittel}}}
|liste1 = {{{liste1}}}
|liste2 = {{{liste2}}}
|liste3 = {{{liste3}}}
|liste4 = {{{liste4}}}
}}

== Eksempler ==
<!--Vennligst oppfordre folk til å ikke bruke <div>-er inni navbokser ettersom (med mindre de håndteres med omtanke) de kan oppheve listestiler/gruppestiler/etc.-->

=== Uten bilde ===
<pre style="overflow:scroll;">
{{Navboks
| innholdsklasse = hlist
| navn = Navboks/dok
| tittel = [[Norsk]]e [[ordbok|ordbøker]]

| gruppe1 = [[Riksmål]]
| liste1 =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]

| gruppe2 = [[Bokmål]]
| liste2 =
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]

| gruppe3 = [[Nynorsk]]
| liste3 =
*[[Nynorskordboka]]
*[[Norsk Ordbok]]

| gruppe4 = [[Ordbok#Elektroniske ordbøker|Elektroniske]]
| liste4 = [[Clue Norge]]
*[[Ordnett]]
}}
</pre>

{{Navboks
|innholdsklasse = hlist
|navn      = Navboks/dok
|status  = uncollapsed
|tittel  = [[Norsk]]e [[ordbok|ordbøker]]
|gruppe1 = [[Riksmål]]
|liste1  =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]
|gruppe2 = [[Bokmål]]
|liste2  =
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]
|gruppe3 = [[Nynorsk]]
|liste3  =
*[[Nynorskordboka]]
*[[Norsk Ordbok]]
|gruppe4 = [[Ordbok#Elektroniske ordbøker|Elektroniske]]
|liste4 =
*[[Clue Norge]]
*[[Ordnett]]
}}

=== Med bilde, uten grupper ===
<pre style="overflow:scroll;">
{{Navboks
|innholdsklasse = hlist
|navn   = Navboks/dok
|tittel  = [[Norsk]]e [[ordbok|ordbøker]]

|bilde  = [[Bilde:Books 001a.jpg|41px]]
|bildestil = padding:0px 10px;

|liste1  =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]
*[[Nynorskordboka]]
*[[Norsk Ordbok]]
*[[Clue Norge]]
*[[Ordnett]]
}}
</pre>
{{Navboks
|innholdsklasse = hlist
|navn   = Navboks/dok
|status  = uncollapsed
|tittel  = [[Norsk]]e [[ordbok|ordbøker]]
|bilde  = [[Bilde:Books 001a.jpg|41px]]
|bildestil = padding:0px 10px;
|liste1  =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]
*[[Nynorskordboka]]
*[[Norsk Ordbok]]
*[[Clue Norge]]
*[[Ordnett]]
}}

=== Med to bilder, uten grupper, flere lister ===
<pre style="overflow:scroll;">
{{Navboks
|innholdsklasse = hlist
|navn     = Navboks/dok
|status = uncollapsed
|tittel  = [[Norsk]]e [[ordbok|ordbøker]]
|bilde  = [[Bilde:Books 001a.jpg|41px]]
|bildestil = padding:0px 10px;
|bildevenstre  = [[Bilde:Books 001a.jpg|41px]]
|bildevenstrestil = padding:0px 10px;
|liste1  =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]
|liste2  =
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]
|liste3  =
*[[Nynorskordboka]]
*[[Norsk Ordbok]]
|liste4 =
*[[Clue Norge]]
*[[Ordnett]]
}}
</pre>

{{Navboks
|innholdsklasse = hlist
|navn     = Navboks/dok
|status = uncollapsed
|tittel  = [[Norsk]]e [[ordbok|ordbøker]]
|bilde  = [[Bilde:Books 001a.jpg|41px]]
|bildestil = padding:0px 10px;
|bildevenstre  = [[Bilde:Books 001a.jpg|41px]]
|bildevenstrestil = padding:0px 10px;
|liste1  =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]
|liste2  =
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]
|liste3  =
*[[Nynorskordboka]]
*[[Norsk Ordbok]]
|liste4 =
*[[Clue Norge]]
*[[Ordnett]]
}}

=== Med bilde, grupper, over, under ===
<pre style="overflow:scroll;">
{{Navboks
| innholdsklasse = hlist
| navn = Navboks/dok
| tittel = [[Norsk]]e [[ordbok|ordbøker]]

| bilde = [[Bilde:Books 001a.jpg|41px]]
| bildestil = padding:0px 10px;
| over = Over-tekst kommer her

| gruppe1 = [[Riksmål]]
| liste1 =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]

| gruppe2 = [[Bokmål]]
| liste2 =
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]

| gruppe3 = [[Nynorsk]]
| liste3 =
*[[Nynorskordboka]]
*[[Norsk Ordbok]]

| gruppe4 = [[Ordbok#Elektroniske ordbøker|Elektroniske]]
| liste4 =
*[[Clue Norge]]
*[[Ordnett]]

| under = Under-tekst kommer her
}}
</pre>

{{Navboks
| innholdsklasse = hlist
| navn = Navboks/dok
| tittel = [[Norsk]]e [[ordbok|ordbøker]]

| bilde = [[Bilde:Books 001a.jpg|41px]]
| bildestil = padding:0px 10px;
| over = Over-tekst kommer her

| gruppe1 = [[Riksmål]]
| liste1 =
*[[Norsk Riksmålsordbok]]
*[[Norsk ordbok]]
*[[Riksmålsordlisten]]

| gruppe2 = [[Bokmål]]
| liste2 =
*[[Bokmålsordboka]]
*[[Norsk ordbok]]
*[[Tanums store rettskrivningsordbok]]

| gruppe3 = [[Nynorsk]]
| liste3 =
*[[Nynorskordboka]]
*[[Norsk Ordbok]]

| gruppe4 = [[Ordbok#Elektroniske ordbøker|Elektroniske]]
| liste4 =
*[[Clue Norge]]
*[[Ordnett]]

| under = Under-tekst kommer her
}}

==Barnenavbokser (navbokser inni hverandre)==
Det er mulig å plassere flere navbokser innenfor en enkelt kantlinje ved å bruke parameteren ''kantlinje'', eller ved å sette den første unavngitte parameteren til ''child''. Basiskoden for å gjøre dette er som følger (som legger til en undergruppe for det første gruppe/liste-feltet):
<pre style="overflow:scroll;">
{{Navboks
| navn = {{subst:PAGENAME}}
| tittel = Tittel

| gruppe1 = [valgfri]
| liste1 = {{Navboks|child
   ...parametre for barnenavboks...
 }}

...
}}
</pre>

===Eksempel på undergrupper===
Dette eksemplet viser hvordan undergrupper kan brukes. Man bruker {{malinfo|Navboks}} med <code>kantlinje = child</code> eller den første unavngitte parameteren satt til <code>child</code>. Legg merke til at parameteren ''partalloddetall'' brukes til å gjøre stripene omvendt i noen av undergruppene for å få alle stripene til bli stilt opp riktig. Hvis du vil fjerne stripene helt, kan du sette <code>listestil = background:transparent;</code> i hver av navboksene.

{{Navboks
|navn = Navboks/dok
|bilde = [[Bilde:Flag of Norway.svg|100px]]
|bildestil = padding:0px 20px;
|status = uncollapsed
|tittel = Eksempel på flere undergrupper
|over = Over
|under = Under

|gruppe1 = Gruppe1
|liste1 = Liste1
|gruppe2 = Gruppe2
|liste2 = 
 {{Navboks|child
  |partalloddetall = swap
  |gruppe1 = Gruppe2.1
  |liste1 = Liste1
  |gruppe2 = Gruppe2.2
  |liste2 = Liste2
  |gruppe3 = Gruppe2.3
  |liste3 = Liste3
 }}

|gruppe3 = Gruppe3
|liste3 = Liste3

|gruppe4 = Gruppe4
|liste4 = 
 {{Navboks|child
  |partalloddetall = swap
  |gruppe1 = Gruppe4.1
  |liste1 = Liste1
  |gruppe2 = Gruppe4.2
  |liste2 = Liste2
  |gruppe3 = Gruppe4.3
  |liste3 = Liste3
 }}
}}

===Flere vis/skjul i en enkelt container===

Eksemplet under er generert med en vanlig navboks for hovedcontaineren. Parametrene liste1 og liste2 inneholder hver en annen navboks, med <code>kantlinje = child</code> angitt. Legg merke til at hver av barnenavboksene har sin egen VDR-navigasjonslinje; disse kan skjules med <code>navbar = plain</code> for hver av dem, eller ved bare å utelate parameteren ''navn'' (barnenavbokser trenger ikke, i motsetning til vanlige navbokser, å ha navn-parameteren angitt).

{{Navboks
|navn  = Navboks/dok
|tittel = [[Generisk toppnivådomene|Generiske toppnivådomener]]
|status = uncollapsed
|innholdsstil = width:50em;

|liste1 =
 {{Navboks|child
  |navn  = Navboks/dok
  |tittel = Nåværende
  |gruppestil = width:9.0em;
  |listestil  = padding:0.4em 0; line-height:1.4em; <!--otherwise lists can appear to form continuous whole--> width:auto;
  |gruppe1 = [[Generisk toppnivådomene|Generisk]]
  |liste1  = [[.biz]]{{,}} [[.com]]{{,}} [[.info]]{{,}} [[.name]]{{,}} [[.net]]{{,}} [[.org]]{{,}} [[.pro]]
  |gruppe2 = [[Sponset toppnivådomene|Sponset]]
  |liste2  = [[.aero]]{{,}} [[.asia]]{{,}} [[.cat]]{{,}} [[.coop]]{{,}} [[.edu]]{{,}} [[.gov]]{{,}} [[.int]]{{,}} [[.jobs]]{{,}} [[.mil]]{{,}} [[.mobi]]{{,}} [[.museum]]{{,}} [[.tel]]{{,}} [[.travel]]
  |gruppe3 = Infrastruktur
  |liste3  = [[.arpa]]
  |gruppe4 = Slettet/foreldet
  |liste4  = [[.nato]]
  |gruppe5 = [[Toppnivådomene#Reserverte TLD-er|Reservert]]
  |liste5  = [[.example]]{{,}} [[.invalid]]{{,}} [[.localhost]]{{,}} [[.test]]
  |gruppe6 = [[Pseudo-toppnivådomene|Pseudo]]
  |liste6  = [[.bitnet]]{{,}} [[.csnet]]{{,}} [[.local]]{{,}} [[.root]]{{,}} [[.uucp]]{{,}} [[.onion|.onion/.exit]]
 }}


|liste2 =
 {{Navboks|child
  |navn  = Navboks/dok
  |tittel = [[Foreslått toppnivådomene|Foreslåtte]]
  |gruppestil = padding:0.2em 1.0em; line-height:1.1em; <!--reduces gap between wrapped groupname lines--> width:9.0em;<!--as above-->
  |listestil  = padding:0.4em 0; line-height:1.4em; <!--as above--> width:auto;<!--as above-->
  |gruppe1 = [[GeoTLD|Steder]]
  |liste1  = [[.berlin]]{{,}} [[.lat]]{{,}} [[.nyc]]
  |gruppe2 = Språk og<br/>nasjonalitet
  |liste2  = [[.bzh]]{{,}} [[.cym]]{{,}} [[.gal]]{{,}} [[.lli]]{{,}} [[.sco]]
  |gruppe3 = Teknisk
  |liste3  = [[.geo]]{{,}} [[.mail]]
  |gruppe4 = Andre
  |liste4  = [[.kids]]{{,}} [[.post]]{{,}} [[.shop]]{{,}} [[.web]]{{,}} [[.xxx]]
 }}

|under = [[Nasjonalt toppnivådomene|Nasjonale toppnivådomener]]
}}

===Ytterligere eksempler===
Du kan finne tilleggseksempler på kompliserte undergrupper og barnenavbokser på [[Mal:Navboks/dok/Avanserte eksempler|siden med avanserte navboks-eksempler]] og [[Mal:Navboks/eksempel|siden med eksempler på navboks-kode]].

== Tekniske detaljer ==
*Denne malen bruker CSS-klasser for de fleste av sine detaljer ved utseendet; derfor er den fullt mulig å tilpasse med skins (egendefinerte utseender).

*Internt bruker denne metamalen HTML-kode i stedet for wikikode for tabellkoden. Det er den vanlige måten vi lager metamaler på siden wikikode har mange ulemper. For eksempel gjør den det vanskeligere å bruke [[m:Help:ParserFunctions|parserfunksjoner]] og spesialtegn i parametrene.

*For flere tekniske detaljer, se [[{{TALKPAGENAME}}|diskusjonssiden]], CSS-klassene i [[MediaWiki:Common.css]] og den skjulbare tabellen som brukes til å skjule boksen i [[MediaWiki:Common.js]].

===Vanskeligheter===
*Den 2 piksler brede linjen mellom grupper og lister er tegnet ved hjelp av egenskapen border-left til listecellen. Derfor må du sette border-left-color lik bakgrunnsfargen (dvs. <code>listestil = border-left-color:purple;</code>) hvis du vil endre bakgrunnsfargen til malen (f.eks. <code>innholdsstil = background:purple;</code>). Hvis du vil ha en kantlinje rundt hver listecelle, så vil den 2 piksler brede linjen mellom listecellene og gruppecellene forsvinne; du må finne din egen løsning.

*Listecellebredden er i utgangspunktet satt til 100%. Derfor må du også sette listestil til å ha width:auto hvis du vil sette bredden på gruppeceller manuelt. Hvis du vil sette gruppebredden og bruke bilder, er det opp til deg å tenke ut CSS-koden i parametrene gruppestil, listestil, bildestil og bildevenstrestil for å få alt til å fungere riktig. Eksempel på å sette gruppebredde:
::<code>gruppestil = width:10em;</code>
::<code>listestil = width:auto;</code>

*Tilstøtende navbokser har bare en 1 piksel bred kantlinje mellom dem. Hvis du setter topp- eller bunnmargen for <code>stil/innholdsstil</code>, vil ikke dette fungere.

*Standardverdiene for margin-left og margin-right for den ytre navbokstabellen er satt til «auto;». Hvis du vil bruke navboksen som en float, må du manuelt sette verdiene for margin-left og margin-right fordi automargene «forstyrrer» float-innstillingen. For eksempel, legg til følgende kode for å bruke navboksen som en float:
::<code>stil = width:22em;float:right;margin-left:1em;margin-right:0em;</code>

== Se også ==
* {{tl|Navboks vedlikehold}} sjekker bruk av en navboks. Anbefales å inkludere på dokumentasjonssiden til navbokser.
* [[:en:Wikipedia:Line break handling|Wikipedia:Line break handling]] (engelsk) &ndash; Et veiledning om hvordan linjeskift (tekstbryting) skal håndteres på Wikipedia, slik som tekstbryting av lenkelister brukt i navbokser.
* {{malinfo|Nobold}} &ndash; For å vise teksten som en vanlig font i en sammenheng der standarden er fet, f.eks. overskriftsceller i tabeller.
<includeonly>
[[Kategori:Grunnmaler|{{PAGENAME}}]]
[[Kategori:Navigasjonsmaler| ]]
</includeonly>