Przejdź do głównej zawartości Przejdź do nawigacji w dokumentach
Check
in English

Pasek nawigacyjny

Dokumentacja i przykłady potężnego, responsywnego nagłówka nawigacyjnego Bootstrap, paska nawigacyjnego. Obejmuje obsługę brandingu, nawigacji i nie tylko, w tym obsługę naszej wtyczki do zwijania.

Jak to działa

Oto, co musisz wiedzieć przed rozpoczęciem korzystania z paska nawigacyjnego:

  • Paski nawigacyjne wymagają opakowania .navbarw .navbar-expand{-sm|-md|-lg|-xl|-xxl}celu responsywnego zwijania i klas schematów kolorów .
  • Domyślnie paski nawigacyjne i ich zawartość są płynne. Zmień kontener , aby na różne sposoby ograniczyć jego szerokość w poziomie.
  • Skorzystaj z naszych klas użytkowych odstępów i elastyczności , aby kontrolować odstępy i wyrównanie w paskach nawigacyjnych.
  • Paski nawigacyjne są domyślnie responsywne, ale możesz je łatwo zmodyfikować, aby to zmienić. Zachowanie responsywne zależy od naszej wtyczki Collapse JavaScript.
  • Zapewnij dostępność, używając <nav>elementu lub, jeśli używasz bardziej ogólnego elementu, takiego jak <div>, dodaj znak role="navigation"do każdego paska nawigacyjnego, aby wyraźnie określić go jako punkt orientacyjny dla użytkowników technologii wspomagających.
  • Wskaż bieżący element, używając aria-current="page"dla bieżącej strony lub aria-current="true"dla bieżącego elementu w zestawie.
  • Nowość w wersji 5.2.0: paski nawigacyjne można tworzyć za pomocą zmiennych CSS, których zakres obejmuje .navbarklasę bazową. .navbar-lightzostał przestarzały i .navbar-darkzostał przepisany w celu zastąpienia zmiennych CSS zamiast dodawania dodatkowych stylów.
Efekt animacji tego komponentu zależy od prefers-reduced-motionzapytania o media. Zobacz zmniejszoną sekcję ruchu w naszej dokumentacji ułatwień dostępu .

Obsługiwane treści

Paski nawigacyjne mają wbudowaną obsługę kilku podkomponentów. W razie potrzeby wybierz spośród następujących:

  • .navbar-branddla Twojej firmy, produktu lub nazwy projektu.
  • .navbar-navdla pełnej wysokości i lekkiej nawigacji (w tym obsługa list rozwijanych).
  • .navbar-togglerdo użytku z naszą wtyczką zwijania i innymi zachowaniami przełączania nawigacji .
  • Narzędzia Flex i rozmieszczania dla dowolnych kontrolek formularzy i akcji.
  • .navbar-textdo dodawania ciągów tekstu wyśrodkowanych w pionie.
  • .collapse.navbar-collapsedo grupowania i ukrywania zawartości paska nawigacyjnego według nadrzędnego punktu przerwania.
  • Dodaj opcjonalny, .navbar-scrollaby ustawić max-heighti przewinąć rozwiniętą zawartość paska nawigacyjnego .

Oto przykład wszystkich podkomponentów zawartych w responsywnym pasku nawigacyjnym o jasnej tematyce, który automatycznie zwija się w lg(dużym) punkcie przerwania.

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarSupportedContent">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item dropdown">
          <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" 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><hr class="dropdown-divider"></li>
            <li><a class="dropdown-item" href="#">Something else here</a></li>
          </ul>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled">Disabled</a>
        </li>
      </ul>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

W tym przykładzie użyto klas narzędziowych tła ( bg-light) i odstępów ( me-auto, mb-2, mb-lg-0, ).me-2

Marka

Można .navbar-brandzastosować do większości elementów, ale kotwica działa najlepiej, ponieważ niektóre elementy mogą wymagać klas użytkowych lub niestandardowych stylów.

Tekst

Dodaj swój tekst w elemencie z .navbar-brandklasą.

html
<!-- As a link -->
<nav class="navbar bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
  </div>
</nav>

<!-- As a heading -->
<nav class="navbar bg-light">
  <div class="container-fluid">
    <span class="navbar-brand mb-0 h1">Navbar</span>
  </div>
</nav>

Obraz

Możesz zamienić tekst .navbar-brandw <img>.

html
<nav class="navbar bg-light">
  <div class="container">
    <a class="navbar-brand" href="#">
      <img src="/docs/5.2/assets/brand/bootstrap-logo.svg" alt="Bootstrap" width="30" height="24">
    </a>
  </div>
</nav>

Obraz i tekst

Możesz także skorzystać z kilku dodatkowych narzędzi, aby jednocześnie dodać obraz i tekst. Zwróć uwagę na dodanie .d-inline-blocki .align-text-topna <img>.

html
<nav class="navbar bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">
      <img src="/docs/5.2/assets/brand/bootstrap-logo.svg" alt="Logo" width="30" height="24" class="d-inline-block align-text-top">
      Bootstrap
    </a>
  </div>
</nav>

Łącza nawigacyjne paska nawigacyjnego opierają się na naszych .navopcjach z własną klasą modyfikatorów i wymagają użycia klas przełączników w celu uzyskania odpowiedniej responsywnej stylizacji. Nawigacja w paskach nawigacyjnych również wzrośnie, aby zajmować jak najwięcej miejsca w poziomie, aby zapewnić bezpieczne wyrównanie zawartości paska nawigacyjnego.

Dodaj .activeklasę .nav-link, aby wskazać bieżącą stronę.

Należy pamiętać, że należy również dodać aria-currentatrybut do aktywnego .nav-link.

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarNav">
      <ul class="navbar-nav">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Features</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Pricing</a>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled">Disabled</a>
        </li>
      </ul>
    </div>
  </div>
</nav>

A ponieważ używamy klas do naszej nawigacji, możesz całkowicie uniknąć podejścia opartego na listach, jeśli chcesz.

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavAltMarkup" aria-controls="navbarNavAltMarkup" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarNavAltMarkup">
      <div class="navbar-nav">
        <a class="nav-link active" aria-current="page" href="#">Home</a>
        <a class="nav-link" href="#">Features</a>
        <a class="nav-link" href="#">Pricing</a>
        <a class="nav-link disabled">Disabled</a>
      </div>
    </div>
  </div>
</nav>

Możesz także użyć list rozwijanych na pasku nawigacyjnym. Rozwijane menu wymagają do pozycjonowania elementu zawijania, więc upewnij się, że używasz oddzielnych i zagnieżdżonych elementów dla .nav-itemi .nav-linkjak pokazano poniżej.

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavDropdown" aria-controls="navbarNavDropdown" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarNavDropdown">
      <ul class="navbar-nav">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Features</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Pricing</a>
        </li>
        <li class="nav-item dropdown">
          <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
            Dropdown link
          </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>
          </ul>
        </li>
      </ul>
    </div>
  </div>
</nav>

Formularze

Umieść różne kontrolki formularzy i komponenty na pasku nawigacyjnym:

html
<nav class="navbar bg-light">
  <div class="container-fluid">
    <form class="d-flex" role="search">
      <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success" type="submit">Search</button>
    </form>
  </div>
</nav>

Bezpośrednie elementy podrzędne .navbarużywają układu flex i domyślnie będą to justify-content: space-between. W razie potrzeby użyj dodatkowych narzędzi flex , aby dostosować to zachowanie.

html
<nav class="navbar bg-light">
  <div class="container-fluid">
    <a class="navbar-brand">Navbar</a>
    <form class="d-flex" role="search">
      <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success" type="submit">Search</button>
    </form>
  </div>
</nav>

Działają też grupy wejściowe. Jeśli pasek nawigacyjny to cały formularz, a przede wszystkim formularz, możesz użyć <form>elementu jako kontenera i zapisać trochę kodu HTML.

html
<nav class="navbar bg-light">
  <form class="container-fluid">
    <div class="input-group">
      <span class="input-group-text" id="basic-addon1">@</span>
      <input type="text" class="form-control" placeholder="Username" aria-label="Username" aria-describedby="basic-addon1">
    </div>
  </form>
</nav>

W ramach tych formularzy paska nawigacyjnego obsługiwane są również różne przyciski. Jest to również świetne przypomnienie, że narzędzia wyrównywania w pionie mogą być używane do wyrównywania elementów o różnych rozmiarach.

html
<nav class="navbar bg-light">
  <form class="container-fluid justify-content-start">
    <button class="btn btn-outline-success me-2" type="button">Main button</button>
    <button class="btn btn-sm btn-outline-secondary" type="button">Smaller button</button>
  </form>
</nav>

Tekst

Paski nawigacyjne mogą zawierać fragmenty tekstu za pomocą .navbar-text. Ta klasa dostosowuje wyrównanie w pionie i odstępy w poziomie dla ciągów tekstu.

html
<nav class="navbar bg-light">
  <div class="container-fluid">
    <span class="navbar-text">
      Navbar text with an inline element
    </span>
  </div>
</nav>

W razie potrzeby wymieszaj i dopasuj do innych składników i narzędzi.

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar w/ text</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarText" aria-controls="navbarText" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarText">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Features</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Pricing</a>
        </li>
      </ul>
      <span class="navbar-text">
        Navbar text with an inline element
      </span>
    </div>
  </div>
</nav>

Schematy kolorów

Nowość w wersji 5.2.0: Motywy paska nawigacyjnego są teraz obsługiwane przez zmienne CSS i .navbar-lightzostały wycofane. Zmienne CSS są stosowane do .navbar, domyślnie do „jasnego” wyglądu i mogą być nadpisane za pomocą .navbar-dark.

Motywy paska nawigacyjnego są łatwiejsze niż kiedykolwiek dzięki połączeniu zmiennych Sass i CSS w Bootstrap. Domyślnie jest to nasz "jasny pasek nawigacyjny" do użytku z jasnymi kolorami tła, ale można również zastosować .navbar-darkdo ciemnych kolorów tła. Następnie dostosuj za pomocą .bg-*narzędzi.

<nav class="navbar navbar-dark bg-dark">
  <!-- Navbar content -->
</nav>

<nav class="navbar navbar-dark bg-primary">
  <!-- Navbar content -->
</nav>

<nav class="navbar" style="background-color: #e3f2fd;">
  <!-- Navbar content -->
</nav>

Kontenery

Chociaż nie jest to wymagane, możesz zawinąć pasek nawigacyjny w , .containeraby wyśrodkować go na stronie, ale pamiętaj, że nadal wymagany jest kontener wewnętrzny. Możesz też dodać kontener wewnątrz, .navbaraby wyśrodkować tylko zawartość stałego lub statycznego górnego paska nawigacyjnego .

html
<div class="container">
  <nav class="navbar navbar-expand-lg bg-light">
    <div class="container-fluid">
      <a class="navbar-brand" href="#">Navbar</a>
    </div>
  </nav>
</div>

Użyj dowolnego z responsywnych kontenerów, aby zmienić szerokość prezentowaną na pasku nawigacyjnym.

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-md">
    <a class="navbar-brand" href="#">Navbar</a>
  </div>
</nav>

Umieszczenie

Użyj naszych narzędzi pozycjonowania , aby umieścić paski nawigacyjne w pozycjach niestatycznych. Do wyboru przyklejony do góry, przyklejony do dołu, przyklejony do góry (przewija się ze stroną, aż dotrze do góry, a następnie tam zostanie) lub przyklejony do dołu (przewija się ze stroną, aż osiągnie dół, a następnie pozostaje tam).

Naprawione paski nawigacyjne używają position: fixed, co oznacza, że ​​są pobierane z normalnego przepływu DOM i mogą wymagać niestandardowego CSS (np. padding-topw <body>), aby zapobiec nakładaniu się z innymi elementami.

html
<nav class="navbar bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Default</a>
  </div>
</nav>
html
<nav class="navbar fixed-top bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Fixed top</a>
  </div>
</nav>
html
<nav class="navbar fixed-bottom bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Fixed bottom</a>
  </div>
</nav>
html
<nav class="navbar sticky-top bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Sticky top</a>
  </div>
</nav>
html
<nav class="navbar sticky-bottom bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Sticky bottom</a>
  </div>
</nav>

Przewijanie

Dodaj .navbar-nav-scrolldo .navbar-nav(lub innego podkomponentu paska nawigacyjnego), aby włączyć przewijanie w pionie w obrębie przełączalnej zawartości zwiniętego paska nawigacyjnego. Domyślnie przewijanie rozpoczyna się na 75vh(lub 75% wysokości okienka ekranu), ale można to zastąpić lokalną właściwością niestandardową CSS --bs-navbar-heightlub niestandardowymi stylami. W większych rzutniach, gdy pasek nawigacyjny jest rozwinięty, zawartość będzie wyglądać tak, jak na domyślnym pasku nawigacyjnym.

Należy pamiętać, że to zachowanie ma potencjalną wadę — gdy overflowustawienie overflow-y: auto(wymagane do przewijania zawartości tutaj) overflow-xjest odpowiednikiem auto, co spowoduje przycięcie części poziomej zawartości.

Oto przykładowy pasek nawigacyjny używający .navbar-nav-scrollz style="--bs-scroll-height: 100px;", z dodatkowymi narzędziami marginesów dla optymalnego odstępu.

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar scroll</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarScroll" aria-controls="navbarScroll" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarScroll">
      <ul class="navbar-nav me-auto my-2 my-lg-0 navbar-nav-scroll" style="--bs-scroll-height: 100px;">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item dropdown">
          <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
            Link
          </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><hr class="dropdown-divider"></li>
            <li><a class="dropdown-item" href="#">Something else here</a></li>
          </ul>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled">Link</a>
        </li>
      </ul>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

Zachowania responsywne

Paski nawigacyjne mogą używać klas .navbar-toggler, .navbar-collapse, i .navbar-expand{-sm|-md|-lg|-xl|-xxl}do określania, kiedy ich zawartość jest zwijana za przyciskiem. W połączeniu z innymi narzędziami możesz łatwo wybrać, kiedy pokazać lub ukryć poszczególne elementy.

W przypadku pasków nawigacyjnych, które nigdy się nie zwijają, dodaj .navbar-expandklasę do paska nawigacyjnego. W przypadku pasków nawigacyjnych, które zawsze się zwijają, nie dodawaj żadnej .navbar-expandklasy.

Przełączanie

Przełączniki paska nawigacyjnego są domyślnie wyrównane do lewej, ale jeśli podążają za elementem rodzeństwa, takim jak .navbar-brand, zostaną automatycznie wyrównane do prawej strony. Odwrócenie znaczników odwróci położenie przełącznika. Poniżej znajdują się przykłady różnych stylów przełączania.

Bez .navbar-brandpokazanego w najmniejszym punkcie przerwania:

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo01" aria-controls="navbarTogglerDemo01" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarTogglerDemo01">
      <a class="navbar-brand" href="#">Hidden brand</a>
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</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>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

Z nazwą marki pokazaną po lewej stronie i przełącznikiem po prawej:

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo02" aria-controls="navbarTogglerDemo02" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarTogglerDemo02">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</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>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

Z przełącznikiem po lewej i nazwą marki po prawej:

html
<nav class="navbar navbar-expand-lg bg-light">
  <div class="container-fluid">
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo03" aria-controls="navbarTogglerDemo03" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <a class="navbar-brand" href="#">Navbar</a>
    <div class="collapse navbar-collapse" id="navbarTogglerDemo03">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</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>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

Treść zewnętrzna

Czasami chcesz użyć wtyczki zwijania, aby wyzwolić element kontenera dla treści, która strukturalnie znajduje się poza .navbar. Ponieważ nasza wtyczka działa na dopasowywaniu idi data-bs-targetdopasowywaniu, jest to łatwe!

html
<div class="collapse" id="navbarToggleExternalContent">
  <div class="bg-dark p-4">
    <h5 class="text-white h4">Collapsed content</h5>
    <span class="text-muted">Toggleable via the navbar brand.</span>
  </div>
</div>
<nav class="navbar navbar-dark bg-dark">
  <div class="container-fluid">
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarToggleExternalContent" aria-controls="navbarToggleExternalContent" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
  </div>
</nav>

Gdy to zrobisz, zalecamy dołączenie dodatkowego kodu JavaScript, aby programowo przenieść fokus do kontenera po jego otwarciu. W przeciwnym razie użytkownicy klawiatury i użytkownicy technologii pomocniczych prawdopodobnie będą mieli trudności ze znalezieniem nowo ujawnionej zawartości – szczególnie jeśli otwarty kontener znajduje się przed przełącznikiem w strukturze dokumentu. Zalecamy również upewnienie się, że przełącznik ma aria-controlsatrybut wskazujący na idkontener treści. Teoretycznie pozwala to użytkownikom technologii wspomagających przeskoczyć bezpośrednio z przełącznika do kontrolowanego przez niego kontenera - ale obsługa tego jest obecnie dość niejednolita.

Offcanvas

Przekształć rozwijany i zwijający się pasek nawigacyjny w szufladę offcanvas z komponentem offcanvas . Rozszerzamy oba domyślne style offcanvas i używamy naszych .navbar-expand-*klas do tworzenia dynamicznego i elastycznego paska bocznego nawigacji.

W poniższym przykładzie, aby utworzyć pasek nawigacyjny poza kanwą, który jest zawsze zwinięty we wszystkich punktach przerwania, .navbar-expand-*całkowicie pomiń klasę.

html
<nav class="navbar bg-light fixed-top">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Offcanvas navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbar" aria-controls="offcanvasNavbar">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="offcanvas offcanvas-end" tabindex="-1" id="offcanvasNavbar" aria-labelledby="offcanvasNavbarLabel">
      <div class="offcanvas-header">
        <h5 class="offcanvas-title" id="offcanvasNavbarLabel">Offcanvas</h5>
        <button type="button" class="btn-close" data-bs-dismiss="offcanvas" aria-label="Close"></button>
      </div>
      <div class="offcanvas-body">
        <ul class="navbar-nav justify-content-end flex-grow-1 pe-3">
          <li class="nav-item">
            <a class="nav-link active" aria-current="page" href="#">Home</a>
          </li>
          <li class="nav-item">
            <a class="nav-link" href="#">Link</a>
          </li>
          <li class="nav-item dropdown">
            <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" 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>
                <hr class="dropdown-divider">
              </li>
              <li><a class="dropdown-item" href="#">Something else here</a></li>
            </ul>
          </li>
        </ul>
        <form class="d-flex" role="search">
          <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
          <button class="btn btn-outline-success" type="submit">Search</button>
        </form>
      </div>
    </div>
  </div>
</nav>

Aby utworzyć pasek nawigacyjny offcanvas, który rozwija się do normalnego paska nawigacyjnego w określonym punkcie przerwania lg, użyj .navbar-expand-lg.

<nav class="navbar navbar-expand-lg bg-light fixed-top">
  <a class="navbar-brand" href="#">Offcanvas navbar</a>
  <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#navbarOffcanvasLg" aria-controls="navbarOffcanvasLg">
    <span class="navbar-toggler-icon"></span>
  </button>
  <div class="offcanvas offcanvas-end" tabindex="-1" id="navbarOffcanvasLg" aria-labelledby="navbarOffcanvasLgLabel">
    ...
  </div>
</nav>

Używając offcanvas na ciemnym pasku nawigacyjnym, pamiętaj, że może być konieczne ciemne tło na treści offcanvas, aby uniknąć nieczytelności tekstu. W poniższym przykładzie dodajemy .navbar-darki .bg-darkdo .navbar, .text-bg-darkdo .offcanvas, .dropdown-menu-darkdo .dropdown-menui do, .btn-close-whiteaby .btn-closeuzyskać odpowiednią stylizację z ciemnym płótnem offcanvas.

html
<nav class="navbar navbar-dark bg-dark fixed-top">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Offcanvas dark navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasDarkNavbar" aria-controls="offcanvasDarkNavbar">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="offcanvas offcanvas-end text-bg-dark" tabindex="-1" id="offcanvasDarkNavbar" aria-labelledby="offcanvasDarkNavbarLabel">
      <div class="offcanvas-header">
        <h5 class="offcanvas-title" id="offcanvasDarkNavbarLabel">Dark offcanvas</h5>
        <button type="button" class="btn-close btn-close-white" data-bs-dismiss="offcanvas" aria-label="Close"></button>
      </div>
      <div class="offcanvas-body">
        <ul class="navbar-nav justify-content-end flex-grow-1 pe-3">
          <li class="nav-item">
            <a class="nav-link active" aria-current="page" href="#">Home</a>
          </li>
          <li class="nav-item">
            <a class="nav-link" href="#">Link</a>
          </li>
          <li class="nav-item dropdown">
            <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
              Dropdown
            </a>
            <ul class="dropdown-menu dropdown-menu-dark">
              <li><a class="dropdown-item" href="#">Action</a></li>
              <li><a class="dropdown-item" href="#">Another action</a></li>
              <li>
                <hr class="dropdown-divider">
              </li>
              <li><a class="dropdown-item" href="#">Something else here</a></li>
            </ul>
          </li>
        </ul>
        <form class="d-flex" role="search">
          <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
          <button class="btn btn-success" type="submit">Search</button>
        </form>
      </div>
    </div>
  </div>
</nav>

CSS

Zmienne

Dodano w wersji 5.2.0

W ramach ewoluującego podejścia Bootstrap do zmiennych CSS, paski nawigacyjne używają teraz lokalnych zmiennych CSS w .navbarcelu ulepszenia dostosowywania w czasie rzeczywistym. Wartości zmiennych CSS są ustawiane przez Sass, więc dostosowywanie Sass jest nadal obsługiwane.

  --#{$prefix}navbar-padding-x: #{if($navbar-padding-x == null, 0, $navbar-padding-x)};
  --#{$prefix}navbar-padding-y: #{$navbar-padding-y};
  --#{$prefix}navbar-color: #{$navbar-light-color};
  --#{$prefix}navbar-hover-color: #{$navbar-light-hover-color};
  --#{$prefix}navbar-disabled-color: #{$navbar-light-disabled-color};
  --#{$prefix}navbar-active-color: #{$navbar-light-active-color};
  --#{$prefix}navbar-brand-padding-y: #{$navbar-brand-padding-y};
  --#{$prefix}navbar-brand-margin-end: #{$navbar-brand-margin-end};
  --#{$prefix}navbar-brand-font-size: #{$navbar-brand-font-size};
  --#{$prefix}navbar-brand-color: #{$navbar-light-brand-color};
  --#{$prefix}navbar-brand-hover-color: #{$navbar-light-brand-hover-color};
  --#{$prefix}navbar-nav-link-padding-x: #{$navbar-nav-link-padding-x};
  --#{$prefix}navbar-toggler-padding-y: #{$navbar-toggler-padding-y};
  --#{$prefix}navbar-toggler-padding-x: #{$navbar-toggler-padding-x};
  --#{$prefix}navbar-toggler-font-size: #{$navbar-toggler-font-size};
  --#{$prefix}navbar-toggler-icon-bg: #{escape-svg($navbar-light-toggler-icon-bg)};
  --#{$prefix}navbar-toggler-border-color: #{$navbar-light-toggler-border-color};
  --#{$prefix}navbar-toggler-border-radius: #{$navbar-toggler-border-radius};
  --#{$prefix}navbar-toggler-focus-width: #{$navbar-toggler-focus-width};
  --#{$prefix}navbar-toggler-transition: #{$navbar-toggler-transition};
  

Niektóre dodatkowe zmienne CSS są również obecne na .navbar-nav:

  --#{$prefix}nav-link-padding-x: 0;
  --#{$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: var(--#{$prefix}navbar-color);
  --#{$prefix}nav-link-hover-color: var(--#{$prefix}navbar-hover-color);
  --#{$prefix}nav-link-disabled-color: var(--#{$prefix}navbar-disabled-color);
  

Dostosowanie za pomocą zmiennych CSS można zobaczyć w .navbar-darkklasie, w której nadpisujemy określone wartości bez dodawania zduplikowanych selektorów CSS.

  --#{$prefix}navbar-color: #{$navbar-dark-color};
  --#{$prefix}navbar-hover-color: #{$navbar-dark-hover-color};
  --#{$prefix}navbar-disabled-color: #{$navbar-dark-disabled-color};
  --#{$prefix}navbar-active-color: #{$navbar-dark-active-color};
  --#{$prefix}navbar-brand-color: #{$navbar-dark-brand-color};
  --#{$prefix}navbar-brand-hover-color: #{$navbar-dark-brand-hover-color};
  --#{$prefix}navbar-toggler-border-color: #{$navbar-dark-toggler-border-color};
  --#{$prefix}navbar-toggler-icon-bg: #{escape-svg($navbar-dark-toggler-icon-bg)};
  

Zmienne Sassa

Zmienne dla wszystkich pasków nawigacyjnych:

$navbar-padding-y:                  $spacer * .5;
$navbar-padding-x:                  null;

$navbar-nav-link-padding-x:         .5rem;

$navbar-brand-font-size:            $font-size-lg;
// Compute the navbar-brand padding-y so the navbar-brand will have the same height as navbar-text and nav-link
$nav-link-height:                   $font-size-base * $line-height-base + $nav-link-padding-y * 2;
$navbar-brand-height:               $navbar-brand-font-size * $line-height-base;
$navbar-brand-padding-y:            ($nav-link-height - $navbar-brand-height) * .5;
$navbar-brand-margin-end:           1rem;

$navbar-toggler-padding-y:          .25rem;
$navbar-toggler-padding-x:          .75rem;
$navbar-toggler-font-size:          $font-size-lg;
$navbar-toggler-border-radius:      $btn-border-radius;
$navbar-toggler-focus-width:        $btn-focus-width;
$navbar-toggler-transition:         box-shadow .15s ease-in-out;

$navbar-light-color:                rgba($black, .55);
$navbar-light-hover-color:          rgba($black, .7);
$navbar-light-active-color:         rgba($black, .9);
$navbar-light-disabled-color:       rgba($black, .3);
$navbar-light-toggler-icon-bg:      url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'><path stroke='#{$navbar-light-color}' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/></svg>");
$navbar-light-toggler-border-color: rgba($black, .1);
$navbar-light-brand-color:          $navbar-light-active-color;
$navbar-light-brand-hover-color:    $navbar-light-active-color;

Zmienne dla ciemnego paska nawigacyjnego :

$navbar-dark-color:                 rgba($white, .55);
$navbar-dark-hover-color:           rgba($white, .75);
$navbar-dark-active-color:          $white;
$navbar-dark-disabled-color:        rgba($white, .25);
$navbar-dark-toggler-icon-bg:       url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'><path stroke='#{$navbar-dark-color}' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/></svg>");
$navbar-dark-toggler-border-color:  rgba($white, .1);
$navbar-dark-brand-color:           $navbar-dark-active-color;
$navbar-dark-brand-hover-color:     $navbar-dark-active-color;

Sassowa pętla

Elastyczne klasy rozwijania/zwijania paska nawigacyjnego (np. .navbar-expand-lg) są łączone z $breakpointsmapą i generowane przez pętlę w programie scss/_navbar.scss.

// Generate series of `.navbar-expand-*` responsive classes for configuring
// where your navbar collapses.
.navbar-expand {
  @each $breakpoint in map-keys($grid-breakpoints) {
    $next: breakpoint-next($breakpoint, $grid-breakpoints);
    $infix: breakpoint-infix($next, $grid-breakpoints);

    // stylelint-disable-next-line scss/selector-no-union-class-name
    &#{$infix} {
      @include media-breakpoint-up($next) {
        flex-wrap: nowrap;
        justify-content: flex-start;

        .navbar-nav {
          flex-direction: row;

          .dropdown-menu {
            position: absolute;
          }

          .nav-link {
            padding-right: var(--#{$prefix}navbar-nav-link-padding-x);
            padding-left: var(--#{$prefix}navbar-nav-link-padding-x);
          }
        }

        .navbar-nav-scroll {
          overflow: visible;
        }

        .navbar-collapse {
          display: flex !important; // stylelint-disable-line declaration-no-important
          flex-basis: auto;
        }

        .navbar-toggler {
          display: none;
        }

        .offcanvas {
          // stylelint-disable declaration-no-important
          position: static;
          z-index: auto;
          flex-grow: 1;
          width: auto !important;
          height: auto !important;
          visibility: visible !important;
          background-color: transparent !important;
          border: 0 !important;
          transform: none !important;
          @include box-shadow(none);
          @include transition(none);
          // stylelint-enable declaration-no-important

          .offcanvas-header {
            display: none;
          }

          .offcanvas-body {
            display: flex;
            flex-grow: 0;
            padding: 0;
            overflow-y: visible;
          }
        }
      }
    }
  }
}