Aldatu testuinguru-gainjartzeak esteken zerrendak eta gehiago bistaratzeko Bootstrap goitibeherako pluginarekin.
Ikuspegi orokorra
Goitibeherak txandaka daitezke, esteken zerrendak eta gehiago bistaratzeko testuinguruko gainjartzeak. Elkarreragile egiten dira sartutako Bootstrap goitibeherako JavaScript pluginarekin. Klik eginez txandakatzen dira, ez pasatzean; hau nahita diseinatutako erabakia da .
Goitibeherak hirugarrenen liburutegi batean eraikitzen dira, Popper.js , zeinak kokapen dinamikoa eta ikusleihoen detekzioa eskaintzen du. Ziurtatu popper.min.js sartzen duzula Bootstrap-en JavaScript baino lehen edo Popper.js duen bootstrap.bundle.min.js/ erabili. bootstrap.bundle.jsPopper.js ez da erabiltzen goitibehurrak nabigazio-barretan kokatzeko, baina kokapen dinamikoa ez baita beharrezkoa.
Gure JavaScript iturburutik eraikitzen ari bazara, beharrezkoautil.js da .
Bootstrap-en goitibehurrak, berriz, generikoak izan daitezen eta hainbat egoera eta marka-egituretarako aplikagarriak dira. Esate baterako, posible da sarrera gehigarriak eta inprimaki-kontrolak dituzten goitibehurrak sortzea, hala nola bilaketa-eremuak edo saioa hasteko inprimakiak. Hori dela eta, Bootstrap-ek ez du espero (ezta automatikoki gehitzen) benetako ARIA menuetarako beharrezkoak rolediren atributuetarik. Egileek beraiek sartu beharko dituzte atributu zehatzago horiek.aria-
Hala eta guztiz ere, Bootstrap-ek teklatuaren menu-interakzio estandar gehienetarako euskarria gehitzen du, hala nola, .dropdown-itemelementu indibidualetan zehar mugitzeko gaitasuna kurtsore-teklak erabiliz eta menua teklaz ixteko aukera ESC.
Adibideak
Itzulbiratu goitibeherako hautagailua (zure botoia edo esteka) eta goitibeherako menua .dropdown, edo deklaratzen duen beste elementu batean position: relative;. Goitibeherak zure beharretara hobeto egokitzeko elementuetatik abiarazi <a>daitezke .<button>
Botoi bakarra
Edozein single .btngoitibeherako hautagailu bihur daiteke marka-aldaketa batzuekin. Hona hemen bi elementuekin nola jar ditzakezun lanean <button>:
Era berean, sortu zatitutako botoien goitibeherako botoi bakarreko goitibeherako ia marka berdinarekin, baina .dropdown-toggle-splitgoitibeherako ikurraren inguruan tarte egokia gehituta.
Klase gehigarri hau kartaren paddingbi aldeetako horizontala % 25 murrizteko eta margin-leftohiko botoien goitibehetarako gehitzen dena kentzeko erabiltzen dugu. Aldaketa gehigarri horiek ikurra zatitutako botoian erdiratuta mantentzen dute eta botoi nagusiaren ondoan tamaina egokiagoko sakatu-eremua eskaintzen dute.
Historikoki goitibeherako menuaren edukiak estekak izan behar ziren, baina hori ez da jada v4-rekin gertatzen. <button>Orain, aukeran , zure goitibehetako elementuak erabil ditzakezu <a>s-en ordez.
Goitibeherako elementu ez-interaktiboak ere sor ditzakezu .dropdown-item-text. Anima zaitez gehiago estiloa CSS edo testu-utilitate pertsonalizatuekin.
Lehenespenez, goitibeherako menu bat automatikoki kokatzen da % 100ean bere gurasoaren goiko eta ezkerreko aldean. Gehitu .dropdown-menu-righta .dropdown-menueskuinera lerrokatu goitibeherako menua.
Buruak gora! Goitibeherak Popper.js-i esker kokatzen dira (nabigazio-barra batean daudenean izan ezik).
Lerrokadura erantzunkorra
Lerrokatze sentikorra erabili nahi baduzu, desgaitu kokapen dinamikoa data-display="static"atributua gehituz eta erabili aldakuntza klasikoak.
Goitibeherako menua eten puntuarekin edo handiagoarekin eskuinera lerrokatzeko , gehitu .dropdown-menu{-sm|-md|-lg|-xl}-right.
Goitibeherako menua ezkerreko eten puntuarekin edo handiagoarekin lerrokatzeko , gehitu .dropdown-menu-righteta .dropdown-menu{-sm|-md|-lg|-xl}-left.
Kontuan izan ez duzula data-display="static"atributurik gehitu behar goitibeherako botoietan nabigazio-barretan, Popper.js ez baita erabiltzen nabigazio-barretan.
Menuaren edukia
Goiburuak
Gehitu goiburu bat ekintzen atalak etiketatzeko edozein goitibeherako menutan.
Jarri forma libreko edozein testu goitibeherako menu batean testuarekin eta erabili tartekatzeko utilitateak . Kontuan izan ziurrenik tamaina-estilo gehigarriak beharko dituzula menuaren zabalera mugatzeko.
Goitibeherako menuan aske dabilen testu adibide batzuk.
Eta hau testu adibide gehiago da.
Formak
Jarri inprimaki bat goitibeherako menu batean, edo egin goitibeherako menu batean, eta erabili marjina edo betegarri-utilitateak behar duzun espazio negatiboa emateko.
Datu-atributuen edo JavaScript-en bidez, goitibeherako pluginak ezkutuko edukia (goigabeko menuak) aldatzen du .showklasea gurasoen zerrendako elementuan aldatuz. Atributua aplikazio mailan goitibeherako menuak ixteko fidatzen da , data-toggle="dropdown"beraz, komeni da beti erabiltzea.
Ukimenerako gaitutako gailuetan, goitibeherako goitibehitza irekitzeak ( $.noop) kudeatzaile hutsak gehitzen ditu elementuaren mouseoverberehalako seme-alabei . <body>Truke itsusi hau beharrezkoa da iOS-en gertaeraren delegazioan bitxikeriaren inguruan lan egiteko , eta horrek bestela goitibeherako goitibehetik kanpoko edozein tokitan sakatze batek goitibeherako aukera ixten duen kodea abiarazteko eragotziko luke. Goitibehitza itxi ondoren, mouseoverkudeatzaile huts gehigarri hauek kentzen dira.
Datu-atributuen bidez
Gehitu data-toggle="dropdown"esteka edo botoi bati goitibeherako aukera aldatzeko.
JavaScript bidez
Deitu goitibehetara JavaScript bidez:
data-toggle="dropdown"oraindik beharrezkoa
Zure goitibehera JavaScript bidez deitzen duzun edo datu-api-a erabiltzen duzun ala ez, data-toggle="dropdown"beti beharrezkoa da goitibeherako elementu abiarazlean egotea.
Aukerak
Aukerak datu-atributuen edo JavaScript bidez pasa daitezke. Datu-atributuetarako, erantsi aukera-izena data-, hemen bezala data-offset="".
Izena
Mota
Lehenetsia
Deskribapena
desplazamendu
zenbakia | katea | funtzioa
0
Goitibeherako desplazamendua bere xedearekiko.
Desplazamendua zehazteko funtzio bat erabiltzen denean, lehen argumentu gisa desplazamendu-datuak dituen objektu batekin deitzen da. Funtzioak egitura bereko objektu bat itzuli behar du. DOM nodo abiarazteko elementua bigarren argumentu gisa pasatzen da.
Informazio gehiagorako, ikusi Popper.js-en offset docs .
irauli
boolearra
egia
Baimendu Goitibehera iraultzea erreferentziako elementuan gainjartzen bada. Informazio gehiagorako, ikusi Popper.js-en flip docs .
muga
katea | elementua
'ScrollParent'
Goitibeherako menuaren gainezka-murriztapenaren muga. 'viewport', 'window', 'scrollParent', edo HTMLElement erreferentzia baten balioak onartzen ditu (JavaScript soilik). Informazio gehiago lortzeko, ikusi Popper.js-en preventOverflow docs .
erreferentzia
katea | elementua
'aldatu'
Goitibeherako menuko erreferentzia-elementua. 'toggle', 'parent', edo HTMLElement erreferentzia baten balioak onartzen ditu . Informazio gehiago lortzeko, jo Popper.js-en referenceObject docs .
bistaratzea
katea
'dinamikoa'
Lehenespenez, Popper.js erabiltzen dugu kokapen dinamikorako. Desgaitu hau erabiliz static.
Kontuan izan , ez boundaryden beste balio batean ezartzen denean 'scrollParent', estiloa edukiontziari position: staticaplikatzen zaiola..dropdown
Metodoak
Metodoa
Deskribapena
$().dropdown('toggle')
Nabigazio-barra edo fitxen nabigazio baten goitibeherako menua aldatzen du.
$().dropdown('show')
Nabigazio-barra edo fitxen nabigazio baten goitibeherako menua erakusten du.
$().dropdown('hide')
Nabigazio-barra edo fitxen nabigazio baten goitibeherako menua ezkutatzen du.
$().dropdown('update')
Elementu baten goitibeherako posizioa eguneratzen du.
$().dropdown('dispose')
Elementu baten goitibeherako zerrenda suntsitzen du.
Gertaerak
Goitibeherako gertaera guztiak .dropdown-menu' ren elementu nagusian abiarazten dira eta relatedTargetpropietate bat dute, zeinaren balioa txandakatzeko aingura-elementua den. hide.bs.dropdowneta hidden.bs.dropdowngertaerek klik-gertaeraren Gertaera Objektu bat daukan clickEventpropietate bat dute (jatorrizko gertaera mota denean soilik ).click
Gertaera
Deskribapena
show.bs.dropdown
Gertaera hau berehala abiarazten da show instance metodoa deitzen denean.
shown.bs.dropdown
Gertaera hau goitibehitza erabiltzailearentzat ikusgai jartzen denean abiarazten da (CSS trantsizioen zain egongo da osatzeko).
hide.bs.dropdown
Gertaera hau berehala abiarazten da ezkutatzeko instantzia metodoa deitzen denean.
hidden.bs.dropdown
Gertaera hau goitibeherako zerrenda erabiltzaileari ezkutatzen amaitzen denean abiarazten da (CSS trantsizioen zain egongo da amaitzeko).