Popovers
Сайтыңыздагы каалаган элементке iOS'то табылгандар сыяктуу Bootstrap поповерлерин кошуу үчүн документтер жана мисалдар.
Обзор
Popover плагинин колдонууда билүү керек болгон нерселер:
- Поповерлер жайгаштыруу үчүн үчүнчү тараптын Popper.js китепканасына таянышат . Сиз bootstrap.js алдында popper.min.js кошушуңуз керек же popovers иштеши үчүн Popper.js камтылган
bootstrap.bundle.min.js
/ колдонушуңуз керек!bootstrap.bundle.js
- Popovers көз карандылык катары инструменттин плагинин талап кылат.
- Эгер сиз биздин JavaScript булактан куруп жатсаңыз, анда
util.js
. - Поповерлер майнаптуулугу үчүн кошулат, андыктан аларды өзүңүз башташыңыз керек .
- Нөл узундуктагы
title
жанаcontent
баалуулуктар эч качан калкып чыгууну көрсөтпөйт. container: 'body'
Татаалыраак компоненттерде (мисалы, киргизүү топторубуз, баскыч топторубуз ж.б.) көйгөйлөрдү жаратпаш үчүн белгилеңиз .- Жашыруун элементтерде поповерлерди иштетүү иштебейт.
.disabled
Үчүн жеdisabled
элементтер үчүн поповерлер орогуч элементинде иштетилиши керек.- Бир нече сызыктар боюнча оролгон анкерлерден иштетилгенде, поповерлер анкерлердин жалпы туурасынын ортосуна жайгаштырылат. Бул жүрүм-турумду болтурбоо үчүн
.text-nowrap
сиздин с боюнча колдонуңуз .<a>
- Поповерлер алардын тиешелүү элементтери DOMдан алынып салынганга чейин жашырылышы керек.
- Popovers көлөкө DOM ичиндеги элементтин аркасында иштетилиши мүмкүн.
Бул компоненттин анимация эффектиси prefers-reduced-motion
медиа суроосуна көз каранды. Биздин жеткиликтүүлүк документтерибиздин кыскартылган кыймыл бөлүмүн караңыз .
Поповерлердин кээ бир мисалдар менен кантип иштээрин көрүү үчүн окууну улантыңыз.
Мисал: Бардык жерде поповерлерди иштетүү
Барактагы бардык поповерлерди инициализациялоонун бир жолу аларды data-toggle
атрибуту боюнча тандоо болот:
Мисал: container
Опцияны колдонуу
Ата-энелик элементте поповерге тоскоол болгон кээ бир стилдер болгондо, container
анын ордуна popover HTML'и ошол элементтин ичинде пайда болушу үчүн салтты белгилегиңиз келет.
Мисал
Төрт багыт
Төрт вариант бар: жогорку, оң, ылдый жана сол тегизделген.
Кийинки чыкылдатууда четке кагуу
focus
Колдонуучунун которуштуруу элементинен башка элементти кийинки чыкылдатуусунда поповерлерди четке кагуу үчүн триггерди колдонуңуз .
Кийинки чыкылдатууда өчүрүү үчүн атайын белги талап кылынат
Туура кайчылаш браузер жана кайчылаш платформа жүрүм-туруму үчүн <a>
тегди эмес , <button>
тегди колдонушуңуз керек, ошондой эле tabindex
атрибутту камтышыңыз керек.
Өчүрүлгөн элементтер
Атрибуту бар элементтер disabled
интерактивдүү эмес, демек, колдонуучулар калкып чыгууну (же инструментарийди) ишке киргизүү үчүн аларды басып же баса албайт. Чечим катары, сиз поповерди орогучтан иштеткиңиз келет <div>
же өчүрүлгөн элементти <span>
жокко чыгаргыңыз келет.pointer-events
Өчүрүлгөн popover триггерлери үчүн, сиз ошондой эле поповер колдонуучуларыңызга дароо визуалдык пикир катары көрүнүшүн кааласаңыз болот, анткени алар өчүрүлгөн элементти басуунуdata-trigger="hover"
күтпөшү мүмкүн .
Колдонуу
JavaScript аркылуу поповерлерди иштетүү:
Параметрлер
Параметрлер маалымат атрибуттары же JavaScript аркылуу берилиши мүмкүн. Дайындардын атрибуттары үчүн параметрдин атын data-
, сыяктуу эле кошуңуз data-animation=""
.
аты | Type | Демейки | Description |
---|---|---|---|
анимация | логикалык | чын | Калкыма файлга CSS өчүп өтүүнү колдонуңуз |
контейнер | string | элемент | жалган | жалган | Белгилүү бир элементке калкыма тиркелет. Мисал: |
мазмун | string | элемент | функция | '' |
Эгерде функция берилсе, ал |
кечиктирүү | саны | объект | 0 | Поповерди көрсөтүү жана жашыруу кечигүү (мс) - кол менен триггер түрүнө тиешелүү эмес Эгерде номер берилсе, кечиктирүү эки жашыруу/көрсөтүү үчүн колдонулат Объекттин структурасы: |
html | логикалык | жалган | HTMLди калкып чыгуучу жерге кыстарыңыз. Эгер жалган болсо, text DOMга мазмунду киргизүү үчүн jQuery ыкмасы колдонулат. XSS чабуулдарынан кооптонуп жатсаңыз, текстти колдонуңуз. |
жайгаштыруу | string | функция | "туура" | Поповерди кантип жайгаштыруу керек - авто | top | түбү | сол | туура. Функция жайгаштырууну аныктоо үчүн колдонулганда, ал биринчи аргумент катары popover DOM түйүнү жана экинчиси катары триггер элементи DOM түйүнү менен чакырылат. Контекст |
селектор | string | жалган | жалган | Эгер селектор берилсе, поповер объекттери көрсөтүлгөн максаттарга өткөрүлүп берилет. Иш жүзүндө, бул динамикалык HTML мазмунун поповерлерди кошууга иштетүү үчүн колдонулат. Бул жана маалыматтык мисалды караңыз . |
шаблон | сап | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
Калкыма түзүүдө колдонула турган негизги HTML. поповердин поповердин
Эң сырткы ороочу элемент |
аталышы | string | элемент | функция | '' |
Эгерде функция берилсе, ал |
триггер | сап | 'басуу' | Поповер кантип иштетилет - чыкылдатыңыз | hover | фокус | колдонмо. Сиз бир нече триггерлерди өткөрө аласыз; аларды боштук менен ажыратыңыз. manual башка триггер менен айкалыштыруу мүмкүн эмес. |
офсет | саны | сап | 0 | Поповердин максатына салыштырмалуу жылышы. Көбүрөөк маалымат алуу үчүн Popper.js'тин офсет документтерине кайрылыңыз . |
fallbackPlacement | string | массив | 'флип' | Поппер кайра кайтарууда кайсы позицияны колдоноорун көрсөтүүгө уруксат бериңиз. Көбүрөөк маалымат алуу үчүн Popper.jsтин жүрүм -туруму боюнча документтерди караңыз |
чек ара | string | элемент | 'scrollParent' | Поповердин толуп кетүү чектөө чек арасы. 'viewport' , 'window' , 'scrollParent' , же HTMLElement шилтемесинин маанилерин кабыл алат (JavaScript гана). Көбүрөөк маалымат алуу үчүн Popper.js'тин preventOverflow документтерине кайрылыңыз . |
Жеке поповерлер үчүн маалымат атрибуттары
Жеке поповерлердин параметрлери альтернатива катары жогоруда түшүндүрүлгөндөй, маалымат атрибуттарын колдонуу аркылуу көрсөтүлүшү мүмкүн.
Методдор
Асинхрондук методдор жана өтүүлөр
Бардык API ыкмалары асинхрондуу жана өтүүнү баштайт . Алар чалуучуга өтүү башталаары менен, бирок ал бүтө электе кайтып келишет . Кошумчалай кетсек, өтүүчү компоненттеги ыкма чакырыгы этибарга алынбайт .
Көбүрөөк маалымат алуу үчүн биздин JavaScript документтерибизди караңыз .
$().popover(options)
Элементтердин жыйнагы үчүн поповерлерди инициализациялайт.
.popover('show')
Элементтин калкып чыгуусун көрсөтөт. Поповер чындыгында көрсөтүлө электе (б.а. shown.bs.popover
окуя болгонго чейин) чалуучуга кайтат. Бул поповерди "кол менен" ишке киргизүү деп эсептелет. Аталышы жана мазмуну нөлгө барабар болгон поповерлер эч качан көрсөтүлбөйт.
.popover('hide')
Элементтин калкып чыгуусун жашырат. Поповер чындыгында жашырылганга чейин (б.а. hidden.bs.popover
окуя болгонго чейин) чалуучуга кайтат. Бул поповерди "кол менен" ишке киргизүү деп эсептелет.
.popover('toggle')
Элементтин калкып чыгуусун өчүрөт. Поповер чындыгында көрсөтүлгөнгө же жашырылганга чейин (б.а. shown.bs.popover
же hidden.bs.popover
окуя болгонго чейин) чалуучуга кайтат. Бул поповерди "кол менен" ишке киргизүү деп эсептелет.
.popover('dispose')
Элементтин поповерин жашырат жана жок кылат. Делегацияны колдонгон поповерлер ( опцияны колдонуу мененselector
түзүлгөн ) тукум триггер элементтеринде өзүнчө жок кылынбайт.
.popover('enable')
Элементтин калкып чыгуусуна көрсөтүү мүмкүнчүлүгүн берет. Поповерлер демейки боюнча иштетилген.
.popover('disable')
Элементтин поповерин көрсөтүү мүмкүнчүлүгүн жок кылат. Поповер кайра иштетилгенде гана көрсөтүлө алат.
.popover('toggleEnabled')
Элементтин поповерин көрсөтүү же жашыруу мүмкүнчүлүгүн өчүрөт.
.popover('update')
Элементтин поповеринин абалын жаңыртат.
Окуялар
Окуя түрү | Description |
---|---|
show.bs.popover | Бул окуя show инстанция ыкмасы чакырылганда дароо күйөт. |
show.bs.popover | Бул окуя поповер колдонуучуга көрүнгөндөн кийин өчүрүлөт (CSS өтүүлөрү аяктаганга чейин күтөт). |
hide.bs.popover | Бул окуя hide инстанция ыкмасы чакырылганда дароо өчүрүлөт. |
hidden.bs.popover | Бул окуя поповер колдонуучудан жашырылгандан кийин өчүрүлөт (CSS өтүүлөрү бүткүчө күтөт). |
inserted.bs.popover | Бул окуя show.bs.popover DOMга popover үлгүсү кошулгандан кийин өчүрүлөт. |