Mga Nav at tab

Dokumentasyon at mga halimbawa para sa kung paano gamitin ang mga kasamang bahagi ng nabigasyon ng Bootstrap.

Sa pahinang ito

Base nav

Ang nabigasyon na available sa Bootstrap ay nagbabahagi ng pangkalahatang markup at mga istilo, mula sa batayang .navklase hanggang sa aktibo at may kapansanan na mga estado. Magpalit ng mga klase ng modifier upang lumipat sa pagitan ng bawat istilo.

Ang base .navna bahagi ay binuo gamit ang flexbox at nagbibigay ng matibay na pundasyon para sa pagbuo ng lahat ng uri ng mga bahagi ng nabigasyon. Kabilang dito ang ilang pag-override sa istilo (para sa pagtatrabaho sa mga listahan), ilang link padding para sa mas malalaking lugar ng hit, at pangunahing naka-disable na estilo.

Ang batayang .navbahagi ay hindi kasama ang anumang .activeestado. Kasama sa mga sumusunod na halimbawa ang klase, pangunahin upang ipakita na ang partikular na klase na ito ay hindi nagti-trigger ng anumang espesyal na istilo.

Upang maihatid ang aktibong estado sa mga teknolohiyang pantulong, gamitin ang aria-currentkatangian — gamit ang pagehalaga para sa kasalukuyang pahina, o truepara sa kasalukuyang item sa isang set.

<ul class="nav">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Ginagamit ang mga klase sa kabuuan, kaya maaaring maging sobrang flexible ang iyong markup. Gumamit ng <ul>s tulad ng nasa itaas, <ol>kung ang pagkakasunud-sunod ng iyong mga item ay mahalaga, o i-roll ang iyong sarili gamit ang isang <nav>elemento. Dahil ang mga .navgamit display: flex, ang mga nav link ay kumikilos tulad ng nav item, ngunit walang dagdag na markup.

<nav class="nav">
  <a class="nav-link active" aria-current="page" href="#">Active</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link disabled" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
</nav>

Magagamit na mga istilo

Baguhin ang istilo ng .navs component gamit ang mga modifier at utility. Paghaluin at pagtugmain kung kinakailangan, o bumuo ng iyong sarili.

Pahalang na pagkakahanay

Baguhin ang pahalang na pagkakahanay ng iyong nav gamit ang flexbox utilities . Bilang default, ang mga nav ay naka-left-align, ngunit madali mong mababago ang mga ito sa center o right aligned.

Nakasentro sa .justify-content-center:

<ul class="nav justify-content-center">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Naka-align sa kanan sa .justify-content-end:

<ul class="nav justify-content-end">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Patayo

I-stack ang iyong nabigasyon sa pamamagitan ng pagbabago ng direksyon ng flex item gamit ang .flex-columnutility. Kailangang i-stack ang mga ito sa ilang viewport ngunit hindi sa iba? Gamitin ang mga tumutugon na bersyon (hal., .flex-sm-column).

<ul class="nav flex-column">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Gaya ng nakasanayan, ang vertical navigation ay posible nang walang <ul>s, masyadong.

<nav class="nav flex-column">
  <a class="nav-link active" aria-current="page" href="#">Active</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link disabled" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
</nav>

Mga tab

Kinukuha ang pangunahing nav mula sa itaas at idinaragdag ang .nav-tabsklase upang makabuo ng naka-tab na interface. Gamitin ang mga ito upang lumikha ng mga tabbable na rehiyon gamit ang aming tab na JavaScript plugin .

<ul class="nav nav-tabs">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Pills

Kunin ang parehong HTML, ngunit gamitin .nav-pillssa halip ang:

<ul class="nav nav-pills">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Punan at bigyang-katwiran

Pilitin ang iyong .navmga nilalaman na palawigin ang buong magagamit na lapad ng isa sa dalawang klase ng modifier. Para proporsyonal na punan ang lahat ng magagamit na espasyo ng iyong .nav-items, gamitin ang .nav-fill. Pansinin na ang lahat ng pahalang na espasyo ay inookupahan, ngunit hindi lahat ng nav item ay may parehong lapad.

<ul class="nav nav-pills nav-fill">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Kapag gumagamit ng <nav>nakabatay sa nabigasyon, maaari mong ligtas na alisin .nav-itemdahil kailangan lang para sa mga elemento .nav-linkng pag-istilo .<a>

<nav class="nav nav-pills nav-fill">
  <a class="nav-link active" aria-current="page" 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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
</nav>

Para sa pantay na lapad na mga elemento, gamitin ang .nav-justified. Ang lahat ng pahalang na espasyo ay sasakupin ng mga nav link, ngunit hindi tulad ng nasa .nav-fillitaas, ang bawat nav item ay magiging parehong lapad.

<ul class="nav nav-pills nav-justified">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" 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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Katulad ng .nav-fillhalimbawa gamit ang isang <nav>-based navigation.

<nav class="nav nav-pills nav-justified">
  <a class="nav-link active" aria-current="page" 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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
</nav>

Paggawa gamit ang mga flex utility

Kung kailangan mo ng mga tumutugon na variation ng nav, isaalang-alang ang paggamit ng isang serye ng mga flexbox utilities . Bagama't mas verbose, nag-aalok ang mga utility na ito ng higit na pagpapasadya sa mga tumutugon na breakpoint. Sa halimbawa sa ibaba, ang aming nav ay isalansan sa pinakamababang breakpoint, pagkatapos ay iaangkop sa isang pahalang na layout na pumupuno sa magagamit na lapad simula sa maliit na breakpoint.

<nav class="nav nav-pills flex-column flex-sm-row">
  <a class="flex-sm-fill text-sm-center nav-link active" aria-current="page" 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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
</nav>

Tungkol sa accessibility

Kung gumagamit ka ng navs upang magbigay ng navigation bar, tiyaking magdagdag ng isang role="navigation"sa pinakalohikal na parent container ng <ul>, o maglagay ng <nav>elemento sa buong nabigasyon. Huwag idagdag ang tungkulin sa <ul>sarili nito, dahil mapipigilan ito na maipahayag bilang isang aktwal na listahan ng mga pantulong na teknolohiya.

Tandaan na ang mga navigation bar, kahit na biswal na naka-istilo bilang mga tab na may .nav-tabsklase, ay hindi dapat ibigay role="tablist", role="tab"o mga role="tabpanel"katangian. Ang mga ito ay angkop lamang para sa mga dynamic na naka-tab na interface, tulad ng inilarawan sa WAI ARIA Authoring Practices . Tingnan ang pag-uugali ng JavaScript para sa mga dynamic na naka-tab na interface sa seksyong ito para sa isang halimbawa. Hindi kinakailangan ang aria-currentattribute sa mga dynamic na tabbed na interface dahil pinangangasiwaan ng aming JavaScript ang napiling estado sa pamamagitan ng pagdaragdag aria-selected="true"sa aktibong tab.

Paggamit ng mga dropdown

Magdagdag ng mga dropdown na menu na may kaunting dagdag na HTML at ang dropdown na JavaScript plugin .

Mga tab na may mga dropdown

<ul class="nav nav-tabs">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item dropdown">
    <a class="nav-link dropdown-toggle" data-bs-toggle="dropdown" href="#" role="button" aria-expanded="false">Dropdown</a>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Action</a></li>
      <li><a class="dropdown-item" href="#">Another action</a></li>
      <li><a class="dropdown-item" href="#">Something else here</a></li>
      <li><hr class="dropdown-divider"></li>
      <li><a class="dropdown-item" href="#">Separated link</a></li>
    </ul>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Mga tabletang may dropdown

<ul class="nav nav-pills">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item dropdown">
    <a class="nav-link dropdown-toggle" data-bs-toggle="dropdown" href="#" role="button" aria-expanded="false">Dropdown</a>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Action</a></li>
      <li><a class="dropdown-item" href="#">Another action</a></li>
      <li><a class="dropdown-item" href="#">Something else here</a></li>
      <li><hr class="dropdown-divider"></li>
      <li><a class="dropdown-item" href="#">Separated link</a></li>
    </ul>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Sass

Mga variable

$nav-link-padding-y:                .5rem;
$nav-link-padding-x:                1rem;
$nav-link-font-size:                null;
$nav-link-font-weight:              null;
$nav-link-color:                    $link-color;
$nav-link-hover-color:              $link-hover-color;
$nav-link-transition:               color .15s ease-in-out, background-color .15s ease-in-out, border-color .15s ease-in-out;
$nav-link-disabled-color:           $gray-600;

$nav-tabs-border-color:             $gray-300;
$nav-tabs-border-width:             $border-width;
$nav-tabs-border-radius:            $border-radius;
$nav-tabs-link-hover-border-color:  $gray-200 $gray-200 $nav-tabs-border-color;
$nav-tabs-link-active-color:        $gray-700;
$nav-tabs-link-active-bg:           $body-bg;
$nav-tabs-link-active-border-color: $gray-300 $gray-300 $nav-tabs-link-active-bg;

$nav-pills-border-radius:           $border-radius;
$nav-pills-link-active-color:       $component-active-color;
$nav-pills-link-active-bg:          $component-active-bg;

Pag-uugali ng JavaScript

Gamitin ang plugin ng tab na JavaScript—isama ito nang isa-isa o sa pamamagitan ng pinagsama bootstrap.js-samang file—upang palawigin ang aming mga tab sa pag-navigate at mga tabletas upang lumikha ng mga tabable na pane ng lokal na nilalaman.

Ang mga dynamic na tabbed na interface, tulad ng inilarawan sa WAI ARIA Authoring Practices , ay nangangailangan ng role="tablist", role="tab", role="tabpanel", at mga karagdagang aria-katangian upang maihatid ang kanilang istraktura, functionality at kasalukuyang estado sa mga user ng mga pantulong na teknolohiya (tulad ng mga screen reader). Bilang pinakamahusay na kasanayan, inirerekomenda namin ang paggamit <button>ng mga elemento para sa mga tab, dahil ito ang mga kontrol na nagti-trigger ng dynamic na pagbabago, sa halip na mga link na nagna-navigate sa isang bagong page o lokasyon.

Tandaan na ang mga dynamic na naka-tab na interface ay hindi dapat maglaman ng mga dropdown na menu, dahil nagdudulot ito ng mga isyu sa kakayahang magamit at accessibility. Mula sa pananaw ng kakayahang magamit, ang katotohanan na ang kasalukuyang ipinapakitang elemento ng trigger ng tab ay hindi agad nakikita (dahil nasa loob ito ng saradong dropdown na menu) ay maaaring magdulot ng kalituhan. Mula sa punto ng view ng pagiging naa-access, kasalukuyang walang makatwirang paraan upang imapa ang ganitong uri ng konstruksyon sa isang karaniwang pattern ng WAI ARIA, ibig sabihin, hindi ito madaling maunawaan ng mga gumagamit ng mga pantulong na teknolohiya.

Ito ay ilang placeholder na nilalaman na nauugnay na nilalaman ng tab na Home. Ang pag-click sa isa pang tab ay magpapalipat-lipat sa visibility ng isang ito para sa susunod. Ang tab na JavaScript ay nagpapalit ng mga klase upang kontrolin ang pagpapakita ng nilalaman at pag-istilo. Magagamit mo ito sa mga tab, tableta, at anumang iba pang .navnabigasyon na pinapagana.

This is some placeholder content the Profile tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

This is some placeholder content the Contact tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

<ul class="nav nav-tabs" id="myTab" role="tablist">
  <li class="nav-item" role="presentation">
    <button class="nav-link active" id="home-tab" data-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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>

Upang tumulong na umangkop sa iyong mga pangangailangan, gumagana ito sa <ul>-based na markup, tulad ng ipinapakita sa itaas, o sa anumang arbitrary na "i-roll ang iyong sariling" markup. Tandaan na kung gumagamit ka ng <nav>, hindi ka dapat direktang magdagdag role="tablist"dito, dahil ma-o-override nito ang katutubong tungkulin ng elemento bilang isang palatandaan ng nabigasyon. Sa halip, lumipat sa isang alternatibong elemento (sa halimbawa sa ibaba, isang simple <div>) at balutin ang <nav>paligid nito.

<nav>
  <div class="nav nav-tabs" id="nav-tab" role="tablist">
    <button class="nav-link active" id="nav-home-tab" data-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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>

Gumagana rin ang tabs plugin sa mga tabletas.

<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-bs-toggle="pill" data-bs-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-bs-toggle="pill" data-bs-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-bs-toggle="pill" data-bs-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>

At may mga vertical na tabletas.

This is some placeholder content the Messages tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

This is some placeholder content the Settings tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

<div class="d-flex align-items-start">
  <div class="nav flex-column nav-pills me-3" id="v-pills-tab" role="tablist" aria-orientation="vertical">
    <button class="nav-link active" id="v-pills-home-tab" data-bs-toggle="pill" data-bs-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-bs-toggle="pill" data-bs-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-bs-toggle="pill" data-bs-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-bs-toggle="pill" data-bs-target="#v-pills-settings" type="button" role="tab" aria-controls="v-pills-settings" aria-selected="false">Settings</button>
  </div>
  <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>

Paggamit ng mga katangian ng data

Maaari mong i-activate ang isang tab o pill navigation nang hindi sumusulat ng anumang JavaScript sa pamamagitan lamang ng pagtukoy data-bs-toggle="tab"o data-bs-toggle="pill"sa isang elemento. Gamitin ang mga katangian ng data na ito sa .nav-tabso .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-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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>

Sa pamamagitan ng JavaScript

Paganahin ang mga tab na tab sa pamamagitan ng JavaScript (kailangang isaaktibo ang bawat tab):

var triggerTabList = [].slice.call(document.querySelectorAll('#myTab a'))
triggerTabList.forEach(function (triggerEl) {
  var tabTrigger = new bootstrap.Tab(triggerEl)

  triggerEl.addEventListener('click', function (event) {
    event.preventDefault()
    tabTrigger.show()
  })
})

Maaari mong i-activate ang mga indibidwal na tab sa maraming paraan:

var triggerEl = document.querySelector('#myTab a[href="#profile"]')
bootstrap.Tab.getInstance(triggerEl).show() // Select tab by name

var triggerFirstTabEl = document.querySelector('#myTab li:first-child a')
bootstrap.Tab.getInstance(triggerFirstTabEl).show() // Select first tab

Fade effect

Upang mag-fade in ang mga tab, idagdag .fadesa bawat isa .tab-pane. Ang unang tab pane ay dapat ding .showgawin ang unang nilalaman na nakikita.

<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>

Paraan

Mga asynchronous na pamamaraan at paglipat

Ang lahat ng mga pamamaraan ng API ay asynchronous at nagsisimula ng isang paglipat . Bumalik sila sa tumatawag sa sandaling magsimula ang paglipat ngunit bago ito matapos . Bilang karagdagan, babalewalain ang isang method call sa isang transitioning component .

Tingnan ang aming dokumentasyon ng JavaScript para sa higit pang impormasyon .

constructor

Ina-activate ang isang elemento ng tab at lalagyan ng nilalaman. Ang tab ay dapat magkaroon ng alinman sa data-bs-targeto, kung gumagamit ng link, isang hrefattribute, na nagta-target ng container node sa DOM.

<ul class="nav nav-tabs" id="myTab" role="tablist">
  <li class="nav-item" role="presentation">
    <button class="nav-link active" id="home-tab" data-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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-bs-toggle="tab" data-bs-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>
  var firstTabEl = document.querySelector('#myTab li:last-child a')
  var firstTab = new bootstrap.Tab(firstTabEl)

  firstTab.show()
</script>

palabas

Pinipili ang ibinigay na tab at ipinapakita ang nauugnay na pane nito. Ang anumang iba pang tab na dati nang napili ay hindi mapipili at ang nauugnay na pane nito ay nakatago. Bumabalik sa tumatawag bago aktwal na naipakita ang tab pane (ibig sabihin bago shown.bs.tabmangyari ang kaganapan).

  var someTabTriggerEl = document.querySelector('#someTabTrigger')
  var tab = new bootstrap.Tab(someTabTriggerEl)

  tab.show()

itapon

Sinisira ang tab ng isang elemento.

getInstance

Static na paraan na nagbibigay-daan sa iyong makuha ang tab na instance na nauugnay sa isang elemento ng DOM

var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getInstance(triggerEl) // Returns a Bootstrap tab instance

getOrCreateInstance

Static na paraan na nagbibigay-daan sa iyong makuha ang instance ng tab na nauugnay sa isang elemento ng DOM, o gumawa ng bago kung sakaling hindi ito nasimulan

var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getOrCreateInstance(triggerEl) // Returns a Bootstrap tab instance

Mga kaganapan

Kapag nagpapakita ng bagong tab, gagana ang mga kaganapan sa sumusunod na pagkakasunud-sunod:

hide.bs.tab(sa kasalukuyang aktibong tab)
show.bs.tab(sa ipapakitang tab)
hidden.bs.tab(sa nakaraang aktibong tab, kapareho ng para sa hide.bs.tabkaganapan)
shown.bs.tab(sa bagong-aktibong kakapakitang tab, kapareho ng para sa show.bs.tabkaganapan)

Kung wala pang tab na aktibo, hindi papaganahin ang hide.bs.tabat mga hidden.bs.tabkaganapan.

Uri ng kaganapan	Paglalarawan
`show.bs.tab`	Ang kaganapang ito ay gumagana sa palabas sa tab, ngunit bago ipakita ang bagong tab. Gamitin `event.target`at `event.relatedTarget`i-target ang aktibong tab at ang nakaraang aktibong tab (kung magagamit) ayon sa pagkakabanggit.
`shown.bs.tab`	Ang kaganapang ito ay gagana sa palabas sa tab pagkatapos maipakita ang isang tab. Gamitin `event.target`at `event.relatedTarget`i-target ang aktibong tab at ang nakaraang aktibong tab (kung magagamit) ayon sa pagkakabanggit.
`hide.bs.tab`	Ang kaganapang ito ay gagana kapag ang isang bagong tab ay ipapakita (at sa gayon ang nakaraang aktibong tab ay itatago). Gamitin `event.target`at `event.relatedTarget`i-target ang kasalukuyang aktibong tab at ang bagong tab na malapit nang maging aktibo, ayon sa pagkakabanggit.
`hidden.bs.tab`	Ang kaganapang ito ay gagana pagkatapos ipakita ang isang bagong tab (at sa gayon ang nakaraang aktibong tab ay nakatago). Gamitin `event.target`at `event.relatedTarget`i-target ang nakaraang aktibong tab at ang bagong aktibong tab, ayon sa pagkakabanggit.

var tabEl = document.querySelector('button[data-bs-toggle="tab"]')
tabEl.addEventListener('shown.bs.tab', function (event) {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})