Поповерлар
Bootstrap поповерларын өстәү өчен документлар һәм мисаллар, iOS'дагы кебек, сезнең сайттагы теләсә нинди элементка.
Поповер плагинын кулланганда белергә кирәк нәрсәләр:
- Поповерлар урнашу өчен Popper.js өченче як китапханәсенә таяналар . Bootstrap.js алдыннан popper.min.js кертергә яки поповерлар эшләсен өчен Popper.js булган
bootstrap.bundle.min.js
/ кулланырга тиеш!bootstrap.bundle.js
- Поповерлар бәйләнеш буларак кораллар плагинын таләп итәләр.
- Әгәр дә сез безнең JavaScriptны чыганактан төзисез икән, бу кирәк
util.js
. - Поповерлар башкару сәбәпләре аркасында сайланалар, шуңа күрә сез аларны үзегез башларга тиеш .
- Нуль озынлыгы
title
һәмcontent
кыйммәтләре беркайчан да поповерны күрсәтмәячәк. container: 'body'
Катлаулырак компонентларда проблемалар килеп чыкмасын өчен күрсәтегез (безнең кертү төркемнәре, төймә төркемнәре һ.б.).- Яшерен элементлардагы поповерлар эшләмәячәк.
- Поповерлар
.disabled
якиdisabled
элементлар төрү элементында башланырга тиеш. - Берничә сызык белән уралган якорьлардан башлангач, поповерлар якорьларның гомуми киңлеге арасында урнашачак. Бу тәртиптән саклану өчен с-ларда
white-space: nowrap;
кулланыгыз .<a>
- Поповерлар тиешле элементлар DOMдан чыгарылганчы яшерелергә тиеш.
Кайбер мисаллар белән поповерларның ничек эшләвен күрү өчен укуны дәвам итегез.
Биттәге барлык поповерларны башлап җибәрүнең бер ысулы - аларны data-toggle
атрибутлары буенча сайлау:
Ата-ана элементында поповерга комачаулаган кайбер стильләр булганда, сез гадәтне күрсәтергә теләрсез, container
шуңа күрә поповерның HTML шул элемент эчендә күренсен.
<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
Дүрт вариант бар: өске, уң, аскы һәм сул тигезләнгән.
focus
Кулланучының чираттагы чирттерелүендәге поповерларны җибәрү өчен триггер кулланыгыз .
Эштән чыгару өчен чираттагы чирттерү өчен кирәк
Дөрес кросс-браузер һәм платформа тәртибе өчен сез тегны түгел , ә <a>
тегны кулланырга тиеш, һәм сез шулай ук атрибутны кертергә тиеш .<button>
tabindex
<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
Атрибутлы элементлар disabled
интерактив түгел, димәк, кулланучылар поповерны (яки кораллар) җибәрү өчен аларны йөртә алмыйлар. Эш урыны буларак, сез поповерны төргәктән чыгарырга <div>
яки инвалид элементны <span>
кире кагарга теләрсез.pointer-events
Инвалид поповер триггерлары өчен, сез шулай ук поповер сезнең кулланучыларга тиз визуаль җавап булып күренсен өчен өстен булырга мөмкин , чөнки алар инвалид элементка басуныdata-trigger="hover"
көтмиләр .
<span class="d-inline-block" data-toggle="popover" data-content="Disabled popover">
<button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>
JavaScript аша поповерларны рөхсәт итегез:
Вариантларны мәгълүмат атрибутлары яки JavaScript аша бирергә мөмкин. Мәгълүмат атрибутлары өчен вариант исемен data-
өстәгез data-animation=""
.
Исем | Тип | Килешү | Тасвирлау |
---|---|---|---|
анимация | буле | дөрес | Поповерга CSS сүнгән күчүне кулланыгыз |
контейнер | кыл | элемент | ялган | ялган | Поповерны билгеле бер элементка өсти. Мисал : |
эчтәлеге | кыл | элемент | функциясе | '' |
Әгәр дә функция бирелсә, ул |
тоткарлау | саны | объект | 0 | Поповерны күрсәтү һәм яшерү (мс) - кул белән эшләнгән триггер төренә кагылмый Әгәр сан бирелсә, яшерү / күрсәтү өчен тоткарлык кулланыла Объект структурасы: |
html | буле | ялган | Поповерга HTML кертү. Ялган булса, jQuery text ысулы DOMга эчтәлек кертү өчен кулланылачак. XSS һөҗүмнәре турында борчылсагыз, текст кулланыгыз. |
урнаштыру | кыл | функциясе | 'дөрес' | Поповерны ничек урнаштырырга - авто | өстә | аста | сул | уң. Урнаштыруны билгеләү өчен функция кулланылганда, ул беренче аргумент буларак поповер DOM төене белән, икенчесе буларак DOM төен элементы дип атала. |
селектор | кыл | ялган | ялган | Әгәр селектор тәкъдим ителсә, поповер объектлары күрсәтелгән максатларга биреләчәк. Практикада, бу динамик HTML эчтәлеген поповерлар өстәү өчен кулланыла. Моны һәм информацион мисалны карагыз . |
шаблон | кыл | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
Поповер ясаганда куллану өчен HTML нигезе. Поповерның Поповерның
Тышкы төрү элементы |
исем | кыл | элемент | функциясе | '' |
Әгәр дә функция бирелсә, ул |
триггер | кыл | 'басыгыз' | Поповер ничек башлана - басыгыз | | фокус | кулланма. Сез берничә триггер узарга мөмкин; аларны бушлык белән аерыгыз. "кулланма" бүтән триггер белән берләштереп булмый. |
офсет | саны | кыл | 0 | Максатка караганда поповерның офсеты. Күбрәк мәгълүмат өчен Popper.js офсет документларына мөрәҗәгать итегез . |
.әр сүзнең | кыл | массив | 'флип' | Попперның кире кайту вакытында нинди позицияне кулланачагын күрсәтергә рөхсәт итегез. Күбрәк мәгълүмат өчен Popper.js тәртибе документларына мөрәҗәгать итегез |
чик | кыл | элемент | 'scrollParent' | Поповерның чик чикләре. 'viewport' ,, Һәм HTMLElement сылтамасының кыйммәтләрен кабул итә 'window' ( JavaScript кына). 'scrollParent' Күбрәк мәгълүмат өчен Popper.js'ның профилактика Оверфлоу документларына мөрәҗәгать итегез . |
Аерым поповерлар өчен мәгълүмат атрибутлары
Индивидуаль поповерлар өчен вариантлар, өстә аңлатылганча, мәгълүмат атрибутлары ярдәмендә күрсәтелергә мөмкин.
Асинхрон ысуллар һәм күчү
Барлык API ысуллары да асинхрон һәм күчү башлый . Күчерелеш башлангач, ләкин ул беткәнче алар шалтыратучыга кире кайталар . Моннан тыш, күчү компонентына методик чакыру игътибарсыз калачак .
Күбрәк мәгълүмат алу өчен безнең JavaScript документларын карагыз.
Элемент җыю өчен поповерларны башлый.
Элементның поповерын күрсәтә. Чакыручыга поповер күрсәтелгәнче кире кайта (ягъни shown.bs.popover
вакыйга булганчы). Бу поповерның "кул белән" этәргеч булып санала. Поповерларның исеме дә, эчтәлеге дә нуль озынлыгында күрсәтелми.
Элементның поповерын яшерә. Чакыручыга поповер яшерелгәнче кире кайта (ягъни hidden.bs.popover
вакыйга булганчы). Бу поповерның "кул белән" этәргеч булып санала.
Элементның поповерын алыштыра. Чакыручыга поповер күрсәтелгәнче яки яшерелгәнче кире кайтаshown.bs.popover
( ягъни hidden.bs.popover
вакыйга булганчы). Бу поповерның "кул белән" этәргеч булып санала.
Элементның поповерын яшерә һәм юк итә. Делегацияне кулланган поповерлар ( вариант ярдәмендә ясалган )selector
нәсел триггер элементларында аерым юк ителми.
Элементның поповерын күрсәтү мөмкинлеге бирә. Поповерлар килешү буенча кушылган.
Элементның поповерын күрсәтү мөмкинлеген бетерә. Поповер яңадан кушылган очракта гына күрсәтеләчәк.
Элементның поповерын күрсәтү яки яшерү мөмкинлеген үзгәртә.
Элементның поповер позициясен яңарта.
Вакыйга төре | Тасвирлау |
---|---|
show.bs.popover | show Бу вакыйга инстанция ысулы чакырылганда шунда ук янып тора . |
күрсәтелгән.bs.popover | Бу вакыйга кулланучыга күренгәннән соң (CSS күчү тәмамлануын көтеп торачак). |
hide.bs.popover | Бу вакыйга hide инстанция ысулы чакырылганнан соң җибәрелә. |
hidden.bs.popover | Бу вакыйга поповер кулланучыдан яшерелгәннән соң җибәрелә (CSS күчү тәмамлануын көтәр). |
insert.bs.popover | Бу вакыйга show.bs.popover DOMга поповер шаблоны өстәлгәннән соң җибәрелә. |