Przejdź do treści

Wzorce

Panel boczny

Jeden panel boczny dla każdej aplikacji Skribly: aplikacji desktopowej Agent, panelu treści, Trackera, Hubu i Id. Wąski pasek sekcji, panel ich stron i rozwinięcia otwierane z boku, nigdy w dół, budowany z celem WCAG 2.2 AA.

BudowaLink do sekcji Budowa

SidebarRail ma cztery części. Pasek ma 72 px szerokości, z ikoną i krótką etykietą przy każdej sekcji. Panel boczny ma 240 px szerokości i wymienia strony otwartej sekcji pod zwykłymi nagłówkami. Strona z podstronami jest wierszem ze strzałką-szewronem, a jej podstrony otwierają się w rozwinięciu, również 240 px szerokim, jeszcze dalej w bok i na wysokości wiersza; trzeci poziom otwiera się tak samo. Nic nigdy nie rozwija się w dół. Przełącznik witryny lub przestrzeni roboczej leży nad paskiem; motyw i menu użytkownika są na dole.

Przykład poniżej jest zadokowany i stoi na Sprzedaż, Produkty, Warianty, więc droga do otwartej strony jest podświetlona na każdym poziomie. Najedź na Produkty albo naciśnij na nich Enter, aby zobaczyć rozwinięcie.

Zadokowany: pasek, panel i rozwinięcie Produktów
Przejdź do treściPrzejdź do nawigacji

Warianty

Strony ze strzałką otwierają kolejny poziom dalej w bok.

tsx
<SidebarRail
  sections={[
    {
      id: 'commerce',
      label: 'Sprzedaż',
      icon: <Icon name="content.product" />,
      groups: [
        {
          label: 'Zamówienia',
          links: [
            {
              href: '/products',
              label: 'Produkty',
              children: [
                { href: '/products/variants', label: 'Warianty' },
                { href: '/products/brands', label: 'Marki' }
              ]
            }
          ]
        }
      ]
    }
  ]}
  current={pathname}
  labels={labels}
  storageKey="content"
  top={<SiteSwitcher />}
  bottom={
    <>
      <ThemeMenu />
      <UserMenu />
    </>
  }
/>

Kaskada w bokLink do sekcji Kaskada w bok

  • Pasek otwiera panel w odległości 72 px od krawędzi początku, rozwinięcie otwiera się przy 312 px, a trzeci poziom przy 552 px. Każdy zachodzi o 1 px na poprzednią ramkę.
  • Górna krawędź rozwinięcia leży na wysokości wiersza, który je otworzył, i przesuwa się w górę tylko tyle, by zostać wewnątrz panelu bocznego. Wyższe rozwinięcie przewija się w środku.
  • Otwarcie poziomu nigdy nie przesuwa żadnego wiersza poziomu, który zawiera jego rodzica.
  • Zamiar najechania: mysz otwiera poziom sekcji lub wiersza po 150 ms najechania, więc wskaźnik przesuwający się po wierszach nie otwiera poziomów na chwilę.
  • Bezpieczny trójkąt: gdy głębszy poziom jest otwarty, przesuwanie wskaźnika po przekątnej w jego stronę nie przełącza na wiersze, które mija po drodze. Przełączenie czeka około 300 ms i jest anulowane, gdy wskaźnik wejdzie na poziom.
  • Unoszący się panel i wszystkie rozwinięcia zamykają się po kliknięciu obok, klawiszu Esc, gdy wskaźnik opuści cały panel boczny, i po wyborze strony.
Domyślnie zwarty: najedź na Sprzedaż, potem na Produkty
Przejdź do treściPrzejdź do nawigacji

Warianty

Strony ze strzałką otwierają kolejny poziom dalej w bok.

Na telefonieLink do sekcji Na telefonie

Poniżej 48 rem nie ma rozwinięć. Przycisk menu otwiera jedną modalną szufladę, której poziomy są ekranami: najpierw sekcje, potem sekcja, potem podstrony wiersza. Nowy ekran wsuwa się z boku, a każdy ekran poza pierwszym zaczyna się wierszem powrotu, który mówi, dokąd wraca, na przykład „Wróć do: Sprzedaż”, ustawionym przez labels.backTo. Szuflada otwiera się na ekranie otwartej strony.

Ramka 24 rem: otwórz menu
Przejdź do treściPrzejdź do nawigacji

Warianty

Strony ze strzałką otwierają kolejny poziom dalej w bok.

StanyLink do sekcji Stany

Sześć stanów panelu bocznego
StanZachowanie
Zwarty (domyślny)Widać tylko pasek 72 px, a treść ma pełną szerokość. Wybierz sekcję, aby otworzyć jej panel.
Unoszący się panelSekcja otwiera swój panel 240 px z boku paska, nad treścią. Otwiera się po kliknięciu, klawiszu Enter, Spacja albo strzałce w prawo, a po najechaniu myszą na 150 ms pokazuje podgląd. Zamyka się po kliknięciu obok, klawiszu Esc albo wyborze strony.
ZadokowanyPrzycisk przypięcia w nagłówku panelu przypina panel obok treści i zostaje on na miejscu. Okrągły przycisk na krawędzi panelu bocznego albo klawisz [ zwija go z powrotem do paska i przypina ponownie; treść przesuwa się razem z nim przez 180 ms. Wybór i ostatnia sekcja są zapamiętywane pod kluczem storageKey. Rozwinięcia boczne nadal się unoszą.
Drugi poziomStrona z podstronami jest wierszem ze strzałką-szewronem. Otwiera rozwinięcie 240 px jeszcze dalej w bok od panelu, z górną krawędzią na wysokości wiersza. Rozwinięcie zaczyna się linkiem do strony nadrzędnej.
Trzeci poziomWiersz rozwinięcia też może mieć podstrony, a one otwierają w ten sam sposób jeszcze jedno rozwinięcie w bok. Czwarty poziom nie jest obsługiwany.
Szuflada na telefoniePoniżej 48 rem pasek zamienia się w jedną modalną szufladę za przyciskiem menu. Każdy poziom jest ekranem wsuwającym się z boku, z wierszem powrotu nazwanym przez labels.backTo, na przykład „Wróć do: Sprzedaż”. Nic nie rozwija się w miejscu.

Sześć standardowych grupLink do sekcji Sześć standardowych grup

Każda aplikacja używa tych grup, w tej kolejności, więc kto zna jedną aplikację Skribly, znajdzie te same miejsca w następnej. Aplikacja pomija grupy, do których nie ma funkcji; nigdy ich nie przemianowuje ani nie przestawia.

Sześć grup, ich ikona z rejestru i to, co do nich należy
GrupaIkonaCo do niej należy
Startnav.homeStrona startowa aplikacji: podsumowanie, to, co wymaga uwagi, skróty. Zwykły link, bez panelu.
Treścifile.documentTo, co aplikacja przechowuje, a użytkownik pisze lub edytuje: strony, wpisy, media, projekty, dokumenty.
Sprzedażcontent.productWszystko, co się sprzedaje lub realizuje: produkty, zamówienia, klienci, zwroty. Pomiń w aplikacjach bez takich funkcji.
Marketingai.sparklesDocieranie do ludzi: newslettery, kampanie, wygląd w wyszukiwarce, wpisy społecznościowe.
Statystykinav.analyticsCzytanie, jak idzie: przegląd, ruch, raporty, dzienniki.
Ustawienianav.settingsKonfiguracja aplikacji lub witryny: ogólne, integracje, członkowie i role, rozliczenia, zaawansowane.

Jak aplikacja przypisuje swoje sekcje

Aplikacja zachowuje własne słowa dla stron i funkcji i umieszcza je pod najbliższą grupą. Gdy grupa nie pasuje, na pasku po prostu nie ma takiego przycisku.

Które strony każdej aplikacji trafiają pod którą grupę
AplikacjaStartTreściSprzedażMarketingStatystykiUstawienia
Agent (aplikacja desktopowa)StartUmiejętności, sesjeBrakBrakHistoria uruchomień, użycieModele, foldery, konto
Panel treściStartStrony, wpisy, mediaZamówienia, produkty (po włączeniu)Newsletter, wygląd w wyszukiwarceRuch, raportyWitryna, członkowie, integracje
TrackerStartProjekty, zgłoszenia, tabliceBrakBrakWykres spalania, tempo, raportyPrzestrzeń, członkowie, etykiety
HubStartAplikacje, projektyBrakBrakAktywność aplikacjiKonto, zespół, tokeny
IdStartBrakBrakBrakAktywność logowaniaProfil, logowanie, urządzenia

IkonyLink do sekcji Ikony

  • Ikony pochodzą wyłącznie z rejestru: <Icon name="nav.home" />. Zobacz .docs/how-to/use-icons.md.
  • Trzy tony, ustawiane przez sam pasek, więc przekazujesz zwykłe Icon: ikony paska są brand, ikona bieżącej sekcji jest duo, ikony linków panelu są mono, a ikona bieżącego linku jest brand.
  • Bieżący element ma też wypełnioną pigułkę i grubszą etykietę, więc nigdy nie zależy od samego koloru.
tsx
{ id: 'commerce', label: 'Sprzedaż', icon: <Icon name="content.product" /> }
{ href: '/orders', label: 'Zamówienia', icon: <Icon name="nav.inbox" /> }

Liczniki i plakietkiLink do sekcji Liczniki i plakietki

Sekcje i linki przyjmują count i countLabel. Czytnik ekranu odczytuje etykietę słowami, na przykład „Zamówienia, 4 nowe”, nigdy samą liczbę. Liczba jest pokazana jako plakietka i nigdy nie jest jedynym sygnałem: znaczenie niosą słowa, nie kolor.

tsx
{ href: '/orders', label: 'Zamówienia', count: 4, countLabel: '4 nowe' }

Klawiatura i czytnik ekranuLink do sekcji Klawiatura i czytnik ekranu

Mapa klawiszy panelu bocznego
GdzieKlawiszeCo się dzieje
PasekStrzałka w górę, w dół, Home, EndPrzechodzą między przyciskami paska. Fokus nie zawija się.
PasekEnter, Spacja albo strzałka w prawoOtwierają panel sekcji i przenoszą fokus na otwartą stronę albo pierwszy link.
Panel lub rozwinięcieStrzałka w prawo, Enter albo Spacja na wierszu ze strzałką-szewronemOtwierają jego boczny poziom i przenoszą fokus na pierwszy link tego poziomu.
Panel lub rozwinięcieStrzałka w lewo albo EscZamykają ten poziom i oddają fokus wierszowi albo przyciskowi paska, który go otworzył. Esc na pasku zamyka unoszący się panel.
Panel lub rozwinięcieStrzałka w górę, w dół, Home, EndPrzechodzą między linkami w obrębie jednego poziomu oraz z pola filtra do pierwszego linku.
PanelPisanie w polu filtraZawęża linki według etykiety i słów kluczowych; akcenty są pomijane. Brak wyników jest odczytywany.
Strona[Zwija przypięty panel do paska albo przypina go ponownie. Działa poza polami tekstowymi; to samo robi przycisk na krawędzi panelu bocznego, a jego dymek podpowiedzi podaje klawisz. Wybór jest zapamiętywany.
StronaTabKolejność: linki pomijania (do nawigacji i do treści), przyciski paska, otwarty poziom, treść. Każdy przycisk paska jest przystankiem klawisza Tab; strzałki są szybszą drogą między nimi, a link pomijania przeskakuje pasek.
  • Pasek jest nazwaną nawigacją z przyciskami. Każdy przycisk sekcji ma aria-expanded i aria-controls wskazujące jego panel.
  • Wiersz z podstronami jest przyciskiem z aria-expanded, aria-controls i aria-haspopup; jego szewron jest dekoracyjny. Rozwinięcie jest nawigacją nazwaną swoim tytułem.
  • Tylko otwarta strona ma aria-current="page"; wiersze na drodze do niej przyjmują ton akcentu i niczego nie dodają.
  • Panel jest nawigacją nazwaną swoim tytułem. Otwarta strona ma aria-current="page".
  • Przy hideLabels słowa pod ikonami są ukryte, a każdy przycisk pokazuje swoją etykietę w dymku podpowiedzi.
  • Każdy cel ma co najmniej 44 px.

RuchLink do sekcji Ruch

Unoszący się panel i każde rozwinięcie przesuwają się o 8 px i pojawiają przez 180 ms (--sk-duration-hover), a ekran na telefonie wsuwa się w tym samym czasie. Przy ograniczonym ruchu pojawiają się i znikają bez przesuwania.

W aplikacji desktopowejLink do sekcji W aplikacji desktopowej

W oknie Electrona z ukrytym paskiem tytułu desktop="mac", "windows" albo "linux" zostawia przeciągalny pas nad paskiem i panelem: 52 px na macOS, na przyciski okna, i 32 px gdzie indziej. titleBarHeight ustawia inną wysokość. Szare kropki w przykładzie oznaczają przyciski okna macOS.

desktop="mac" z hideLabels
Przejdź do treściPrzejdź do nawigacji

Warianty

Strony ze strzałką otwierają kolejny poziom dalej w bok.

tsx
<SidebarRail desktop="mac" hideLabels sections={sections} current={pathname} labels={labels} />
// main process: new BrowserWindow({ titleBarStyle: 'hiddenInset' })

Rób i nie róbLink do sekcji Rób i nie rób

Zamówienia

Rób tak. Utrzymuj etykiety do jednego słowa, żeby mieściły się pod ikoną w 72 px.

Zamówienia i realizacja

Nie rób tak. Używaj długiej etykiety, która się zawija albo jest ucięta.

Sprzedaż, Produkty, a Warianty w rozwinięciu z boku

Rób tak. Otwieraj głębsze strony w bok, w rozwinięciu na wysokości wiersza.

Produkty z Wariantami wypisanymi pod spodem

Nie rób tak. Rozwijaj listę w dół pod jej rodzicem.

Zwykłe nagłówki: Zamówienia, Katalog

Rób tak. Grupuj linki pod zwykłymi nagłówkami, które są zawsze widoczne.

Nagłówek Katalog, który się zwija

Nie rób tak. Zwijaj grupy.

Sprzedaż, Produkty, Warianty, a resztę w kartach

Rób tak. Zatrzymaj się na trzech poziomach, a głębsze strony przenieś do kart w nagłówku strony.

Sprzedaż, Produkty, Warianty, Opcje, Wartości

Nie rób tak. Zagnieżdżaj czwarty poziom.

Wypełniona pigułka, grubsza etykieta i aria-current

Rób tak. Oznaczaj bieżący element kształtem, grubością i aria-current.

Tylko inny kolor

Nie rób tak. Oznaczaj bieżący element samym kolorem.

Przełącznik, motyw i menu użytkownika

Rób tak. Zostaw pasek na nawigację, plus przełącznik, motyw i menu użytkownika.

Przycisk „Nowe zamówienie” na pasku

Nie rób tak. Umieszczaj na pasku akcje, które nie są nawigacją.

Lista wdrożeniaLink do sekcji Lista wdrożenia

  • Sekcje są przypisane do sześciu grup, w standardowej kolejności, a grupy zbędne dla aplikacji są pominięte.
  • Każda ikona to nazwa z rejestru, przez Icon, w trzech tonach.
  • Etykiety, prop labels, aria-label i countLabel są propami w języku angielskim i polskim, bez żadnych tekstów wbudowanych w powłokę aplikacji.
  • Liczniki mają countLabel czytany słowami.
  • storageKey jest ustawiony dla każdej aplikacji, żeby aplikacje w jednej domenie nie dzieliły wyboru.
  • Agent przekazuje desktop i wysokość paska tytułu zgodną z ustawieniem okna.
  • Głębsze strony otwierają się z boku jako podstrony swojego wiersza: żadna lista nie rozwija się w dół, żadna grupa się nie zwija i nie ma czwartego poziomu.
  • Każdy wiersz nadrzędny ma własną stronę, a labels.backTo jest ustawione, żeby szuflada na telefonie nazywała, dokąd wraca każdy wiersz powrotu.
  • Panel w Laravelu stosuje się do .docs/how-to/adopt-the-sidebar.md.

Szukaj na stronie

Strzałki przenoszą między wynikami, Enter otwiera, Esc zamyka. Ctrl K /