Aqleb is-superpożizzjonijiet kuntestwali għall-wiri ta' listi ta' links u aktar bil-plugin dropdown Bootstrap.
Ħarsa ġenerali
Dropdowns huma toggleable, overlays kuntestwali għall-wiri ta 'listi ta' links u aktar. Huma jsiru interattivi mal-plugin Bootstrap dropdown JavaScript inkluż. Huma qed toggled billi tikklikkja, mhux billi tittajjar; din hija deċiżjoni ta' disinn intenzjonali .
Dropdowns huma mibnija fuq librerija ta 'parti terza, Popper.js , li tipprovdi pożizzjonament dinamiku u skoperta viewport. Kun żgur li tinkludi popper.min.js qabel il-JavaScript ta' Bootstrap jew uża bootstrap.bundle.min.js/ bootstrap.bundle.jsli fih Popper.js. Popper.js ma jintużax biex ipoġġi dropdowns fin-navbars għalkemm peress li l-pożizzjonament dinamiku mhuwiex meħtieġ.
Jekk qed tibni JavaScript tagħna mis-sors, teħtieġutil.js .
Aċċessibilità
L -istandard WAI ARIA jiddefinixxi role="menu"widget attwali , iżda dan huwa speċifiku għal menus simili għal applikazzjoni li jqanqlu azzjonijiet jew funzjonijiet. Il-menus ARIA jista' jkun fihom biss oġġetti tal-menu, oġġetti tal-menu tal-kaxxa ta' kontroll, oġġetti tal-menu tal-buttuni tar-radju, gruppi tal-buttuni tar-radju u sub-menus.
Il-dropdowns ta' Bootstrap, min-naħa l-oħra, huma mfassla biex ikunu ġeneriċi u applikabbli għal varjetà ta' sitwazzjonijiet u strutturi ta' markup. Pereżempju, huwa possibbli li jinħolqu dropdowns li fihom inputs addizzjonali u kontrolli tal-formoli, bħal oqsma ta 'tfittxija jew formoli ta' login. Għal din ir-raġuni, Bootstrap ma jistenna (u lanqas iżid awtomatikament) xi wieħed mill- roleu aria-attributi meħtieġa għal menus ARIA veri. L-awturi se jkollhom jinkludu dawn l-attributi aktar speċifiċi huma stess.
Madankollu, Bootstrap iżid appoġġ integrat għall-biċċa l-kbira tal-interazzjonijiet standard tal-menu tat-tastiera, bħall-abbiltà li timxi minn .dropdown-itemelementi individwali billi tuża ċ-ċwievet tal-cursor u tagħlaq il-menu biċ- ESCċavetta.
Eżempji
Kebbeb it-toggle tal-dropdown (il-buttuna jew il-link tiegħek) u l-menu dropdown fi ħdan .dropdown, jew element ieħor li jiddikjara position: relative;. Dropdowns jistgħu jiġu attivati minn <a>jew <button>elementi li jaqblu aħjar mal-bżonnijiet potenzjali tiegħek.
Buttuna waħda
Kwalunkwe wieħed .btnjista' jinbidel f'toggle dropdown b'xi bidliet fil-markup. Hawn kif tista 'tpoġġihom jaħdmu ma' kwalunkwe <button>elementi:
Bl-istess mod, oħloq dropdowns tal-buttuna maqsuma prattikament bl-istess markup bħal dropdowns ta 'buttuna waħda, iżda biż-żieda ta' .dropdown-toggle-splitgħal spazjar xieraq madwar il-caret dropdown.
Aħna nużaw din il-klassi żejda biex innaqqsu l-orizzontali paddingfuq kull naħa tal-caret b'25% u neħħi margin-leftdak miżjud għal dropdowns tal-buttuni regolari. Dawk il-bidliet żejda jżommu l-caret iċċentrat fil-buttuna maqsuma u jipprovdu żona ta 'hit ta' daqs aktar xieraq ħdejn il-buttuna prinċipali.
Storikament il-kontenuti tal-menu dropdown kellhom ikunu links, iżda dan m'għadux il-każ ma v4. Issa tista' b'għażla tuża <button>elementi fil-dropdowns tiegħek minflok <a>s biss.
Tista' wkoll toħloq oġġetti dropdown mhux interattivi b' .dropdown-item-text. Ħossok liberu li tfassal aktar b'utilitajiet CSS jew test tad-dwana.
B'mod awtomatiku, menu dropdown jitqiegħed awtomatikament 100% minn fuq u tul in-naħa tax-xellug tal-ġenitur tiegħu. Żid .dropdown-menu-rightmal- .dropdown-menulemin tallinja l-menu dropdown.
Irjus up! Dropdowns huma pożizzjonati grazzi għal Popper.js (ħlief meta jkunu jinsabu f'navbar).
Allinjament reattiv
Jekk trid tuża allinjament li jirrispondu, iddiżattiva l-pożizzjonament dinamiku billi żżid l- data-display="static"attribut u uża l-klassijiet tal-varjazzjoni li tirrispondi.
Biex tallinja dritt il-menu dropdown mal-punt ta' waqfien mogħti jew akbar, żid .dropdown-menu{-sm|-md|-lg|-xl}-right.
Biex tallinja xellug il-menu dropdown mal-punt ta 'waqfien mogħti jew akbar, żid .dropdown-menu-rightu .dropdown-menu{-sm|-md|-lg|-xl}-left.
Innota li m'għandekx bżonn iżżid data-display="static"attribut mal-buttuni dropdown fin-navbars, peress li Popper.js ma jintużax fin-navbars.
Kontenut tal-menu
Headers
Żid header biex ittikketta sezzjonijiet tal-azzjonijiet fi kwalunkwe menu dropdown.
Poġġi kwalunkwe test ta' forma ħielsa f'menu dropdown bit-test u uża utilitajiet ta' spazjar . Innota li x'aktarx ikollok bżonn stili ta' daqs addizzjonali biex tillimita l-wisa' tal-menu.
Xi eżempju ta' test li jiċċirkola b'xejn fil-menu dropdown.
Permezz ta 'attributi tad-dejta jew JavaScript, il-plugin dropdown jibdel kontenut moħbi (menus dropdown) billi taqleb il- .showklassi fuq l-oġġett tal-lista prinċipali. L- data-toggle="dropdown"attribut huwa bbażat fuqu għall-għeluq tal-menus dropdown f'livell ta 'applikazzjoni, għalhekk hija idea tajba li dejjem tużah.
Fuq apparati li jintmess, il-ftuħ ta' dropdown iżid handlers vojta ( $.noop) mouseovermat-tfal immedjati tal- <body>element. Dan il-hack ċertament ikrah huwa meħtieġ biex taħdem madwar quirk fid-delegazzjoni tal-avvenimenti tal-iOS , li inkella jipprevjeni vit kullimkien barra mill-dropdown milli jikkawża l-kodiċi li jagħlaq il-dropdown. Ladarba l-dropdown jingħalaq, dawn il-handlers vojta addizzjonali mouseoverjitneħħew.
Via attributi tad-data
Żid data-toggle="dropdown"ma' link jew buttuna biex taqleb dropdown.
Via JavaScript
Ċempel il-dropdowns permezz ta' JavaScript:
data-toggle="dropdown"għadu meħtieġ
Irrispettivament minn jekk inti sejħa dropdown tiegħek permezz JavaScript jew minflok tuża d-data-api, data-toggle="dropdown"huwa dejjem meħtieġ li tkun preżenti fuq l-element grillu dropdown.
Għażliet
L-għażliet jistgħu jiġu mgħoddija permezz ta' attributi tad-dejta jew JavaScript. Għal attributi tad-dejta, ehmeż l-isem tal-għażla ma' data-, bħal f' data-offset="".
Isem
Tip
Default
Deskrizzjoni
offset
numru | spag | funzjoni
0
Tpaċija tal-dropdown relattiv għall-mira tagħha.
Meta tintuża funzjoni biex tiddetermina l-offset, tissejjaħ b'oġġett li jkun fih id-dejta tal-offset bħala l-ewwel argument tagħha. Il-funzjoni trid tirritorna oġġett bl-istess struttura. L-element triggering node DOM huwa mgħoddi bħala t-tieni argument.
Għal aktar informazzjoni irreferi għad-doks tal- offset ta' Popper.js .
flip
boolean
veru
Ħalli Dropdown jinqaleb f'każ ta' sovrapożizzjoni fuq l-element ta' referenza. Għal aktar informazzjoni irreferi għall- flip docs ta' Popper.js .
fruntiera
spag | element
'scrollParent'
Limitu ta' restrizzjoni ta' overflow tal-menu dropdown. Jaċċetta l-valuri ta' 'viewport', 'window', 'scrollParent', jew referenza HTMLElement (JavaScript biss). Għal aktar informazzjoni irreferi għad-doks preventOverflow ta' Popper.js .
referenza
spag | element
'toggle'
Element ta' referenza tal-menu dropdown. Jaċċetta l-valuri ta' 'toggle', 'parent', jew referenza HTMLElement. Għal aktar informazzjoni irreferi għad-doks referenceObject ta' Popper.js .
wiri
spag
'dinamika'
B'mod awtomatiku, nużaw Popper.js għal pożizzjonament dinamiku. Iddiżattiva dan b' static.
Innota meta boundaryhuwa ssettjat għal kwalunkwe valur minbarra 'scrollParent', l-istil position: statichuwa applikat għall- .dropdownkontenitur.
Metodi
Metodu
Deskrizzjoni
$().dropdown('toggle')
Jiddawwar il-menu dropdown ta' navbar partikolari jew ta' navigazzjoni bit-tabbed.
$().dropdown('show')
Juri l-menu dropdown ta' navbar partikolari jew ta' navigazzjoni bit-tabbed.
$().dropdown('hide')
Jaħbi l-menu dropdown ta' navbar partikolari jew ta' navigazzjoni bit-tabbed.
$().dropdown('update')
Taġġorna l-pożizzjoni ta' dropdown ta' element.
$().dropdown('dispose')
Jeqred id-dropdown ta' element.
Avvenimenti
L-avvenimenti kollha dropdown huma sparati fuq l .dropdown-menu-element ġenitur ta '' u għandhom relatedTargetproprjetà, li l-valur tagħha huwa l-element ta 'ankra toggling. hide.bs.dropdownu l- hidden.bs.dropdownavvenimenti għandhom clickEventproprjetà (biss meta t-tip ta' avveniment oriġinali huwa click) li fih Oġġett ta' Avveniment għall-avveniment tal-ikklikkja.
Avveniment
Deskrizzjoni
show.bs.dropdown
Dan l-avveniment jispara immedjatament meta jissejjaħ il-metodu tal-ispettaklu.
shown.bs.dropdown
Dan l-avveniment jiġi sparat meta l-dropdown tkun saret viżibbli għall-utent (se tistenna għal transizzjonijiet CSS, biex jitlestew).
hide.bs.dropdown
Dan l-avveniment jiġi sparat immedjatament meta l-metodu tal-istanza taħbi jkun ġie msejjaħ.
hidden.bs.dropdown
Dan l-avveniment jiġi sparat meta l-dropdown ikun lest jiġi moħbi mill-utent (se jistenna għal transizzjonijiet CSS, biex jitlestew).