Skiptu um samhengisyfirlag til að sýna lista yfir tengla og fleira með fellivalmyndinni Bootstrap.
Yfirlit
Hægt er að skipta um fellivalmyndir, samhengisyfirlögn til að birta tenglalista og fleira. Þeir eru gerðir gagnvirkir með meðfylgjandi Bootstrap fellivalmynd JavaScript viðbótinni. Þeim er skipt með því að smella, ekki með því að sveima; þetta er viljandi hönnunarákvörðun .
Dropdowns eru byggðar á þriðja aðila bókasafni, Popper.js , sem veitir kraftmikla staðsetningu og uppgötvun útsýnisglugga. Vertu viss um að hafa popper.min.js á undan Bootstrap JavaScript eða notaðu bootstrap.bundle.min.js/ bootstrap.bundle.jssem inniheldur Popper.js. Popper.js er ekki notað til að staðsetja fellivalmyndir í navbars þó þar sem kraftmikil staðsetning er ekki nauðsynleg.
Ef þú ert að byggja JavaScript okkar frá uppruna, krefstutil.js það .
Aðgengi
WAI ARIA staðallinn skilgreinir raunverulega role="menu"græju , en þetta er sérstakt fyrir forritalíka valmyndir sem kalla fram aðgerðir eða aðgerðir. ARIA valmyndir geta aðeins innihaldið valmyndaratriði, valmyndaratriði gátreitar, valmyndaratriði fyrir valhnappa, valhnappahópa og undirvalmyndir.
Dropdownlistir Bootstrap eru aftur á móti hönnuð til að vera almenn og eiga við margvíslegar aðstæður og álagningaruppbyggingu. Til dæmis er hægt að búa til fellivalmyndir sem innihalda viðbótarinntak og formstýringar, svo sem leitarreitir eða innskráningareyðublöð. Af þessum sökum býst Bootstrap ekki við (né bætir sjálfkrafa við) neinum af roleog aria-eiginleikum sem krafist er fyrir sannar ARIA valmyndir. Höfundar verða sjálfir að láta þessa sértækari eiginleika fylgja með.
Hins vegar bætir Bootstrap við innbyggðum stuðningi fyrir flest venjuleg lyklaborðsvalmyndasamskipti, svo sem möguleikann á að fara í gegnum einstaka .dropdown-itemþætti með því að nota bendilinn og loka valmyndinni með ESCtakkanum.
Dæmi
Vefjið fellivalmyndina (hnappinn þinn eða tengilinn) og fellivalmyndina innan .dropdown, eða annan þátt sem lýsir yfir position: relative;. Hægt er að kveikja á fellivalmyndum frá <a>eða <button>þáttum til að passa betur við hugsanlegar þarfir þínar.
Einn hnappur
Hægt er að breyta hverjum einasta .btní fellivalmynd með nokkrum álagningarbreytingum. Svona geturðu sett þá til að vinna með hvorum <button>þáttunum:
Á sama hátt, búðu til fellivalmyndahnappa með nánast sömu merkingu og fellivalmyndir með einum hnappi, en með því að bæta við .dropdown-toggle-splitfyrir rétt bil í kringum fellilistann.
Við notum þennan aukaflokk til að draga úr láréttu paddinghvoru megin við hornið um 25% og fjarlægja það margin-leftsem er bætt við fyrir venjulegar fellivalmyndir hnappa. Þessar aukabreytingar halda skjánum fyrir miðju í skiptuhnappinum og veita meira viðeigandi stærð höggsvæði við hlið aðalhnappsins.
Sögulega þurfti innihald fellivalmynda að vera tenglar, en það er ekki lengur raunin með v4. Nú geturðu valfrjálst notað <button>þætti í fellilistanum þínum í stað <a>s.
Þú getur líka búið til ógagnvirka fellilista með .dropdown-item-text. Ekki hika við að stíla frekar með sérsniðnum CSS eða textaforritum.
Sjálfgefið er að fellivalmynd er sjálfkrafa staðsett 100% efst og meðfram vinstri hlið foreldris. Bættu .dropdown-menu-rightvið .dropdown-menutil hægri stilltu fellivalmyndina.
Höfuð upp! Fellilistar eru staðsettir þökk sé Popper.js (nema þegar þeir eru í stýristiku).
Móttækileg röðun
Ef þú vilt nota móttækilega röðun skaltu slökkva á kraftmikilli staðsetningu með því að bæta við data-display="static"eigindinni og nota móttækilega afbrigðisflokkana.
Til að stilla fellivalmyndina til hægri.dropdown-menu{-sm|-md|-lg|-xl}-right við tiltekinn brotpunkt eða stærra skaltu bæta við .
Til að samræma fellivalmyndina til vinstri.dropdown-menu-right við tiltekið brotpunkt eða stærra skaltu bæta við og .dropdown-menu{-sm|-md|-lg|-xl}-left.
Athugaðu að þú þarft ekki að bæta data-display="static"eigind við fellivalhnappa í navbars, þar sem Popper.js er ekki notað í navbars.
Innihald valmyndar
Hausar
Bættu við haus til að merkja hluta aðgerða í hvaða fellivalmynd sem er.
Settu hvaða texta sem er í frjálsu formi í fellivalmynd með texta og notaðu biltól . Athugaðu að þú þarft líklega fleiri stærðarstíla til að takmarka breidd valmyndarinnar.
Nokkur dæmi um texta sem flæðir frjálst í fellivalmyndinni.
Og þetta er meira dæmi um texta.
Eyðublöð
Settu eyðublað í fellivalmynd, eða gerðu það í fellivalmynd, og notaðu spássíu eða fyllingu til að gefa því neikvæða plássið sem þú þarfnast.
Í gegnum gagnaeiginleika eða JavaScript breytir fellivalmyndinni falið efni (fellivalmyndir) með því að skipta um .showbekk á yfirliðinu á listanum. Stuðst data-toggle="dropdown"er við eiginleikann til að loka fellivalmyndum á forritastigi, svo það er góð hugmynd að nota hann alltaf.
Á snertivirkum tækjum bætir opnun fellivalmyndar tómum ( $.noop) mouseovermeðhöndlunaraðilum við næstu börn <body>frumefnisins. Þetta óneitanlega ljóta hakk er nauðsynlegt til að vinna í kringum sérkenni í viðburðaútsendingu iOS , sem annars myndi koma í veg fyrir að smellt væri hvar sem er fyrir utan fellilistann kveiki kóðann sem lokar fellilistanum. Þegar fellilistanum er lokað eru þessir tómu mouseovermeðhöndlarar til viðbótar fjarlægðir.
Í gegnum gagnaeiginleika
Bættu data-toggle="dropdown"við tengil eða hnapp til að skipta um fellilista.
Með JavaScript
Hringdu í fellilistana í gegnum JavaScript:
data-toggle="dropdown"enn krafist
Óháð því hvort þú hringir í fellilistann þinn í gegnum JavaScript eða notar þess í stað gagna-api, data-toggle="dropdown"þarf alltaf að vera til staðar á kveikjuhluta fellilistans.
Valmöguleikar
Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-offset="".
Nafn
Tegund
Sjálfgefið
Lýsing
á móti
númer | strengur | virka
0
Jöfnun á fellilistanum miðað við markmið hans.
Þegar fall er notað til að ákvarða offsetið er það kallað með hlut sem inniheldur offset gögnin sem fyrstu rök. Fallið verður að skila hlut með sömu uppbyggingu. Kveikjuþátturinn DOM hnútur er samþykktur sem önnur rök.
Frekari upplýsingar er að finna í offset skjölum Popper.js .
fletta
Boolean
satt
Leyfa fellilistanum að snúa við ef skarast á viðmiðunareiningunni. Nánari upplýsingar er að finna í flip-skjölum Popper.js .
mörk
strengur | þáttur
'scrollParent'
Yfirfallsþvingunarmörk fellivalmyndarinnar. Samþykkir gildin 'viewport', 'window', 'scrollParent', eða HTMLElement tilvísun (aðeins JavaScript). Nánari upplýsingar er að finna í preventOverflow skjölum Popper.js .
tilvísun
strengur | þáttur
'skipta'
Tilvísunarþáttur í fellivalmyndinni. Samþykkir gildi 'toggle', 'parent', eða HTMLElement tilvísun. Fyrir frekari upplýsingar skaltu vísa til Popper.js's referenceObject skjöl .
sýna
strengur
'dynamic'
Sjálfgefið er að við notum Popper.js fyrir kraftmikla staðsetningu. Slökktu á þessu með static.
popperConfig
núll | mótmæla
núll
Til að breyta sjálfgefna Popper.js stillingu Bootstrap, sjáðu stillingar Popper.js
Athugaðu þegar boundaryer stillt á annað gildi en 'scrollParent', stíllinn position: staticer notaður á .dropdownílátið.
Aðferðir
Aðferð
Lýsing
$().dropdown('toggle')
Skiptir á fellivalmynd tiltekinnar siglingastiku eða flipaleiðsögu.
$().dropdown('show')
Sýnir fellivalmynd tiltekinnar siglingastiku eða flipaleiðsögu.
$().dropdown('hide')
Felur fellivalmynd tiltekinnar siglingastiku eða flipaleiðsögu.
$().dropdown('update')
Uppfærir staðsetningu fellilista þáttar.
$().dropdown('dispose')
Eyðir fellivalmynd frumefnis.
Viðburðir
Allir fellilistaviðburðir eru ræstir á .dropdown-menu's parent element og hafa relatedTargeteiginleika, sem gildir er skipta akkeri þáttur. hide.bs.dropdownog hidden.bs.dropdownatburðir hafa clickEventeiginleika (aðeins þegar upprunalega atburðartegundin er click) sem inniheldur atburðarhlut fyrir smelliviðburðinn.
Viðburður
Lýsing
show.bs.dropdown
Þessi atburður ræsir strax þegar sýndartilviksaðferðin er kölluð.
shown.bs.dropdown
Þessi atburður er ræstur þegar fellivalmyndin hefur verið gerð sýnileg notandanum (bíður eftir CSS umskiptum til að ljúka).
hide.bs.dropdown
Þessi atburður er ræstur strax þegar fela tilviksaðferðin hefur verið kölluð.
hidden.bs.dropdown
Þessi atburður er ræstur þegar fellivalmyndinni hefur verið falið fyrir notandanum (bíður eftir CSS umskiptum til að ljúka).