Apseимерелү
Проект буенча эчтәлекнең күренүен берничә класс һәм безнең JavaScript плагиннары белән алыштырыгыз.
Ничек бу эшли
JavaScript плагины җимерелү эчтәлекне күрсәтү һәм яшерү өчен кулланыла. Кнопка яки анкор триггер буларак кулланыла, сез алыштырган конкрет элементларга күчерелгән. Элементны җимерү height
хәзерге кыйммәтеннән җанландырачак 0
. CSS анимацияләрне ничек эшләвен исәпкә алып, сез элементта куллана padding
алмыйсыз . .collapse
Киресенчә, классны мөстәкыйль төрү элементы итеп кулланыгыз.
prefers-reduced-motion
медиа соравына бәйле. Безнең документларның кыскартылган хәрәкәт бүлеген карагыз
.
Мисал
Класс үзгәртүләре аша бүтән элементны күрсәтү һәм яшерү өчен астагы төймәләргә басыгыз:
.collapse
эчтәлекне яшерә.collapsing
күчү вакытында кулланыла.collapse.show
эчтәлек күрсәтә
Гадәттә, без data-bs-target
атрибутлы төймә кулланырга киңәш итәбез. Семантик күзлектән тәкъдим ителмәсә дә, сез href
атрибут (һәм а role="button"
) белән сылтама куллана аласыз. Ике очракта data-bs-toggle="collapse"
да таләп ителә.
<p>
<a class="btn btn-primary" data-bs-toggle="collapse" href="#collapseExample" role="button" aria-expanded="false" aria-controls="collapseExample">
Link with href
</a>
<button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
Button with data-bs-target
</button>
</p>
<div class="collapse" id="collapseExample">
<div class="card card-body">
Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
Берничә максат
А <button>
яки <a>
берничә элементны үз href
яисә data-bs-target
атрибутында селектор белән күрсәтеп күрсәтә һәм яшерә ала. Берничә <button>
яки <a>
элементны күрсәтә һәм яшерә ала, әгәр алар һәрберсе үз атрибутикасы белән href
мөрәҗәгать data-bs-target
итсәләр
<p>
<a class="btn btn-primary" data-bs-toggle="collapse" href="#multiCollapseExample1" role="button" aria-expanded="false" aria-controls="multiCollapseExample1">Toggle first element</a>
<button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target="#multiCollapseExample2" aria-expanded="false" aria-controls="multiCollapseExample2">Toggle second element</button>
<button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target=".multi-collapse" aria-expanded="false" aria-controls="multiCollapseExample1 multiCollapseExample2">Toggle both elements</button>
</p>
<div class="row">
<div class="col">
<div class="collapse multi-collapse" id="multiCollapseExample1">
<div class="card card-body">
Some placeholder content for the first collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
</div>
<div class="col">
<div class="collapse multi-collapse" id="multiCollapseExample2">
<div class="card card-body">
Some placeholder content for the second collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
</div>
</div>
Уңайлык
aria-expanded
Контроль элементка өстәргә онытмагыз . Бу атрибут контроль белән бәйләнгән җимерелә торган элементның хәзерге торышын ачык күрсәтә, укучыларга һәм охшаш ярдәмче технологияләргә. Әгәр җимерелә торган элемент килешү буенча ябылса, контроль элементтагы атрибутның кыйммәте булырга тиеш aria-expanded="false"
. Әгәр дә син җимерелә торган элементны show
класс ярдәмендә килешү буенча ачык итеп куйсаң, aria-expanded="true"
аның урынына контрольгә куй. Плагин бу атрибутны автоматик рәвештә контрольдә алыштырачак, җимерелә торган элемент ачылган яки ябылган (JavaScript аша, яисә кулланучы шул ук җимерелә торган элементка бәйләнгән бүтән контроль элементны этәргәнгә). Әгәр контроль элементның HTML элементы төймә булмаса (мәсәлән, ан <a>
яки <div>
), атрибутrole="button"
элементка кушылырга тиеш.
Әгәр сезнең контроль элемент бер җимерелә торган элементны максат итә икән - ягъни data-bs-target
атрибут id
селекторга күрсәтә - сез атылучы элементны үз aria-controls
эченә алган контроль элементына өстәргә тиеш id
. Заманча экран укучылары һәм охшаш ярдәмче технологияләр бу атрибутны кулланучыларга җимерелә торган элементның үзенә юнәлтү өчен өстәмә кыска юллар белән тәэмин итү өчен кулланалар.
Игътибар итегез, Bootstrap-ның хәзерге гамәлгә ашыруы WAI-ARIA Авторлык Практикалары 1.1 аккордеон үрнәгендә тасвирланган төрле факультатив клавиатура үзара бәйләнешне үз эченә алмый - сезгә аларны JavaScript белән кертергә кирәк булачак.
Сасс
Variзгәрешләр
$transition-collapse: height .35s ease;
Дәресләр
Collимерелү күчү классларын табарга мөмкин, scss/_transitions.scss
чөнки алар берничә компонент буенча бүлешәләр (җимерелү һәм аккордеон).
.collapse {
&:not(.show) {
display: none;
}
}
.collapsing {
height: 0;
overflow: hidden;
@include transition($transition-collapse);
}
Куллану
Apseимерелү плагины авыр күтәрү өчен берничә класс куллана:
.collapse
эчтәлекне яшерә.collapse.show
эчтәлеген күрсәтә.collapsing
күчү башлангач өстәлә, беткәч бетерелә
Бу классларны табып була _transitions.scss
.
Мәгълүмат атрибутлары аша
Бер яки берничә җимерелә торган элементларга контрольне автоматик рәвештә билгеләү data-bs-toggle="collapse"
өчен data-bs-target
элементка өстәгез. data-bs-target
Атрибут җимерелүне куллану өчен CSS селекторын кабул итә . Классны collapse
җимерелә торган элементка өстәргә онытмагыз. Килешү ачык булса, өстәмә класс өстәгез show
.
Accимерелә торган мәйданга аккордеонга охшаган төркем белән идарә итү өчен, мәгълүмат атрибутын өстәгез data-bs-parent="#selector"
. Моны эштә күрү өчен демога мөрәҗәгать итегез.
JavaScript аша
Кул белән эшләгез:
var collapseElementList = [].slice.call(document.querySelectorAll('.collapse'))
var collapseList = collapseElementList.map(function (collapseEl) {
return new bootstrap.Collapse(collapseEl)
})
Вариантлар
Вариантларны мәгълүмат атрибутлары яки JavaScript аша бирергә мөмкин. Мәгълүмат атрибутлары өчен вариант исемен data-bs-
өстәгез data-bs-parent=""
.
Исем | Тип | Килешү | Тасвирлау |
---|---|---|---|
parent |
селектор | jQuery объект | DOM элементы | false |
Әгәр дә ата-ана тәэмин ителсә, күрсәтелгән ата-ана астында барлык җимерелә торган элементлар бу җимерелә торган әйбер күрсәтелгәндә ябылачак. (традицион аккордеон тәртибенә охшаган - бу card класска бәйле). Атрибут максатчан җимерелә торган мәйданда куелырга тиеш. |
toggle |
буле | true |
Чакырыла торган элементны алыштыра |
Методлар
Асинхрон ысуллар һәм күчү
Барлык API ысуллары да асинхрон һәм күчү башлый . Күчерелеш башлангач, ләкин ул беткәнче шалтыратучыга кире кайталар . Моннан тыш, күчү компонентына методик чакыру игътибарсыз калачак .
Күбрәк мәгълүмат алу өчен безнең JavaScript документларын карагыз .
Эчтәлекне җимерелә торган элемент буларак активлаштыра. Өстәмә вариантларны кабул итә object
.
Сез конструктор белән җимерелү инстанциясен булдыра аласыз, мәсәлән:
var myCollapse = document.getElementById('myCollapse')
var bsCollapse = new bootstrap.Collapse(myCollapse, {
toggle: false
})
Метод | Тасвирлау |
---|---|
toggle |
Collимерелә торган элементны күрсәтә яки яшерә. Apsимерелә торган элемент чынбарлыкта күрсәтелгән яки яшерелгәнче (ягъни вакыйга булганчы) шалтыратучыга кире кайта.shown.bs.collapse hidden.bs.collapse |
show |
Apsимерелә торган элементны күрсәтә. Apsимерелә торган элемент чынбарлыкта күрсәтелгәнче (мәсәлән, shown.bs.collapse вакыйга булганчы) шалтыратучыга кире кайта. |
hide |
Apsимерелә торган элементны яшерә. Apsимерелә торган элемент яшерелгәнче (мәсәлән, hidden.bs.collapse вакыйга булганчы) шалтыратучыга кире кайта. |
dispose |
Элементның җимерелүен юк итә. (DOM элементында сакланган мәгълүматны бетерә) |
getInstance |
DOM элементына бәйләнгән таркалу инстанциясен алырга мөмкинлек биргән статик ысул, сез аны болай куллана аласыз:bootstrap.Collapse.getInstance(element) |
getOrCreateInstance |
DOM элементына бәйләнгән җимерелү инстанциясен кире кайтара торган статик ысул, яисә ул башланмаган очракта яңасын булдыра. Сез аны болай куллана аласыз:bootstrap.Collapse.getOrCreateInstance(element) |
Вакыйгалар
Bootstrap-ның җимерелү классы җимерелү функциясенә кушылу өчен берничә вакыйганы фаш итә.
Вакыйга төре | Тасвирлау |
---|---|
show.bs.collapse |
show Бу вакыйга инстанция ысулы чакырылганда шунда ук янып тора . |
shown.bs.collapse |
Бу вакыйга кулланучыга җимерелгән элемент күренгәндә эшләнә (CSS күчү тәмамлануын көтәр). |
hide.bs.collapse |
Бу вакыйга hide метод чакырылганнан соң ук җибәрелә. |
hidden.bs.collapse |
Бу вакыйга кулланучының таркалу элементы яшерелгәндә эшләнә (CSS күчү тәмамлануын көтәр). |
var myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', function () {
// do something...
})