Web Accessibility Academy · Lekcja

Akordeony z button i aria-expanded

Zbuduj mechanizm ujawniania, który informuje o otwarciu i zamknięciu.

Lekcja 3 z 413 kroki

Akordeony z button i aria-expanded to bezpłatna lekcja Web Accessibility Academy na CoddyKit. To lekcja 3 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 Web Accessibility Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Web Accessibility Academy zawiera 4 lekcji w sumie.

Jak działa akordeon

Akordeon to stos nagłówków, które można rozwijać i zwijać, aby pokazywać zawartość. Każda sekcja może otwierać się niezależnie, inaczej niż w przypadku kart.

Nagłówek jest przyciskiem

Utwórz każdy nagłówek akordeonu jako prawdziwy button. Przyciski można fokusować, działają z klawiszami Enter i Spacja oraz są automatycznie rozpoznawane przez czytniki ekranu.

<button>Shipping details</button>

Nagłówek div nie działa

Uważaj na klikalny element div użyty jako nagłówek. Nie można na nim ustawić fokusu, nie reaguje na klawiaturę i nie przekazuje technologiom asystującym informacji o swojej funkcji.

<div onclick="toggle()">Shipping details</div>

aria-expanded jest kluczowe

Dodaj aria-expanded do przycisku, aby czytniki ekranu ogłaszały, czy sekcja jest zwinięta, czy rozwinięta. Ten pojedynczy stan sprawia, że akordeon jest dostępny.

<button aria-expanded="false">Shipping details</button>

Przełączanie stanu po kliknięciu

Gdy użytkownik aktywuje przycisk, przełączaj aria-expanded między true i false. Wartość musi być zgodna z tym, czy panel jest faktycznie wyświetlany.

btn.setAttribute("aria-expanded", String(open));

Wskazywanie regionu

Użyj na przycisku atrybutu aria-controls ustawionego na id otwieranego panelu. Użytkownicy dowiedzą się, jaką zawartość pokazuje ten nagłówek.

<button aria-controls="sec1" aria-expanded="false">More</button>

Ukrywanie zwiniętego panelu

Gdy sekcja jest zamknięta, nadaj jej panelowi atrybut hidden. Spowoduje to usunięcie panelu ze strony i drzewa dostępności aż do jego ponownego otwarcia.

<div id="sec1" hidden>Panel content</div>

Umieszczanie nagłówków w prawdziwych nagłówkach

Umieść każdy przycisk w prawdziwym nagłówku, takim jak h3. Użytkownicy czytników ekranu będą mogli przechodzić między sekcjami za pomocą nawigacji po nagłówkach.

<h3><button aria-expanded="false">FAQ</button></h3>

Bez ARIA dla pojedynczych ujawnień

Pojedynczy element pokazujący i ukrywający zawartość to disclosure, a nie zestaw kart. Potrzebuje tylko przycisku z aria-expanded — bez ról tablist ani tab.

Pozostawianie fokusu na przycisku

Po przełączeniu pozostaw fokus na przycisku, który nacisnął użytkownik. Nie przenoś fokusu do panelu — zaskoczyłoby to użytkowników klawiatury.

Dlaczego aria-expanded wygrywa

Ponieważ przycisk zawiera własny stan, czytnik ekranu za każdym razem informuje, czy element jest rozwinięty, czy zwinięty. Użytkownicy zawsze wiedzą, co się stanie po jego aktywowaniu.

Szybkie sprawdzenie

Tworzysz nagłówek akordeonu, który otwiera i zamyka sekcję. Który atrybut udostępnia informację o jego stanie?

Podsumowanie: dostępne akordeony

Dowiedziałeś się, że nagłówek akordeonu to button with aria-expanded umieszczony w nagłówku. Przełączaj stan, wskazuj panel i ukrywaj go po zamknięciu.

Bezpłatny start

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
30
Lekcje
120

Często zadawane pytania

Czy lekcja „Akordeony z button i aria-expanded” jest bezpłatna?

Tak — pełny tekst „Akordeony z button i aria-expanded” 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 Web Accessibility Academy, przejdź na CoddyKit PRO. Kurs Web Accessibility Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Akordeony z button i aria-expanded”?

Zbuduj mechanizm ujawniania, który informuje o otwarciu i zamknięciu. Ćwiczysz Web Accessibility 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ąć Web Accessibility Academy?

Nie wymagamy żadnego doświadczenia. Web Accessibility 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 3 z 4.

Ile czasu zajmuje lekcja „Akordeony z button i aria-expanded”?

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 Web Accessibility Academy?

Tak. Każda lekcja Web Accessibility 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

  1. Wzorzec kart: tablist, tab, tabpanel
  2. Nawigacja między kartami za pomocą klawiszy strzałek
  3. Akordeony z button i aria-expanded
  4. Mechanizm ujawniania czy karty: wybierz właściwy
← Powrót do Web Accessibility Academy