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 .navaktiivisiin ja pois käytöstä oleviin tiloihin. Vaihda muokkausluokkia vaihtaaksesi kunkin tyylin välillä.

Peruskomponentti .navon 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 .navei sisällä mitään .activetilaa. 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 .navkä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ä .navmuokkaajilla 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-columnapuohjelmalla. 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-tabsluokan 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-pillssen 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 .navlaajentamaan koko käytettävissä olevaa leveyttä toisella kahdesta muokkausluokasta. Täytä kaikki käytettävissä oleva tila suhteellisesti .nav-items: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-linkon 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-fillyllä, 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-fillesimerkki, 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-tabsluokan 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.jstiedoston 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.

Huomaa, että välilehden JavaScript-laajennus ei tue avattavia valikoita sisältäviä välilehtiliittymiä, koska ne aiheuttavat 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.

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-tabstai .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ä .fadekuhunkin .tab-pane. Ensimmäisen välilehtiruudun on myös .showtehtä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 .

Katso lisätietoja JavaScript - dokumentaatiostamme .

$().tab

Aktivoi välilehtielementin ja sisältösäiliön. Välilehdellä tulee olla joko attribuutti data-targettai, jos käytetään linkkiä, hrefattribuutti, 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.tabtapahtumaa).

$('#someTab').tab('show')

.tab('dispose')

Tuhoaa elementin välilehden.

Tapahtumat

Kun uusi välilehti näytetään, tapahtumat käynnistyvät seuraavassa järjestyksessä:

  1. hide.bs.tab(nykyisellä aktiivisella välilehdellä)
  2. show.bs.tab(näytettävissä välilehdellä)
  3. hidden.bs.tab(edellisellä aktiivisella välilehdellä sama kuin hide.bs.tabtapahtumalla)
  4. shown.bs.tab(äskettäin aktiivisella juuri näytetyllä välilehdellä, sama kuin show.bs.tabtapahtumassa)

Jos mikään välilehti ei ollut jo aktiivinen, hide.bs.tabja hidden.bs.tabtapahtumia 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.targetja event.relatedTargetkohdistaaksesi 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.targetja event.relatedTargetkohdistaaksesi 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.targetja event.relatedTargetkohdistaaksesi 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.targetja event.relatedTargetkohdistaaksesi 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
})