# Django 6.0.7 - dokumentacja

# Dostępność

Projekt Django jest zobowiązany do zapewnienia, że strony internetowe zbudowane z Django mogą być używane przez każdego, włączając w to ludzi z niepełnosprawnościami. Wbudowane komponenty Django, takie jak interfejs admina oraz domyślne renderowanie formularzy, powinny stosować się do standardów dostępności oraz naszych własnych celów wsparcia dedykowanych urządzeń wprowadzania i technologii asystujących.

## Standardy dostępności

Pracujemy nad zgodnością z wymaganiami wytycznych Web Content Accessibility Guidelines (WCAG), wersja 2.2, na poziomie AA. Wytyczne WCAG są najbardziej zatwierdzonym standardem dla dostępności w sieci. AA-level guidelines jest najbardziej znanym celem zgodności prawnej na świecie.

Zamierzamy, także pracować nad innymi lepszymi procedurami, takimi jak:

- Wytyczne WCAG 2.2 AAA-level guidelines – bardziej surowe kryteria, które wykraczają poza poziom AA.

- Nadchodzące wytyczne WCAG 3.0 guidelines – nowe rozwijające się standardy, które mierzą w unifikację i poprawę poprzednich wersji wytycznych WCAG.

- Wytyczne Authoring Tool Accessibility Guidelines (ATAG) 2.0 – są to wytyczne dla programów i usług używanych do tworzenia treści w internecie.

Aby dowiedzieć się więcej o dostępności bez zagłębiania się dalej w standardy, polecamy projekt The A11Y Project, który to ułatwia dostępność cyfrową dzięki pracy społeczności.

## Cele wsparcia i testowanie

Poza standardami, chcemy upewnić się, że Django będzie działać dla ludzi, używających różnego rodzaju urządzeń wprowadzania i technologii asystujacych. To ma zalety, dzięki którym Django będzie działać lepiej dla każdego. Najlepszym sposobem aby to osiągnąć jest wzięcie pod uwagę aspektów dostępności podczas projektowania cech. W razie wątpliwości, należy skonsultować się z innymi użytkownikami, którzy używają urządzeń asystujących lub z ekspertami do spraw dostępności. Możecie zwrócić się do Zespołu Dostępności przez - Accessibility Django forum topic lub przez kanał `#accessibility` na serwerze Discord - Django Discord server.

### Podstawy testów

Projektuj UI z dostępnością na uwadze, a testowanie zostanie potrzebne jako ostatnie sprzwdzenie. Dla bardziej złożonych interfejsów, skonsultuj się z innymi twórcami aby ustalić cele testów. Skontaktuj się z Accessibility team dla wsparcia i koordynacji testowania.

Zawsze testuj zmiany interfejsu użytkownika z:

- Nawigacją tylko z użyciem klawiatury. Typowe błędy zawierają:

  - Nie można dotrzeć do interaktywnego elementu używając klawiszy Tab lub strzałek.

  - Interaktywny element „więzi” fokus wejścia i nie pozwala na dalszą nawigację.

  - Interaktywny element nie pokazuje widocznego zaznacznenia kiedy jest na nim fokus wejścia.

  - Porządek fokusu jest niekonsekwentny z logicznym porządkiem, który jest widoczny.

- Wytyczne Accessibility Insights rozszerzenia przeglądarki internetowej automatycznie zatwierdza funkcję lub inne narzędzie z zatwierdzeniem Axe.

Kiedy zmiany UI mogłyby wpłynąc na te procedury, testuj też z:

- Nawigacją wyłącznie przez dotyk. Typowe błędy zawierają:

  - Cel dotyku (interaktywny element) jest zbyt mały.

  - Hover-based interaction that does not translate to touch, such as a hover-only tooltip.

- Powiększenie przeglądarki 400%. Typowe błędy zwierają:

  - Treść jest ucięta lub znika kiedy się przybliża.

  - Treść, która nie zawiera typowo dwuwymiarowego układu powoduje przewijanie w dwóch kierunkach (pionowo i poziomo). Przewijanie dwuwymiarowe jest akceptowalne dla treści takich jak zdjęcia, mapy, wideo, i tabele, które wymagają dwóch wymiarów do użytku.

- Tryb zmiany koloru (na przykład Tryb Dużego Kontrastu Windows). Zauważ, że to może być testowane przez tryb `"high_contrast"` w testach screenshot tests. Typowe błędy zawierają:

  - Zbytnie poleganie na kolorach dla znaczeń, co ulega zmianie w trybach zmiany kolorów.

  - Użycie `!important` lub innych stylów może zepsuć tryb zmiany kolorów.

### Rekomendowane technologie asystujące.

Kiedy zmiany UI mogłyby mieć wpływ na technologie asystujące, przedstawiamy tu popularne darmowe wybory, które rekomendujemy do testowania.

Dla systemu Windows:

- NVDA - rekomendowany dla Firefox ESR

- Narrator - rekomendowany dla Microsoft Edge

- Windows Magnifier

- Windows Speech Recognition

- Contrast themes

Dla systemu macOS:

- VoiceOver - rekomendowany dla Safari

- macOS Zoom

- macOS Voice Control

Dla systemu Linux:

- Orca - rekomendowany dla Firefox ESR

Dla urządzeń mobilnych lub tabletów:

- VoiceOver na iOS, lub TalkBack na Androidzie

Następujące to popularne licencjonowane wybory. Jeśli jesteś użytkownikiem, któregoś z nich lub możesz współpracować z innym użytkownikiem posiadającym licencję, testuj też przeciw:

- JAWS w systemie Windows

- Dragon w systemie Windows

## Znane problemy i jak je usunąć

Są jeszcze części Django, które nie odpowiadają naszym celom dostępności. Pracujemy nad naprawą problemów, jako zarazem w pracach konserwacyjnych jak i większych poprawkach. Aby poznać znane błędy i zostać zaangażowanym, zobacz:

- Forum `#accessibility` na serwerze Discord Django Discord server`_.

- Forum: Accessibility Django forum topic.

- Problemy z dostępnością na trackerze wniosków: Accessibility issues on the ticket tracker.

- Naszą tablicę projektu Django: django accessibility improvements

- Zespół dostępności: Accessibility team.