Bobongola ba superpositions contextuelles mpo na kolakisa ba liste ya ba liens mpe mingi na plugin ya kokita ya Bootstrap.
Botali ya mozindo
Ba dropdowns ezali toggleable, ba overlays contextuels mpo na kolakisa ba liste ya ba liens mpe mingi mosusu. Bazali kosala interactive na plugin ya JavaScript oyo ezali kokita ya Bootstrap oyo ezali na kati. Bazali ko toggled na ko cliquer, na ko hover te; oyo ezali ekateli ya kosala na mokano .
Ba dropdowns etongami na bibliothèque ya troisième partie, Popper.js , oyo epesaka positionnement dynamique mpe détection ya port de vue. Sala makasi otia popper.min.js liboso ya JavaScript ya Bootstrap to salela bootstrap.bundle.min.js/ bootstrap.bundle.jsoyo ezali na Popper.js. Popper.js esalelamaka te mpo na ko positionner ba dropdowns na ba navbars atako lokola positionnement dynamique esengeli te.
Soki ozali kotonga JavaScript na biso uta na source, esengiutil.js .
Kozala na makoki ya kozwa yango
Norme WAI ARIA elimboli role="menu"widget ya solo , kasi oyo ezali ya sikisiki na ba menu lokola ya bosaleli oyo ebandisaka misala to misala. Ba menu ya ARIA ekoki kozala kaka na biloko ya menu, biloko ya menu ya case ya kotiya elembo, biloko ya menu ya bouton ya radio, bituluku ya bouton ya radio, mpe ba sous-menu.
Ba dropdowns ya Bootstrap, na ngambo mosusu, esalemi mpo na kozala générique mpe ekoki kosalelama na ba situations ndenge na ndenge mpe na ba structures ya marquage. Na ndakisa, ezali na nzela ya kosala ba dropdowns oyo ezali na ba entrées ya kobakisa mpe ba contrôles ya formulaire, lokola ba champs ya recherche to ba formulaires ya login. Mpo na ntina oyo, Bootstrap ezali kozela te (to kobakisa na ndenge ya automatique) moko ya rolempe aria-bizaleli oyo esengeli mpo na ba menu ya solosolo ya ARIA . Bakomi bakosengela kokɔtisa bango moko bizaleli wana ya sikisiki mingi.
Kasi, Bootstrap ebakisi lisungi oyo etongami na kati mpo na mingi ya boyokani ya menu ya klaviatware ya momesano, lokola makoki ya kotambola na kati ya .dropdown-itembiloko mokomoko na kosaleláká bafungola ya kursɛrɛ mpe kokanga menu na ESCfungola.
Bandakisa
Envelopper toggle ya dropdown (bouton to lien na yo) mpe menu ya dropdown na kati ya .dropdown, to élément mosusu oyo esakoli position: relative;. Ba dropdowns ekoki kozala déclenché à partir ya <a>to <button>ba éléments mpo na ko correspondre malamu na ba besoins na yo potentiels.
Bouton moko
Single nyonso .btnekoki kobongwana na toggle ya kokita na mwa mbongwana ya bilembo. Tala ndenge okoki kotia bango na mosala na ba <button>éléments moko to mosusu:
Ndenge moko mpe, sala ba dropdowns ya bouton split na marque presque moko na ba dropdowns ya bouton moko, kasi na kobakisa ya .dropdown-toggle-splitmpo na espacement malamu zingazinga ya caret ya dropdown.
Tosalelaka kelasi oyo ya likolo mpo na kokitisa horizontal paddingna ngambo nyonso mibale ya caret na 25% mpe kolongola margin-leftoyo ebakisami mpo na ba déroulants ya bouton ya mbala na mbala. Mbongwana wana ya kobakisa ebatelaka caret na katikati na bouton ya kokabola mpe epesaka esika ya kobɛta oyo ezali na bonene oyo ebongi mpenza pembeni ya bouton monene.
Historiquement ba contenus ya menu déroulant esengelaki ezala ba liens, mais ezali lisusu bongo te na v4. Sikoyo okoki kosalela optionnellement ba <button>éléments na ba dropdowns na yo au lieu ya kaka <a>s.
Okoki mpe kosala biloko ya kokita oyo ezali na boyokani te na .dropdown-item-text. Bozala na bonsomi ya kosala style lisusu na ba utilitaires ya CSS to ya texte personnalisé.
Na ndenge ya libela, menu oyo ezali kokita ezali kotyama automatiquement 100% kobanda na likoló mpe na ngámbo ya lobɔkɔ ya mwasi ya moboti na yango. Bakisa .dropdown-menu-rightna a .dropdown-menuna droite aligner menu oyo ezali kokita.
Mitó likoló! Ba dropdowns e positionné grâce na Popper.js (sauf soki ezali na kati ya navbar).
Alignment oyo ezo répondre
Soki olingi kosalela alignment responsive, désactiver positionnement dynamique na kobakisa data-display="static"attribut mpe salela ba classes ya variation responsive.
Mpo na kosala boyokani na lobɔkɔ ya mobali na menu oyo ezali kokita na esika oyo bapesi to oyo eleki monene, bakisá .dropdown-menu{-sm|-md|-lg|-xl}-right.
Mpo na kosala ete menu oyo ezali kokita na lobɔkɔ ya mwasi na esika oyo bapesi to oyo eleki monene, bakisa .dropdown-menu-rightmpe .dropdown-menu{-sm|-md|-lg|-xl}-left.
Yeba ete osengeli te kobakisa data-display="static"attribut na ba boutons ya kokita na ba navbars, lokola Popper.js esalelamaka te na ba navbars.
Makambo oyo ezali na menu
Mitó ya makambo
Bakisa motó mpo na kotya bilembo na biteni ya misala na menu nyonso oyo ezali kokita.
Tia makomi nyonso ya forme libre na kati ya menu ya kokita na makomi mpe salelá ba utilitaires ya esika ya kofanda . Yebá ete okozala mbala mosusu na mposa ya mitindo mosusu ya kopesa bonene mpo na kopekisa bonene ya menu.
Mokanda moko ya ndakisa oyo ezali koleka na bonsomi na kati ya menu oyo ezali kokita.
Mpe oyo ezali makomi ya ndakisa mingi koleka.
Baformilɛrɛ
Tia formulaire moko na kati ya menu oyo ezali kokita, to sala yango na menu oyo ezali kokita, mpe salelá ba utilitaires ya marge to ya padding mpo na kopesa yango esika ya mabe oyo osengeli na yango.
Na nzela ya ba attributs ya ba données to JavaScript, plugin oyo ezali kokita ebalusaka makambo oyo ebombami (ba menu oyo ezali kokita) na kobongola .showkelasi na eloko ya liste ya baboti. Attribut data-toggle="dropdown"etie motema mpo na kokanga ba menu ya kokita na niveau ya application, yango wana ezali likanisi malamu kosalela yango ntango nyonso.
Na ba appareils oyo ekoki ko toucher, kofungola dropdown ebakisi ba handlers ya pamba ( $.noop) na bana ya mbala moko ya élément. This admittedly ugly hack is necessary to work around a quirk in iOS’ event delegation , oyo soki te elingaki kopekisa robinet esika nyonso libanda ya dropdown e déclencher code oyo ekanga dropdown. Soki kaka dropdown ekangami, ba handlers oyo ya pamba ya kobakisa elongolamaka.mouseover<body>mouseover
Na nzela ya ba attributs ya ba données
Bakisa data-toggle="dropdown"na lien to na bouton mpo na kobongola esika oyo ezali kokita.
Na nzela ya JavaScript
Benga ba dropdowns na nzela ya JavaScript:
data-toggle="dropdown"esɛngami naino
Indépendamment soki obengi dropdown na yo na nzela ya JavaScript to na esika na yango kosalela data-api, data-toggle="dropdown"esengeli ntango nyonso kozala présent na élément déclencheur ya dropdown.
Makambo oyo okoki kopona
Ba options ekoki koleka na nzela ya ba attributs ya ba données to JavaScript. Mpo na ba attributs ya ba données, bakisa kombo ya option na data-, lokola na data-offset="".
Nkombo
Lolenge
Mbeba
Ndimbola
offset ya kosala
motango | molongo ya molongo | mosala
0.
Offset ya dropdown par rapport na cible na yango.
Tango fonction esalelami pona koyeba offset, ebengami na objet oyo ezali na ba données ya offset lokola argument na yango ya liboso. Fonction esengeli kozongisa eloko oyo ezali na structure moko. Node DOM ya élément déclencheur eleki lokola argument ya mibale.
Mpo na koyeba makambo mingi tala Docs ya offset ya Popper.js .
kobalusa
boolean
ya solo
Tika Dropdown ebalusa na cas ya superposition na élément ya référence. Mpo na koyeba makambo mingi tala na flip docs ya Popper.js .
ndelo ya mboka
molongo ya molongo | eloko
'moboti ya défilement'.
Frontière ya contrainte ya débordement ya menu oyo ezali kokita. Endimi motuya ya 'viewport', 'window', 'scrollParent', to référence ya HTMLElement (JavaScript kaka). Mpo na koyeba makambo mingi tala ba docs ya preventOverflow ya Popper.js .
referansi
molongo ya molongo | eloko
'toggle'.
Elemento ya référence ya menu oyo ezali kokita. Endimi motuya ya 'toggle', 'parent', to référence ya HTMLElement. Mpo na koyeba makambo mingi tala Docs ya referenceObject ya Popper.js .
kolakisa
shene
'dynamique'.
Par défaut, tosalelaka Popper.js pona positionnement dynamique. Désactiver oyo na static.
Yeba ntango boundaryetiamaki na motuya mosusu longola se 'scrollParent', lolenge position: staticesalelami na eloko ya .dropdownkobomba.
Ba méthodes ya kosala
Metode
Ndimbola
$().dropdown('toggle')
Ezali kobongola menu oyo ezali kokita ya navbar to navigation oyo ezali na onglet oyo epesami.
$().dropdown('show')
Ezali kolakisa menu oyo ezali kokita ya navbar to navigation oyo ezali na onglet oyo epesami.
$().dropdown('hide')
Ebombaka menu oyo ezali kokita ya navbar to navigation oyo ezali na onglet oyo epesami.
$().dropdown('update')
Ezali kosala mikolo oyo position ya dropdown ya élément moko.
$().dropdown('dispose')
Ebebisaka dropdown ya élément moko.
Makambo oyo esalemaki
Ba événements nionso ya dropdown ezo betama na .dropdown-menuélément parent ya 's pe eza na relatedTargetpropriété, oyo valeur na yango eza élément anchor toggling. hide.bs.dropdownmpe hidden.bs.dropdownmakambo ezali na clickEventbozwi (kaka ntango lolenge ya likambo ya ebandeli ezali click) oyo ezali na Objet ya Likambo mpo na likambo ya kofina.
Likambo
Ndimbola
show.bs.dropdown
Evenement oyo ezo beta mbala moko tango méthode ya instance ya kolakisa ebengami.
shown.bs.dropdown
Evenement oyo ezo beta tango dropdown esalemi komonana na mosaleli (ekozela ba transitions ya CSS, mpo esila).
hide.bs.dropdown
Evenement oyo ezo beta mbala moko tango méthode ya instance ya kobomba ebengami.
hidden.bs.dropdown
Evenement oyo ezo beta tango dropdown esili kobombama na mosaleli (ekozela ba transitions ya CSS, mpo esila).