Fetoša dikhupetšo tša diteng bakeng sa go bontšha mananeo a dikgokagano le tše dingwe ka polaka ya go theoga ya Bootstrap.
Kakaretšo
Di-dropdown di ka fetošwa, di-overlay tša diteng tša go bontšha mananeo a dikgokagano le tše dingwe. Di dirilwe gore di be le tirišano ka plugin ya JavaScript ya go theoga ya Bootstrap yeo e akareditšwego. Di fetošwa ka go kgotla, e sego ka go hovering; ye ke phetho ya go hlama yeo e dirilwego ka boomo .
Di-dropdown di agilwe godimo ga bokgobapuku bja mokgatlo wa boraro, Popper.js , yeo e fago maemo a go fetoga le go utolla lefelo la go lebelela. Kgonthišetša gore o akaretša popper.min.js pele ga JavaScript ya Bootstrap goba o diriša bootstrap.bundle.min.js/ bootstrap.bundle.jsyeo e nago le Popper.js. Popper.js ga e šomišwe go bea di-dropdown ka go di-navbar le ge e le go beakanya ga go fetoga ga go nyakege.
Ge e ba o aga JavaScript ya rena go tšwa mothopong, e nyakautil.js .
Phihlelelo
The WAI ARIA standard defines an actual role="menu"widget , eupša se se itšego go dimenu tša go swana le tirišo tšeo di hlohleletšago ditiro goba mešomo. Dimenu tša ARIA di ka ba le fela diaetheme tša thepo, diaetheme tša thepo ya lepokisi la go hlahloba, diaetheme tša thepo ya konope ya radio, dihlopha tša dikonope tša radio, le dimenu tša ka fasana.
Di-dropdown tša Bootstrap, ka lehlakoreng le lengwe, di hlamilwe go ba tša kakaretšo le go šoma maemong a fapa-fapanego le dibopego tša go swaya. Go fa mohlala, go a kgonega go hlama dithepo te di theogago te di nago le ditseno ta tlaleleto le ditaolo ta diforomo, go swana le mafelo a go nyaka goba diforomo ta go tsena. Ka lebaka le, Bootstrap ga e letele (goba go oketša ka go iketla) efe goba efe ya rolele aria-dika tše di nyakegago bakeng sa dimenu tša nnete tša ARIA . Bangwadi ba tla swanelwa ke go akaretša dika tše tše di lebanyago kudu ka bobona.
Le ge go le bjalo, Bootstrap e tlaleletša thekgo ye e agetšwego ka gare ya bontši bja ditirišano tša thepo ya khiiboto ya maemo, go swana le bokgoni bja go sepela ka .dropdown-itemdielemente ka botee ka go šomiša dinotlelo tša khesara le go tswalela thepo ka ESCsenotlelo.
Mehlala
Phuthelela toggle ya go theoga (konope ya gago goba kgokagano) le thepo ya go theoga ka gare ga .dropdown, goba elemente ye nngwe yeo e tsebagatšago position: relative;. Di-dropdown di ka hlohleletša go tšwa <a>goba <button>dielemente go swanela gakaone dinyakwa tša gago tšeo di ka bago gona.
Konopo e le nngwe
Sefe goba sefe se tee se .btnka fetošetšwa go toggle ya go theoga ka diphetogo tše dingwe tša go swaya. Ke kamoo o ka di beago ka gona go šoma ka <button>dielemente tše dingwe le tše dingwe:
Ka mo go swanago, hlama di-dropdown tša konope ya go arogana ka go nyakile go swana le go swaya mo go swanago le go theoga ga konope e tee, eupša ka tlaleletšo ya .dropdown-toggle-splitbakeng sa sekgoba se se swanetšego go dikologa caret ya go theoga.
Re diriša sehlopha se sa tlaleletšo go fokotša go rapalala paddingka mahlakoreng ka bobedi a caret ka 25% le go tloša margin-leftseo se okeditšwego bakeng sa di-dropdown tša konope tša ka mehla. Diphetogo tšeo tše oketšegilego di boloka caret e tsepame konotswaneng yeo e arotšwego gomme e nea lefelo la go otla leo le nago le bogolo bjo bo swanetšego kudu kgaufsi le konotswana e kgolo.
Go ya ka histori dikagare tša thepo ya go theoga di be di swanetše go ba dikgokagano, eupša seo ga se sa le bjalo ka v4. Bjale o ka šomiša ka boikgethelo <button>dielemente ka go dithepo tša gago go e na le <a>s fela.
O ka hlama gape diaetheme tša go theoga tšeo e sego tša tirišano ka .dropdown-item-text. Ikwe o lokologile go setaele go ya pele ka CSS ya tlwaelo goba didirišwa tša sengwalwa.
Ka go ikemela, thepo ya go theoga e bewa ka go iketla 100% go tšwa godimo le go bapa le lehlakore la nngele la motswadi wa yona. Oketša .dropdown-menu-rightgo a go ya .dropdown-menugo le letona logaganya thepo ya go theoga.
Dihlogo godimo! Di-dropdown di bewa ka lebaka la Popper.js (ntle le ge di le ka gare ga navbar).
Go logaganya mo go arabelago
Ge o nyaka go šomiša go logaganya ga go arabela, šitiša go beakanya maemo ka go oketša data-display="static"seka gomme o šomiše diklase tša phapano ya go arabela.
Go logaganya ka go le letona thepo ya go theoga le ntlha ya go kgaotša ye e filwego goba ye kgolo, oketša .dropdown-menu{-sm|-md|-lg|-xl}-right.
Go logaganya thepo ya go theoga ya le letshadi.dropdown-menu-right le ntlha ya go kgaotša ye e filwego goba ye kgolo, oketša le .dropdown-menu{-sm|-md|-lg|-xl}-left.
Hlokomela gore ga o hloke go oketša data-display="static"seka go dikonope tša go theoga ka go di-navbar, ka ge Popper.js e sa šomišwe ka go di-navbar.
Diteng tša menu
Dihlogo tša dihlogo
Oketša hlogo go leina dikarolo tša ditiro ka go thepo efe goba efe ya go theoga.
Bea sengwalwa sefe goba sefe sa sebopego sa go se lefelwe ka gare ga thepo ya go theoga ka sengwalwa gomme o šomiše didirišwa tša sekgoba . Hlokomela gore go na le kgonagalo ya gore o tla nyaka mekgwa ya tlaleletšo ya go lekanyetša bogolo go thibela bophara bja thepo.
Sengwalwa se sengwe sa mohlala seo se elelago ka bolokologi ka gare ga thepo ya go theoga.
Gomme se ke sengwalwa sa mohlala kudu.
Diforomo
Bea foromo ka gare ga thepo ya go theoga, goba o e dire gore e be thepo ya go theoga, gomme o šomiše didirišwa tša mošito goba tša go tlatša go e fa sekgoba se sebe seo o se nyakago.
Ka dika tša datha goba JavaScript, polaka ya go theoga e fetoša diteng tše di utilwego (dimenu tša go theoga) ka go fetoša .showsehlopha go aetheme ya lenaneo la motswadi. Sebopego data-toggle="dropdown"se ithekgile ka go tswalela dimenu tša go theoga maemong a tirišo, ka fao ke kgopolo ye botse go se šomiša ka mehla.
Go didirišwa tšeo di kgontšhitšwego ka go kgoma, go bula selo sa go theoga go oketša didirišwa tša go swara tše di se nago selo ( $.noop) mouseovergo bana ba kgaufsi ba <body>elemente. This admittedly ugly hack is necessary to work around a quirk in iOS’ event delegation , e leng ka tsela e nngwe e ne e tla thibela pompo kae kapa kae ka ntle ho dropdown ho qholotsa khoutu e koala dropdown. Ge go šetše go tswaletšwe, didirišwa tše tša tlaleletšo tše di se nago selo mouseoverdi a tlošwa.
Ka dika ya data
Oketša data-toggle="dropdown"go kgokagano goba konope go fetoša go theoga.
Ka JavaScript
Bitša di-drolodown ka JavaScript:
data-toggle="dropdown"e sa dutše e nyakega
Go sa šetšwe gore o bitša dropdown ya gago ka JavaScript goba go e na le moo o diriša data-api, data-toggle="dropdown"go nyakega ka mehla go ba gona go elemente ya go hlohleletša ya dropdown.
Dikgetho
Dikgetho di ka fetišwa ka dika tša datha goba JavaScript. Bakeng sa dika tša datha, tlaleletša leina la kgetho go data-, bjalo ka go data-offset="".
Leina
Mohuta
Hlokomologa
Tlhalošo
offset
nomoro ya | thapo ya | mošomo
0.
Offset ya dropdown leloko le sepheo lona. Bakeng sa tshedimošo e oketšegilego lebelela Popper.js's offset docs .
phepheula
boolean ya go swana
nnete
Dumelela Dropdown go flip ge go ka ba le go swana godimo ga elemente ya tšhupetšo. Bakeng sa tshedimošo e oketšegilego lebelela Popper.js's flip docs .
mollwane
thapo ya | ntlha
'Motswadi wa go kgokološa'.
Moedi wa thibelo ya go tlala wa thepo ya go theoga. E amogela dikelo tša 'viewport', 'window', 'scrollParent', goba tšhupetšo ya HTMLElement (JavaScript fela). Bakeng sa tshedimošo e oketšegilego lebelela ditokomane tša preventOverflow tša Popper.js .
tšhupetšo
thapo ya | ntlha
'toggle'.
Reference elements ya menu ya go theoga. E amogela dikelo tša 'toggle', 'parent', goba tšhupetšo ya HTMLElement. Bakeng sa tshedimošo ye ntši lebelela ditokomane tša referenceObject tša Popper.js .
bontšha
thapo
'dynamic'.
Ka default, re sebelisa Popper.js bakeng sa boemo ba mafolofolo. Thibela se ka static.
Hlokomela ge boundarye beakantšwe go boleng bjo bongwe le bjo bongwe ntle le 'scrollParent', setaele position: staticse dirišwa go .dropdownsetshelo.
Mekgwa ya go šoma
Mokgwa
Tlhalošo
$().dropdown('toggle')
E fetola thepo ya go theoga ya navbar ye e filwego goba go sepelasepela ga dithepo.
$().dropdown('show')
E bontšha thepo ya go theoga ya navbar ye e filwego goba go sepelasepela ka dithepo.
$().dropdown('hide')
E uta thepo ya go theoga ya navbar ye e filwego goba go sepelasepela ka dithepo.
$().dropdown('update')
E mpshafatša maemo a go theoga ga elemente.
$().dropdown('dispose')
E senya go theoga ga elemente.
Ditiragalo
Ditiragalo ka moka tša go theoga di thuntšhwa go .dropdown-menuelemente ya motswadi ya 's gomme di na le relatedTargetthepa, yeo boleng bja yona e lego elemente ya ankora ya go fetoša. hide.bs.dropdowngomme hidden.bs.dropdownditiragalo di na le clickEventthepa (feela ge mohuta wa tiragalo ya mathomo e le click) yeo e nago le Selo sa Tiragalo sa tiragalo ya go klika.
Tiragalo
Tlhalošo
show.bs.dropdown
Tiragalo ye e thunya ka pela ge mokgwa wa mohlala wa pontšho o bitšwa.
shown.bs.dropdown
Tiragalo ye e thuntšhwa ge go theoga go dirilwe gore go bonagale go modiriši (e tla emela diphetogo tša CSS, go phetha).
hide.bs.dropdown
Tiragalo ye e thuntšhwa ka pela ge mokgwa wa go uta mohlala o biditšwe.
hidden.bs.dropdown
Tiragalo ye e thuntšhwa ge go theoga go feditše go utollwa go tšwa go modiriši (e tla emela diphetogo tša CSS, go phetha).