chevron-left chevron-right

Piotr Nalepa Frontend, architecture and AI

[JS] Jak zbudować menu dopasowujące się do szerokości strony z wykorzystaniem AdaptiveNav.js?

This version
blog.piotrnalepa.pl/2016/03/20/js-jak-zbudowac-menu-dopasowujace-sie-do-szerokosci-strony-z-wykorzystaniem-adaptivenav-js
Published
Author
, Staff Software Engineer
Category
JavaScript
Feedback
Write to me · Post on X

This post is 10 years old. Browsers and tools may have changed since then, so check the code against current documentation before you use it.

Tworząc nowoczesne strony internetowe bardzo często można się spotkać z problemem działania nawigacji w różnych trybach działania strony. Czy menu ma się chować? Czy może ma zmieniać swój kształt i wygląd? Jest wiele różnych podejść.

Ten artykuł jest pierwszym z serii artykułów w których będę opisywał sposoby wykorzystania pluginów Javascript stworzonych w wolnych chwilach przeze mnie.

Section 1AdaptiveNav.js - co to jest?

AdaptiveNav.js jest to plugin Javascript, który pozwala na dostosowanie liczby widocznych elementów menu w zależności od szerokości ekranu. Jeśli elementy nie mieszczą się na ekranie, to wtedy zostają przeniesione do listy rozwijanej która jest otwierana za pomocą dodatkowego przycisku w nawigacji.

Sposób działania pluginu można zobaczyć na animacji poniżej:

AdaptiveNav.js in action

Section 2Jak wykorzystać plugin na swojej stronie?

Aby móc wykorzystać możliwości pluginu na swojej stronie, należy pobrać plugin z repozytorium na Github.com lub uruchomić w linii komend następującą komendę:

npm install adaptive-nav

Następnie, należy dołączyć pliki adaptive-nav.min.js oraz adaptive-nav.css na swojej stronie.

Kolejnym krokiem jest przygotowanie struktury nawigacji w kodzie HTML. Przykładowa struktura może wyglądać następująco:

Example 1HTML
1
2
3
4
5
6
7
8
9
<nav class="adaptive-nav">
    <ul class="adaptive-nav__list">
        <li class="adaptive-nav__list__item">Item 1</li>
        <li class="adaptive-nav__list__item">Item 2</li>
        [...]
        <li class="adaptive-nav__list__item">Item 14</li>
        <li class="adaptive-nav__list__item">Item 15</li>
    </ul>
</nav>

Jeśli korzystamy z tej struktury, to możemy uruchomić plugin w następujący sposób:

Example 2JavaScript
1
new AdaptiveNav();

Section 3Zaawansowane wykorzystanie pluginu AdaptiveNav.js

W przypadku gdy dysponujemy inną strukturą HTML lub innymi klasami CSS dodanymi do elementów nawigacji, to możemy nieco zmodyfikować działanie pluginu poprzez dodanie obiektu z konfiguracją podczas inicjalizacji pluginu.

Example 3JavaScript
1
2
3
4
5
6
7
8
var adaptiveNav = new AdaptiveNav({
    // selektor CSS kontenera zawierającego menu z elementami nawigacji
    navSelector: '.nav-container',
    // selektor CSS listy z elementami nawigacji
    navListSelector: '.nav-list',
    // selektor CSS elementów nawigacji pierwszego poziomu (elementy z dodatkowych menu rozwijanych nie powinny używać tego selektora)
    navItemSelector: '.nav-item'
});

W przykładzie powyżej przedstawiono wszystkie opcje konfiguracyjne pluginu. Wszystkie z nich dotyczą selektorów CSS na podstawie których plugin będzie mógł odpowiednio zmodyfikować swoje działanie.

Ponadto, AdaptiveNav.js udostępnia metodę do aktualizowania stanu nawigacji (widoczności elementów nawigacji) na żądanie. Wystarczy tak jak w przykładzie powyżej utworzyć zmienną o nazwie adaptiveNav a następnie wywołać metodę aktualizującą stan nawigacji:

Example 4JavaScript
1
adaptiveNav.update();

Section 4Podsumowanie

Mam nadzieję, że plugin utworzony przeze mnie okaże się przydatny w Twojej codziennej pracy. Po zminifikowaniu plik z kodem waży niecałe 3kB. Wszelkie uwagi co do działania pluginu można zgłaszać w komentarzach do tego wpisu lub bezpośrednio na Github.com.

Zapraszam do pobierania pluginu stąd - AdaptiveNav.js | Github.com

Share
Feedback

About the author

Staff Software Engineer

I've been writing this blog since 2009 and building for the web professionally for 14 years. Today I lead the frontend of the Cosmos platform at Bishop Fox, where I've been since day one of the project. Before that I worked at OLX, KUDO, Auto1 and eZ Systems. Here I write about what I've learned in practice: JavaScript, TypeScript, React, CSS and frontend architecture. I've also spoken at conferences across Poland and Europe. Got a question or an idea for a post? Let me know!