Ampifamadiho ny overlay contextual amin'ny fampisehoana lisitry ny rohy sy ny maro hafa miaraka amin'ny plugin bootstrap dropdown.
Overview
Ny dropdowns dia azo toggle, overlay contextual mba hampisehoana ny lisitry ny rohy sy ny maro hafa. Izy ireo dia natao hifaneraserana miaraka amin'ny plugin Bootstrap dropdown JavaScript. Avadika amin'ny alalan'ny fanindriana izy ireo, fa tsy amin'ny fanodinkodinana; Fanapahan - kevitra noforonina izany .
Ny dropdowns dia naorina amin'ny tranomboky an'ny antoko fahatelo, Popper.js , izay manome toerana mavitrika sy fijerena ny seranan-tsambo. Aza hadino ny mampiditra popper.min.js alohan'ny Bootstrap's JavaScript na mampiasa bootstrap.bundle.min.js/ bootstrap.bundle.jsizay misy Popper.js. Popper.js dia tsy ampiasaina amin'ny fametrahana ny dropdowns amin'ny navbars na dia tsy ilaina aza ny fametrahana dynamic.
Raha manorina JavaScript avy amin'ny loharano ianao dia mitakyutil.js .
Accessibility
Ny fenitry ny WAI ARIA dia mamaritra ny role="menu"widget tena izy , saingy manokana amin'ny menus mitovy amin'ny fampiharana izay miteraka hetsika na asa. Ny menio ARIA dia tsy afaka mirakitra afa-tsy ireo singa sakafo, ireo singa ao amin'ny boaty fisavana, ireo singa amin'ny sakafo bokotra radio, ireo vondrona bokotra radio ary ireo zana-meno.
Ny fampidinana an'i Bootstrap kosa dia natao ho an'ny ankapobeny sy azo ampiharina amin'ny toe-javatra isan-karazany sy rafitra marika. Ohatra, azo atao ny mamorona dropdown izay misy fampidirana fanampiny sy fanaraha-maso ny endrika, toy ny sahan-karoka na ny endrika fidirana. Noho izany antony izany, Bootstrap dia tsy manantena (na manampy ho azy) ny iray amin'ireo roletoetra aria-ilaina amin'ny menu ARIA marina . Ny mpanoratra dia tsy maintsy mampiditra ireo toetra manokana ireo ny tenany.
Na izany aza, ny Bootstrap dia manampy fanohanana natsangana ho an'ny ankamaroan'ny fifandraisana amin'ny sakafo fitendry mahazatra, toy ny fahafahana mivezivezy amin'ny .dropdown-itemsinga tsirairay amin'ny fampiasana ny fanalahidin'ny cursor ary manidy ny sakafo amin'ny ESCfanalahidy.
OHATRA
Fenoy ny toggle an'ny dropdown (ny bokotra na ny rohinao) sy ny menio midina ao anaty .dropdown, na singa hafa manambara position: relative;. Ny dropdowns dia azo avy amin'ny singa <a>na <button>singa mba hifanaraka tsara kokoa amin'ny zavatra ilainao.
bokotra tokana
Ny singa .btntsirairay dia azo avadika ho toggle midina miaraka amin'ny fanovana marika. Ity ny fomba ahafahanao mampiasa azy ireo amin'ny <button>singa roa:
Ny votoatin'ny menio midina ara-tantara dia tokony ho rohy, saingy tsy izany intsony no mitranga amin'ny v4. Ankehitriny ianao dia afaka mampiasa <button>singa ao amin'ny dropdowns fa tsy <a>s fotsiny.
Amin'ny alàlan'ny default, apetraka ho azy 100% avy any ambony sy eo amin'ny ilany havia amin'ny ray aman-dreniny ny menio midina. Ampio .dropdown-menu-rightamin'ny .dropdown-menurindran-kavanana ny menio midina.
Fampitandremana! Ny dropdowns dia napetraka noho ny Popper.js (afa-tsy rehefa voarakitra ao anaty navbar).
Fandrindrana mamaly
Raha te-hampiasa alignment responsive ianao dia esory ny toerana dynamique amin'ny alàlan'ny fampidirana ilay data-display="static"toetra ary ampiasao ny kilasy fanovana valiny.
Mba hampifanitsiana havanana ny menio midina miaraka amin'ny teboka tapaka nomena na lehibe kokoa, ampio .dropdown-menu{-sm|-md|-lg|-xl}-right.
Mba hampifanitsiana ny menio midina ankavia.dropdown-menu-right amin'ny teboka tapaka nomena na lehibe kokoa, ampio ary .dropdown-menu{-sm|-md|-lg|-xl}-left.
Mariho fa tsy mila manampy data-display="static"toetra ianao amin'ny bokotra midina ao amin'ny navbars, satria Popper.js dia tsy ampiasaina amin'ny navbars.
Ny votoatin'ny menu
lohapejy
Manampia lohapejy hanamarihana ny ampahan'ny hetsika amin'ny menio midina.
Apetraho ao anatin'ny menio midina miaraka amin'ny lahatsoratra ary ampiasao ny fampiasan'ny spacing . Mariho fa mety mila fomba fandrefesana fanampiny ianao mba hanerena ny sakan'ny menio.
Ohatra sasantsasany izay mikoriana maimaim-poana ao amin'ny menio midina.
Ary ity dia lahatsoratra ohatra bebe kokoa.
teny
Asio endrika iray ao anatin'ny menio midina, na ataovy ao anaty menio midina, ary ampiasao ny fampiasa amin'ny sisiny na padding mba hanomezana azy ny toerana ratsy ilainao.
Amin'ny alàlan'ny toetran'ny data na JavaScript, ny plugin fidinana dia mamadika votoaty miafina (meno midina) amin'ny alàlan'ny fanodina ny .showkilasy amin'ny lisitry ny ray aman-dreny. Ny data-toggle="dropdown"toetra dia iankinana amin'ny fanakatonana ny menio midina amin'ny ambaratonga fampiharana, noho izany dia tsara ny mampiasa azy foana.
Amin'ny fitaovana azo ampiasaina amin'ny fikitihana, ny fanokafana ny fidinana dia manampy mpiandraikitra ( $.noop) tsy misy na inona na inona mouseoveramin'ireo ankizy avy hatrany amin'ilay <body>singa. Ity hack tena ratsy ekena ity dia ilaina amin'ny fampandehanana ny quirk amin'ny delegasiona hetsika iOS , izay raha tsy izany dia manakana ny paompy na aiza na aiza ivelan'ny dropdown tsy hiteraka ny code izay manidy ny dropdown. Rehefa mihidy ny mouseoverfidinana dia esorina ireo mpikirakira poakaty fanampiny ireo.
Amin'ny alàlan'ny data attributes
Ampio data-toggle="dropdown"amin'ny rohy na bokotra iray mba hivezivezena ny fidina.
Amin'ny JavaScript
Antsoy amin'ny alalan'ny JavaScript ny dropdowns:
data-toggle="dropdown"mbola takiana
Na inona na inona miantso ny fidinao amin'ny JavaScript ianao na mampiasa ny data-api, data-toggle="dropdown"dia tsy maintsy misy foana ny singa trigger an'ny dropdown.
FANDIKANA
Ny safidy dia azo alefa amin'ny alàlan'ny toetran'ny data na JavaScript. Ho an'ny toetran'ny data, ampidiro amin'ny data-, toy ny ao amin'ny data-offset="".
Rehefa ampiasaina hamaritana ny offset ny asa iray, dia antsoina miaraka amin'ny zavatra misy ny data offset ho tohan-kevitra voalohany. Ny asa dia tsy maintsy mamerina zavatra mitovy rafitra. Ny node DOM node dia alefa ho tohan-kevitra faharoa.
Raha mila fanazavana fanampiny dia jereo ny Popper.js's offset docs .
Atsimbadiho
boolean
marina
Avelao hihodina ny Dropdown raha sendra misy mifanipaka amin'ny singa fanondro. Raha mila fanazavana fanampiny dia jereo ny Popper.js's flip docs .
sisin-tany
string | singa
'scrollParent'
Fehezan'ny fihoaram-pefy amin'ny menio midina. Manaiky ny sandan'ny 'viewport', 'window', 'scrollParent', na reference HTMLElement (JavaScript ihany). Raha mila fanazavana fanampiny dia jereo ny Popper.js's preventOverflow docs .
Reference
string | singa
'toggle'
Singa fanondro amin'ny menio midina. Manaiky ny sandan'ny 'toggle', 'parent', na reference HTMLElement. Raha mila fanazavana fanampiny dia jereo ny Popper.js's referenceObject docs .
Mariho rehefa boundaryapetraka amin'ny sanda hafa ankoatra ny 'scrollParent', ny fomba position: staticdia ampiharina amin'ny .dropdownfitoeran-javatra.
fomba
FOMBA
Description
$().dropdown('toggle')
Manova ny menio fidinan'ny navbar nomena na navigateur misy tabilao.
$().dropdown('show')
Mampiseho ny menio midina amin'ny navbar nomena na navigateur misy tabilao.
$().dropdown('hide')
Manafina ny menio midina amin'ny navbar nomena na navigateur misy tabilao.
$().dropdown('update')
Manavao ny toeran'ny fidinan'ny singa iray.
$().dropdown('dispose')
Manimba ny fidinan'ny singa iray.
zava-mitranga
Ny hetsika fidinana rehetra dia alefa amin'ny .dropdown-menusinga ray aman-dreny ary manana relatedTargetfananana, izay singa vatofantsika mifamadika ny sandany. hide.bs.dropdownary hidden.bs.dropdownny hetsika dia manana clickEventfananana (raha ny karazana hetsika tany am-boalohany dia click) izay misy zava-mitranga ho an'ny hetsika kitihina.