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.
<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
72px od krawędzi początku, rozwinięcie otwiera się przy312px, a trzeci poziom przy552px. 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.
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.
StanyLink do sekcji Stany
| Stan | Zachowanie |
|---|---|
| Zwarty (domyślny) | Widać tylko pasek 72 px, a treść ma pełną szerokość. Wybierz sekcję, aby otworzyć jej panel. |
| Unoszący się panel | Sekcja 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. |
| Zadokowany | Przycisk 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 poziom | Strona 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 poziom | Wiersz 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 telefonie | Poniż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.
| Grupa | Ikona | Co do niej należy |
|---|---|---|
| Start | nav.home | Strona startowa aplikacji: podsumowanie, to, co wymaga uwagi, skróty. Zwykły link, bez panelu. |
| Treści | file.document | To, co aplikacja przechowuje, a użytkownik pisze lub edytuje: strony, wpisy, media, projekty, dokumenty. |
| Sprzedaż | content.product | Wszystko, co się sprzedaje lub realizuje: produkty, zamówienia, klienci, zwroty. Pomiń w aplikacjach bez takich funkcji. |
| Marketing | ai.sparkles | Docieranie do ludzi: newslettery, kampanie, wygląd w wyszukiwarce, wpisy społecznościowe. |
| Statystyki | nav.analytics | Czytanie, jak idzie: przegląd, ruch, raporty, dzienniki. |
| Ustawienia | nav.settings | Konfiguracja 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.
| Aplikacja | Start | Treści | Sprzedaż | Marketing | Statystyki | Ustawienia |
|---|---|---|---|---|---|---|
| Agent (aplikacja desktopowa) | Start | Umiejętności, sesje | Brak | Brak | Historia uruchomień, użycie | Modele, foldery, konto |
| Panel treści | Start | Strony, wpisy, media | Zamówienia, produkty (po włączeniu) | Newsletter, wygląd w wyszukiwarce | Ruch, raporty | Witryna, członkowie, integracje |
| Tracker | Start | Projekty, zgłoszenia, tablice | Brak | Brak | Wykres spalania, tempo, raporty | Przestrzeń, członkowie, etykiety |
| Hub | Start | Aplikacje, projekty | Brak | Brak | Aktywność aplikacji | Konto, zespół, tokeny |
| Id | Start | Brak | Brak | Brak | Aktywność logowania | Profil, 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 jestduo, ikony linków panelu sąmono, a ikona bieżącego linku jestbrand. - Bieżący element ma też wypełnioną pigułkę i grubszą etykietę, więc nigdy nie zależy od samego koloru.
{ 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.
{ href: '/orders', label: 'Zamówienia', count: 4, countLabel: '4 nowe' }Klawiatura i czytnik ekranuLink do sekcji Klawiatura i czytnik ekranu
| Gdzie | Klawisze | Co się dzieje |
|---|---|---|
| Pasek | Strzałka w górę, w dół, Home, End | Przechodzą między przyciskami paska. Fokus nie zawija się. |
| Pasek | Enter, Spacja albo strzałka w prawo | Otwierają panel sekcji i przenoszą fokus na otwartą stronę albo pierwszy link. |
| Panel lub rozwinięcie | Strzałka w prawo, Enter albo Spacja na wierszu ze strzałką-szewronem | Otwierają jego boczny poziom i przenoszą fokus na pierwszy link tego poziomu. |
| Panel lub rozwinięcie | Strzałka w lewo albo Esc | Zamykają ten poziom i oddają fokus wierszowi albo przyciskowi paska, który go otworzył. Esc na pasku zamyka unoszący się panel. |
| Panel lub rozwinięcie | Strzałka w górę, w dół, Home, End | Przechodzą między linkami w obrębie jednego poziomu oraz z pola filtra do pierwszego linku. |
| Panel | Pisanie w polu filtra | Zawęż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. |
| Strona | Tab | Kolejność: 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-expandediaria-controlswskazujące jego panel. - Wiersz z podstronami jest przyciskiem z
aria-expanded,aria-controlsiaria-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
hideLabelssł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.
<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
Zamówienia i realizacja
Sprzedaż, Produkty, a Warianty w rozwinięciu z boku
Produkty z Wariantami wypisanymi pod spodem
Zwykłe nagłówki: Zamówienia, Katalog
Nagłówek Katalog, który się zwija
Sprzedaż, Produkty, Warianty, a resztę w kartach
Sprzedaż, Produkty, Warianty, Opcje, Wartości
Wypełniona pigułka, grubsza etykieta i aria-current
Tylko inny kolor
Przełącznik, motyw i menu użytkownika
Przycisk „Nowe zamówienie” na pasku
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.