Scoránaigh forleagain comhthéacsúla chun liostaí nasc agus tuilleadh a thaispeáint leis an mbreiseán anuas Bootstrap.
Forbhreathnú
Is forleagan comhthéacsúla in-scoránaithe iad anuas chun liostaí nasc agus go leor eile a thaispeáint. Déantar iad idirghníomhach leis an mbreiseán JavaScript anuas Bootstrap atá san áireamh. Déantar iad a scoránaigh trí chliceáil, ní trí hovering; is cinneadh deartha d'aon ghnó é seo .
Tógtar dropdowns ar leabharlann tríú páirtí, Popper.js , a sholáthraíonn suíomh dinimiciúil agus braite radhairc. Bí cinnte popper.min.js a chur san áireamh roimh JavaScript Bootstrap nó úsáid bootstrap.bundle.min.js/ bootstrap.bundle.jsina bhfuil Popper.js. Ní úsáidtear Popper.js chun anuas a shuíomh sna barraí nascleanúna ach mar ní gá suíomh dinimiciúil a dhéanamh.
Sainmhíníonn caighdeán WAI ARIArole="menu" giuirléid iarbhír , ach baineann sé seo go sonrach le biachláir cosúil le feidhmchláir a spreagann gníomhartha nó feidhmeanna. Ní féidir ach míreanna roghchláir, míreanna roghchláir ticbhosca, míreanna roghchláir cnaipe raidió, grúpaí cnaipí raidió, agus fo-roghchláir a bheith i mbiachláir ARIA .
Ar an láimh eile, tá dropdowns Bootstrap deartha le bheith cineálach agus infheidhme ar éagsúlacht cásanna agus struchtúir marcála. Mar shampla, is féidir anuas a chruthú ina bhfuil ionchuir bhreise agus rialuithe foirme, mar réimsí cuardaigh nó foirmeacha logáil isteach. Ar an ábhar sin, ní bhíonn Bootstrap ag súil le (ná cuireann sé leis go huathoibríoch) le haon cheann de na roleagus na aria-tréithe a theastaíonn le haghaidh fíor- roghchláir ARIA . Beidh ar na húdair na tréithe níos sainiúla seo a chur san áireamh iad féin.
Mar sin féin, cuireann Bootstrap tacaíocht ionsuite le haghaidh an chuid is mó de na hidirghníomhaíochtaí caighdeánach roghchlár méarchláir, mar shampla an cumas bogadh trí .dropdown-itemeilimintí aonair ag baint úsáide as na heochracha cúrsóra agus an roghchlár a dhúnadh leis an ESCeochair.
Samplaí
Wrap an scoránaigh anuas (do cnaipe nó nasc) agus an roghchlár anuas laistigh de .dropdown, nó eilimint eile a dhearbhaíonn position: relative;. Is féidir titim anuas a spreagadh ó <a>nó <button>eilimintí a d’oirfeadh níos fearr do do riachtanais ionchasacha.
Cnaipe singil
Is féidir aon singil .btna iompú ina scorán anuas le roinnt athruithe marcála. Seo mar is féidir leat iad a chur ag obair le ceachtar den dá <button>eilimint:
Ar an gcaoi chéanna, cruthaigh anuas ar chnaipí scoilte a bhfuil an mharcáil chéanna acu beagnach agus anuas ar chnaipí anuas, ach .dropdown-toggle-splitcuir isteach spásáil cheart timpeall ar an gcúram anuas.
Bainimid úsáid as an rang breise seo chun an cothrománach paddingar gach taobh den airíoch a laghdú 25% agus bainimid an ceann margin-lefta chuirtear leis le haghaidh anuas cnaipe rialta. Coinníonn na hathruithe breise sin an cúramóir dírithe ar an gcnaipe scoilte agus soláthraíonn siad limistéar buailte de mhéid níos oiriúnaí in aice leis an bpríomhchnaipe.
Go stairiúil níor mhór naisc a bheith in ábhar an roghchláir anuas , ach ní mar sin atá an scéal a thuilleadh le v4. <button>Anois is féidir leat eilimintí a úsáid go roghnach i do liostaí anuas seachas díreach <a>s.
Is féidir leat míreanna anuas neamh-idirghníomhacha a chruthú le .dropdown-item-text. Ná bíodh drogall ort tuilleadh stíle a dhéanamh le CSS saincheaptha nó le fóntais téacs.
De réir réamhshocraithe, tá roghchlár anuas suite go huathoibríoch 100% ón mbarr agus ar an taobh clé dá thuismitheoir. Cuir .dropdown-menu-rightle a .dropdown-menuar dheis ailíniú an roghchlár anuas.
Cinnirí suas! Tá dropdowns suite a bhuíochas do Popper.js (ach amháin nuair a bhíonn siad i mbarra nascleanúna).
Ailíniú sofhreagrach
Más mian leat ailíniú sofhreagrach a úsáid, díchumasaigh suíomh dinimiciúil tríd an data-display="static"tréith a chur leis agus úsáid na ranganna éagsúlachta sofhreagracha.
Chun an roghchlár anuas a ailíniú ar dheis.dropdown-menu{-sm|-md|-lg|-xl}-right leis an brisphointe tugtha nó níos mó, cuir .
Chun an roghchlár anuas a ailíniú ar chlé.dropdown-menu-right leis an brisphointe tugtha nó níos mó, cuir leis agus .dropdown-menu{-sm|-md|-lg|-xl}-left.
Tabhair faoi deara nach gá duit data-display="static"aitreabúid a chur le cnaipí anuas i mbarraí nascleanúna, ós rud é nach n-úsáidtear Popper.js i mbarraí nascleanúna.
Ábhar an roghchláir
Ceanntásca
Cuir ceanntásc leis chun codanna de ghníomhartha a lipéadú in aon roghchlár anuas.
Cuir téacs saorfhoirme ar bith laistigh de roghchlár anuas le téacs agus bain úsáid as fóntais spásála . Tabhair faoi deara gur dócha go mbeidh stíleanna breise méide uait chun leithead an roghchláir a shrianadh.
Roinnt téacs samplach atá ag sreabhadh go saor laistigh den roghchlár anuas.
Agus is téacs samplach níos mó é seo.
Foirmeacha
Cuir foirm laistigh de roghchlár anuas, nó cuir isteach i roghchlár anuas í, agus úsáid fóntais corrlaigh nó stuála chun an spás diúltach atá uait a thabhairt dó.
Trí shaintréithe sonraí nó JavaScript, scorálann an breiseán anuas ábhar i bhfolach (roghchláir anuas) tríd an .showrang a scoránaigh ar mhír liosta na dtuismitheoirí. Bítear ag brath ar an data-toggle="dropdown"tréith chun roghchláir anuas a dhúnadh ag leibhéal feidhmchláir, mar sin is smaoineamh maith é a úsáid i gcónaí.
Ar ghléasanna tadhaill-chumasaithe, cuireann oscailt anuas láimhseálaithe folamh ( $.noop) le leanaí díreacha na heiliminte. Tá an hack seo atá gránna admhaigh riachtanach chun oibriú timpeall ar chorraíl i dtoscaireacht imeachta iOS , rud a chuirfeadh cosc ar sconna áit ar bith lasmuigh den anuas as an gcód a dhúnann an anuas a spreagadh. Nuair a dhúntar an anuas, baintear na láimhseálaithe breise folamh seo.mouseover<body>mouseover
Trí tréithe sonraí
Cuir data-toggle="dropdown"le nasc nó cnaipe chun anuas a scoránaigh.
Trí JavaScript
Cuir glaoch ar na anuas trí JavaScript:
data-toggle="dropdown"fós ag teastáil
Is cuma cé acu a ghlaonn tú ar do anuas trí JavaScript nó ina ionad sin go n-úsáideann tú an data-api, ní mór duit data-toggle="dropdown"a bheith i láthair i gcónaí ar eilimint truicir an anuas.
Roghanna
Is féidir roghanna a chur ar aghaidh trí tréithe sonraí nó JavaScript. Maidir le tréithe sonraí, cuir ainm na rogha i gceangal le data-, mar atá i data-offset="".
Ainm
Cineál
Réamhshocrú
Cur síos
fhritháireamh
uimhir | teaghrán | feidhm
0
Fritháireamh an anuas i gcoibhneas lena sprioc.
Nuair a úsáidtear feidhm chun an fritháireamh a chinneadh, tugtar é le réad ina bhfuil na sonraí fritháirimh mar a chéad argóint. Caithfidh an fheidhm rud a thabhairt ar ais leis an struchtúr céanna. Ritear an nód DOM na heiliminte spreagúla mar an dara argóint.
Le haghaidh tuilleadh faisnéise déan tagairt do dhoiciméid fhritháireamh Popper.js .
smeach
Boole
fíor
Ceadaigh Dropdown a smeach i gcás forluí ar an eilimint tagartha. Le haghaidh tuilleadh eolais féach ar dhoiciméid smeach Popper.js .
teorainn
teaghrán | eilimint
'scrollParent'
Teorainn shrianta thar maoil an roghchláir anuas. Glacann sé le luachanna 'viewport', 'window', 'scrollParent', nó tagairt HTMLElement (JavaScript amháin). Le haghaidh tuilleadh faisnéise déan tagairt do dhoiciméid preventOverflow Popper.js .
tagairt
teaghrán | eilimint
'scoránaigh'
Gné thagartha den roghchlár anuas. Glacann sé le luachanna 'toggle', 'parent', nó tagairt HTMLElement. Le haghaidh tuilleadh faisnéise déan tagairt do dhoiciméid tagarthaObject Popper.js .
taispeáint
teaghrán
'dinimiciúil'
De réir réamhshocraithe, úsáidimid Popper.js le haghaidh suíomh dinimiciúil. Díchumasaigh é seo le static.
popperConfig
null | réad
null
Chun cumraíocht réamhshocraithe Bootstrap Popper.js a athrú, féach cumraíocht Popper.js
Tabhair faoi deara nuair boundarya shocraítear ar aon luach seachas 'scrollParent', cuirtear an stíl position: statici bhfeidhm ar an .dropdowngcoimeádán.
Modhanna
Modh
Cur síos
$().dropdown('toggle')
Scoránaigh an roghchlár anuas de bharra nascleanúna nó nascleanúna cluaisíní tugtha.
$().dropdown('show')
Taispeáin an roghchlár anuas de bharra nav nó nascleanúint cluaisíní tugtha.
$().dropdown('hide')
Folaigh an roghchlár anuas de bharra nav nó nascleanúint cluaisín tugtha.
$().dropdown('update')
Nuashonraítear suíomh anuas gné.
$().dropdown('dispose')
Scriosann sé anuas eilimint.
Imeachtaí
Déantar na himeachtaí anuas go léir a bhriseadh ag an .dropdown-menumáthaireilimint agus tá relatedTargetmaoin acu, arb é a luach an eilimint ancaire scoránaithe. hide.bs.dropdownagus hidden.bs.dropdowntá clickEventairí ag imeachtaí (ach amháin nuair is é an cineál imeachta bunaidh click) ina bhfuil Réad Imeachta don imeacht cliceáil.
Imeacht
Cur síos
show.bs.dropdown
Teann an teagmhas seo láithreach nuair a ghlaoitear an modh ásc taispeána.
shown.bs.dropdown
Tá an teagmhas seo bréan nuair a bheidh an anuas infheicthe ag an úsáideoir (fanacht le haghaidh aistrithe CSS, le cur i gcrích).
hide.bs.dropdown
Cuirtear an teagmhas seo ar ceal láithreach nuair a ghlaoitear an modh um shampla seithí.
hidden.bs.dropdown
Tá an teagmhas seo bréan nuair a bheidh an anuas críochnaithe a bheith i bhfolach ar an úsáideoir (fanacht le haghaidh aistrithe CSS, a chur i gcrích).