Поповерлер
Құжаттар мен сайтыңыздағы кез келген элементке iOS жүйесінде табылғандар сияқты Bootstrap қалқымалы файлдарын қосуға арналған мысалдар.
Popover плагинін пайдалану кезінде білу керек нәрселер:
- Поповерлер орналасу үшін үшінші тарап Popper.js кітапханасына сүйенеді . Popovers жұмыс істеуі үшін bootstrap.js алдында popper.min.js қосу керек немесе Popper.js бар
bootstrap.bundle.min.js
/ пайдалану керекbootstrap.bundle.js
! - Popovers тәуелділік ретінде құралдар тақтасының плагинін қажет етеді.
- Егер сіз JavaScript-ті дереккөзден құрастырсаңыз, ол
util.js
. - Popovers өнімділік себептері бойынша қосылады, сондықтан оларды өзіңіз баптандыруыңыз керек .
- Нөлдік ұзындық
title
пенcontent
мәндер ешқашан қалқымалы терезені көрсетпейді. container: 'body'
Күрделі құрамдас бөліктерде (мысалы, енгізу топтары, түймелер топтары, т.б.) ақауларды көрсетпеу үшін көрсетіңіз .- Жасырын элементтерде қалқандарды іске қосу жұмыс істемейді.
.disabled
Қаптама элементінде немесеdisabled
элементтер үшін поповерлер іске қосылуы керек.- Бірнеше жолдар бойымен оралатын якорьлерден іске қосылғанда, қалқымалы белгілер якорьдің жалпы ені арасында ортаға орналасады. Бұл әрекетті болдырмау үшін s
.text-nowrap
on yours пайдаланыңыз .<a>
- Поповерлер олардың сәйкес элементтері DOM ішінен жойылмас бұрын жасырылуы керек.
Кейбір мысалдармен поповерлер қалай жұмыс істейтінін көру үшін оқуды жалғастырыңыз.
Беттегі барлық қалқымалы терезелерді инициализациялаудың бір жолы оларды data-toggle
атрибуты бойынша таңдау болады:
Негізгі элементте қалқымалы файлға кедергі келтіретін кейбір мәнерлер болған кезде, container
оның орнына қалқымалы файлдың HTML-сі сол элемент ішінде пайда болатындай реттелетін параметрді көрсеткіңіз келеді.
Төрт опция қолжетімді: жоғарғы, оң жақ, төменгі және солға тураланған.
focus
Триггерді ауыстырып-қосқыш элементтен басқа элементті пайдаланушы келесі рет басқанда қалқымалы терезелерді алып тастау үшін пайдаланыңыз .
Келесі нұқу кезінде өшіру үшін арнайы белгілеу қажет
Кросс-шолғыш және кросс-платформа әрекеті үшін тегті емес, тегті пайдалану керек <a>
, сонымен қатар <button>
төлсипатты қамту керек tabindex
.
Төлсипатқа ие элементтер disabled
интерактивті емес, яғни пайдаланушылар қалқымалы терезені (немесе құралдар кеңесін) іске қосу үшін меңзерді апара алмайды немесе баса алмайды. Шешім ретінде сіз қаптамадан қалқымалы әрекетті іске қосқыңыз келеді <div>
немесе өшірілген элементтегі элементті <span>
қайта анықтағыңыз келеді .pointer-events
Өшірілген қалқымалы триггерлер үшін қалқымалы триггерлер пайдаланушыларыңызға дереу көрнекі кері байланыс ретінде пайда болуын қалауыңыз мүмкін, себебі олар өшірілген элементті басудыdata-trigger="hover"
күтпеуі мүмкін .
JavaScript арқылы popovers қосыңыз:
Опцияларды деректер атрибуттары немесе JavaScript арқылы жіберуге болады. Деректер атрибуттары үшін параметр атауын ішінде data-
сияқты қосыңыз data-animation=""
.
Аты | Түр | Әдепкі | Сипаттама |
---|---|---|---|
анимация | логикалық | рас | Қалқымалы файлға CSS өшіру көшуін қолданыңыз |
контейнер | жол | элемент | жалған | жалған | Қалқымалы элементті белгілі бір элементке қосады. Мысалы: |
мазмұны | жол | элемент | функциясы | '' |
Егер функция берілсе, ол |
кешіктіру | саны | объект | 0 | Қалқымалы файлды көрсету және жасыру кідірісі (мс) - қолмен триггер түріне қолданылмайды Егер нөмір берілсе, кідіріс жасыру/көрсету үшін де қолданылады Объектінің құрылымы – бұл: |
html | логикалық | жалған | Қалқымалы файлға HTML енгізіңіз. Егер жалған болса, jQuery text әдісі мазмұнды DOM ішіне енгізу үшін пайдаланылады. XSS шабуылдары туралы алаңдасаңыз, мәтінді пайдаланыңыз. |
орналастыру | жол | функциясы | 'дұрыс' | Қалқымалы құрылғыны қалай орналастыруға болады - авто | жоғарғы | төменгі | сол жақ | дұрыс. Орналастыруды анықтау үшін функция пайдаланылған кезде, ол бірінші аргумент ретінде popover DOM түйінімен, ал екінші ретінде іске қосу элементі DOM түйінімен шақырылады. Мәтінмән |
селектор | жол | жалған | жалған | Егер селектор берілсе, қалқымалы нысандар көрсетілген мақсаттарға беріледі. Іс жүзінде бұл динамикалық HTML мазмұнына қалқымалы файлдарды қосу үшін пайдаланылады. Мынаны және ақпаратты мысалды қараңыз . |
шаблон | жол | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
Қалқымалы файлды жасау кезінде қолданылатын негізгі HTML. Попопвер ішке Попопвер ішке
Ең сыртқы орауыш элементінде |
тақырып | жол | элемент | функциясы | '' |
Егер функция берілсе, ол |
триггер | жол | 'басу' | Popover қалай іске қосылады - | түймесін басыңыз меңзегіш | фокус | нұсқаулық. Сіз бірнеше триггерлерді өткізе аласыз; оларды бос орынмен бөліңіз. manual басқа триггермен біріктіру мүмкін емес. |
офсет | саны | жол | 0 | Мақсатқа қатысты поповердің ығысуы. Қосымша ақпаратты Popper.js офсеттік құжаттарынан қараңыз . |
fallbackPlacement | жол | массив | «айналу» | Поппер қалпына келтіруде қандай позицияны қолданатынын көрсетуге рұқсат беріңіз. Қосымша ақпаратты Popper.js мінез-құлық құжаттарынан қараңыз |
шекара | жол | элемент | 'scrollParent' | Қалқымалы құрылғының толып кету шектеуінің шекарасы. 'viewport' , 'window' , 'scrollParent' , немесе HTMLElement сілтемесінің мәндерін қабылдайды (тек JavaScript). Қосымша ақпаратты Popper.js's preventOverflow құжаттарынан қараңыз . |
Жеке қалқандарға арналған деректер атрибуттары
Жеке қалқандарға арналған опцияларды жоғарыда түсіндірілгендей деректер атрибуттарын пайдалану арқылы балама түрде көрсетуге болады.
Асинхронды әдістер мен ауысулар
Барлық API әдістері асинхронды және өтуді бастайды . Олар қоңырау шалушыға ауысу басталған бойда, бірақ аяқталмай тұрып қайтады . Сонымен қатар, өтпелі құрамдастағы әдіс шақыруы еленбейді .
Элемент жинағы үшін қалқымалы элементтерді инициализациялайды.
Элементтің қалқымалы қалпын көрсетеді. Қоңырау шалушыға қалқымалы қоңырау нақты көрсетілмей тұрып (яғни shown.bs.popover
оқиға орын алмас бұрын) қайтарады. Бұл қалқыманың «қолмен» іске қосылуы болып саналады. Тақырыптары мен мазмұны нөлге тең болатын поповерлер ешқашан көрсетілмейді.
Элементтің қалқымалы қалқымалын жасырады. Қалқымалы қоңырау шынымен жасырылғанға дейін (яғни оқиға орын алмас бұрын) қоңырау шалушыға оралады . hidden.bs.popover
Бұл қалқыманың «қолмен» іске қосылуы болып саналады.
Элементтің қалқымалы параметрін ауыстырады. Қоңырау шалушыға қалқымалы шын мәнінде көрсетілмей тұрып немесе жасырылғанға дейін (яғни shown.bs.popover
немесе hidden.bs.popover
оқиға болғанға дейін) қайтарады. Бұл қалқыманың «қолмен» іске қосылуы болып саналады.
Элементтің қалқымалы қалпын жасырады және жояды. Делегацияны пайдаланатын поповерлер ( опция арқылы жасалғанselector
) ұрпақ триггер элементтерінде жеке жойылмайды.
Элементтің қалқымалы терезесін көрсету мүмкіндігін береді. Popovers әдепкі бойынша қосылады.
Элементтің қалқымалы нұсқасының көрсетілу мүмкіндігін жояды. Қалқымалы құрылғы қайта қосылғанда ғана көрсетіледі.
Элементтің қалқымалы нұсқасын көрсету немесе жасыру мүмкіндігін ауыстырады.
Элементтің қалқымалы қалқымалы орнын жаңартады.
Оқиға түрі | Сипаттама |
---|---|
show.bs.popover | show Бұл оқиға даналық әдісі шақырылған кезде бірден іске қосылады. |
көрсетілген.bs.popover | Бұл оқиға қалқымалы файл пайдаланушыға көрінетін болған кезде іске қосылады (CSS ауысуларының аяқталуын күтеді). |
hide.bs.popover | Бұл оқиға даналық hide әдісі шақырылған кезде бірден іске қосылады. |
hidden.bs.popover | Бұл оқиға қалқымалы файлды пайдаланушыдан жасыруды аяқтаған кезде іске қосылады (CSS ауысуларының аяқталуын күтеді). |
inserted.bs.popover | Бұл оқиға show.bs.popover popover үлгісі DOM файлына қосылған оқиғадан кейін іске қосылады. |