Navs
Dokumentasie en voorbeelde vir hoe om Bootstrap se ingeslote navigasiekomponente te gebruik.
Basis nav
Navigasie beskikbaar in Bootstrap deel algemene opmaak en style, van die basisklas .nav
tot die aktiewe en gedeaktiveerde state. Ruil wysigerklasse om tussen elke styl te wissel.
Die basis .nav
komponent is gebou met flexbox en bied 'n sterk basis vir die bou van alle soorte navigasie komponente. Dit bevat 'n paar styl-oorskrywings (vir werk met lyste), 'n paar skakelopvulling vir groter trefareas, en basiese gestremde stilering.
Die basiskomponent .nav
sluit geen .active
staat in nie. Die volgende voorbeelde sluit die klas in, hoofsaaklik om te demonstreer dat hierdie spesifieke klas geen spesiale stilering veroorsaak nie.
Klasse word deurgaans gebruik, so jou opmaak kan baie buigsaam wees. Gebruik <ul>
s soos hierbo, <ol>
as die volgorde van jou items belangrik is, of rol jou eie met 'n <nav>
element. Omdat die .nav
gebruike display: flex
, tree die nav-skakels dieselfde op as nav-items, maar sonder die ekstra opmaak.
Beskikbare style
Verander die styl van .nav
s-komponent met wysigers en nutsprogramme. Meng en pas soos nodig, of bou jou eie.
Horisontale belyning
Verander die horisontale belyning van jou nav met flexbox nutsprogramme . By verstek is navs linksbelyn, maar jy kan dit maklik verander na middel- of regsbelyn.
Gesentreer met .justify-content-center
:
Regsbelyn met .justify-content-end
:
Vertikaal
Stapel jou navigasie deur die rigting van die buigitem met die .flex-column
hulpprogram te verander. Moet u dit op sommige uitkykpoorte stapel, maar nie op ander nie? Gebruik die responsiewe weergawes (bv. .flex-sm-column
).
Soos altyd is vertikale navigasie ook moontlik sonder <ul>
s.
Oortjies
Neem die basiese navigasie van bo af en voeg die .nav-tabs
klas by om 'n oortjie-koppelvlak te genereer. Gebruik hulle om oortjies te skep met ons oortjie JavaScript-inprop .
Pille
Neem dieselfde HTML, maar gebruik .nav-pills
eerder:
Vul en regverdig
Dwing jou .nav
se inhoud om die volle beskikbare breedte een van twee wysigerklasse uit te brei. Om alle beskikbare spasie proporsioneel met jou .nav-item
s te vul, gebruik .nav-fill
. Let daarop dat alle horisontale spasie beset is, maar nie elke navigasie-item het dieselfde breedte nie.
Wanneer u 'n <nav>
-gebaseerde navigasie gebruik, maak seker dat u dit .nav-item
op die ankers insluit.
Vir gelyke breedte elemente, gebruik .nav-justified
. Alle horisontale spasie sal deur navigasieskakels in beslag geneem word, maar anders as .nav-fill
bogenoemde, sal elke navigasie-item dieselfde breedte hê.
Soortgelyk aan die .nav-fill
voorbeeld wat 'n <nav>
-gebaseerde navigasie gebruik, maak seker dat dit .nav-item
op die ankers ingesluit word.
Werk met flex utilities
As jy responsiewe navigasie-variasies benodig, oorweeg dit om 'n reeks flexbox-nutsprogramme te gebruik . Alhoewel dit meer breedvoerig is, bied hierdie nutsprogramme groter aanpassing oor responsiewe breekpunte. In die voorbeeld hieronder sal ons nav op die laagste breekpunt gestapel word, en dan aanpas by 'n horisontale uitleg wat die beskikbare breedte vul vanaf die klein breekpunt.
Met betrekking tot toeganklikheid
As jy navs gebruik om 'n navigasiebalk te verskaf, maak seker dat jy 'n role="navigation"
by die mees logiese ouerhouer van die <ul>
, voeg, of 'n <nav>
element om die hele navigasie draai. Moenie die rol by die <ul>
self voeg nie, aangesien dit sal verhoed dat dit as 'n werklike lys deur ondersteunende tegnologieë aangekondig word.
Let daarop dat navigasiestawe, selfs al is dit visueel as oortjies saam met die .nav-tabs
klas gestileer, nierole="tablist"
, role="tab"
of role="tabpanel"
kenmerke gegee moet word nie. Dit is slegs geskik vir dinamiese oortjies-koppelvlakke, soos beskryf in die WAI ARIA -outeurpraktyke . Sien JavaScript-gedrag vir dinamiese oortjies-koppelvlakke in hierdie afdeling vir 'n voorbeeld.
Gebruik aftreklys
Voeg aftrekkieslyste by met 'n bietjie ekstra HTML en die aftreklys JavaScript-inprop .
Oortjies met aftreklys
Pille met dropdowns
JavaScript gedrag
Gebruik die oortjie JavaScript-inprop—sluit dit individueel of deur die saamgestelde bootstrap.js
lêer in—om ons navigasie-oortjies en -pille uit te brei om oortjies van plaaslike inhoud te skep, selfs via aftreklyste.
As jy ons JavaScript vanaf die bron bou, vereisutil.js
dit .
Dinamiese koppelvlakke met oortjies, soos beskryf in die WAI ARIA Authoring Practices , vereis role="tablist"
, role="tab"
, role="tabpanel"
, en bykomende aria-
eienskappe om hul struktuur, funksionaliteit en huidige toestand aan gebruikers van ondersteunende tegnologieë (soos skermlesers) oor te dra.
Let daarop dat dinamiese oortjies-koppelvlakke nie aftrekkieslyste moet bevat nie, aangesien dit beide bruikbaarheids- en toeganklikheidkwessies veroorsaak. Vanuit 'n bruikbaarheidsperspektief kan die feit dat die oortjie wat tans vertoon word se snellerelement nie onmiddellik sigbaar is nie (soos dit binne die geslote aftreklys is) verwarring veroorsaak. Vanuit 'n toeganklikheidsoogpunt is daar tans geen sinvolle manier om hierdie soort konstruksie na 'n standaard WAI ARIA-patroon te karteer nie, wat beteken dat dit nie maklik verstaanbaar gemaak kan word vir gebruikers van ondersteunende tegnologieë nie.
Rou denim jy het seker nog nie van daardie jean kortbroek Austin gehoor nie. Nesciunt tofu stumptown aliqua, retro synth meester skoonmaak. Snor cliche tempor, williamsburg carles vegan helvetica. Reprehenderit slagter retro keffiyeh dreamcatcher synth. Cosby-trui eu banh mi, qui irure terry richardson ex inkvis. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan Amerikaanse klere, slagter voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Om te help om aan jou behoeftes te voldoen, werk dit met <ul>
-gebaseerde opmaak, soos hierbo getoon, of met enige arbitrêre "rol jou eie" opmaak. Let daarop dat as jy gebruik <nav>
, jy nie role="tablist"
direk daarby moet byvoeg nie, aangesien dit die element se inheemse rol as 'n navigasielandmerk sal ignoreer. Skakel eerder oor na 'n alternatiewe element (in die voorbeeld hieronder, 'n eenvoudige <div>
) en draai die <nav>
om dit.
Die tabs-inprop werk ook met pille.
Consequat occaecat ullamco amet non eiusmod nostrud dolore irure incididunt est duis anim sunt officia. Fugiat velit proident aliquip nisi incididunt nostrud oefening proident est nisi. Irure magna elit commodo anim ex veniam culpa eiusmod id nostrud sit cupidatat in veniam advertensie. Eiusmod consequat eu adipisicing minim anim aliquip cupidatat culpa excepteur quis. Occaecat sit eu oefening irure Lorem incididunt nostrud.
Ad pariatur nostrud pariatur exercitation ipsum ipsum culpa mollit commodo mollit ex. Aute sunt incididunt amet commodo est sint nisi deserunt pariatur do. Aliquip ex eiusmod voluptate exercitation cillum id incididunt elit sunt. Qui minim sit magna Lorem id et dolore velit Lorem amet exercitation duis deserunt. Anim id labore elit adipisicing ut in id occaecat pariatur ut ullamco ea tempor duis.
Est quis nulla laborum officia ad nisi ex nostrud culpa Lorem excepteur aliquip dolor aliqua irure ex. Nulla ut duis ipsum nisi elit fugiat commodo sunt reprehenderit laborum veniam eu veniam. Eiusmod minim exercitation fugiat irure ex labore incididunt do fugiat commodo aliquip sit id deserunt reprehenderit aliquip nostrud. Amet ex cupidatat excepteur aute veniam incididunt mollit cupidatat esse irure officia elit do ipsum ullamco Lorem. Ullamco ut ad minim do mollit labore ipsum laboris ipsum commodo sunt tempor enim incididunt. Commodo quis sunt dolore aliquip aute tempor irure magna enim minim reprehenderit. Ullamco consectetur culpa veniam sint cillum aliqua incididunt velit ullamco sunt ullamco quis quis commodo voluptate. Mollit nulla nostrud adipisicing aliqua cupidatat aliqua pariatur mollit voluptate voluptate consequat non.
En met vertikale pille.
Cillum ad ut irure tempor velit nostrud occaecat ullamco aliqua anim Lorem sint. Veniam sint duis incididunt do esse magna mollit excepteur laborum qui. Id id reprehenderit sit est eu aliqua occaecat quis et velit excepteur laborum mollit dolore eiusmod. Ipsum dolor in occaecat commodo et voluptate minim reprehenderit mollit pariatur. Deserunt non laborum enim et cillum eu deserunt excepteur ea incididunt minim occaecat.
Culpa dolor voluptate do laboris laboris irure reprehenderit id incididunt duis pariatur mollit aute magna pariatur consectetur. Eu veniam duis non ut dolor deserunt commodo et minim in quis laboris ipsum velit id veniam. Quis ut consectetur adipisicing officia excepteur non sit. Ut et elit aliquip labore Lorem enim eu. Ullamco mollit occaecat dolore ipsum id officia mollit qui esse anim eiusmod do sint minim consectetur qui.
Fugiat id quis dolor culpa eiusmod anim velit excepteur proident dolor aute qui magna. Ad proident laboris ullamco esse anim Lorem Lorem veniam quis Lorem irure occaecat velit nostrud magna nulla. Velit et et proident Lorem do ea tempor officia dolor. Reprehenderit Lorem aliquip labore est magna commodo est ea veniam consectetur.
Eu dolore ea ullamco dolore Lorem id cupidatat excepteur reprehenderit consectetur elit id dolor proident in cupidatat officia. Voluptate excepteur commodo labore nisi cillum duis aliqua do. Aliqua amet qui mollit consectetur nulla mollit velit aliqua veniam nisi id do Lorem deserunt amet. Culpa ullamco sit adipisicing labore officia magna elit nisi in aute tempor commodo eiusmod.
Die gebruik van data-kenmerke
Jy kan 'n oortjie- of pilnavigasie aktiveer sonder om enige JavaScript te skryf deur bloot 'n element te spesifiseer data-toggle="tab"
of data-toggle="pill"
op 'n element. Gebruik hierdie data-kenmerke op .nav-tabs
of .nav-pills
.
Via JavaScript
Aktiveer tabbare oortjies via JavaScript (elke oortjie moet individueel geaktiveer word):
Jy kan individuele oortjies op verskeie maniere aktiveer:
Vervaag effek
Om oortjies te laat vervaag, voeg .fade
by elke .tab-pane
. Die eerste oortjie-venster moet ook .show
die aanvanklike inhoud sigbaar maak.
Metodes
Asinchroniese metodes en oorgange
Alle API-metodes is asynchronies en begin 'n oorgang . Hulle keer terug na die oproeper sodra die oorgang begin is, maar voordat dit eindig . Daarbenewens sal 'n metode-oproep op 'n oorgangskomponent geïgnoreer word .
$().tab
Aktiveer 'n oortjie-element en inhoudhouer. Tab moet óf 'n data-target
óf 'n href
teiken 'n houer nodus in die DOM hê.
.tab('wys')
Kies die gegewe oortjie en wys die gepaardgaande paneel. Enige ander oortjie wat voorheen gekies is, word ongeselekteer en die gepaardgaande paneel word versteek. Keer terug na die beller voordat die oortjie-venster werklik gewys is (dws voor die shown.bs.tab
gebeurtenis plaasvind).
.tab('dispose')
Vernietig 'n element se oortjie.
Gebeurtenisse
Wanneer 'n nuwe oortjie gewys word, begin die gebeure in die volgende volgorde:
hide.bs.tab
(op die huidige aktiewe oortjie)show.bs.tab
(op die om te wys-oortjie)hidden.bs.tab
(op die vorige aktiewe oortjie, dieselfde een as vir diehide.bs.tab
geleentheid)shown.bs.tab
(op die nuut-aktiewe oortjie wat pas gewys is, dieselfde een as vir dieshow.bs.tab
geleentheid)
As geen oortjie reeds aktief was nie, sal die hide.bs.tab
en hidden.bs.tab
gebeure nie geaktiveer word nie.
Soort gebeurtenis | Beskrywing |
---|---|
show.bs.tab | Hierdie gebeurtenis begin op oortjievertoning, maar voordat die nuwe oortjie gewys is. Gebruik event.target en event.relatedTarget om onderskeidelik die aktiewe oortjie en die vorige aktiewe oortjie (indien beskikbaar) te teiken. |
getoon.bs.tab | Hierdie gebeurtenis begin op oortjievertoning nadat 'n oortjie gewys is. Gebruik event.target en event.relatedTarget om onderskeidelik die aktiewe oortjie en die vorige aktiewe oortjie (indien beskikbaar) te teiken. |
versteek.bs.tab | Hierdie gebeurtenis begin wanneer 'n nuwe oortjie gewys moet word (en dus moet die vorige aktiewe oortjie versteek word). Gebruik event.target en event.relatedTarget om onderskeidelik die huidige aktiewe oortjie en die nuwe wat binnekort aktief sal wees, te teiken. |
hidden.bs.tab | Hierdie gebeurtenis begin nadat 'n nuwe oortjie gewys is (en dus word die vorige aktiewe oortjie versteek). Gebruik event.target en event.relatedTarget om onderskeidelik die vorige aktiewe oortjie en die nuwe aktiewe oortjie te teiken. |