Pārslēdziet kontekstuālos pārklājumus, lai parādītu saišu sarakstus un citus, izmantojot Bootstrap nolaižamo spraudni.
Pārskats
Nolaižamās izvēlnes ir pārslēdzamas, kontekstuāli pārklājumi, lai parādītu saišu sarakstus un daudz ko citu. Tie ir padarīti interaktīvi, izmantojot iekļauto Bootstrap nolaižamo JavaScript spraudni. Tie tiek pārslēgti, noklikšķinot, nevis virzot kursoru; tas ir apzināts dizaina lēmums .
Nolaižamās izvēlnes ir izveidotas, pamatojoties uz trešās puses bibliotēku Popper.js , kas nodrošina dinamisku pozicionēšanu un skata loga noteikšanu. Noteikti iekļaujiet popper.min.js pirms Bootstrap JavaScript vai izmantojiet bootstrap.bundle.min.js/ bootstrap.bundle.jskas satur Popper.js. Popper.js netiek izmantots, lai pozicionētu nolaižamās izvēlnes navigācijas joslās, jo dinamiskā pozicionēšana nav nepieciešama.
WAI ARIA standarts definē faktisko role="menu"logrīku , taču tas attiecas tikai uz lietojumprogrammām līdzīgām izvēlnēm, kas aktivizē darbības vai funkcijas . ARIA izvēlnēs var būt tikai izvēlnes vienumi, izvēles rūtiņu izvēlnes vienumi, radio pogu izvēlnes vienumi, radio pogu grupas un apakšizvēlnes.
No otras puses, Bootstrap nolaižamās izvēlnes ir izstrādātas tā, lai tās būtu vispārīgas un piemērotas dažādām situācijām un iezīmēšanas struktūrām. Piemēram, ir iespējams izveidot nolaižamās izvēlnes, kas satur papildu ievades un veidlapas vadīklas, piemēram, meklēšanas laukus vai pieteikšanās veidlapas. Šī iemesla dēļ Bootstrap neparedz (nedz arī automātiski nepievieno) nevienu no roleun aria-atribūtiem, kas nepieciešami patiesajām ARIA izvēlnēm. Autoriem pašiem būs jāiekļauj šie specifiskākie atribūti.
Tomēr Bootstrap pievieno iebūvētu atbalstu lielākajai daļai standarta tastatūras izvēlņu mijiedarbības, piemēram, iespēju pārvietoties pa atsevišķiem .dropdown-itemelementiem, izmantojot kursora taustiņus, un aizvērt izvēlni ar ESCtaustiņu.
Piemēri
Aptiniet nolaižamās izvēlnes slēdzi (jūsu pogu vai saiti) un nolaižamo izvēlni .dropdownvai citu elementu, kas deklarē position: relative;. Nolaižamās izvēlnes var tikt aktivizētas no <a>vai <button>elementiem, lai labāk atbilstu jūsu potenciālajām vajadzībām.
Viena poga
Jebkuru singlu .btnvar pārvērst par nolaižamo slēdzi, veicot dažas iezīmēšanas izmaiņas. Tālāk ir norādīts, kā varat tos izmantot, izmantojot kādu no <button>elementiem.
Līdzīgi izveidojiet sadalīto pogu nolaižamās izvēlnes ar gandrīz tādu pašu marķējumu kā vienas pogas nolaižamajiem izvēlnēm, taču pievienojot .dropdown-toggle-splitpareizu atstarpi ap nolaižamo sarakstu.
Mēs izmantojam šo papildu klasi, lai par 25% samazinātu horizontālo paddinglīmeni abās pakāpju pusēs un noņemtu margin-leftparasto pogu nolaižamo izvēlni. Šīs papildu izmaiņas saglabā centrējumu sadalīšanas pogā un nodrošina atbilstošāka izmēra trāpījuma apgabalu blakus galvenajai pogai.
Vēsturiski nolaižamās izvēlnes saturam bija jābūt saitēm, taču tas vairs neattiecas uz versiju 4. Tagad nolaižamajos izvēlnēs varat izmantot <button>elementus, nevis tikai <a>s.
Varat arī izveidot neinteraktīvus nolaižamās izvēlnes vienumus, izmantojot .dropdown-item-text. Jūtieties brīvi turpināt stilu, izmantojot pielāgotas CSS vai teksta utilītas.
Pēc noklusējuma nolaižamā izvēlne tiek automātiski novietota 100% no augšdaļas un tās vecākvārda kreisajā pusē. Pievienojiet nolaižamo izvēlni .dropdown-menu-rightlīdzi pa labi..dropdown-menu
Uzmanību! Nolaižamās izvēlnes ir izvietotas, pateicoties Popper.js (izņemot gadījumus, kad tās atrodas navigācijas joslā).
Atsaucīga izlīdzināšana
Ja vēlaties izmantot adaptīvo līdzināšanu, atspējojiet dinamisko pozicionēšanu, pievienojot data-display="static"atribūtu, un izmantojiet adaptīvās variācijas klases.
Lai līdzinātu nolaižamo izvēlni pa labi ar norādīto pārtraukuma punktu vai lielāku, pievienojiet .dropdown-menu{-sm|-md|-lg|-xl}-right.
Lai līdzinātu kreiso nolaižamo izvēlni ar norādīto vai lielāku pārtraukuma punktu, pievienojiet .dropdown-menu-rightun .dropdown-menu{-sm|-md|-lg|-xl}-left.
Ņemiet vērā, ka navigācijas joslās nolaižamajām pogām nav jāpievieno data-display="static"atribūts, jo Popper.js nav izmantots navigācijas joslās.
Izvēlnes saturs
Virsraksti
Pievienojiet galveni, lai apzīmētu darbību sadaļas jebkurā nolaižamajā izvēlnē.
Ievietojiet jebkuru brīvas formas tekstu nolaižamajā izvēlnē ar tekstu un izmantojiet atstarpju utilītas . Ņemiet vērā, ka, iespējams, būs nepieciešami papildu izmēru stili, lai ierobežotu izvēlnes platumu.
Daži teksta paraugi, kas ir brīvi plūstošs nolaižamajā izvēlnē.
Un tas ir vairāk teksta paraugs.
Veidlapas
Ievietojiet veidlapu nolaižamajā izvēlnē vai izveidojiet to par nolaižamo izvēlni un izmantojiet piemales vai polsterējuma utilītas , lai piešķirtu tai nepieciešamo negatīvo vietu.
Izmantojot datu atribūtus vai JavaScript, nolaižamais spraudnis pārslēdz slēpto saturu (nolaižamās izvēlnes), pārslēdzot .showklasi vecāksaraksta vienumā. Atribūts data-toggle="dropdown"tiek izmantots, lai aizvērtu nolaižamās izvēlnes lietojumprogrammas līmenī, tāpēc ieteicams to izmantot vienmēr.
Skārienierīcēs, atverot nolaižamo izvēlni , elementa tiešajiem pakārtotajiem elementiem tiek pievienoti tukši ( $.noop) apdarinātāji . Šī, protams, neglītā uzlaušana ir nepieciešama, lai novērstu iOS notikumu deleģēšanas dīvainību , kas citādi neļautu, pieskaroties nekur ārpus nolaižamās izvēlnes, aktivizētu kodu, kas aizver nolaižamo izvēlni. Kad nolaižamā izvēlne ir aizvērta, šie papildu tukšie apstrādātāji tiek noņemti.mouseover<body>mouseover
Izmantojot datu atribūtus
Pievienojiet data-toggle="dropdown"saitei vai pogai, lai pārslēgtu nolaižamo izvēlni.
Izmantojot JavaScript
Izsauciet nolaižamās izvēlnes, izmantojot JavaScript:
data-toggle="dropdown"joprojām ir nepieciešams
Neatkarīgi no tā, vai izsaucat savu nolaižamo izvēlni, izmantojot JavaScript vai tā vietā izmantojat datu api, data-toggle="dropdown"nolaižamās izvēlnes aktivizētāja elementā vienmēr ir jābūt klāt.
Iespējas
Opcijas var nodot, izmantojot datu atribūtus vai JavaScript. Datu atribūtiem pievienojiet opcijas nosaukumu data-, tāpat kā data-offset="".
Vārds
Tips
Noklusējums
Apraksts
kompensēt
numurs | stīga | funkciju
0
Nolaižamās izvēlnes nobīde attiecībā pret tās mērķi.
Ja funkcija tiek izmantota, lai noteiktu nobīdi, tā tiek izsaukta ar objektu, kas satur nobīdes datus kā savu pirmo argumentu. Funkcijai ir jāatgriež objekts ar tādu pašu struktūru. Aktivizējošais elements DOM mezgls tiek nodots kā otrais arguments.
Ļaujiet nolaižamajai izvēlnei apgriezties, ja atsauces elements pārklājas. Lai iegūtu papildinformāciju, skatiet Popper.js flip docs .
robeža
stīga | elements
'scrollParent'
Nolaižamās izvēlnes pārpildes ierobežojuma robeža. Pieņem vērtības 'viewport', 'window', 'scrollParent'vai HTMLElement atsauci (tikai JavaScript). Papildinformāciju skatiet dokumentā Popper.js preventOverflow .
atsauce
stīga | elements
'pārslēgt'
Nolaižamās izvēlnes atsauces elements. Pieņem 'toggle', 'parent', vai HTMLElement atsauces vērtības. Lai iegūtu papildinformāciju, skatiet Popper.js atsauciObject docs .
displejs
virkne
'dinamisks'
Pēc noklusējuma mēs izmantojam Popper.js dinamiskai pozicionēšanai. Atspējojiet to ar static.
popperConfig
null | objektu
null
Lai mainītu Bootstrap noklusējuma Popper.js konfigurāciju, skatiet sadaļu Popper.js konfigurācija
Ņemiet vērā, ja boundaryir iestatīta vērtība, kas nav 'scrollParent', stils position: statictiek lietots .dropdownkonteineram.
Metodes
Metode
Apraksts
$().dropdown('toggle')
Pārslēdz noteiktās navigācijas joslas vai cilnes navigācijas nolaižamo izvēlni.
$().dropdown('show')
Parāda noteiktas navigācijas joslas vai cilnes navigācijas nolaižamo izvēlni.
$().dropdown('hide')
Slēp attiecīgās navigācijas joslas vai cilnes navigācijas nolaižamo izvēlni.
$().dropdown('update')
Atjaunina elementa nolaižamās izvēlnes pozīciju.
$().dropdown('dispose')
Iznīcina elementa nolaižamo izvēlni.
Pasākumi
Visi nolaižamā saraksta notikumi tiek aktivizēti .dropdown-menuvecākelementā, un tiem ir relatedTargetrekvizīts, kura vērtība ir pārslēgšanas enkura elements. hide.bs.dropdownun hidden.bs.dropdownnotikumiem ir clickEventrekvizīts (tikai tad, ja sākotnējais notikuma veids ir click), kas satur klikšķa notikuma notikuma objektu.
Pasākums
Apraksts
show.bs.dropdown
Šis notikums tiek aktivizēts nekavējoties, kad tiek izsaukta parādīšanas instances metode.
shown.bs.dropdown
Šis notikums tiek aktivizēts, kad nolaižamā izvēlne ir padarīta redzama lietotājam (tiks gaidīts, līdz CSS pārejas tiks pabeigtas).
hide.bs.dropdown
Šis notikums tiek aktivizēts nekavējoties, kad tiek izsaukta slēpšanas instances metode.
hidden.bs.dropdown
Šis notikums tiek aktivizēts, kad nolaižamā izvēlne ir paslēpta no lietotāja (tiks gaidīts, kamēr CSS pārejas tiks pabeigtas).