Mall:Navbox/dok

Mallen är till för att på ett enkelt sätt skapa kraftfulla navigationsmallar. Tänk på att mallen används för att standardisera alla navigationsrutor på hela svenskspråkiga Wikipedia så ändra inte mallens stil, det är dock möjligt.

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 mer än två navigationsrutor i en artikel.
• uncollapsed - eller något annat. 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}}