Шаблён:Навігацыйная табліца са слупкамі

Дакумэнтацыя

Гэты шаблён выкарыстоўвае некаторыя надзвычай складаныя і эзатэрычныя ўласьцівасьці мовы азначэньня шаблёнаў.

Калі ласка, не спрабуйце зьмяняць яго датуль, пакуль

Вы да канца не зразумееце, як ён уладкованы;
Вы ня будзеце гатовыя да ўхіленьня любых наступстваў у выпадку нечаканага выніку. Экспэрымэнты варта праводзіць у пясочніцы для шаблёнаў або ў вашай асабістай прасторы.

Шаблён для вываду зьместу ў выглядзе калёнак.

Код для капіяваньня

Калі вы не карыстаецеся пэўным парамэтрам, прыбярыце яго з выкліку шаблёну.

{{Навігацыйная табліца са слупкамі
| назва_шаблёну          = {{Падстаноўка:НАЗВА_СТАРОНКІ}}
| state                  = {{{state|}}}

| назва                  = 
| верх                   = 
| выява                  = 

| слупок1                = 
| слупок2                = 
| слупок3                = 
<!-- ... -->
| слупок20               = 

| ніз                    = 
}}

Сьпіс парамэтраў

Налады шаблёну

назва_шаблёну

Назва шаблёну, на які будуць спасылацца {{спасылкі шаблёну}} (п · а · р — праглядзець · абмеркаваць · рэдагаваць). Каб уласнаруч ня ўводзіць назву шаблёну, можна скарыстацца падстаноўкай: Навігацыйная табліца/Дакумэнтацыя. Парамэтар абавязковы для запаўненьня, толькі калі вызначаны парамэтар назва, а рамка ня вызначаны.

рамка, {{{1}}} [падгрупа / нашчадак, няма]

Вызначае наяўнасьць у табліцы вонкавай рамкі. Вызначаць можна паводле назвы парамэтры, а таксама як першы безназоўны парамэтар (накшталт {{Навігацыйная табліца|нашчадак↵| ... }}). Значэньне нашчадак (падгрупа зьяўляецца сынонімам) прыбірае рамку для зграбнага адлюстраваньня ўнутры іншай навігацыйнай табліцы. Значэньне няма можна выкарыстоўваць для таго, каб зьмясьціць навігацыйную табліцу ў кантэйнэр іншага тыпу (ня варта зьмяшчаць НТ з гэтым значэньнем унутры іншай навігацыйнай табліцы!).

спасылкі [схаваць, выключыць]

Парамэтар кантралюе выгляд спасылак шаблёну (гл. {{спасылкі шаблёну}}). Значэньне схаваць хавае спасылкі, але пакідае заглушку, каб захаваць цэнтраваньне загалоўка. выключыць выдаляе спасылкі, а загаловак ссоўваецца ў левы бок. Ня варта хаваць спасылкі шаблёну без належнай патрэбы!

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

Кантралюе магчымасьці згортваньня навігацыйнай табліцы.

Дапомна выкарыстоўваецца значэньне autocollapse. Паводле гэтага значэньня кожны падобны шаблён будзе згорнуты аўтаматычна, калі на старонцы больш як 2 НТ з магчымасьцю згортваньня. Інакш табліца будзе разгорнутая. Падрабязныя тэхнічныя зьвесткі даступныя ў MediaWiki:Common.js.
collapsed прымушае табліцу ўвесь час знаходзіцца ў згорнутым стане. Каб яе разгарнуць, трэба націснуць кнопку паказаць на табліцы.
plain прыбірае з табліцы магчымасьць згортваньня і выдаляе адпаведную кнопку, пры гэтым на месцы кнопкі будзе месьціцца заглушка, каб захаваць цэнтраваньне загалоўка.
off выключае магчымасьць згортваньня і выдаляе кнопку. На месцы кнопкі заглушка не ствараецца, таму загаловак ссунецца ў правы бок. Не рэкамэндуецца выкарыстоўваць безь вялікай патрэбы.
Любое іншае значэньне, адрознае ад autocollapse, collapsed, plain і off (як то uncollapsed) прымушае табліцу ўвесь час знаходзіцца ў разгорнутым выглядзе, колькі б згортваемых табліц ні месьцілася на старонцы.

Ячэйкі са зьвесткамі

назва: Загаловак табліцы, адлюстроўваецца ўверсе на ўсю шырыню. У левай частцы радка назвы адлюстроўваюцца спасылкі на шаблён, яго старонку гутарак і на старонку рэдагаваньня. Праваруч — кнопка схаваць/паказаць, якая згортвае/разгортвае табліцу.
верх: Поле акурат пад загалоўкам, на ўсю шырыню.
выява, выява_зьлева: Выявы, якія адлюстроўваюцца праваруч і леваруч на ўсю вышыню табліцы (за выняткам загалоўка). Каб выява_зьлева карэктна адлюстроўвалася, мусіць быць вызначаны парамэтар сьпіс1, а групы інфармацыі не павінны выкарыстоўвацца ўвогуле.
група_інфармацыі_n, n = 1 .. 6: (група_інфармацыі1, група_інфармацыі2 .. група_інфармацыі6) «Загаловак» радка са зьвесткамі, адлюстроўваецца зьлева.
сьпіс_n, n = 1 .. 6: (сьпіс1, сьпіс2 .. сьпіс6) Асноўнае поле для зьвестак. Калі група інфармацыі з адпаведным нумарам не пазначаная, поле займае ўсю шырыню, а зьмест выцэнтроўваецца.
ніз: Аналяг верх, але адлюстроўваецца ў самым нізе.

Вызначэньні стылю

стыль

CSS, які ўжываецца да галоўнай табліцы. Існуе таксама стыль_карткі, які робіць тое самае (але не зьяўляецца сынонімам: спачатку ўжываецца стыль_карткі, а потым стыль). Ня варта захапляцца ўжываньнем гэтага парамэтра, каб ня ўносіць вялікі разлад у аднастайнасьць навігацыйных табліцаў.

базавы_стыль

CSS-стылі, якія ўжываюцца да ячэек назва, верх, група_інфармацыі_n і ніз. Не ўжываецца ён толькі да ячэек сьпіс_n. Парамэтар карысны, што дазваляе вызначыць асноўны колер тла табліцы без паўтарэньня ў некалькіх парамэтрах. Напрыклад:

|базавы_стыль = {{Колер|Беларусь}}

стыль_загалоўка

CSS-стылі, якія ўжываюцца да ячэйкі назва. Найчасьцей выкарыстоўваецца для вызначэньня колеру тла:

|стыль_загалоўка = background: #hhhhhh;

стыль_групаў

CSS-стылі, якія ўжываюцца да ячэек група_інфармацыі_n.

стыль_групы_n

CSS-стылі, якія ўжываюцца да асобнай ячэйкі група_інфармацыі_n.

|стыль_групы5 = background: red; color: white;

стыль_сьпісаў: CSS-стылі, якія ўжываюцца да ўсіх ячэек сьпіс_n.
стыль_сьпісу_n: CSS-стылі, якія ўжываюцца да асобнай ячэйкі сьпіс_n.
стыль_цотных_сьпісаў
стыль_няцотных_сьпісаў: CSS-стылі, якія ўжываюцца да цотных і няцотных сьпісаў адпаведна. Дапомна ў табліцы цотныя і няцотныя радкі крыху адрозьніваюцца колерам тла, каб адасобіць адзін радок ад другога.
цотнасьць [памяняць, even, odd, off]: Значэньне памяняць дазваляе «памяняць месцамі» цотныя і няцотныя радкі (маецца на ўвазе толькі колер тла). Калі вызначыць парамэтар як even ці odd, усе сьпісы будуць выяўленыя з колерам тла цотных ці няцотных сьпісаў адпаведна. off выключае падтрымку цотнасьці/няцотнасьці (варта выкарыстоўваць у выпадках, калі адна НТ укладзеная ў другую, і ў выніку парадак цотнасьці ў іх не супадае).
стыль_верх
стыль_ніз: CSS-стылі, якія ўжываюцца да ячэйкі верх і ніз адпаведна.
стыль_выявы
стыль_выявы_зьлева: CSS-стылі, якія ўжываюцца да ячэйкі выява і выява_зьлева адпаведна.

Парамэтры слупкоў

шырыня_слупкоў

шырыня, пажадана ў прапарцыйных адзінках кшталту 'em' альбо ў адсотках. Выкарыстоўваецца для ўсіх калёнак, для якіх не зададзеная індывідуальная шырыня. Дапомна — 10em. Прыклады:

шырыня_слупкоў = 15em

шырыня_слупкоў = 25%

поўны_памер

любое значэньне гэтага парамэтру задае сумарную шырыню ўсіх слупкоў роўнай 100%. Гэты парамэтар лепей не выкарыстоўваць ад граху падалей. Прыклад:

поўны_памер = ага

водступ: Водступ перад першым слупком, пажадана ў прапарцыйных адзінках. Дапомна — 5em. Каб адключыць водступ, трэба задаць парамэтру значэньне 0 (альбо 0em, альбо 0%).

Дадатковыя парамэтры

кляса_карткі
кляса_верху
кляса_групаў
кляса_сьпісаў
кляса_нізу: Дзякуючы гэтым парамэтрам да адпаведных элемэнтаў можна далучыць дадатковыя CSS-клясы.