Ennek a sablonnak a segítségével relatíve gyorsan lehet navigációs sablont létrehozni, egy vagy több listányi link megadásával. Alapértelmezett stílusai a legtöbb esetben megfelelőek, de indokolt esetben lehetséges testre szabni. A navbox és a navbox-család testvérsablonjainak használata erősen ajánlott a navigációs sablonok egységesítése, és a könnyű használat miatt.
{{{alul}}} Alternatív navbox formák a táblák rendezése fejezetben találhatóak.
A navbox kisbetűs paraméterneveket használ, ahogy a fenti példán is látszik. Csak a kötelező név és cím megadásával egysoros dobozt kapunk, a „csoport1”, „alul”, „felül”, stb. elhagyható.
Az alapvető, leggyakrabban használt paraméterek a következők (lejjebb megtalálod a teljes listát is):
név = a sablon neve. (A fenti kód kimásolásakor automatikusan bekerül.)
cím = a sablon fejlécében található szöveg, például: [[Szabad szoftverek]].
címstílus = CSS paraméter hozzárendelése a fejléchez, például: background:gray;
csoportstílus = CSS paraméter hozzárendelése a csoportok celláihoz, például: background:#eee;
kép = nem kötelező jobb oldali kép (a szócikkekben használt általános formával, lásd: [[Kép:XYZ.jpg|90px]]).
balkép = nem kötelező bal oldali kép (hasonlóan mint a „kép” paraméternél).
felül = nem kötelező szöveg, ami a listák/csoportok felett jelenik meg.
csoportszám = szöveg a bal oldalon a lista-szám előtt (ha a csoportszám el van hagyva, akkor a bal oldalon kezdődik a listaszám). Legfeljebb 32 csoport elem adható meg.
listaszám = a wikilinkek listájának szövege, gyakran emelt ponttal elválasztva. Például: [[A]]{{·}} [[B]]. Legfeljebb 32 lista elem adható meg.
alul = nem kötelező szöveg, ami a listák/csoportok alatt jelenik meg.
A további részletek és összetett korlátozások magyarázatát a paraméterek leírása szekcióban olvashatod. Néhány eltérő navbox formátum: táblák elrendezése.
Alább található a {{navbox}}(?) sablonnal használható paraméterek teljes listája. A legtöbb esetben csak a név, cím és lista1 paramétereket kell megadni, de gyerek navboxok használatakor még ezekre sincsen szükség.
A {{navbox}}(?) sablonnak sok közös paramétere van a testvéreivel ({{Navbox oszlop}}(?) és {{Navbox alcsoport}}(?)) az egységesség és a könnyebb használat jegyében. A kereszttel† jelölt paraméterek közösek a három fő navigációs sablonban.
A sablon neve, ami az „m • v • sz” („megnézi • vitatja • szerkeszti a sablont”) linkek összes lapon való helyes működéséhez kell. Rövidítésképpen használhatod a {{subst:PAGENAME}} mágiát. A név paraméter csak akkor kötelező, ha meg van adva cím, és a keret paraméter nincs beállítva.
Alapértelmezett az autocollapse. Így összecsukva jelenik meg, ha az oldalon további kettő vagy több összecsukható táblázat van. Egyébként nyitva marad.
Ha collapsed állapotúra állítjuk, mindig csukva fog megjelenni.
Ha plain az értéke, midig kinyitott állapotú lesz, „becsuk” link nélkül, de a cím középen marad.
Végül off esetén midig kinyitott állapotú lesz, „becsuk” link nélkül; de nincs kitöltés, hogy a címet középen tartsa. Ezért ezt csak haladó használatra ajánljuk, ahol a „kinyit/becsuk” gombnak rejtve kell lennie.
Ha az autocollapse, collapsed, plain, vagy off paramétereken kívül bármi mást adunk meg (például „uncollapsed”), akkor a navbox kinyitott állapotban jelenik meg, de működik a „becsuk” gomb.
Hogy a sablon lapján (nem beillesztve) nyitva legyen, de szócikkben automatikusan csukódjon, tedd az „uncollapsed” paramétert <noinclude> tagek közé:
állapot = <noinclude>uncollapsed</noinclude>
navbar†
Alapértelmezett a {{m-v-sz}}. Ha az értéke plain, az „m • v • sz” linkek a címsor bal oldalán nem jelennek meg, de automatikus kitöltéssel a cím középre igazított marad. Az off értékkel is ki lehet kapcsolni, de akkor nincs kitöltés, ezért ezt csak haladó használatra ajánljuk (a plain a legtöbb esetben megfelelő). Egyébként erősen ellenjavallt elrejteni ezeket a linkeket, mert a szerkesztőknek így egyszerűbb módosítani a sablont, és egységesebb lesz a kinézet.
keret†
Alább bővebb leírást és példákat találsz a navboxok egymásba ágyazásáról. Ha értéke gyerek vagy alcsoport, akkor a navboxot keret nélküli alcsoportnak használhatjuk, ami belesimul a szülő dobozba. Ekkor a keret rejtett, és a tábla egyik oldalán sincs kitöltés, így pontosan illeszkedik a szülő navbox egyik listájába. Ha az értéke nincs, szintúgy nincs kitöltés és keret, és használható más konténer gyerekeként (másik navboxba beágyazva ne használjuk, akkor csak gyerek vagy alcsoport legyen). Ha bármi más az értéke (alapértelmezett állapot), szokványos navboxot rajzol 1 pixeles kerettel. Egy alternatív módja, hogy megadjuk az alcsoport keretstílust (azaz az első névtelen paramétert használjuk a border helyett):
A legfelső (cím)sor szövege, középre igazítva. Általában a sablon témája, azaz a tartalom rövid leírása. Illik egysorosnak lennie, de ha mégis szükség van második sorra, használjuk a {{-}} kódot hogy a középre igazítás működjön. Ez a paraméter technikailag nem kötelező, de a {{navbox}}(?) használata cím nélkül eléggé céltalan.
csoportszám†(azaz csoport1, csoport2, stb.)
Ha meg van adva, a szöveg a fejléc-cellában jelenik meg, a listaszám mellett balra. Ha elhagyjuk, a listaszám a táblázat teljes szélességét használja.
listaszám†(azaz lista1, lista2, stb.)
A sablon teste, általában egy rakás link. A formátuma inline, de a szöveget külön sorokba is írhatjuk, ha az egész listát <div> </div> tagok közé zárjuk. Minimum egy lista paraméter kötelező, minden további lista a táblázat új soraként szerepel. Minden listaszám előtt szerepelhet egy hozzá tartozó csoportszám paraméter.
kép†
Egy kép, ami a címsor alatt és a sablon testének jobb oldalán, a listák/csoportok mellett lesz látható. Hogy megfelelően megjelenjen, kell lennie lista1nek. A kép paraméter a megjelenítéshez a rendes wikikódot fogadja el, azaz
kép = [[Kép:Example.jpg|100px]]
balkép†
Egy kép, ami a címsor alatt és a sablon testének bal oldalán lesz látható. Hogy megfelelően megjelenjen, kell lennie lista1nek. A balkép paraméter a megjelenítéshez a rendes wikikódot fogadja el, azaz
balkép = [[Kép:Example.jpg|100px]]
felül†
Teljes szélességű cella a címsor és az első csoport/lista között, azaz a sablon testéhez képest (csoportok, listák, képek) felül. Kép nélküli sablonban a felül úgy viselkedik mint a lista1csoport1 nélkül.
alul†
Teljes szélességű cella a a sablon testéhez képest (csoportok, listák, képek) alul. Kép nélküli sablonban az alul úgy viselkedik mint az utolsó listaszámcsoportszám nélkül.
A stílusok és az egységesített kinézet nem nagyon férnek össze a Wikipédiában. Természetesen a sablon kinézetének megváltoztatása lehetséges, de csak indokolt esetekben.
stílus†
CSS stílusokat adhatunk meg a sablon testéhez. A bodystílus paraméterrel ugyanezt érhetjük el. Csak mértékkel használatos, mert összevisszaságokhoz vezethet. Példák:
stílus = background:#nnnnnn;
stílus = width:N [em/%/px vagy width:auto];
stílus = float:[left/right/none];
stílus = clear:[right/left/both/none];
alapstílus†
CSS stílusok, amelyek a cím, felül, alul és csoport cellákra egyaránt vonatkoznak, de a lista cellákra nem. Egyszerű és kényelmes mód a navbox alapszínének megváltoztatására anélkül, hogy az egyes részekre külön kellene megismételnünk. Példa:
alapstílus = background:lightskyblue;
címstílus†
A címsorra vonatkozó CSS stílusok. Megváltoztatható vele például a címsor háttérszíne. Példák:
címstílus = background:#nnnnnn;
címstílus = background:name;
csoportstílus†
A csoportszám cella által alkalmazott CSS stílusok változtathatók meg vele. Ez az opció felülbírálja az egész táblázatra vonatkozó stílusokat. Például:
CSS stílusok, amik csak egy konkrét csoportra vonatkoznak a csoportstílus paraméteren felül. Csak akkor illik használni, ha tényleg szükséges. Példa:
csoport3stílus = background:red;color:white;
listastílus†
A listákra vonatkozó CSS stílusok. A párosstílus és páratlanstílus paraméterek felülbírálják, ha meg vannak adva.
listaszámstílus†
CSS stílusok, amik csak egy konkrét listára vonatkoznak a listastílus paraméteren felül. Csak akkor illik használni, ha tényleg szükséges. Példa:
lista5stílus = background:#ddddff;
listatérköz†
Egy szám és mértékegysége, ami a lista cellák közti kitöltést adják meg. A lista cellák alapértelmezett kitöltése 0.25em kétoldalt, és 0em fent és lent. Bonyolult technikai okokból a "listastílus=padding:0.5em;" (vagy bármilyen más helykitöltés beállítás) nem működik. Példák:
listatérköz = 0em; (eltávolítja az összes helykitöltést)
páratlanstílus
párosstílus
A páros/páratlan számú listákra vonatkozik. Felülbírálja a listastílus paramétert. Az alapértelmezett viselkedés szerint „csíkos” lesz a táblázat (váltakozva fehér és szürke hátterű), az olvasás megkönnyítése érdekében. Nem illik megváltoztatni, csak alapos indokkal.
párospáratlan[csere, ki]
Ha értéke csere, a páros és páratlan sorok automatikus csíkozása megfordul. Alapesetben a páros sorok háttere szürke a csíkozás miatt, ezzel a paraméterrel pedig a páratlan sorok háttere lesz szürke. A ki értéket használva letiltjuk az automatikus csíkozást. Ezt a haladó paramétert csak akkor szabad használni, ha a navboxot gyerekként használjuk, és nem stimmel a csíkozás. Példák és további magyarázat található lejjebb a gyerek navboxok leírásánál.
felülstílus†
alulstílus†
A felső (felül paraméterrel megadott) és alsó (alul paraméterrel megadott) cellákra vonatkozó CSS stílusok. Általában háttérszín vagy igazítás megváltoztatására:
felülstílus = background:#nnnnnn;
felülstílus = text-align:[left/center/right];
képstílus†
balképstílus†
CSS stílusok azokra a cellákra, ahol a bal és jobb oldali képek csücsülnek. Csak indokolt esetben használandó, általában szélességi gondok megoldására; ha a csoportszélesség meg van adva, és a képcella szélessége túl nagyra nő. Példa:
Az itt látható beállítások a leggyakrabban használt és módosított értékek. A többi bonyolultabb stílusbeállítást kihagytuk, hogy egyszerű maradjon a lista. A legtöbb dolog a Common.css-ben van definiálva.
Mivel a listastílus és a páratlanstílus is átlátszó hátterű, a páratlan számú listák háttere a bodystílus-ban megadott értékű lesz, ami alapesetben #fdfdfd (halványszürke). A lista ha van csoportja balra igazított (text-align:left;), ha nincs középre (text-align:center;). Mivel csak a bodystílus-nak van vertical-align paramétere, az összes többi örökli a vertical-align:middle; beállítását.
Csoportfejléc-cellát helyez a címsorba, ugyanazokkal az alapértelmezett stílusokkal mint a csoportszám. Csak kivételes körülmények közt szabad használni (általában haladó meta-sablonoknál). Valamennyire ismerni kell hozzá a {{navbox}}(?) belső működését; mert ha használni szeretnéd, kézzel kell beállítani a CSS stílusokat, hogy megfelelően működjön. Ha nem vagy biztos magadban, érdeklődj a vitalapon.
címcsoportstílus
A címcsoport cella stílusai.
belsőstílus
Nagyon haladóknak szánt paraméter csak bonyolult metasablonok készítéséhez. Belsőleg a navbox egy külső táblázatot használ a keret rajzolásához, és egy belsőt minden másra (cím/felül/csoportok/listák/alul/képek stb.). A stílus/bodystílus paraméterek a külső táblára vonatkoznak, aminek értékeit a belső örökli; de bizonyos esetekben (metasablonok) szükséges lehet a belső táblázat kézzel való beállítása. Ezzel a paraméterrel elérhető a belső táblázat, így stílusokat tudunk definiálni. Csak saját felelősségre használható.
{{Navbox}} sablonnal készített táblázat, kép, balkép, listahasználatával, továbbá a csoportok, felül és alul paraméterek nélkül (a listák szürke hátterei a bemutatáshoz lettek hozzáadva):
Lehetséges több navboxot közös keretbe foglalni a keret paraméter segítségével, vagy ha az első névtelen paraméter „gyerek”. Az alapvető kód ehhez így néz ki (ami egy alcsoportot ad az első listához):
Az alábbi példán látható hogy lehet használni az alcsoportokat. Ajánlott a {{Navbox alcsoport}}(?) használata, de ugyanazt az eredményt érjük el a {{Navbox}}keret = gyerek paraméterével, vagy ha az első névtelen paraméter gyerek. A párospáratlan paraméter segítségével inverzbe vált a csíkozás néhány alcsoportban, hogy végig konzisztens maradjon a kinézet. Ha teljesen el szeretnéd távolítani a csíkozást, használd a listastílus = background:transparent; kódot minden navboxban.
Az alábbi példában navbox a fő konténer, a lista1 … lista5 paraméterei pedig beágyazott navboxok, melyek első névtelen paramétere gyerek. Az összes alárendelt navboxnak saját „m • v • sz” linkjei vannak, ezeket elrejthetjük a gyerek navboxokban a navbar = plain kóddal, vagy a név paraméter elhagyásával (az alárendelt navboxokban nem kötelező a név, ellentétben a rendes navboxokkal).
Ezt a navbox sablont úgy terveztük, hogy együttműködjön a két testvérpárjával: {{Navbox oszlop}}(?) és {{Navbox alcsoport}}(?). Mindhárom sablon nagyrészt közös paraméterekkel rendelkezik az egyszerűbb használat miatt (a teljes paraméterlistában kereszttel† jelölve). De a legfontosabb, hogy mindhárom használható bármelyik másik gyerekeként (a keret=gyerek paraméterrel, vagy ha az első névtelen paraméter gyerek.
Ez a sablon legnagyobbrészt CSS osztályokat használ, így teljesen testre szabható.
Eme meta-sablon belül HTML-kódokat használ wikikód helyett a táblázatokhoz. Ez a szokásos módszer a metasablonok készítésénél, mivel a wikikódnak számos hátránya van ilyen esetben. Például úgy nehezebb lenne használni az elemző függvényeket (parser functions), és a speciális karaktereket a paraméterekben.
A csoportok és listák közti 2px széles keretet a lista-cella border-left tulajdonsága szabályozza. Így ha meg szeretnéd változtatni a sablon háttérszínét (például bodystílus = background:purple;), akkor figyelned kell hogy a border-left-color azonos legyen a háttérszínnel (azaz listastílus = border-left-color:purple;). Ha minden listacella körül keretet szeretnél, akkor a 2px-es keret a lista és csoport cellák közt eltűnik, ekkor ki kell találnod valami megoldást magadnak.
A listacella szélessége alapesetben 100%. Így ha kézzel szeretnéd a csoportcellák szélességét állítani, a listastílusnál is meg kell adnod, hogy width:auto. Ha meg akarod adni a csoportszélességet és képet is szeretnél használni, magadnak kell kijátszani a CSS paramétereket a csoport-, lista-, kép- és balképstílusokban, hogy minden megfelelően működjön. Példa a csoportszélesség megadására:
csoportstílus = width:10em;
listastílus = width:auto;
Egymás alatti navboxok között csak egy pixel keret van (kivéve IE6-ban, ami nem támogatja a szükséges CSS-t). Ha beállítod a stílus/bodystílus felső vagy alsó margóját, akkor ez nem fog működni.
Az alapértelmezett margin-left és margin-right a külső navbox táblánál „auto;”-ra van állítva. Ha a navboxot lebegve szeretnéd használni, kézzel kell a megfelelő margin-left és margin-right értékeket beállítani, mert az auto margó összeakad a lebegés opcióval. Például használd a következő kódot a floathoz:
stílus = width:22em;float:right;margin-left:1em;margin-right:0em;
