Navit
Dokumentaatio ja esimerkkejä Bootstrapin mukana tulevien navigointikomponenttien käytöstä.
Base nav
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.
.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">Disabled</a>
</li>
</ul>
Luokkia käytetään kaikkialla, joten merkintäsi voi olla erittäin joustava. Käytä <ul>
kuten yllä, <ol>
jos kohteidesi järjestys on tärkeä, tai rullaa omasi <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">Disabled</a>
</nav>
Saatavilla olevat tyylit
Muuta s-komponentin tyyliä .nav
muokkaajilla ja apuohjelmilla. Sekoita ja yhdistä tarvittaessa tai rakenna omasi.
Vaakasuora kohdistaminen
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">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">Disabled</a>
</li>
</ul>
Pystysuora
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">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">Disabled</a>
</nav>
Välilehdet
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">Disabled</a>
</li>
</ul>
Pillerit
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">Disabled</a>
</li>
</ul>
Täytä ja perustele
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="#">Much 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">Disabled</a>
</li>
</ul>
Kun käytät <nav>
-pohjaista navigointia, voit turvallisesti jättää sen pois .nav-item
, koska se .nav-link
on tarpeen vain <a>
tyylielementtien osalta.
<nav class="nav nav-pills nav-fill">
<a class="nav-link active" href="#">Active</a>
<a class="nav-link" href="#">Much longer nav link</a>
<a class="nav-link" href="#">Link</a>
<a class="nav-link disabled">Disabled</a>
</nav>
Käytä yhtä leveille elementeille .nav-justified
. Nav-linkit täyttävät kaiken vaakasuoran tilan, mutta toisin kuin .nav-fill
yllä, jokainen navigointikohde on sama leveä.
<ul class="nav nav-pills nav-justified">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Much 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">Disabled</a>
</li>
</ul>
Samanlainen kuin .nav-fill
esimerkki, jossa käytetään <nav>
-pohjaista navigointia.
<nav class="nav nav-pills nav-justified">
<a class="nav-link active" href="#">Active</a>
<a class="nav-link" href="#">Much longer nav link</a>
<a class="nav-link" href="#">Link</a>
<a class="nav-link disabled">Disabled</a>
</nav>
Työskentely flex utilities
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="#">Longer nav 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">Disabled</a>
</nav>
Mitä tulee saavutettavuuteen
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 ARIA Authoring Practices Guide -välilehtimallissa kuvataan . Katso esimerkki dynaamisten välilehtiliittymien JavaScript-käyttäytymisestä tässä osiossa.
Pudotusvalikoiden käyttäminen
Lisää avattavat valikot hieman ylimääräisellä HTML-koodilla ja avattavalla JavaScript-laajennuksella .
Välilehdet avattavilla valikoilla
<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-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">Disabled</a>
</li>
</ul>
Pillerit pudotusvalikoilla
<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-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">Disabled</a>
</li>
</ul>
JavaScript-käyttäytyminen
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ä.
Jos rakennat JavaScript-koodiamme lähteestä, se vaatiiutil.js
.
Dynaamiset välilehdet, kuten ARIA Authoring Practices Guide -välilehtimallissa kuvataan , vaativat role="tablist"
, role="tab"
, role="tabpanel"
ja aria-
lisäattribuutteja, jotta niiden rakenne, toiminnallisuus ja nykyinen tila voidaan välittää aputekniikoiden (kuten näytönlukuohjelmien) käyttäjille. Suosittelemme käyttämään <button>
välilehtien elementtejä parhaana käytäntönä, koska nämä ovat säätimiä, jotka käynnistävät dynaamisen muutoksen uudelle sivulle tai sijaintiin siirtyvien linkkien sijaan.
Välilehtipaneelin paikkamerkkisisältö. Tämä liittyy Koti-välilehteen. Vie sinut mailia korkealle, niin korkealle, koska hänellä on tuo yksi kansainvälinen hymy. Sängyssäni on muukalainen, päässäni jyskyttää. Voi ei. Toisessa elämässä saisin sinut jäämään. Koska minä pystyn mihin tahansa. Sopii kruunaavaan taisteluun. Käytettiin varastamaan vanhempiesi viinaa ja kiipeämään katolle. Sävy, rusketus ja valmis, lisää se, koska siitä tulee raskasta. Hänen rakkautensa on kuin huume. Luulen, että unohdin, että minulla on mahdollisuus valita.
Välilehtipaneelin paikkamerkkisisältö. Tämä liittyy profiilivälilehteen. Sinulla on hienoin arkkitehtuuri. Passin leimat, hän on kosmopoliittinen. Hieno, raikas, kova, saimme sen lukkoon. En olisi koskaan suunnitellut, että jonain päivänä menetän sinut. Hän syö sydämesi. Suudellasi on kosminen, jokainen liike on taikuutta. Tarkoitan niitä, tarkoitan kuin hän olisi se. Tervehdys rakkaat, lähdetään matkalle. Omista vain yö kuin 4. heinäkuuta! Mutta menet mieluummin hukkaan.
Placeholder content for the tab panel. This one relates to the contact tab. Her love is like a drug. All my girls vintage Chanel baby. Got a motel and built a fort out of sheets. 'Cause she's the muse and the artist. (This is how we do) So you wanna play with magic. So just be sure before you give it all to me. I'm walking, I'm walking on air (tonight). Skip the talk, heard it all, time to walk the walk. Catch her if you can. Stinging like a bee I earned my stripes.
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" role="presentation">
<button class="nav-link active" id="home-tab" data-toggle="tab" data-target="#home" type="button" role="tab" aria-controls="home" aria-selected="true">Home</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="profile-tab" data-toggle="tab" data-target="#profile" type="button" role="tab" aria-controls="profile" aria-selected="false">Profile</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="contact-tab" data-toggle="tab" data-target="#contact" type="button" role="tab" aria-controls="contact" aria-selected="false">Contact</button>
</li>
</ul>
<div class="tab-content" id="myTabContent">
<div class="tab-pane fade show active" id="home" role="tabpanel" aria-labelledby="home-tab">...</div>
<div class="tab-pane fade" id="profile" role="tabpanel" aria-labelledby="profile-tab">...</div>
<div class="tab-pane fade" id="contact" role="tabpanel" aria-labelledby="contact-tab">...</div>
</div>
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.
<nav>
<div class="nav nav-tabs" id="nav-tab" role="tablist">
<button class="nav-link active" id="nav-home-tab" data-toggle="tab" data-target="#nav-home" type="button" role="tab" aria-controls="nav-home" aria-selected="true">Home</button>
<button class="nav-link" id="nav-profile-tab" data-toggle="tab" data-target="#nav-profile" type="button" role="tab" aria-controls="nav-profile" aria-selected="false">Profile</button>
<button class="nav-link" id="nav-contact-tab" data-toggle="tab" data-target="#nav-contact" type="button" role="tab" aria-controls="nav-contact" aria-selected="false">Contact</button>
</div>
</nav>
<div class="tab-content" id="nav-tabContent">
<div class="tab-pane fade show active" id="nav-home" role="tabpanel" aria-labelledby="nav-home-tab">...</div>
<div class="tab-pane fade" id="nav-profile" role="tabpanel" aria-labelledby="nav-profile-tab">...</div>
<div class="tab-pane fade" id="nav-contact" role="tabpanel" aria-labelledby="nav-contact-tab">...</div>
</div>
Välilehdet-laajennus toimii myös pillereiden kanssa.
Välilehtipaneelin paikkamerkkisisältö. Tämä liittyy Koti-välilehteen. Vie sinut mailia korkealle, niin korkealle, koska hänellä on tuo yksi kansainvälinen hymy. Sängyssäni on muukalainen, päässäni jyskyttää. Voi ei. Toisessa elämässä saisin sinut jäämään. Koska minä pystyn mihin tahansa. Sopii kruunaavaan taisteluun. Käytettiin varastamaan vanhempiesi viinaa ja kiipeämään katolle. Sävy, rusketus ja valmis, lisää se, koska siitä tulee raskasta. Hänen rakkautensa on kuin huume. Luulen, että unohdin, että minulla on mahdollisuus valita.
Placeholder content for the tab panel. This one relates to the profile tab. You got the finest architecture. Passport stamps, she's cosmopolitan. Fine, fresh, fierce, we got it on lock. Never planned that one day I'd be losing you. She eats your heart out. Your kiss is cosmic, every move is magic. I mean the ones, I mean like she's the one. Greetings loved ones let's take a journey. Just own the night like the 4th of July! But you'd rather get wasted.
Placeholder content for the tab panel. This one relates to the contact tab. Her love is like a drug. All my girls vintage Chanel baby. Got a motel and built a fort out of sheets. 'Cause she's the muse and the artist. (This is how we do) So you wanna play with magic. So just be sure before you give it all to me. I'm walking, I'm walking on air (tonight). Skip the talk, heard it all, time to walk the walk. Catch her if you can. Stinging like a bee I earned my stripes.
<ul class="nav nav-pills mb-3" id="pills-tab" role="tablist">
<li class="nav-item" role="presentation">
<button class="nav-link active" id="pills-home-tab" data-toggle="pill" data-target="#pills-home" type="button" role="tab" aria-controls="pills-home" aria-selected="true">Home</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="pills-profile-tab" data-toggle="pill" data-target="#pills-profile" type="button" role="tab" aria-controls="pills-profile" aria-selected="false">Profile</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="pills-contact-tab" data-toggle="pill" data-target="#pills-contact" type="button" role="tab" aria-controls="pills-contact" aria-selected="false">Contact</button>
</li>
</ul>
<div class="tab-content" id="pills-tabContent">
<div class="tab-pane fade show active" id="pills-home" role="tabpanel" aria-labelledby="pills-home-tab">...</div>
<div class="tab-pane fade" id="pills-profile" role="tabpanel" aria-labelledby="pills-profile-tab">...</div>
<div class="tab-pane fade" id="pills-contact" role="tabpanel" aria-labelledby="pills-contact-tab">...</div>
</div>
Ja pystypillereillä.
Välilehtipaneelin paikkamerkkisisältö. Tämä liittyy Koti-välilehteen. Näin sinut keskustassa laulamassa bluesia. Katso, kun kierrät viemäriä. Mikset anna minun pysähtyä? Raskas on pää, joka kantaa kruunua. Kyllä, me saamme enkelit itkemään, sataa maan päälle ylhäältä. Haluatko nähdä esityksen 3D:nä, elokuvana. Tuntuuko sinusta koskaan niin paperin ohuelta. Se on kyllä tai ei, ehkä ei.
Placeholder content for the tab panel. This one relates to the profile tab. Takes you miles high, so high, 'cause she’s got that one international smile. There's a stranger in my bed, there's a pounding in my head. Oh, no. In another life I would make you stay. ‘Cause I, I’m capable of anything. Suiting up for my crowning battle. Used to steal your parents' liquor and climb to the roof. Tone, tan fit and ready, turn it up cause its gettin' heavy. Her love is like a drug. I guess that I forgot I had a choice.
Placeholder content for the tab panel. This one relates to the messages tab. You got the finest architecture. Passport stamps, she's cosmopolitan. Fine, fresh, fierce, we got it on lock. Never planned that one day I'd be losing you. She eats your heart out. Your kiss is cosmic, every move is magic. I mean the ones, I mean like she's the one. Greetings loved ones let's take a journey. Just own the night like the 4th of July! But you'd rather get wasted.
Placeholder content for the tab panel. This one relates to the settings tab. Her love is like a drug. All my girls vintage Chanel baby. Got a motel and built a fort out of sheets. 'Cause she's the muse and the artist. (This is how we do) So you wanna play with magic. So just be sure before you give it all to me. I'm walking, I'm walking on air (tonight). Skip the talk, heard it all, time to walk the walk. Catch her if you can. Stinging like a bee I earned my stripes.
<div class="row">
<div class="col-3">
<div class="nav flex-column nav-pills" id="v-pills-tab" role="tablist" aria-orientation="vertical">
<button class="nav-link active" id="v-pills-home-tab" data-toggle="pill" data-target="#v-pills-home" type="button" role="tab" aria-controls="v-pills-home" aria-selected="true">Home</button>
<button class="nav-link" id="v-pills-profile-tab" data-toggle="pill" data-target="#v-pills-profile" type="button" role="tab" aria-controls="v-pills-profile" aria-selected="false">Profile</button>
<button class="nav-link" id="v-pills-messages-tab" data-toggle="pill" data-target="#v-pills-messages" type="button" role="tab" aria-controls="v-pills-messages" aria-selected="false">Messages</button>
<button class="nav-link" id="v-pills-settings-tab" data-toggle="pill" data-target="#v-pills-settings" type="button" role="tab" aria-controls="v-pills-settings" aria-selected="false">Settings</button>
</div>
</div>
<div class="col-9">
<div class="tab-content" id="v-pills-tabContent">
<div class="tab-pane fade show active" id="v-pills-home" role="tabpanel" aria-labelledby="v-pills-home-tab">...</div>
<div class="tab-pane fade" id="v-pills-profile" role="tabpanel" aria-labelledby="v-pills-profile-tab">...</div>
<div class="tab-pane fade" id="v-pills-messages" role="tabpanel" aria-labelledby="v-pills-messages-tab">...</div>
<div class="tab-pane fade" id="v-pills-settings" role="tabpanel" aria-labelledby="v-pills-settings-tab">...</div>
</div>
</div>
</div>
Tietoattribuuttien käyttäminen
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
.
<!-- Nav tabs -->
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" role="presentation">
<button class="nav-link active" id="home-tab" data-toggle="tab" data-target="#home" type="button" role="tab" aria-controls="home" aria-selected="true">Home</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="profile-tab" data-toggle="tab" data-target="#profile" type="button" role="tab" aria-controls="profile" aria-selected="false">Profile</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="messages-tab" data-toggle="tab" data-target="#messages" type="button" role="tab" aria-controls="messages" aria-selected="false">Messages</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="settings-tab" data-toggle="tab" data-target="#settings" type="button" role="tab" aria-controls="settings" aria-selected="false">Settings</button>
</li>
</ul>
<!-- Tab panes -->
<div class="tab-content">
<div class="tab-pane active" id="home" role="tabpanel" aria-labelledby="home-tab">...</div>
<div class="tab-pane" id="profile" role="tabpanel" aria-labelledby="profile-tab">...</div>
<div class="tab-pane" id="messages" role="tabpanel" aria-labelledby="messages-tab">...</div>
<div class="tab-pane" id="settings" role="tabpanel" aria-labelledby="settings-tab">...</div>
</div>
JavaScriptin kautta
Ota välilehdet käyttöön JavaScriptin kautta (jokainen välilehti on aktivoitava erikseen):
$('#myTab button').on('click', function (event) {
event.preventDefault()
$(this).tab('show')
})
Voit aktivoida yksittäisiä välilehtiä useilla tavoilla:
$('#myTab button[data-target="#profile"]').tab('show') // Select tab by name
$('#myTab li:first-child button').tab('show') // Select first tab
$('#myTab li:last-child button').tab('show') // Select last tab
$('#myTab li:nth-child(3) button').tab('show') // Select third tab
Häivytysefekti
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.
<div class="tab-content">
<div class="tab-pane fade show active" id="home" role="tabpanel" aria-labelledby="home-tab">...</div>
<div class="tab-pane fade" id="profile" role="tabpanel" aria-labelledby="profile-tab">...</div>
<div class="tab-pane fade" id="messages" role="tabpanel" aria-labelledby="messages-tab">...</div>
<div class="tab-pane fade" id="settings" role="tabpanel" aria-labelledby="settings-tab">...</div>
</div>
menetelmät
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 .
$().tab
Aktivoi välilehtielementin ja sisältösäiliön. Välilehdellä tulee olla joko attribuutti data-target
tai, jos käytetään linkkiä, href
attribuutti, joka kohdistaa DOM:n säilön solmuun.
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" role="presentation">
<button class="nav-link active" id="home-tab" data-toggle="tab" data-target="#home" type="button" role="tab" aria-controls="home" aria-selected="true">Home</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="profile-tab" data-toggle="tab" data-target="#profile" type="button" role="tab" aria-controls="profile" aria-selected="false">Profile</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="messages-tab" data-toggle="tab" data-target="#messages" type="button" role="tab" aria-controls="messages" aria-selected="false">Messages</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="settings-tab" data-toggle="tab" data-target="#settings" type="button" role="tab" aria-controls="settings" aria-selected="false">Settings</button>
</li>
</ul>
<div class="tab-content">
<div class="tab-pane active" id="home" role="tabpanel" aria-labelledby="home-tab">...</div>
<div class="tab-pane" id="profile" role="tabpanel" aria-labelledby="profile-tab">...</div>
<div class="tab-pane" id="messages" role="tabpanel" aria-labelledby="messages-tab">...</div>
<div class="tab-pane" id="settings" role="tabpanel" aria-labelledby="settings-tab">...</div>
</div>
<script>
$(function () {
$('#myTab li:last-child button').tab('show')
})
</script>
.tab('show')
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).
$('#someTab').tab('show')
.tab('dispose')
Tuhoaa elementin välilehden.
Tapahtumat
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. |
$('button[data-toggle="tab"]').on('shown.bs.tab', function (event) {
event.target // newly activated tab
event.relatedTarget // previous active tab
})