Skrypt widgetu dostępności
Wymagany poziom znajomości JavaScript
Aby skonfigurować i wdrożyć widget dostępności WCAG jako zwykły skrypt, wystarczy podstawowa znajomość JavaScript, obejmująca:
- Dodawanie skryptów do stron internetowych.
- Tworzenie i modyfikowanie obiektów JavaScript.
- Przekazywanie argumentów do funkcji.
Nie jest wymagana zaawansowana wiedza programistyczna – skrypt został zaprojektowany tak, aby był łatwy do integracji nawet w prostych stronach HTML bez frameworków.
Jeśli jednak korzystasz z nowoczesnych technologii frontendowych, takich jak npm, React, Vue lub Svelte, rekomendujemy instalację widgetu poprzez dedykowane paczki:
- Instalacja przez npm (TypeScript/JavaScript)
- Instalacja w projektach React
- Instalacja w projektach Vue
- Instalacja w projektach Svelte
Te metody oferują dodatkowe udogodnienia, takie jak hooki, providery, mechanizmy reaktywne i lepszą integrację z aplikacją SPA.
Struktura i działanie skryptu
Podstawowy szkielet skryptu:
<script>
(function (d, s, t) {
var f = d.getElementsByTagName(s)[0],
j = d.createElement(s);
j.async = true;
j.src = '//wcag.dock.codes/accessibility/' + t + '/start.js';
f.parentNode.insertBefore(j, f);
})(document, 'script', '_TOKEN_');
</script>
Parametry skryptu:
-
'_TOKEN_'- Opis: Unikalny token przypisany do Twojego widgetu.
- Wymagane: Tak.
- Token pobierzesz bezpłatnie w swoim koncie DockWCAG.
- Przykład:
'abcde12345'.
Uwagi końcowe
- Przed wdrożeniem upewnij się, że Twój token jest poprawny i aktywny.
- Jeśli widget nie wyświetla się po dodaniu skryptu, sprawdź konsolę przeglądarki (F12 → „Console”).
- W przypadku dalszych problemów odwiedź sekcję Rozwiązywanie problemów lub skontaktuj się z nami.