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
.navbar
w.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 znakrole="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 lubaria-current="true"
dla bieżącego elementu w zestawie.
prefers-reduced-motion
zapytania 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-brand
dla Twojej firmy, produktu lub nazwy projektu..navbar-nav
dla pełnej wysokości i lekkiej nawigacji (w tym obsługa list rozwijanych)..navbar-toggler
do użytku z naszą wtyczką zwijania i innymi zachowaniami przełączania nawigacji .- Narzędzia Flex i rozmieszczania dla dowolnych kontrolek formularzy i akcji.
.navbar-text
do dodawania ciągów tekstu wyśrodkowanych w pionie..collapse.navbar-collapse
do grupowania i ukrywania zawartości paska nawigacyjnego według nadrzędnego punktu przerwania.- Dodaj opcjonalny,
.navbar-scroll
aby ustawićmax-height
i 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.
<nav class="navbar navbar-expand-lg navbar-light 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="#" id="navbarDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</a>
<ul class="dropdown-menu" aria-labelledby="navbarDropdown">
<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">
<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 ( my-2
, my-lg-0
, me-sm-0
, ).my-sm-0
Marka
Można .navbar-brand
zastosować 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-brand
klasą.
<!-- As a link -->
<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
</div>
</nav>
<!-- As a heading -->
<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<span class="navbar-brand mb-0 h1">Navbar</span>
</div>
</nav>
Obraz
Możesz zamienić tekst .navbar-brand
w <img>
.
<nav class="navbar navbar-light bg-light">
<div class="container">
<a class="navbar-brand" href="#">
<img src="/docs/5.1/assets/brand/bootstrap-logo.svg" alt="" 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-block
i .align-text-top
na <img>
.
<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">
<img src="/docs/5.1/assets/brand/bootstrap-logo.svg" alt="" width="30" height="24" class="d-inline-block align-text-top">
Bootstrap
</a>
</div>
</nav>
Nav
Łącza nawigacyjne paska nawigacyjnego opierają się na naszych .nav
opcjach 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 .active
klasę .nav-link
, aby wskazać bieżącą stronę.
Należy pamiętać, że należy również dodać aria-current
atrybut do aktywnego .nav-link
.
<nav class="navbar navbar-expand-lg navbar-light 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.
<nav class="navbar navbar-expand-lg navbar-light 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-item
i .nav-link
jak pokazano poniżej.
<nav class="navbar navbar-expand-lg navbar-light 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="#" id="navbarDropdownMenuLink" role="button" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown link
</a>
<ul class="dropdown-menu" aria-labelledby="navbarDropdownMenuLink">
<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:
<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<form class="d-flex">
<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 .navbar
używają układu flex i będą domyślnie justify-content: space-between
. W razie potrzeby użyj dodatkowych narzędzi flex , aby dostosować to zachowanie.
<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand">Navbar</a>
<form class="d-flex">
<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.
<nav class="navbar navbar-light 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 do wyrównywania w pionie mogą być używane do wyrównywania elementów o różnych rozmiarach.
<nav class="navbar navbar-light 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.
<nav class="navbar navbar-light 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.
<nav class="navbar navbar-expand-lg navbar-light 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
Motywowanie paska nawigacyjnego nigdy nie było łatwiejsze dzięki połączeniu klas tematycznych i background-color
narzędzi. Wybierz opcję .navbar-light
do użytku z jasnymi kolorami tła lub .navbar-dark
ciemnymi kolorami 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 navbar-light" style="background-color: #e3f2fd;">
<!-- Navbar content -->
</nav>
Kontenery
Chociaż nie jest to wymagane, możesz zawinąć pasek nawigacyjny w , .container
aby wyśrodkować go na stronie, ale pamiętaj, że nadal wymagany jest kontener wewnętrzny. Możesz też dodać kontener wewnątrz, .navbar
aby wyśrodkować zawartość stałego lub statycznego górnego paska nawigacyjnego .
<div class="container">
<nav class="navbar navbar-expand-lg navbar-light 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.
<nav class="navbar navbar-expand-lg navbar-light 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. Wybierz opcję przymocowana do góry, przymocowana do dołu lub przyklejona do góry (przewija się wraz ze stroną, aż dotrze do góry, a następnie tam pozostanie). Naprawione paski nawigacyjne używają position: fixed
, co oznacza, że są pobierane z normalnego przepływu DOM i mogą wymagać niestandardowego CSS (np. padding-top
w <body>
), aby zapobiec nakładaniu się z innymi elementami.
Pamiętaj też, że .sticky-top
używa position: sticky
, który nie jest w pełni obsługiwany w każdej przeglądarce .
<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Default</a>
</div>
</nav>
<nav class="navbar fixed-top navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Fixed top</a>
</div>
</nav>
<nav class="navbar fixed-bottom navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Fixed bottom</a>
</div>
</nav>
<nav class="navbar sticky-top navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Sticky top</a>
</div>
</nav>
Przewijanie
Dodaj .navbar-nav-scroll
do .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 widocznego obszaru), ale można to zastąpić lokalną właściwością niestandardową CSS --bs-navbar-height
lub 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 overflow
ustawienie overflow-y: auto
(wymagane do przewijania zawartości tutaj) overflow-x
jest odpowiednikiem auto
, co spowoduje przycięcie części poziomej zawartości.
Oto przykładowy pasek nawigacyjny używający .navbar-nav-scroll
z style="--bs-scroll-height: 100px;"
, z dodatkowymi narzędziami marginesów dla optymalnego odstępu.
<nav class="navbar navbar-expand-lg navbar-light 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="#" id="navbarScrollingDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
Link
</a>
<ul class="dropdown-menu" aria-labelledby="navbarScrollingDropdown">
<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">
<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-expand
klasę do paska nawigacyjnego. W przypadku pasków nawigacyjnych, które zawsze się zwijają, nie dodawaj żadnej .navbar-expand
klasy.
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-brand
pokazanego w najmniejszym punkcie przerwania:
<nav class="navbar navbar-expand-lg navbar-light 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">
<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:
<nav class="navbar navbar-expand-lg navbar-light 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">
<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:
<nav class="navbar navbar-expand-lg navbar-light 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">
<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 id
i data-bs-target
dopasowywaniu, jest to łatwe!
<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-controls
atrybut wskazujący na id
kontener 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 za pomocą wtyczki 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ę.
<nav class="navbar navbar-light 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 text-reset" 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="#" id="offcanvasNavbarDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</a>
<ul class="dropdown-menu" aria-labelledby="offcanvasNavbarDropdown">
<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">
<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-light 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>
Sass
Zmienne
$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-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-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;
$navbar-dark-brand-color: $navbar-dark-active-color;
$navbar-dark-brand-hover-color: $navbar-dark-active-color;
Pętla
Klasy rozwijania/zwijania paska nawigacyjnego (np. .navbar-expand-lg
) są łączone z $breakpoints
mapą 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: $navbar-nav-link-padding-x;
padding-left: $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-header {
display: none;
}
.offcanvas {
position: inherit;
bottom: 0;
z-index: 1000;
flex-grow: 1;
visibility: visible !important; // stylelint-disable-line declaration-no-important
background-color: transparent;
border-right: 0;
border-left: 0;
@include transition(none);
transform: none;
}
.offcanvas-top,
.offcanvas-bottom {
height: auto;
border-top: 0;
border-bottom: 0;
}
.offcanvas-body {
display: flex;
flex-grow: 0;
padding: 0;
overflow-y: visible;
}
}
}
}
}