diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index e6cacba3b..4f1f46cb6 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -1,54 +1,54 @@ --- id: accessibility -title: Accessibility +title: Dostępność permalink: docs/accessibility.html --- -## Why Accessibility? {#why-accessibility} +## Czym jest dostępność? {#why-accessibility} -Web accessibility (also referred to as [**a11y**](https://en.wiktionary.org/wiki/a11y)) is the design and creation of websites that can be used by everyone. Accessibility support is necessary to allow assistive technology to interpret web pages. +Pojęcie dostępności stron internetowych (określanej również [**a11y**](https://en.wiktionary.org/wiki/a11y) od ang. *accessibility*) zostało zaprojektowane i stworzone z myślą o internecie przystępnym dla wszystkich. Wspieranie dostępności jest niezbędne, aby umożliwić technologiom asystującym poprawną interpretację stron. -React fully supports building accessible websites, often by using standard HTML techniques. +React w pełni wspiera budowanie dostępnych dla wszystkich stron internetowych, często z wykorzystaniem standardowych technik HTML. -## Standards and Guidelines {#standards-and-guidelines} +## Standard oraz wytyczne {#standards-and-guidelines} ### WCAG {#wcag} -The [Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) provides guidelines for creating accessible web sites. +[Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) dostarcza zbiór wytycznych, jak tworzyć poprawne oraz dostępne dla wszystkich strony internetowe. -The following WCAG checklists provide an overview: +Poniższe listy kontrolne WCAG zawierają przegląd: -- [WCAG checklist from Wuhcag](https://www.wuhcag.com/wcag-checklist/) -- [WCAG checklist from WebAIM](https://webaim.org/standards/wcag/checklist) -- [Checklist from The A11Y Project](https://a11yproject.com/checklist.html) +- [Lista kontrolna WCAG stworzona przez Wuhcag](https://www.wuhcag.com/wcag-checklist/) +- [Lista kontrolna WCAG stworzona przez WebAIM](https://webaim.org/standards/wcag/checklist) +- [Lista kontrolna projektu A11Y](https://a11yproject.com/checklist.html) ### WAI-ARIA {#wai-aria} -The [Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) document contains techniques for building fully accessible JavaScript widgets. +Dokument [Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) zawiera listę technik pomagających w budowaniu w pełni dostępnych aplikacji javascriptowych. -Note that all `aria-*` HTML attributes are fully supported in JSX. Whereas most DOM properties and attributes in React are camelCased, these attributes should be hyphen-cased (also known as kebab-case, lisp-case, etc) as they are in plain HTML: +Warto zaznaczyć, że wszystkie atrybuty HTML `aria-*` są w pełni wspierane przez JSX. Mimo że większość tagów oraz atrybutów DOM w Reakcie zapisujemy w notacji camelCase, to te związane z dostępnością powinny być zapisywane z wykorzystaniem myślników (znanych również jako kebab-case, lisp-case itp.), ponieważ są one traktowane jak zwykłe atrybuty HTML. ```javascript{3,4} ``` -## Semantic HTML {#semantic-html} -Semantic HTML is the foundation of accessibility in a web application. Using the various HTML elements to reinforce the meaning of information -in our websites will often give us accessibility for free. +## Semantyczny HTML {#semantic-html} -- [MDN HTML elements reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Element) +Semantyczny HTML jest podstawą dostępności aplikacji webowych. Wykorzystując różne elementy HTML, które wzmacniają znaczenie informacji na naszych stronach, bardzo często możemy stworzyć w pełni dostępną stronę bez dodatkowego nakładu pracy. -Sometimes we break HTML semantics when we add `