Dodatki Storybook i testowanie dostępności
@storybook/addon-a11y, dodatek viewport oraz dodatek docs do automatycznej dokumentacji.
Dodatki Storybook i testowanie dostępności to bezpłatna lekcja Vue Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Vue Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Vue Academy zawiera 4 lekcji w sumie.
Rozszerzanie Storybooka za pomocą dodatków
Dodatki integrują z Storybookiem dodatkowe panele i narzędzia. Oprócz Controls i Actions dodatki obsługują dostępność, responsywne widoki oraz automatycznie generowaną dokumentację.
Dodatek Accessibility
@storybook/addon-a11y uruchamia silnik axe-core dla każdego story i zgłasza naruszenia standardu WCAG — problemy z kontrastem, brakujące etykiety i nieprawidłowe role — bezpośrednio w panelu.
// terminal
// npm install -D @storybook/addon-a11yRejestrowanie dodatku
Dodaj dodatek do tablicy addons w pliku .storybook/main.ts. Uruchom ponownie Storybooka, aby go załadować.
// .storybook/main.ts
const config = {
addons: [
"@storybook/addon-essentials",
"@storybook/addon-a11y",
],
}Odczytywanie panelu a11y
Otwórz story i przejdź do karty Accessibility. Każdy wynik jest pogrupowany jako: Violations (wymagają naprawy), Passes (zaliczone) oraz Incomplete (wymagają ręcznego sprawdzenia). Kliknięcie naruszenia wyróżnia dany element.
Typowe naruszenia wykrywane przez dodatek
- Niewystarczający kontrast kolorów tekstu i tła.
- Przyciski lub linki bez dostępnych nazw.
- Obrazy bez tekstu
alt. - Pola formularzy bez powiązanych etykiet.
Wykrywanie tych problemów w izolacji jest znacznie tańsze niż robienie tego po wydaniu.
Konfiguracja a11y dla pojedynczego story
Reguły można dostosowywać dla poszczególnych stories za pomocą parametrów — na przykład wyłączyć regułę obsługiwaną w innym miejscu lub oznaczyć elementy do pominięcia.
export const NoContrastCheck = {
parameters: {
a11y: {
config: {
rules: [{ id: "color-contrast", enabled: false }],
},
},
},
}Dodatek Viewport
Dodatek viewport (wchodzący w skład essentials) pozwala wyświetlać story w różnych rozmiarach urządzeń — telefonu, tabletu i komputera — aby weryfikować responsywne punkty przełomowe.
Wybieranie widoku
Lista rozwijana na pasku narzędzi przełącza obszar roboczy na gotowe ramki urządzeń. Można także ustawić domyślny viewport dla pojedynczego story.
export const Mobile = {
parameters: {
viewport: { defaultViewport: "mobile1" },
},
}Niestandardowe viewporty
Zdefiniuj własne punkty przełomowe w pliku preview.ts, aby odpowiadały dokładnym szerokościom w systemie projektowym.
// .storybook/preview.ts
const preview = {
parameters: {
viewport: {
viewports: {
tablet: { name: "Tablet", styles: { width: "768px", height: "1024px" } },
},
},
},
}Dodatek Docs
@storybook/addon-docs odpowiada za automatycznie generowaną dokumentację. W połączeniu z tags: ["autodocs"] tworzy stronę Docs dla każdego komponentu na podstawie propsów i stories.
export default {
component: Card,
tags: ["autodocs"],
}Dokumentacja, która pozostaje aktualna
Ponieważ dokumentacja jest generowana na podstawie rzeczywistych komponentów i stories, nie może się zdezaktualizować. Tabele propsów odzwierciedlają faktyczne definicje propsów, a przykłady to działające stories.
Szybkie sprawdzenie
Sprawdź swoją wiedzę na temat dodatków Storybooka.
Podsumowanie
Nauczono się korzystać z najważniejszych dodatków Storybooka:
@storybook/addon-a11yzgłasza naruszenia WCAG dla każdego story (kontrast, etykiety i role) i można go konfigurować osobno dla każdego story.- Dodatek viewport umożliwia podgląd responsywnych punktów przełomowych za pomocą gotowych lub niestandardowych rozmiarów.
@storybook/addon-docswraz ztags: ["autodocs"]automatycznie generuje zawsze aktualną dokumentację na podstawie propsów i stories.- Dodatki rejestruje się w tablicy
addonsplikumain.ts.
Ucz się HTML dzięki korepetycjom AI — za darmo
Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.
- Kursy
- 42
- Lekcje
- 156
Często zadawane pytania
Czy lekcja „Dodatki Storybook i testowanie dostępności” jest bezpłatna?
Tak — pełny tekst „Dodatki Storybook i testowanie dostępności” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Vue Academy, przejdź na CoddyKit PRO. Kurs Vue Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Dodatki Storybook i testowanie dostępności”?
@storybook/addon-a11y, dodatek viewport oraz dodatek docs do automatycznej dokumentacji. Ćwiczysz Vue Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Vue Academy?
Nie wymagamy żadnego doświadczenia. Vue Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Dodatki Storybook i testowanie dostępności”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Vue Academy?
Tak. Każda lekcja Vue Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Konfiguracja Storybook dla Vue 3
- Pisanie stories komponentów
- Controls, actions i args
- Dodatki Storybook i testowanie dostępności