Перайсьці да зьместу

Шаблён:Навігацыйная табліца/Дакумэнтацыя

Зьвесткі зь Вікіпэдыі — вольнай энцыкляпэдыі

Функцыянальная й гнуткая ўнівэрсальная навігацыйная табліца

Выдатна пасуе для тэрытарыяльна-адміністрацыйнага падзелу або любой іншай навігацыі.

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

[рэдагаваць крыніцу]
{{Навігацыйная табліца
| назва_шаблёну      = {{Падстаноўка:НАЗВА_СТАРОНКІ}}
| 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.
|група_інфармацыі5_стыль = background: red; color: white;
шырыня_групы
Задае агульную для ўсіх ячэек група_інфармацыі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.

стыль_карткі = background: #fdfdfd; width: 100%; vertical-align: middle;
стыль_загалоўка = background: #ccccff; padding-left: 1em; padding-right: 1em; text-align: center;
стыль_верх = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: center;
стыль_ніз = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: center;
стыль_групаў = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: right;
стыль_сьпісаў = background: transparent; text-align: left/center;
стыль_няцотных_сьпісаў = background: transparent;
стыль_цотных_сьпісаў = background: #f7f7f7;

Паколькі стыль_сьпісаў і стыль_няцотных_сьпісаў маюць празрыстае тло (transparent), яны фактычна спадкуюць тло ад стыль_карткі (дапомна #fdfdfd — белы з налётам шэрасьці). Калі сьпіс мае адпаведную групу, ён будзе раўнавацца па левым баку, інакш — па цэнтру. Толькі стыль_карткі вызначае vertical-align, таму ўсе ўкладзеныя элемэнты спадкуюць гэтую уласьцівасьць: vertical-align: middle.

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

[рэдагаваць крыніцу]
кляса_карткі
кляса_верху
кляса_групаў
кляса_сьпісаў
кляса_ніз
Дзякуючы гэтым парамэтрам да адпаведных элемэнтаў можна далучыць дадатковыя CSS-клясы.
група_назва
Стварае ячэйку групы ў загалоўку. Выкарыстаньне гэтай функцыі вельмі цяжкае, паколькі вымагае ня толькі веданьня HTML/CSS, але і лёгікі гэтага шаблёну.
стыль_групы_назвы
CSS-стылі для ячэйкі група_назва
стыль_цела
CSS-стылі, якія ўжываюцца да навігацыйнай табліцы, калі яна пазбаўленая вонкавай абалонкі (напрыклад, калі |рамка = няма). Выкарыстоўваць зь перасьцярогай.

Схема табліцы

[рэдагаваць крыніцу]

{{Навігацыйная табліца}} без выявы, верху і нізу (шэры колер даданы толькі для лепшай ілюстрацыйнасьці):

{{Навігацыйная табліца}} з выкарыстаньнем выявы, верху і нізу (шэры колер даданы толькі для лепшай ілюстрацыйнасьці):

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

{{Навігацыйная табліца
|назва_шаблёну = Навігацыйная табліца/Дакумэнтацыя
|назва = [[Піла (сэрыя фільмаў)|Сэрыя фільмаў «Піла»]]
|група_інфармацыі1 = Фільмы
|сьпіс1 = 
* ''[[Піла (фільм, 2003)|Піла]]'' (кароткі)
* ''[[Піла (фільм)|Піла]]''
* ''[[Піла ІІ]]''
* ''[[Піла ІІІ]]''
* ''[[Піла IV]]''
* ''[[Піла V]]''
* ''[[Піла VI]]''
* ''[[Піла VII]]''
|група_інфармацыі2      = Пэрсанажы
|сьпіс2                 = 
* [[Піла (пэрсанаж)|Піла]]
* [[Аманда Янг]]
* [[Сям’я Горданаў]]
* [[Адам Фолкнэр]]
* [[Элісан Кэры]]
* [[Эрык Мэцьюз]]
* [[Сям’я Райнхарт]]
* [[Рыг]]
|група_інфармацыі3      = Саўндтрэкі
|сьпіс3                 = 
* ''[[Піла (саўндтрэк)|Піла]]''
* ''[[Піла II (саўндтрэк)|Піла II]]''
* ''[[Піла III (саўндтрэк)|Піла III]]''
* ''[[Піла IV (саўндтрэк)|Піла IV]]''
}}

З выявай, бяз групаў

[рэдагаваць крыніцу]
{{Навігацыйная табліца
|назва_шаблёну = Менск
|назва = Славутасьці [[Менск]]у
|выява  = [[Файл:Coat of arms of Minsk.svg|справа|55пкс|Герб Менску]]
|сьпіс1 = 
* [[Сьпіс помнікаў Менску|Помнікі]]
* [[Музэі Менску|Музэі]]
* [[Сьпіс культавых будынкаў Менску|Храмы]]
* [[Тэатры Менску|Тэатры]]
* [[Фантаны Менску|Фантаны]]
* [[Сьвіслач (басэйн Дняпра)|Сьвіслач]]
* [[Менскі заапарк|Заапарк]]
* [[Высокі Рынак|Высокі Рынак (Верхні Горад)]]
* [[Менская ратуша|Ратуша]]
* [[Траецкае прадмесьце]]
* [[Музэй Вялікай Айчыннай вайны (Менск)|Музэй ВАВ]]
* [[Нацыянальная бібліятэка Беларусі|Бібліятэка]]
* [[Менскі чыгуначны вакзал|Вакзал]]
* [[Менскі мэтрапалітэн|Мэтро]]
* [[Мінск-1 (аэрапорт)|Аэрапорт]]
* [[Менская дзіцячая чыгунка імя К. С. Заслонава|Дзіцячая чыгунка]]
* [[Дынама Менск (футбольны клюб)|ФК «Дынама»]]
* [[Дынама Менск (хакейны клюб)|ХК «Дынама»]]
* [[Дынама (стадыён, Менск)|Стадыён «Дынама»]]
* [[Курапаты|Курапаты]]
* [[Вядомыя асобы Менску|Вядомыя менчукі]]
}}

Дзьве выявы, некалькі сьпісаў, бяз групаў

[рэдагаваць крыніцу]
{{Навігацыйная табліца
|назва_шаблёну  = Навігацыйная табліца/Дакумэнтацыя
|назва = Загаловак
|выява = [[Файл:Emblem of the Papacy SE.svg|50px|link=|alt=]]
|выява_зьлева = [[Файл:Emblem of the Papacy SE.svg|50px]]

|сьпіс1 =
* Адзін
* Два
* Тры
* Чатыры
|сьпіс2 =
* Адзін
* Два
* Тры
|сьпіс3 =
* Адзін
* Два
|сьпіс4 =
* Адзін
}}

Выява, групы, верх і ніз

[рэдагаваць крыніцу]
{{Навігацыйная табліца
|назва_шаблёну = Навігацыйная табліца/Дакумэнтацыя
|назва = Загаловак табліцы
|выява = [[Файл:Emblem of the Papacy SE.svg|50px|link=|alt=]]
|верх = Lorem ipsum dolor set amet.
|група_інфармацыі1 = Lorem
|сьпіс1 =
* Ipsum
* Dolor
* Set
* Amet
|група_інфармацыі2 = Ipsum
|сьпіс2 = 
* Dolor
* Set
* Amet
|група_інфармацыі3 = Dolor
|сьпіс3 = 
* Set
* Amet
|група_інфармацыі4 = Set
|сьпіс4 = 
* Amet
|ніз = Amet
}}

Глядзіце таксама

[рэдагаваць крыніцу]