# Dobre praktyki WCAG - szablony wydruków (low-code) ## Darmowe narzędzia pozwalające weryfikować dostępność wydruku ## PAC PAC - (Windows) - narzędzie służące do sprawdzania, czy pliki PDF są zgodne z wymogami dostępności. Przy jego użyciu można zweryfikować czy nasz PDF spełnia standardy PDF/UA i WCAG oraz wygenerować na tej podstawie raport. Pozwala również na podejrzenie struktury dokumentu dla czytnika ekranu. {% hint style="info" %} Należy zwrócić uwagę, że PAC nie jest oficjalnym narzędziem stworzonym przez komisję ISO, a firmę zewnętrzną, tym samym wyniki jej raportów i analiz nie są jedynymi, którymi należy się w pełni sugerować, ponieważ nie stanowią one jedynego dostępnego narzędzia tego typu, a inne rozwiązania mogą oferować informacje oraz analizy, które w jakimś stopniu mogą się różnić. {% endhint %}

Ilustracja 1. Panel główny PAC

Ilustracja 2. Drzewo struktury HTML dokumentu

Ilustracja 3. Podgląd struktury HTML dokumentu

## Axes4 Axes4 - - narzędzie online generujące raport dostępności. Jest ograniczony względem narzędzia PAC o dokładniejszą analizę ze wskazaniem błędów i brak możliwości podglądu struktury PDF.

Ilustracja 4. Raport dostępności

## Czytniki ekranowe Informacje znajdują się [tutaj](#dobrepraktykiwcagszablonywydrukow-lowcode-czytnikiekranowe) ## Deklaracje metadanych wydruku W kontekście dostępności **\** możemy zadeklarować metadane lub inne dodatkowe informacje, które nie wpływają bezpośrednio na formatowanie wizualne. {% hint style="danger" %} **\** dla poprawnego działania w strukturze dokumentu musi znajdować się pomiędzy tagiem **\**, a pierwszym **\** {% endhint %} Czytniki ekranu mogą interpretować te wartości. Zgodnie z założeniami UA i WCAG w metadanych powinny pojawić **tytuł wniosku, język oraz ustawienie DisplayDocTitle**. Przykład deklaracji: ``` pl <- zadeklarowanie języka true <- ustawienie DisplayDocTitle Dokument AwZ <- tytuł Document author <- autor Dokument AwZ <- opis ``` ## Nadanie prawidłowego tagu adresów e-mail oraz linków Adresy e-mail oraz linki do adresów zewnętrznych powinny być zawarte w kontekście tagu **\** Przykład: ```xml ... ``` ## Modyfikacja roli elementów Domyślnie elementy automatycznie mają ustawiane odpowiadające im typy w generowanej strukturze PDF. (H1 do H6 dla nagłówków, L dla list itp.). Jest jednak możliwość nadpisania domyślnych ról w przypadku, gdybyśmy chcieli poprawić domyślną strukturę za pomocą atrybutu "role". **Domyślne \ ma przypisaną rolę \

**`.` ``` ... Header z tagiem H1 Paragraf w sekcji ... ``` W celu pominięcia niektórych elementów w strukturze PDF, aby nie były widoczne dla czytnika ekranowego, możemy zastosować **role="artifact"**. Przydaje się to w celu ominięcia w strukturze np. elementów typu **\** takich jak nagłówki oraz stopki stron, które przypadku osób niewidomych są nieprzydatne w momencie przeczytania przez czytnik ekranowy. Przykład wykorzystania dla nagłówka: ``` ``` Istnieje również możliwość "zawinięcia" treści, którą chcielibyśmy pominąć w strukturze PDF używając elementu <**fo:wrapper>** z nadaną rolą "artifact". Przykład dla prezentacji formatu daty dd-mm-rrrr pod polem: ``` dd - mm - rrrr ``` ## Prezentacja pustych komórek Do tworzenia elementów, które nie muszą prezentować wartości i mogą być puste nie powinno stosować niełamliwej spacji czy znaków w takim samym kolorze jak tło wydruku. Przykład template dla checkboxa bez zaznaczenia powodujący błąd w raporcie dostępności ze względu na użycie color="white" co powoduje wyświetlenie białego znaku na białym tle: ```xml xsl:template name="checkbox_template"> ✕ ✕ ``` Zamiast niego lepiej utworzyć pustą komórkę z nadanym stylem **padding-top** i **padding-bottom**, który wizualnie da nam taki sam wygląd komórki bez konieczności występowania w niej żadnego niepotrzebnego znaku. ``` X ``` ## Odległości pomiędzy elementami - unikanie pustych wierszy Złą praktyką jest używanie elementów np. fo:block ze znakami niełamliwej spacji do zwiększania odległości pomiędzy elementami na wydruku. Taki sam efekt można osiągnąć używając stylów takich jak **margin-top** i **margin-bottom.** Unikniemy dzięki temu niepotrzebnych pustych elementów w strukturze dokumentu. W przypadku chęci zwiększenia odległości pomiędzy wierszami **\** można skorzystać z własności tabeli **border-collapse="separate"** oraz **border-spacing="...".** Przykładowo: ``` Row 1 Row 2 ``` {% hint style="info" %} Dostępność w PDF (artykuł na blogu Consdaty) [Dostępność w PDF - dokumenty bez barier](https://blog.consdata.tech/2025/04/28/dostepnosc-w-pdf-dokumenty-bez-barier.html) {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/wcag/dobre-praktyki-wcag-szablony-wydrukow-low-code.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.