Navigace a karty

Dokumentace a příklady, jak používat navigační komponenty obsažené v Bootstrapu.

Na této straně

Základní nav

Navigace dostupná v Bootstrapu sdílí obecné označení a styly, od základní .navtřídy až po aktivní a zakázaný stav. Zaměňte třídy modifikátorů pro přepínání mezi jednotlivými styly.

Základní .navkomponenta je vyrobena z flexboxu a poskytuje pevný základ pro stavbu všech typů navigačních komponent. Zahrnuje některé přepisy stylů (pro práci se seznamy), výplň odkazů pro větší oblasti zásahu a základní zakázaný styl.

Základní .navkomponenta neobsahuje žádný .activestav. Následující příklady zahrnují třídu, hlavně proto, aby demonstrovaly, že tato konkrétní třída nespouští žádný speciální styl.

Chcete-li přenést aktivní stav na asistenční technologie, použijte aria-currentatribut — pomocí pagehodnoty pro aktuální stránku nebo truepro aktuální položku v sadě.

html

<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">Disabled</a>
  </li>
</ul>

Třídy se používají všude, takže vaše označení může být velmi flexibilní. Použijte <ul>s jako výše, <ol>pokud je důležité pořadí vašich položek, nebo si hoďte vlastní s <nav>prvkem. Vzhledem k .navpoužití display: flexse navigační odkazy chovají stejně jako položky navigace, ale bez zvláštního označení.

html

<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">Disabled</a>
</nav>

Dostupné styly

Změňte styl .navkomponenty s pomocí modifikátorů a utilit. Mixujte a spojujte podle potřeby nebo si vytvořte vlastní.

Horizontální zarovnání

Změňte vodorovné zarovnání své navigace pomocí nástrojů flexbox . Ve výchozím nastavení jsou navigace zarovnány doleva, ale můžete je snadno změnit na zarovnané na střed nebo doprava.

Na střed s .justify-content-center:

html

<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">Disabled</a>
  </li>
</ul>

Zarovnáno vpravo s .justify-content-end:

html

<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">Disabled</a>
  </li>
</ul>

Vertikální

Uspořádejte svou navigaci změnou směru flexibilní položky pomocí .flex-columnnástroje. Potřebujete je naskládat do některých výřezů, ale do jiných ne? Použijte responzivní verze (např. .flex-sm-column).

html

<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">Disabled</a>
  </li>
</ul>

Jako vždy je vertikální navigace možná i bez <ul>s.

html

<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">Disabled</a>
</nav>

Karty

Převezme základní navigaci shora a přidá .nav-tabstřídu pro vytvoření rozhraní s kartami. Použijte je k vytvoření tablovatelných regionů pomocí našeho pluginu tab JavaScript .

html

<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">Disabled</a>
  </li>
</ul>

Pilulky

Vezměte stejný HTML, ale použijte .nav-pillsmísto něj:

html

<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">Disabled</a>
  </li>
</ul>

Vyplňte a zdůvodněte

Vynutíte, aby obsah vašeho souboru .navrozšířil celou dostupnou šířku jedné ze dvou tříd modifikátorů. Chcete-li úměrně vyplnit veškerý dostupný prostor vaším .nav-items, použijte .nav-fill. Všimněte si, že veškerý horizontální prostor je obsazen, ale ne každá položka navigace má stejnou šířku.

html

<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">Disabled</a>
  </li>
</ul>

Při použití <nav>navigace založené na principu můžete vynechat .nav-item, protože .nav-linkje vyžadováno pouze pro prvky stylů <a>.

html

<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">Disabled</a>
</nav>

Pro prvky stejné šířky použijte .nav-justified. Veškerý horizontální prostor bude obsazen navigačními odkazy, ale na rozdíl od .nav-fillvýše uvedeného bude mít každá navigační položka stejnou šířku.

html

<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">Disabled</a>
  </li>
</ul>

Podobně jako v .nav-fillpříkladu s použitím <nav>navigace založené na.

html

<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">Disabled</a>
</nav>

Práce s flex utilitami

Pokud potřebujete responzivní varianty navigace, zvažte použití řady nástrojů flexbox . I když jsou tyto nástroje podrobnější, nabízejí větší přizpůsobení napříč citlivými body přerušení. V níže uvedeném příkladu bude naše navigace naskládána na nejnižší bod přerušení a poté se přizpůsobí vodorovnému rozvržení, které vyplní dostupnou šířku počínaje malým bodem přerušení.

html

<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">Disabled</a>
</nav>

Ohledně přístupnosti

Pokud k poskytování navigačního panelu používáte navigace, nezapomeňte přidat a role="navigation"do nejlogičtějšího nadřazeného kontejneru <ul>, nebo obklopit <nav>prvek kolem celé navigace. Nepřidávejte roli k <ul>samotné roli, protože by to zabránilo tomu, aby byla asistenčními technologiemi oznámena jako skutečný seznam.

Všimněte si, že navigační panely, i když jsou vizuálně stylizované jako karty s .nav-tabstřídou, by neměly být uvedeny role="tablist", role="tab"nebo role="tabpanel"atributy. Ty jsou vhodné pouze pro rozhraní s dynamickými kartami, jak je popsáno ve vzoru karet ARIA Authoring Practices Guide . Příklad viz Chování JavaScriptu pro rozhraní s dynamickými kartami v této části. Atribut aria-currentnení nutný na rozhraních s dynamickými kartami, protože náš JavaScript zpracovává vybraný stav přidáním aria-selected="true"na aktivní kartu.

Pomocí rozbalovacích nabídek

Přidejte rozevírací nabídky s trochou kódu HTML navíc a rozbalovacím pluginem JavaScript .

Karty s rozevíracími seznamy

html

<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">Disabled</a>
  </li>
</ul>

Pilulky s rozevíracími seznamy

html

<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">Disabled</a>
  </li>
</ul>

CSS

Proměnné

Přidáno ve verzi 5.2.0

V rámci vyvíjejícího se přístupu Bootstrap proměnných CSS nyní navigační systémy používají místní proměnné CSS na .nav, .nav-tabs, a .nav-pillspro vylepšené přizpůsobení v reálném čase. Hodnoty pro proměnné CSS se nastavují prostřednictvím Sass, takže přizpůsobení Sass je stále podporováno.

V .navzákladní třídě:

  --#{$prefix}nav-link-padding-x: #{$nav-link-padding-x};
  --#{$prefix}nav-link-padding-y: #{$nav-link-padding-y};
  @include rfs($nav-link-font-size, --#{$prefix}nav-link-font-size);
  --#{$prefix}nav-link-font-weight: #{$nav-link-font-weight};
  --#{$prefix}nav-link-color: #{$nav-link-color};
  --#{$prefix}nav-link-hover-color: #{$nav-link-hover-color};
  --#{$prefix}nav-link-disabled-color: #{$nav-link-disabled-color};

Ve .nav-tabstřídě modifikátoru:

  --#{$prefix}nav-tabs-border-width: #{$nav-tabs-border-width};
  --#{$prefix}nav-tabs-border-color: #{$nav-tabs-border-color};
  --#{$prefix}nav-tabs-border-radius: #{$nav-tabs-border-radius};
  --#{$prefix}nav-tabs-link-hover-border-color: #{$nav-tabs-link-hover-border-color};
  --#{$prefix}nav-tabs-link-active-color: #{$nav-tabs-link-active-color};
  --#{$prefix}nav-tabs-link-active-bg: #{$nav-tabs-link-active-bg};
  --#{$prefix}nav-tabs-link-active-border-color: #{$nav-tabs-link-active-border-color};

Ve .nav-pillstřídě modifikátoru:

  --#{$prefix}nav-pills-border-radius: #{$nav-pills-border-radius};
  --#{$prefix}nav-pills-link-active-color: #{$nav-pills-link-active-color};
  --#{$prefix}nav-pills-link-active-bg: #{$nav-pills-link-active-bg};

Sass proměnné

$nav-link-padding-y:                .5rem;
$nav-link-padding-x:                1rem;
$nav-link-font-size:                null;
$nav-link-font-weight:              null;
$nav-link-color:                    var(--#{$prefix}link-color);
$nav-link-hover-color:              var(--#{$prefix}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;

Chování JavaScriptu

Použijte zásuvný modul JavaScript tab – zahrňte jej jednotlivě nebo prostřednictvím zkompilovaného bootstrap.jssouboru – k rozšíření našich navigačních karet a pilulek tak, aby vytvořily tabelovatelné panely místního obsahu.

Toto je nějaký zástupný obsah související s kartou Domů . Kliknutím na jinou kartu přepnete viditelnost této karty pro další. Karta JavaScript zaměňuje třídy pro ovládání viditelnosti obsahu a stylů. Můžete jej použít s kartami, pilulkami a jakoukoli jinou .navnavigací.

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.

This is some placeholder content the Disabled tab's associated content.

<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-tab-pane" type="button" role="tab" aria-controls="home-tab-pane" 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-tab-pane" type="button" role="tab" aria-controls="profile-tab-pane" 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-tab-pane" type="button" role="tab" aria-controls="contact-tab-pane" aria-selected="false">Contact</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="disabled-tab" data-bs-toggle="tab" data-bs-target="#disabled-tab-pane" type="button" role="tab" aria-controls="disabled-tab-pane" aria-selected="false" disabled>Disabled</button>
  </li>
</ul>
<div class="tab-content" id="myTabContent">
  <div class="tab-pane fade show active" id="home-tab-pane" role="tabpanel" aria-labelledby="home-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="profile-tab-pane" role="tabpanel" aria-labelledby="profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="contact-tab-pane" role="tabpanel" aria-labelledby="contact-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="disabled-tab-pane" role="tabpanel" aria-labelledby="disabled-tab" tabindex="0">...</div>
</div>

Aby to vyhovovalo vašim potřebám, funguje to se <ul>značkami založenými na principu, jak je uvedeno výše, nebo s libovolným označením „nahodit vlastní“. Všimněte si, že pokud používáte <nav>, neměli byste role="tablist"k němu přidávat přímo, protože by to přepsalo nativní roli prvku jako orientační bod navigace. Místo toho přepněte na alternativní prvek (v níže uvedeném příkladu jednoduchý <div>) a obtočte <nav>jej.

This is some placeholder content the Disabled tab's associated content.

<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>
    <button class="nav-link" id="nav-disabled-tab" data-bs-toggle="tab" data-bs-target="#nav-disabled" type="button" role="tab" aria-controls="nav-disabled" aria-selected="false" disabled>Disabled</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" tabindex="0">...</div>
  <div class="tab-pane fade" id="nav-profile" role="tabpanel" aria-labelledby="nav-profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="nav-contact" role="tabpanel" aria-labelledby="nav-contact-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="nav-disabled" role="tabpanel" aria-labelledby="nav-disabled-tab" tabindex="0">...</div>
</div>

Plugin tabs funguje i s pilulkami.

This is some placeholder content the Disabled tab's associated content.

<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>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="pills-disabled-tab" data-bs-toggle="pill" data-bs-target="#pills-disabled" type="button" role="tab" aria-controls="pills-disabled" aria-selected="false" disabled>Disabled</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" tabindex="0">...</div>
  <div class="tab-pane fade" id="pills-profile" role="tabpanel" aria-labelledby="pills-profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="pills-contact" role="tabpanel" aria-labelledby="pills-contact-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="pills-disabled" role="tabpanel" aria-labelledby="pills-disabled-tab" tabindex="0">...</div>
</div>

A s vertikálními pilulkami. V ideálním případě byste pro svislé karty měli přidat také aria-orientation="vertical"do kontejneru seznamu karet.

This is some placeholder content the Disabled tab's associated content.

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-disabled-tab" data-bs-toggle="pill" data-bs-target="#v-pills-disabled" type="button" role="tab" aria-controls="v-pills-disabled" aria-selected="false" disabled>Disabled</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" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-profile" role="tabpanel" aria-labelledby="v-pills-profile-tab" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-disabled" role="tabpanel" aria-labelledby="v-pills-disabled-tab" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-messages" role="tabpanel" aria-labelledby="v-pills-messages-tab" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-settings" role="tabpanel" aria-labelledby="v-pills-settings-tab" tabindex="0">...</div>
  </div>
</div>

Přístupnost

Dynamická rozhraní s kartami, jak je popsáno ve vzoru záložek ARIA Authoring Practices Guide , vyžadují role="tablist", role="tab", role="tabpanel"a další aria-atributy, aby uživatelům asistenčních technologií (jako jsou čtečky obrazovky) zprostředkovaly jejich strukturu, funkčnost a aktuální stav. Jako osvědčený postup doporučujeme používat <button>prvky pro karty, protože se jedná o ovládací prvky, které spouštějí dynamickou změnu, spíše než odkazy, které přecházejí na novou stránku nebo umístění.

V souladu se vzorem ARIA Authoring Practices je aktivní pouze aktivní karta. Když je plugin JavaScript inicializován, nastaví se tabindex="-1"na všechny neaktivní ovládací prvky karty. Jakmile je aktuálně aktivní záložka aktivní, kurzorové klávesy aktivují předchozí/následující záložku, přičemž plugin odpovídajícím způsobem změní pohybtabindex . Všimněte si však, že plugin JavaScript nerozlišuje mezi vodorovnými a svislými seznamy karet, pokud jde o interakce s klávesami kurzoru: bez ohledu na orientaci seznamu karet přejde kurzor nahoru i doleva na předchozí kartu a kurzor dolů a doprava na další záložka.

Obecně platí, že pro usnadnění navigace pomocí klávesnice se doporučuje, aby bylo možné zaměřit i samotné panely karet, pokud již nelze zaměřit první prvek obsahující smysluplný obsah uvnitř panelu karet. Plugin JavaScript se nesnaží tento aspekt zvládnout – tam, kde je to vhodné, budete muset panely záložek explicitně nastavit tak, aby bylo možné zaměřit se na ně přidáním tabindex="0"označení.

Zásuvný modul JavaScript nepodporuje rozhraní s kartami, které obsahují rozevírací nabídky, protože ty způsobují problémy s použitelností i přístupností. Z hlediska použitelnosti může způsobit zmatek skutečnost, že spouštěcí prvek aktuálně zobrazené karty není okamžitě viditelný (jelikož je uvnitř zavřené rozevírací nabídky). Z hlediska přístupnosti v současnosti neexistuje rozumný způsob, jak tento druh konstrukce namapovat na standardní vzor WAI ARIA, což znamená, že nemůže být snadno srozumitelný pro uživatele asistenčních technologií.

Použití atributů dat

Můžete aktivovat navigaci na kartě nebo pilulce bez psaní jakéhokoli JavaScriptu pouhým zadáním data-bs-toggle="tab"nebo data-bs-toggle="pill"na prvku. Použijte tyto atributy dat na .nav-tabsnebo .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" tabindex="0">...</div>
  <div class="tab-pane" id="profile" role="tabpanel" aria-labelledby="profile-tab" tabindex="0">...</div>
  <div class="tab-pane" id="messages" role="tabpanel" aria-labelledby="messages-tab" tabindex="0">...</div>
  <div class="tab-pane" id="settings" role="tabpanel" aria-labelledby="settings-tab" tabindex="0">...</div>
</div>

Prostřednictvím JavaScriptu

Povolit záložky pomocí JavaScriptu (každá karta musí být aktivována samostatně):

const triggerTabList = document.querySelectorAll('#myTab button')
triggerTabList.forEach(triggerEl => {
  const tabTrigger = new bootstrap.Tab(triggerEl)

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

Jednotlivé karty můžete aktivovat několika způsoby:

const triggerEl = document.querySelector('#myTab button[data-bs-target="#profile"]')
bootstrap.Tab.getInstance(triggerEl).show() // Select tab by name

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

Efekt vyblednutí

Chcete-li, aby karty vybledly, přidejte .fadeke každému .tab-pane. První panel karet musí také .showzviditelnit počáteční obsah.

<div class="tab-content">
  <div class="tab-pane fade show active" id="home" role="tabpanel" aria-labelledby="home-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="profile" role="tabpanel" aria-labelledby="profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="messages" role="tabpanel" aria-labelledby="messages-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="settings" role="tabpanel" aria-labelledby="settings-tab" tabindex="0">...</div>
</div>

Metody

Asynchronní metody a přechody

Všechny metody API jsou asynchronní a zahajují přechod . Vrátí se k volajícímu, jakmile je přechod zahájen, ale před jeho ukončením . Kromě toho bude ignorováno volání metody na přechodové komponentě .

Další informace naleznete v naší dokumentaci k JavaScriptu .

Aktivuje váš obsah jako prvek karty.

Pomocí konstruktoru můžete vytvořit instanci karty, například:

const bsTab = new bootstrap.Tab('#myTab')

Metoda	Popis
`dispose`	Zničí záložku prvku.
`getInstance`	Statická metoda, která vám umožňuje získat instanci karty přidruženou k prvku DOM, můžete ji použít takto: `bootstrap.Tab.getInstance(element)`.
`getOrCreateInstance`	Statická metoda, která vrátí instanci karty přidruženou k prvku DOM nebo vytvoří novou v případě, že nebyla inicializována. Můžete jej použít takto: `bootstrap.Tab.getOrCreateInstance(element)`.
`show`	Vybere danou kartu a zobrazí související panel. Jakákoli jiná karta, která byla dříve vybrána, se stane nevybranou a její přidružené podokno se skryje. Vrátí se k volajícímu dříve, než se panel karet skutečně zobrazí (tj. než dojde k `shown.bs.tab`události).

Události

Při zobrazení nové karty se události spustí v následujícím pořadí:

hide.bs.tab(na aktuální aktivní kartě)
show.bs.tab(na kartě k zobrazení)
hidden.bs.tab(na předchozí aktivní záložce, stejné jako u hide.bs.tabudálosti)
shown.bs.tab(na nově aktivní právě zobrazené záložce, stejné jako u show.bs.tabudálosti)

Pokud již žádná karta nebyla aktivní, události hide.bs.taba hidden.bs.tabse nespustí.

Typ události	Popis
`hide.bs.tab`	Tato událost se spustí, když se má zobrazit nová karta (a tedy předchozí aktivní karta má být skryta). Pomocí `event.target`a `event.relatedTarget`můžete cílit na aktuální aktivní kartu a na novou kartu, která bude brzy aktivní.
`hidden.bs.tab`	Tato událost se spustí po zobrazení nové karty (a tedy předchozí aktivní karta je skryta). Pomocí `event.target`a `event.relatedTarget`můžete cílit na předchozí aktivní kartu a na novou aktivní kartu.
`show.bs.tab`	Tato událost se spustí při zobrazení karty, ale předtím, než se zobrazí nová karta. Pomocí `event.target`a `event.relatedTarget`můžete cílit na aktivní kartu a na předchozí aktivní kartu (pokud je k dispozici).
`shown.bs.tab`	Tato událost se spustí při zobrazení karty po zobrazení karty. Pomocí `event.target`a `event.relatedTarget`můžete cílit na aktivní kartu a na předchozí aktivní kartu (pokud je k dispozici).

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