Гэты шаблён выкарыстоўвае некаторыя надзвычай складаныя і эзатэрычныя ўласьцівасьці мовы азначэньня шаблёнаў.
Калі ласка, не спрабуйце зьмяняць яго датуль, пакуль
Вы да канца не зразумееце, як ён уладкованы;
Вы ня будзеце гатовыя да ўхіленьня любых наступстваў у выпадку нечаканага выніку. Экспэрымэнты варта праводзіць у пясочніцы для шаблёнаў або ў вашай асабістай прасторы.
Функцыянальная й гнуткая ўнівэрсальная навігацыйная табліца
Выдатна пасуе для тэрытарыяльна-адміністрацыйнага падзелу або любой іншай навігацыі.
Код для капіяваньня
Зьвярніце ўвагу:
Не выдаляйце парамэтар state, ён патрэбны для працы шаблёну {{Інфармацыя пра навігацыйную табліцу}}. Калі трэба запоўніць парамэтар, пішыце значэньне такім чынам: | state = {{{state|<значэньне>}}}.
Калі вы не карыстаецеся якім-небудзь іншым парамэтрам, прыбярыце яго з выкліку шаблёну.
{{Навігацыйная табліца| назва_шаблёну ={{Падстаноўка:НАЗВА_СТАРОНКІ}}| state ={{{state|}}}<!-- Не выдаляйце гэты парамэтар. -->| назва =| верх =| выява =| група_інфармацыі1 =| сьпіс1 =| група_інфармацыі2 =| сьпіс2 =| група_інфармацыі3 =| сьпіс3 =<!-- … -->| група_інфармацыі20 =| сьпіс20 =| ніз =}}<noinclude>{{Інфармацыя пра навігацыйную табліцу}}</noinclude>
Сьпіс парамэтраў
Налады шаблёну
назва_шаблёну
Назва шаблёну, на які будуць спасылацца {{спасылкі шаблёну}} (п · а · р — праглядзець · абмеркаваць · рэдагаваць). Каб уласнаруч ня ўводзіць назву шаблёну, можна скарыстацца падстаноўкай: Навігацыйная табліца/Дакумэнтацыя. Парамэтар абавязковы для запаўненьня, толькі калі вызначаны парамэтар назва, а рамка ня вызначаны.
рамка, {{{1}}} [падгрупа / нашчадак, няма]
Вызначае наяўнасьць у табліцы вонкавай рамкі. Вызначаць можна паводле назвы парамэтры, а таксама як першы безназоўны парамэтар (накшталт {{Навігацыйная табліца|нашчадак↵| ... }}). Значэньне нашчадак (падгрупа зьяўляецца сынонімам) прыбірае рамку для зграбнага адлюстраваньня ўнутры іншай навігацыйнай табліцы. Значэньне няма можна выкарыстоўваць для таго, каб зьмясьціць навігацыйную табліцу ў кантэйнэр іншага тыпу (ня варта зьмяшчаць НТ з гэтым значэньнем унутры іншай навігацыйнай табліцы!).
спасылкі [схаваць, выключыць]
Парамэтар кантралюе выгляд спасылак шаблёну (гл. {{спасылкі шаблёну}}). Значэньне схаваць хавае спасылкі, але пакідае заглушку, каб захаваць цэнтраваньне загалоўка. выключыць выдаляе спасылкі, а загаловак ссоўваецца ў левы бок. Ня варта хаваць спасылкі шаблёну без належнай патрэбы!
state [autocollapse, uncollapsed, collapsed, plain, off]
Кантралюе магчымасьці згортваньня навігацыйнай табліцы.
Дапомна выкарыстоўваецца значэньне autocollapse. Паводле гэтага значэньня кожны падобны шаблён будзе згорнуты аўтаматычна, калі на старонцы больш як 2 НТ з магчымасьцю згортваньня. Інакш табліца будзе разгорнутая. Падрабязныя тэхнічныя зьвесткі даступныя ў MediaWiki:Common.js.
collapsed прымушае табліцу ўвесь час знаходзіцца ў згорнутым стане. Каб яе разгарнуць, трэба націснуць кнопку паказаць на табліцы.
plain прыбірае з табліцы магчымасьць згортваньня і выдаляе адпаведную кнопку, пры гэтым на месцы кнопкі будзе месьціцца заглушка, каб захаваць цэнтраваньне загалоўка.
off выключае магчымасьць згортваньня і выдаляе кнопку. На месцы кнопкі заглушка не ствараецца, таму загаловак ссунецца ў правы бок. Не рэкамэндуецца выкарыстоўваць безь вялікай патрэбы.
Любое іншае значэньне, адрознае ад autocollapse, collapsed, plain і off (як то uncollapsed) прымушае табліцу ўвесь час знаходзіцца ў разгорнутым выглядзе, колькі б згортваемых табліц ня месьцілася на старонцы.
звычайныя_сьпісы
Дапомна навігацыйная табліца мае клясу hlist, дзякуючы якой звычайныя сьпісы, аформленыя паводле правілаў вікі-сынтаксісу, адлюстроўваюцца як гарызантальныя сьпісы (з падтрымкай укладзеных элемэнтаў). Калі існуе неадкладная патрэба выключыць гэтую клясу, вызначце любым чынам парамэтар. Гарызантальныя сьпісы зьяўляюцца болей аптымальным спосабам стварэньня навігацыйных сьпісаў у табліцах, бо здымаюць нагрузку з парсэра (дзясяткі шаблёнаў {{*}}), і перакладаюць яе на браўзэр карыстальніка, які сфарматуе сьпісы імгненна.
Ячэйкі са зьвесткамі
назва
Загаловак табліцы, адлюстроўваецца ўверсе на ўсю шырыню. У левай частцы радка назвы адлюстроўваюцца спасылкі на шаблён, яго старонку гутарак і на старонку рэдагаваньня. Праваруч — кнопка схаваць/паказаць якая згортвае/разгортвае табліцу.
верх
Поле акурат пад загалоўкам, на ўсю шырыню.
выява, выява_зьлева
Выявы, якія адлюстроўваюцца праваруч і леваруч на ўсю вышыню табліцы (за выняткам загалоўка). Каб выява_зьлева карэктна адлюстроўвалася, мусіць быць вызначаны парамэтар сьпіс1, а групы інфармацыі не павінны выкарыстоўвацца ўвогуле.
група_інфармацыіn, n = 1 .. 20
(група_інфармацыі1, група_інфармацыі2 .. група_інфармацыі20) «Загаловак» радка са зьвесткамі, адлюстроўваецца зьлева.
сьпісn, n = 1 .. 20
(сьпіс1, сьпіс2 .. сьпіс20)Асноўнае поле для зьвестак. Калі група інфармацыі з адпаведным нумарам не пазначаная, поле займае ўсю шырыню, а зьмест выцэнтроўваецца.
ніз
Аналяг верх, але адлюстроўваецца ў самым нізе.
Вызначэньні стылю
стыль
CSS, які ўжываецца да галоўнай табліцы. Існуе таксама стыль_карткі, які робіць тое самае (але не зьяўляецца сынонімам: спачатку ўжываецца стыль_карткі, а потым стыль). Ня варта захапляцца ўжываньнем гэтага парамэтру, каб ня ўносіць вялікі разлад у аднастайнасьць навігацыйных табліцаў.
базавы_стыль
CSS-стылі, якія ўжываюцца да ячэек назва, верх, група_інфармацыіn і ніз. Не ўжываецца ён толькі да ячэек сьпісn. Парамэтар карысны, што дазваляе вызначыць асноўны колер тла табліцы без паўтарэньня ў некалькіх парамэтрах. Напрыклад:
|базавы_стыль = {{Колер|Беларусь}}
стыль_загалоўка
CSS-стылі, якія ўжываюцца да ячэйкі назва. Найчасьцей выкарыстоўваецца для вызначэньня колеру тла:
|стыль_загалоўка = background: #hhhhhh;
стыль_групаў
CSS-стылі, якія ўжываюцца да ячэек група_інфармацыіn.
група_інфармацыіn_стыль
CSS-стылі, якія ўжываюцца да асобнай ячэйкі група_інфармацыіn.
Задае агульную для ўсіх ячэек група_інфармацыіn шырыню:
|шырыня_групы = 9em
стыль_сьпісаў
CSS-стылі, якія ўжываюцца да ўсіх ячэек сьпісn.
сьпісn_стыль
CSS-стылі, якія ўжываюцца да асобнай ячэйкі сьпісn.
водступы_сьпісаў
Вызначае водступы ўсіх ячэек сьпісаў. Перадвызначаныя водступы: 0.25em зьлева і справа, 0 зьверху і зьнізу. З-за асаблівасьцяў рэалізацыі шаблёну padding: xxyy, дададзены ў стыль_сьпісаў, не дае рады. Прыклад:
|водступы_сьпісаў = 0.5em 0;
стыль_цотных_сьпісаў
стыль_няцотных_сьпісаў
CSS-стылі, якія ўжываюцца да цотных і няцотных сьпісаў адпаведна. Дапомна ў табліцы цотныя і няцотныя радкі крыху адрозьніваюцца колерам тла, каб адасобіць адзін радок ад другога.
цотнасьць [памяняць, even, odd, off]
Значэньне памяняць дазваляе «памяняць месцамі» цотныя і няцотныя радкі (маецца наўвазе толькі колер тла). Калі вызначыць парамэтар як even ці odd, усе сьпісы будуць выяўленыя з колерам тла цотных ці няцотных сьпісаў адпаведна. off выключае падтрымку цотнасьці/няцотнасьці (варта выкарыстоўваць у выпадках, калі адна НТ укладзеная ў другую, і ў выніку парадак цотнасьці ў іх не супадае).
стыль_верх
стыль_ніз
CSS-стылі, якія ўжываюцца да ячэйкі верх і ніз адпаведна.
стыль_выявы
стыль_выява_зьлева
CSS-стылі, якія ўжываюцца да ячэйкі выява і выява_зьлева адпаведна.
Перадвызначаныя стылі
Ніжэй пададзеныя зьвесткі пра стылі, якія выкарыстоўваюцца ў навігацыйнай табліцы дапомна. Большасьць зь іх вызначаная на ўзроўні ўсяго сайту ў MediaWiki:Common.css.
Паколькі стыль_сьпісаў і стыль_няцотных_сьпісаў маюць празрыстае тло (transparent), яны фактычна спадкуюць тло ад стыль_карткі (дапомна #fdfdfd — белы з налётам шэрасьці). Калі сьпіс мае адпаведную групу, ён будзе раўнавацца па левым баку, інакш — па цэнтру. Толькі стыль_карткі вызначае vertical-align, таму ўсе ўкладзеныя элемэнты спадкуюць гэтую уласьцівасьць: vertical-align: middle.
Дадатковыя парамэтры
кляса_карткі
кляса_верху
кляса_групаў
кляса_сьпісаў
кляса_ніз
Дзякуючы гэтым парамэтрам да адпаведных элемэнтаў можна далучыць дадатковыя CSS-клясы.
група_назва
Стварае ячэйку групы ў загалоўку. Выкарыстаньне гэтай функцыі вельмі цяжкае, паколькі вымагае ня толькі веданьня HTML/CSS, але і лёгікі гэтага шаблёну.
стыль_групы_назвы
CSS-стылі для ячэйкі група_назва
стыль_цела
CSS-стылі, якія ўжываюцца да навігацыйнай табліцы, калі яна пазбаўленая вонкавай абалонкі (напрыклад, калі |рамка = няма). Выкарыстоўваць зь перасьцярогай.
Схема табліцы
{{Навігацыйная табліца}}безвыявы, верху і нізу (шэры колер даданы толькі для лепшай ілюстрацыйнасьці):
{{Навігацыйная табліца
|назва_шаблёну = Навігацыйная табліца/Дакумэнтацыя
|назва = Загаловак
|выява = [[Файл:Emblem of the Papacy SE.svg|50px|link=|alt=]]
|выява_зьлева = [[Файл:Emblem of the Papacy SE.svg|50px]]
|сьпіс1 =
* Адзін
* Два
* Тры
* Чатыры
|сьпіс2 =
* Адзін
* Два
* Тры
|сьпіс3 =
* Адзін
* Два
|сьпіс4 =
* Адзін
}}