Mall:Navbox/dok

Mallen är till för att på ett enkelt sätt skapa kraftfulla navigationsmallar.

Användning

Tomma parametrar kan raderas.

{{Navbox
|name    = {{subst:PAGENAME}}
|title   = 
|image   = 
|above   = 

|group1  = 
|list1   = 

|group2  = 
|list2   = 
 ...
|group25 = 
|list25  = 

|below   = 
}}

Parametrar

Alla mallens parametrar skrivs med gemener. title är den enda parametern som är obligatorisk, alla andra kan utelämnas.

De mest grundläggande parametrarna är:

name - mallens namn. (  ).

title - navigationsmallens titel, skrivs till exempel: Lista över hårdvara från [[Atari]].

state (autocollapse, uncollapsed, collapsed) - hur mallen ska te sig när den används, om den ska visas direkt, eller om den ska vara dold.

titlestyle - CSS stil för titlelisten, till exempel: background:gray;. (CSS)

groupstyle - CSS stil för groupcellerna, till exempel: background:#eee;. (CSS)

image - kan användas för att placera en bild till höger i mallen. Använd normal bild-syntax.

imageleft - kan användas för att placera en bild till vänster i mallen. Använd normal bild-syntax.

above - text som ska hamna mellan titeln och listan.

groupn - titeln för den n:te list-parametern. Kan utelämnas.

listn - text som ofta är wikilänkar till relaterade sidor. Brukar separeras med antingen {{!}}, {{•}} eller {{·}}

below - text som hamnar på en egen rad längst ner i mallen.

Stilparametrar

style - för hela mallen, men påverkar inte defaultvärden för övriga tabellceller. (CSS)

basestyle - för title- och group-rubriker, samt above- och below-celler. (CSS)

titlestyle - för mallens rubrik (title). (CSS)

groupstyle, groupnstyle - för alla eller vissa grupprubriker. (CSS)

liststyle, listnstyle - för allt eller visst listinnehåll. (CSS)

abovestyle - för above-cellen. (CSS)

belowstyle - för below-cellen. (CSS)

imagestyle, imageleftstyle - för tabellceller som innehåller bilder. (CSS)

evenodd (swap, on, off) - ger en nyanskillnad på raderna i mallen.

evenstyle, oddstyle - för listinnehåll på udda respektive jämna rader. (CSS)

Parametrar med inställningar

state [autocollapse, uncollapsed, collapsed, plain, off]

Parametern state används för att definiera hur mallen ska te sig när den blir inkluderad i en artikel. Alla lägen ignoreras om användaren har stängt av JavaScript.

• autocollapse - Standardinställningen. Döljer innehållet i navigationsrutan när det är två eller fler navigationsrutor i en artikel.
• uncollapsed - eller något annat^[1]. Detta gör så att navigationsrutans innehåll inte döljs om det är två eller mer i en artikel.
• collapsed - Tvingar navigationsrutan att dölja sitt innehåll även om den är ensam i en artikel.
• plain, off - Tar bort möjligheten att dölja navigationsrutans innehåll.

evenodd [off, on, swap, even, odd]

• off - Standardinställningen. Stänger av mallens ränder.
• on - Slår på mallens funktion för ränder.
• swap - Slår på mallens funktion för ränder. Byter så att stilen på odd används för even och tvärt om, används för inkluderade undermallar.
• even, odd - Sätter alla ränder i hela mallen till att ha den valda stilen.

Användningsexempel

Mycket simpel

{{navbox
|name  = {{subst:PAGENAME}}
|title = Boxens titel
|list1 = Boxens innehåll
}}

Med grupper

{{navbox
|name   = {{subst:PAGENAME}}
|title  = 
|group1 = 
|list1  = 
|group2 = 
|list2  = 
}}

Underboxar

Underboxar kan användas för att bara visa delar av navigationsrutor åt gången, till exempel vid ett lands uppdelning i län och kommuner.

{{navbox
|name   = {{subst:PAGENAME}}
|title  = 
|list1  ={{navbox|child
  |title = 
  |group1= 
  |list1 = 
  |group2= 
  |list2 = 
  }}
|list2  ={{navbox|child
  |title = 
  |group1= 
  |list1 = 
  |group2= 
  |list2 = 
  }}
}}

Övrig funktionalitet

Dölja {{tnavbar}}

Navbox använder {{tnavbar}} för att visa de tre länkarna (Visa, diskutera och redigera) i titeln. I bland kan det vara önskvärt att dölja dessa då mallen används för något annat än en navigationsruta. Detta är dock inget som rekommenderas eller bör användas.

För att dölja {{tnavbar}} från mallen så sätter man bara parametern name till #dölj navigeringslänkarna.

Se även

• {{infobox}}

Fotnoter

1. Vad som helst som inte är en av de andra parametrarna, men använd något som är lättförstått.