Przejdź do treści
Spis treści

Komponenty

Komponenty

Biblioteka tego, co naprawdę jest w aplikacji, opisana w stanie docelowym. Każda strona mówi, kiedy używać, kiedy nie, jakie są warianty i stany, jak działa z klawiatury, i czy aplikacja jest z tym zgodna dzisiaj.

Stan rozdziału:
szkic

Skąd się biorą komponenty

Z aplikacji, nie z wyobraźni. Katalog apps/web/src/components/system ma dziś: przycisk, kartę, odznakę, pole, tabelę, zakładki, menu, awatar i listę wyboru. Poza system są komponenty domenowe: stany urządzenia (stan.tsx), paszport, nawigacja, pusty stan placówki, formularze. Kanon opisuje je w kolejności od najczęściej używanych.

Żywe przykłady na tych stronach są zbudowane z tokenów brandbooka, więc pokazują stan docelowy, nie obecny wygląd aplikacji. Różnice stoją w ramkach „Rozbieżność”.

Stan rozdziału

KomponentW aplikacjiW KanonieAplikacja zgodna?
Przyciskisystem/przycisk.tsx, przycisk-klasy.tsgotowerozjazd: kolor, narożnik, cień
Kartysystem/karta.tsxgotowerozjazd: kolor tła i cień
Oznaczenia statusustan.tsx, system/odznaka.tsxgotowezgodne co do zasady
Tabelesystem/tabela.tsxgotowezgodne co do układu
Pola formularzasystem/pole.tsxszkicrozjazd: narożnik
Zakładkisystem/zakladki.tsxszkicrozjazd: narożnik
Powiadomieniabrak komponentudo napisanianie ma tego elementu
Modalebrak komponentudo napisanianie ma tego elementu
Nawigacjanawigacja.tsxdo napisaniarozjazd: znak, kolor
Stany pustepusta-placowka.tsx, teksty w pl.jsonszkiczgodne co do zasady
Stany ładowaniabrak (loading.tsx nie istnieje)do napisanianie ma tego elementu
Stany błędurole="alert" w formularzach, not-found.tsxszkiczgodne co do zasady

Co każda strona komponentu zawiera

  • Żywy przykład zbudowany z tokenów.
  • Kiedy używać i kiedy nie.
  • Warianty i stany (spoczynek, najechanie, ognisko, wciśnięcie, wyłączony, błąd).
  • Dostępność z klawiatury: co robi Tab, Enter, Spacja, Escape, strzałki.
  • Zgodność aplikacji: co jest dziś inaczej i w którym pliku to zmienić.