Пераключайце кантэкстныя накладкі для адлюстравання спісаў спасылак і многае іншае з дапамогай выпадальнага плагіна Bootstrap.
Агляд
Выпадаючыя спісы - гэта кантэкстныя накладкі, якія можна пераключаць, для адлюстравання спісаў спасылак і іншага. Яны зроблены інтэрактыўнымі з уключаным плагінам Bootstrap для выпадальнага меню JavaScript. Яны пераключаюцца націскам, а не навядзеннем; гэта наўмыснае дызайнерскае рашэнне .
Выпадаючыя спісы створаны на аснове старонняй бібліятэкі Popper.js , якая забяспечвае дынамічнае пазіцыянаванне і выяўленне вокны прагляду. Абавязкова ўключыце popper.min.js перад JavaScript Bootstrap або выкарыстоўвайце bootstrap.bundle.min.js/ bootstrap.bundle.js, які змяшчае Popper.js. Popper.js не выкарыстоўваецца для размяшчэння выпадаючых спісаў у панэлі навігацыі, хоць дынамічнае пазіцыянаванне не патрабуецца.
Стандарт WAI ARIA вызначае фактычны role="menu"віджэт , але гэта адносіцца да прыкладных меню, якія запускаюць дзеянні або функцыі. Меню ARIA могуць утрымліваць толькі пункты меню, пункты меню сцяжкоў, пункты меню перамыкачоў, групы перамыкачоў і падменю.
Выпадаючыя спісы Bootstrap, з іншага боку, распрацаваны як агульныя і дастасавальныя да розных сітуацый і структур разметкі. Напрыклад, можна ствараць выпадальныя спісы, якія змяшчаюць дадатковыя ўводы і элементы кіравання формамі, такія як палі пошуку або формы ўваходу. Па гэтай прычыне Bootstrap не чакае (і не дадае аўтаматычна) ніякіх атрыбутаў roleі , неабходных для сапраўдных меню ARIA . Аўтары самі павінны ўключыць гэтыя больш канкрэтныя атрыбуты.aria-
Тым не менш, Bootstrap сапраўды дадае ўбудаваную падтрымку большасці стандартных узаемадзеянняў з меню клавіятуры, такіх як магчымасць перамяшчацца па асобных .dropdown-itemэлементах з дапамогай клавіш курсора і закрываць меню з дапамогай ESCклавішы.
Прыклады
Абгарніце перамыкач выпадальнага меню (вашу кнопку або спасылку) і выпадальнае меню ў .dropdownабо іншы элемент, які абвяшчае position: relative;. Выпадаючыя спісы можна выклікаць з <a>або <button>элементаў, каб лепш адпавядаць вашым патэнцыяльным патрэбам.
Адзіная кнопка
Любы сінгл .btnможна ператварыць у выпадальны пераключальнік з некаторымі зменамі разметкі. Вось як вы можаце прымусіць іх працаваць з адным з <button>элементаў:
Аналагічным чынам стварыце выпадальныя спісы з раздзеленымі кнопкамі практычна з той жа разметкай, што і выпадальныя спісы з адной кнопкай, але з даданнем .dropdown-toggle-splitдля належнага інтэрвалу вакол выпадальнага меню.
Мы выкарыстоўваем гэты дадатковы клас для памяншэння гарызанталі paddingпа абодва бакі карэткі на 25% і выдалення таго margin-left, што дадаецца для звычайных выпадаючых кнопак. Гэтыя дадатковыя змены трымаюць курсор у цэнтры раздзеленай кнопкі і забяспечваюць вобласць траплення больш адпаведнага памеру побач з галоўнай кнопкай.
Гістарычна змесціва выпадальнага меню павінна было быць спасылкамі, але гэта ўжо не так у версіі 4. Цяпер вы можаце па жаданні выкарыстоўваць <button>элементы ў выпадаючых спісах замест проста <a>s.
Вы таксама можаце ствараць неінтэрактыўныя выпадальныя элементы з дапамогай .dropdown-item-text. Не саромейцеся ствараць дадатковыя стылі з дапамогай карыстацкіх CSS або тэкставых утыліт.
Па змаўчанні выпадаючае меню аўтаматычна размяшчаецца на 100% зверху і ўздоўж левага боку бацькоўскага меню. Дадайце .dropdown-menu-rightда .dropdown-menuвыраўноўвання выпадальнага меню па правым краі.
Галаву ўверх! Выпадаючыя спісы размяшчаюцца дзякуючы Popper.js (за выключэннем выпадкаў, калі яны змяшчаюцца ў панэлі навігацыі).
Адаптыўнае выраўноўванне
Калі вы хочаце выкарыстоўваць адаптыўнае выраўноўванне, адключыце дынамічнае пазіцыянаванне, дадаўшы data-display="static"атрыбут, і выкарыстоўвайце адаптыўныя класы варыяцый.
Каб выраўнаваць выпадаючае меню з дадзенай кропкай прыпынку або большай, дадайце.dropdown-menu{-sm|-md|-lg|-xl}-right .
Каб выраўнаваць левае выпадальнае меню з дадзенай кропкай перапынку або большай, дадайце .dropdown-menu-rightі .dropdown-menu{-sm|-md|-lg|-xl}-left.
Звярніце ўвагу, што вам не трэба дадаваць data-display="static"атрыбут да кнопак выпадальнага спісу ў панэлі навігацыі, паколькі Popper.js не выкарыстоўваецца ў панэлі навігацыі.
Змест меню
Загалоўкі
Дадайце загаловак, каб пазначыць раздзелы дзеянняў у любым выпадальным меню.
Змесціце любы тэкст свабоднай формы ў выпадальнае меню з тэкстам і выкарыстоўвайце ўтыліты для размяшчэння інтэрвалаў . Звярніце ўвагу, што вам, верагодна, спатрэбяцца дадатковыя стылі памераў, каб абмежаваць шырыню меню.
Некалькі прыкладаў тэксту, які свабодна расцякаецца ў выпадальным меню.
І гэта яшчэ прыклад тэксту.
Формы
Размясціце форму ў выпадальным меню або ператварыце яе ў выпадаючае меню і выкарыстоўвайце ўтыліты поля або запаўнення , каб даць ёй неабходнае адмоўнае месца.
З дапамогай атрыбутаў дадзеных або JavaScript плагін выпадальнага меню пераключае схаваны кантэнт (выпадаючыя меню), пераключаючы .showклас у бацькоўскім пункце спісу. Атрыбут data-toggle="dropdown"выкарыстоўваецца для закрыцця выпадаючых меню на ўзроўні прыкладанняў, таму добра выкарыстоўваць яго заўсёды.
На сэнсарных прыладах адкрыццё выпадальнага меню дадае пустыя ( $.noop) mouseoverапрацоўшчыкі да непасрэдных даччыных <body>элементаў элемента. Гэты пачварны хак неабходны, каб абыйсці дзівацтвы ў дэлегаванні падзей у iOS , якія ў адваротным выпадку перашкодзяць націсканню дзе-небудзь па-за выпадальным спісам выклікаць код, які закрывае выпадальны спіс. Пасля закрыцця выпадальнага меню гэтыя дадатковыя пустыя mouseoverапрацоўшчыкі выдаляюцца.
Праз атрыбуты дадзеных
Дадайце data-toggle="dropdown"да спасылкі або кнопкі, каб пераключыць выпадальны спіс.
Праз JavaScript
Выклік выпадаючых меню праз JavaScript:
data-toggle="dropdown"яшчэ патрабуецца
Незалежна ад таго, выклікаеце вы выпадальны спіс праз JavaScript або замест гэтага выкарыстоўваеце data-api, data-toggle="dropdown"ён заўсёды павінен прысутнічаць у спускавым элеменце выпадальнага меню.
Параметры
Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-offset="".
Імя
Тып
Па змаўчанні
Апісанне
зрушэнне
нумар | радок | функцыя
0
Зрушэнне выпадальнага меню адносна мэты.
Калі функцыя выкарыстоўваецца для вызначэння зрушэння, яна выклікаецца з аб'ектам, які змяшчае даныя зрушэння ў якасці першага аргумента. Функцыя павінна вяртаць аб'ект з такой жа структурай. Запускаючы элемент DOM вузел перадаецца ў якасці другога аргумента.
Для атрымання дадатковай інфармацыі звярніцеся да афсетнай дакументацыі Popper.js .
перавярнуць
лагічны
праўда
Дазволіць перагортванне выпадальнага меню ў выпадку перакрыцця апорнага элемента. Для атрымання дадатковай інфармацыі звярніцеся да перагортваемай дакументацыі Popper.js .
мяжа
радок | элемент
'scrollParent'
Мяжа абмежавання перапаўнення выпадальнага меню. Прымае значэнні 'viewport', 'window', 'scrollParent'або спасылку HTMLElement (толькі JavaScript). Для атрымання дадатковай інфармацыі звярніцеся да Popper.js's preventOverflow docs .
спасылка
радок | элемент
"пераключэнне"
Спасылкавы элемент выпадальнага меню. Прымае значэнні 'toggle', 'parent', або спасылку HTMLElement. Для атрымання дадатковай інфармацыі звярніцеся да дакументацыі referenceObject Popper.js .
дысплей
радок
"дынамічны"
Па змаўчанні мы выкарыстоўваем Popper.js для дынамічнага пазіцыянавання. Адключыце гэта з дапамогай static.
popperConfig
нуль | аб'ект
нуль
Каб змяніць стандартную канфігурацыю Bootstrap Popper.js, глядзіце канфігурацыю Popper.js
Звярніце ўвагу, калі boundaryдля гэтага значэнне ўстаноўлена любое значэнне, акрамя 'scrollParent', стыль position: staticпрымяняецца да .dropdownкантэйнера.
Метады
Метад
Апісанне
$().dropdown('toggle')
Пераключае выпадальнае меню дадзенай панэлі навігацыі або навігацыі з укладкамі.
$().dropdown('show')
Паказвае выпадальнае меню дадзенай панэлі навігацыі або навігацыі з укладкамі.
$().dropdown('hide')
Хавае выпадальнае меню дадзенай панэлі навігацыі або навігацыі з укладкамі.
$().dropdown('update')
Абнаўляе пазіцыю выпадальнага меню элемента.
$().dropdown('dispose')
Знішчае выпадальны спіс элемента.
Падзеі
Усе выпадаючыя падзеі запускаюцца ў .dropdown-menuбацькоўскім элеменце і маюць relatedTargetуласцівасць, значэннем якой з'яўляецца перамыкаючы прывязны элемент. hide.bs.dropdownі hidden.bs.dropdownпадзеі маюць clickEventуласцівасць (толькі калі зыходны тып падзеі click), якая змяшчае аб'ект падзеі для падзеі пстрычкі.
Падзея
Апісанне
show.bs.dropdown
Гэта падзея спрацоўвае неадкладна пры выкліку метаду паказу экземпляра.
shown.bs.dropdown
Гэта падзея запускаецца, калі выпадальнае меню становіцца бачным для карыстальніка (будзе чакаць завяршэння пераходаў CSS).
hide.bs.dropdown
Гэта падзея запускаецца неадкладна, калі быў выкліканы метад экзэмпляра hide.
hidden.bs.dropdown
Гэта падзея запускаецца, калі выпадальнае меню скончана хавацца ад карыстальніка (будзе чакаць завяршэння пераходаў CSS).