Navit
Dokumentaatio ja esimerkkejä Bootstrapin mukana tulevien navigointikomponenttien käytöstä.
Bootstrapissa käytettävissä oleva navigointi jakaa yleiset merkinnät ja tyylit perusluokista .nav
aktiivisiin ja pois käytöstä oleviin tiloihin. Vaihda muokkausluokkia vaihtaaksesi kunkin tyylin välillä.
Peruskomponentti .nav
on rakennettu flexboxilla ja se tarjoaa vahvan perustan kaikentyyppisten navigointikomponenttien rakentamiseen. Se sisältää joitain tyylien ohituksia (luetteloiden kanssa työskentelyä varten), joitain linkkien täyttöjä suurempia osumaalueita varten ja peruskäytöstä poistetun tyylin.
Peruskomponentti .nav
ei sisällä mitään .active
tilaa. Seuraavat esimerkit sisältävät luokan, lähinnä sen osoittamiseksi, että tämä tietty luokka ei käynnistä mitään erityistä tyyliä.
<ul class="nav">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Luokkia käytetään kaikkialla, joten merkintäsi voi olla erittäin joustava. Käytä <ul>
s kuten yllä, tai rullaa omasi vaikkapa <nav>
elementillä. Koska .nav
käyttötarkoitukset display: flex
, nav-linkit toimivat samalla tavalla kuin navigointikohteet, mutta ilman ylimääräisiä merkintöjä.
<nav class="nav">
<a class="nav-link active" href="#">Active</a>
<a class="nav-link" href="#">Link</a>
<a class="nav-link" href="#">Link</a>
<a class="nav-link disabled" href="#">Disabled</a>
</nav>
Muuta s-komponentin tyyliä .nav
muokkaajilla ja apuohjelmilla. Sekoita ja yhdistä tarvittaessa tai rakenna omasi.
Muuta navigaattorisi vaakasuuntausta flexbox-apuohjelmilla . Oletusarvoisesti navat tasataan vasemmalle, mutta voit helposti muuttaa ne keskelle tai oikealle tasattuiksi.
Keskitetty .justify-content-center
:
<ul class="nav justify-content-center">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Oikealle tasattuna kanssa .justify-content-end
:
<ul class="nav justify-content-end">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Pinoa navigointisi muuttamalla joustavan kohteen suuntaa .flex-column
apuohjelmalla. Pitääkö ne pinota joihinkin kuvaportteihin, mutta ei muihin? Käytä responsiivisia versioita (esim. .flex-sm-column
).
<ul class="nav flex-column">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Kuten aina, pystysuuntainen navigointi on mahdollista <ul>
myös ilman s-kirjainta.
<nav class="nav flex-column">
<a class="nav-link active" href="#">Active</a>
<a class="nav-link" href="#">Link</a>
<a class="nav-link" href="#">Link</a>
<a class="nav-link disabled" href="#">Disabled</a>
</nav>
Ottaa perusnavigaattorin ylhäältä ja lisää .nav-tabs
luokan luodakseen välilehtikäyttöliittymän. Käytä niitä välilehtialueiden luomiseen JavaScript-laajennuksellamme .
<ul class="nav nav-tabs">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Ota sama HTML, mutta käytä .nav-pills
sen sijaan:
<ul class="nav nav-pills">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Pakota sisältösi .nav
laajentamaan koko käytettävissä olevaa leveyttä toisella kahdesta muokkausluokasta. Täytä kaikki käytettävissä oleva tila suhteellisesti .nav-item
s:lläsi käyttämällä .nav-fill
. Huomaa, että kaikki vaakasuora tila on varattu, mutta kaikilla navigointikohdilla ei ole samaa leveyttä.
<ul class="nav nav-pills nav-fill">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Longer nav link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Kun käytät <nav>
-pohjaista navigointia, muista sisällyttää .nav-item
ankkureihin.
<nav class="nav nav-pills nav-fill">
<a class="nav-item nav-link active" href="#">Active</a>
<a class="nav-item nav-link" href="#">Link</a>
<a class="nav-item nav-link" href="#">Link</a>
<a class="nav-item nav-link disabled" href="#">Disabled</a>
</nav>
Käytä yhtä leveitä elementtejä varten .nav-justified
. Nav-linkit täyttävät kaiken vaakasuoran tilan, mutta toisin kuin .nav-fill
yllä, jokainen navigointikohde on sama leveä.
<nav class="nav nav-pills nav-justified">
<a class="nav-link active" href="#">Active</a>
<a class="nav-link" href="#">Longer nav link</a>
<a class="nav-link" href="#">Link</a>
<a class="nav-link disabled" href="#">Disabled</a>
</nav>
Kuten .nav-fill
esimerkissä, jossa käytetään <nav>
-pohjaista navigointia, muista sisällyttää .nav-item
ankkureihin.
<nav class="nav nav-pills nav-justified">
<a class="nav-item nav-link active" href="#">Active</a>
<a class="nav-item nav-link" href="#">Link</a>
<a class="nav-item nav-link" href="#">Link</a>
<a class="nav-item nav-link disabled" href="#">Disabled</a>
</nav>
Jos tarvitset reagoivia navigointimuunnelmia, harkitse useiden flexbox-apuohjelmien käyttöä . Vaikka nämä apuohjelmat ovat monisanaisempia, ne tarjoavat enemmän mukauttamista reagoivien keskeytyskohtien välillä. Alla olevassa esimerkissä navigaattorimme pinotaan alimmalle keskeytyspisteelle ja mukautetaan sitten vaakasuuntaiseen asetteluun, joka täyttää käytettävissä olevan leveyden pienestä keskeytyskohdasta alkaen.
<nav class="nav nav-pills flex-column flex-sm-row">
<a class="flex-sm-fill text-sm-center nav-link active" href="#">Active</a>
<a class="flex-sm-fill text-sm-center nav-link" href="#">Link</a>
<a class="flex-sm-fill text-sm-center nav-link" href="#">Link</a>
<a class="flex-sm-fill text-sm-center nav-link disabled" href="#">Disabled</a>
</nav>
Jos käytät navigointipalkin luomiseen navigointia, muista lisätä role="navigation"
loogisimpaan ylätason säilöön <ul>
tai kääri <nav>
elementti koko navigointipalkin ympärille. Älä lisää roolia <ul>
itseensä, koska se estäisi sen ilmoittamisen todelliseksi luetteloksi aputekniikoiden avulla.
Huomaa, että navigointipalkkeja, vaikka ne olisivat visuaalisesti tyylitelty välilehdiksi .nav-tabs
luokan kanssa, ei pitäisi antaa role="tablist"
, role="tab"
tai role="tabpanel"
attribuutteja. Nämä sopivat vain dynaamisille välilehtiliittymille, kuten WAI ARIA Authoring Practices kuvataan . Katso esimerkki dynaamisten välilehtiliittymien JavaScript-käyttäytymisestä tässä osiossa.
Lisää avattavia valikoita hieman ylimääräisellä HTML-koodilla ja avattavalla JavaScript-laajennuksella .
<ul class="nav nav-tabs">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item dropdown">
<a class="nav-link dropdown-toggle" data-toggle="dropdown" href="#" role="button" aria-haspopup="true" aria-expanded="false">Dropdown</a>
<div class="dropdown-menu">
<a class="dropdown-item" href="#">Action</a>
<a class="dropdown-item" href="#">Another action</a>
<a class="dropdown-item" href="#">Something else here</a>
<div class="dropdown-divider"></div>
<a class="dropdown-item" href="#">Separated link</a>
</div>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
<ul class="nav nav-pills">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item dropdown">
<a class="nav-link dropdown-toggle" data-toggle="dropdown" href="#" role="button" aria-haspopup="true" aria-expanded="false">Dropdown</a>
<div class="dropdown-menu">
<a class="dropdown-item" href="#">Action</a>
<a class="dropdown-item" href="#">Another action</a>
<a class="dropdown-item" href="#">Something else here</a>
<div class="dropdown-divider"></div>
<a class="dropdown-item" href="#">Separated link</a>
</div>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" href="#">Disabled</a>
</li>
</ul>
Käytä välilehden JavaScript-laajennusta – sisällytä se yksittäin tai käännetyn bootstrap.js
tiedoston kautta – laajentaaksesi navigointivälilehtiämme ja pillereitämme luodaksesi välilehtiruutuja paikallisesta sisällöstä jopa pudotusvalikoiden kautta.
Jos rakennat JavaScript-koodiamme lähteestä, se vaatiiutil.js
.
Dynaamiset välilehtiliittymät, kuten WAI ARIA Authoring Practices -julkaisussa kuvataan , vaativat role="tablist"
, role="tab"
, role="tabpanel"
ja aria-
lisäattribuutteja, jotta ne voivat välittää rakenteensa, toiminnallisuutensa ja nykytilansa avustavien tekniikoiden (kuten näytönlukuohjelmien) käyttäjille.
Huomaa, että dynaamiset välilehtiliittymät eivät saa sisältää avattavia valikoita, koska tämä aiheuttaa sekä käytettävyys- että saavutettavuusongelmia. Käytettävyyden kannalta se, että tällä hetkellä näytettävän välilehden laukaisuelementti ei ole heti näkyvissä (koska se on suljetun avattavan valikon sisällä), voi aiheuttaa sekaannusta. Saavutettavuuden näkökulmasta tällä hetkellä ei ole järkevää tapaa kartoittaa tällaista rakennetta standardi WAI ARIA -malliin, mikä tarkoittaa, että sitä ei voida helposti tehdä ymmärrettäväksi aputekniikoiden käyttäjille.
Raaka denim et luultavasti ole kuullut niistä farkkushortseja Austin. Nesciunt tofu stumptown aliqua, retro syntetisaattorin puhdistusaine. Viikset klisee tempor, williamsburg carles vegaani helvetica. Reprehenderit butcher retro keffiyeh Dreamcatcher synth. Cosby villapaita eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis neuletakki amerikkalaiset vaatteet, teurastaja 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.
Jotta tämä vastaa tarpeitasi, tämä toimii <ul>
yllä olevan kuvan mukaisella merkinnällä tai millä tahansa mielivaltaisella "rullaa omalla" merkinnällä. Huomaa, että jos käytät <nav>
, sinun ei pitäisi lisätä role="tablist"
siihen suoraan, koska se ohittaisi elementin alkuperäisen roolin navigoinnin maamerkkinä. Vaihda sen sijaan vaihtoehtoiseen elementtiin (alla olevassa esimerkissä yksinkertainen <div>
) ja kääri sen <nav>
ympärille.
Välilehdet-laajennus toimii myös pillereiden kanssa.
Consequat occaecat ullamco amet non eiusmod nostrud dolore irure incidunt est duis anim sunt officia. Fugiat velit proident aliquip nisi incididunt nostrud exercitation proident est nisi. Irure magna elit commodo anim ex veniam culpa eiusmod id nostrud sit cupidatat in veniam ad. Eiusmod consequat eu adipisicing minim anim aliquip cupidatat culpa paitsi quis. Occaecat sit eu exercitation 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.
Ja pystypillereillä.
Cillum ad ut irure tempor velit nostrud occaecat ullamco aliqua anim Lorem sint. Veniam sint duis incididunt do esse magna mollit paitsi työvoima qui. Id id reprehenderit sit est eu aliqua occaecat quis et velit paitsi laborum mollit dolore eiusmod. Ipsum dolor in occaecat commodo et voluptate minim reprehenderit mollit pariatur. Deserunt non laborum enim et cillum eu deserunt paitsi 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.
Voit aktivoida välilehden tai pillerinavigoinnin kirjoittamatta JavaScriptiä yksinkertaisesti määrittämällä data-toggle="tab"
tai data-toggle="pill"
elementin päälle. Käytä näitä tietomääritteitä kohdassa .nav-tabs
tai .nav-pills
.
Ota välilehdet käyttöön JavaScriptin kautta (jokainen välilehti on aktivoitava erikseen):
Voit aktivoida yksittäisiä välilehtiä useilla tavoilla:
Saat välilehdet häivyttää lisäämällä .fade
kuhunkin .tab-pane
. Ensimmäisen välilehtiruudun on myös .show
tehtävä alkuperäinen sisältö näkyväksi.
Asynkroniset menetelmät ja siirtymät
Kaikki API - menetelmät ovat asynkronisia ja aloittavat siirtymän . He palaavat soittajan luo heti siirtymisen alkaessa, mutta ennen sen päättymistä . Lisäksi siirtyvän komponentin menetelmäkutsu jätetään huomioimatta .
Aktivoi välilehtielementin ja sisältösäiliön. Välilehdellä tulee olla joko a data-target
tai href
kohdistava säilön solmu DOM:ssa.
Valitsee välilehden ja näyttää siihen liittyvän ruudun. Kaikki muut aiemmin valitut välilehdet jäävät valitsemattomiksi ja niihin liittyvä ruutu piilotetaan. Palaa soittajalle ennen kuin välilehtiruutu on todella näytetty (eli ennen shown.bs.tab
tapahtumaa).
Tuhoaa elementin välilehden.
Kun uusi välilehti näytetään, tapahtumat käynnistyvät seuraavassa järjestyksessä:
hide.bs.tab
(nykyisellä aktiivisella välilehdellä)show.bs.tab
(näytettävissä välilehdellä)hidden.bs.tab
(edellisellä aktiivisella välilehdellä sama kuinhide.bs.tab
tapahtumalla)shown.bs.tab
(äskettäin aktiivisella juuri näytetyllä välilehdellä, sama kuinshow.bs.tab
tapahtumassa)
Jos mikään välilehti ei ollut jo aktiivinen, hide.bs.tab
ja hidden.bs.tab
tapahtumia ei käynnistetä.
Tapahtumatyyppi | Kuvaus |
---|---|
show.bs.tab | Tämä tapahtuma käynnistyy välilehtien näyttämisen yhteydessä, mutta ennen kuin uusi välilehti on näytetty. Käytä event.target ja event.relatedTarget kohdistaaksesi aktiiviseen välilehteen ja edelliseen aktiiviseen välilehteen (jos saatavilla). |
show.bs.tab | Tämä tapahtuma käynnistyy välilehden näyttämisen yhteydessä, kun välilehti on näytetty. Käytä event.target ja event.relatedTarget kohdistaaksesi aktiiviseen välilehteen ja edelliseen aktiiviseen välilehteen (jos saatavilla). |
hide.bs.tab | Tämä tapahtuma käynnistyy, kun uusi välilehti näytetään (ja siten edellinen aktiivinen välilehti piilotetaan). Käytä event.target ja event.relatedTarget kohdistaaksesi nykyiseen aktiiviseen välilehteen ja uuteen pian aktiiviseen välilehteen. |
piilotettu.bs.tab | Tämä tapahtuma käynnistyy, kun uusi välilehti näytetään (ja siten edellinen aktiivinen välilehti piilotetaan). Käytä event.target ja event.relatedTarget kohdistaaksesi edelliseen aktiiviseen välilehteen ja uuteen aktiiviseen välilehteen. |