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

Вікіпедыя:Згортвальныя блокі

З Вікіпедыі, свабоднай энцыклапедыі

Згортвальныя блокі — шаблоны, які даюць магчымасць дынамічна «схаваць» свой змест, пакідаючы толькі загаловак. Існуе два віды згортвальных блокаў: div'ы і табліцы.

Выкарыстанне

[правіць зыходнік]

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

Па магчымасці пажадана не выкарыстоўваць код згортвальных div'аў і табліц наўпрост, а карыстацца наяўнымі базавымі шаблонамі. Напрыклад, div'ы выкарыстоўваюцца ў

  • {{hider}}

а згортвальная табліца выкарыстана ў

Для стварэння згортвальнага div да яго дадаецца клас NavFrame, пры гэтым унутраны блок з класам NavHead утворыць заўсёды бачны загаловак, а кожны ўнутраныя блокі з класамі NavContent і NavPic хаваюцца:

<div class="NavFrame">
  <div class="NavHead">
    Загаловак
  </div>
  <div class="NavContent">
     Утрыманне
  </div>
  <div class="NavPic">
     Выява
  </div>
</div>

Як правіла, выкарыстоўваецца адзін NavContent для асноўнага зместу, і ад нуля да двух NavPic для выяў.

Стандартны вонкавы выгляд усіх гэтых класаў задаецца ў MediaWiki:Common.css. Для змены афармлення можна задаць дадатковыя CSS стылі проста ў вікікодзе. У прыватнасці, бо ў NavPic зададзены стыль «плаваць злева», для дадавання другой выявы справа трэба выкарыстаць <div class="NavPic" style="float:right">

Для таго, каб зрабіць кожную табліцу згортвальнай, дастаткова дадаць да яе клас collapsible:

{| class="standard collapsible"
!colspan=2|Загаловак
|-
|Ячэйка 1*1||Ячэйка 2*1||Ячэйка 3*1
|-
|Ячэйка 1*2||Ячэйка 2*2||Ячэйка 3*2
|}

Загаловак
Ячэйка 1*1 Ячэйка 2*1 Ячэйка 3*1
Ячэйка 1*2 Ячэйка 2*2 Ячэйка 3*2

Першы радок (загаловак) звычайна робяць з адной ячэйкі.

Пачатковы стан

[правіць зыходнік]

Пачатковы стан (адразу па загрузцы старонкі) згортвальнага блоку паказваецца з дапамогай аднаго з трох дадатковых класаў:

  • collapsed азначае, што блок будзе згорнуты
  • expanded азначае, што блок будзе разгорнуты
  • autocollapse: усе блокі з гэтым класам будуць згорнутыя, толькі калі агульная колькасць згортвальных блокаў гэтага тыпу (div'ы і табліцы лічацца асобна) на старонцы больш за два.

Калі дадатковых класаў не паказана, то лічыцца, што ў табліцы клас expanded, а ў div'а autocollapsed.

Прыклад:

<div class="NavFrame collapsed">
  <div class="NavHead">Згорнуты</div>
  <div class="NavContent">
     па змаўчанні блок
  </div>
</div>

Персанальныя налады

[правіць зыходнік]

Зарэгістраваныя ўдзельнікі могуць змяняць для сябе некаторыя настаўленні згортвальных div'аў і табліц, змяняючы значэнні наступных параметраў у сваім common.js (паказаныя значэнні па змоўчанні):

NavigationBarShowDefault = 2 //максімальная колькасць згортвальных div на старонцы, 
 //пасля якога ўсё з іх без класа expanded будуць першапачаткова згорнутыя
collapseCaption = 'схаваць' //спасылка-перамыкач на разгорнутым блоку
expandCaption = 'паказаць' //спасылка-перамыкач на згорнутым блоку

Тэхнічныя дэталі

[правіць зыходнік]

Механізм «згортвання» рэалізуецца JavaScript кодам у MediaWiki:Common.js. Гэты код працуе ва ўсіх сучасных браўзерах. Наведвальнікі, які адключылі ў браўзэры падтрымку JavaScript, будуць бачыць гэтыя блокі ў разгорнутым выглядзе без спасылак схаваць/паказаць.

Можна лёгка распазнаць які від блока выкарыстоўваецца: у <div>'аў квадратныя дужкі [] з'яўляюцца часткай спасылкі «паказаць/схаваць», а ў табліц — не.