Programista Astro we Wrocławiu

Programista Astro dla firm z Wrocławia: semantyczny HTML, wyspy i fokus, ustawa o dostępności z 2024 roku dla handlu elektronicznego i WCAG 2.2. Praca zdalna, jedna osoba.

Programista Astro

Migracja z WordPress do Astro we Wrocławiu

Wiele firm we Wrocławiu korzysta z WordPressa, ale napotyka ograniczenia wydajności, bezpieczeństwa i kosztów hostingu. Astro rozwiązuje te problemy dzięki statycznemu HTML, zerowej ilości JavaScriptu i wdrożeniu na edge. Migruję istniejące strony WordPress do Astro z pełnym zachowaniem SEO, mapowaniem URL i przekierowaniami 301.

  • PageSpeed 95-100

    Statyczny HTML bez JavaScriptu. Szybsze niż jakiekolwiek rozwiązanie WordPress.

  • Bezpieczna migracja SEO

    Mapowanie URL, przekierowania 301, zachowanie pozycji w Google.

  • Hosting na Cloudflare Pages

    Globalny CDN, darmowy SSL, natychmiastowe wdrożenia. Koszty hostingu bliskie zeru.

#Dostępna strona w Astro zaczyna się od HTML-a, a psuje się w wyspach

W Astro komponent bez dyrektywy client:* trafia na stronę jako sam HTML, bez JavaScriptu. Dokumentacja opisuje wyspę jako “enhanced UI component on an otherwise static page of HTML”, czyli ulepszony komponent na statycznej stronie. Dla dostępności to dobra wiadomość: nagłówki, listy, linki, przyciski i formularze są zwykłymi znacznikami, które czytnik ekranu i klawiatura obsługują bez dodatkowej pracy.

Problemy pojawiają się tam, gdzie dochodzi interaktywność: menu mobilne, okno koszyka, kalkulator, wyszukiwarka, baner zgód. To właśnie te elementy buduję jako wyspy i to je sprawdzam najdokładniej. Strony i sklepy dla firm z Wrocławia piszę w Astro, TypeScripcie i Tailwindzie, pracuję zdalnie, a wygląd dostaję od ciebie.

Hala Stulecia we Wrocławiu

Zdjęcie: Jar.ciurus, CC BY-SA 3.0 pl, Wikimedia Commons.

#Co w Astro robię inaczej, żeby strona była dostępna

#Semantyka i układ strony

Jedna strona ma jeden h1, znaczniki header, nav, main i footer, a kolejność nagłówków odpowiada treści, nie wyglądowi. Każda podstrona ma własny title. To nie jest kosmetyka: gdy w Astro włączysz przejścia widoków, router dodaje element aria-live ustawiony na assertive, a czytnik ekranu ogłasza po nawigacji tekst z title, a gdy go brak, pierwszy h1, a na końcu ścieżkę adresu. Dokumentacja Astro zaleca, żeby zawsze podawać title.

#Dyrektywy client i wybór wyspy

Dyrektywy różnią się chwilą ładowania: client:load ładuje i uwodnia komponent od razu, client:idle po zakończeniu początkowego ładowania, client:visible dopiero po wejściu w widok, a client:media po spełnieniu zapytania CSS. Wyjątkiem jest client:only, która według dokumentacji pomija renderowanie HTML na serwerze. Dla treści, bez której formularz nie ma sensu, taka wyspa oznacza pustą stronę do chwili załadowania skryptu, więc w nawigacji, formularzach i koszyku jej nie używam.

#Przejścia widoków, fokus i animacje

Dokumentacja przejść widoków opisuje komponent, który przy ustawieniu prefers-reduced-motion wyłącza animacje, także zastępcze, i po prostu podmienia elementy DOM. Zostawiam to włączone. Moduły skryptów z paczki wykonują się tylko raz, więc kod, który ma działać po każdej nawigacji, podpinam pod zdarzenie astro:page-load. Dokumentacja nie opisuje, gdzie ląduje fokus klawiatury po przejściu, dlatego po każdej nawigacji sprawdzam to ręcznie i w razie potrzeby ustawiam fokus sam.

#Co sprawdza narzędzie deweloperskie Astro

Pasek deweloperski ma aplikację Audit, która na bieżącej stronie szuka typowych problemów z dostępnością i wydajnością, a wyniki wyróżnia na stronie. Dokumentacja zaznacza, że to nie zastępuje Pa11y ani Lighthouse, a pasek nie pojawia się na opublikowanej stronie. Traktuję go jako pierwszy filtr przy pisaniu komponentów, nie jako dowód zgodności.

#Ustawa o dostępności a sklep internetowy

Ustawa z 26 kwietnia 2024 r. o zapewnianiu spełniania wymagań dostępności niektórych produktów i usług przez podmioty gospodarcze (Dz.U. 2024 poz. 731) weszła w życie 28 czerwca 2025 r. Wdraża dyrektywę (UE) 2019/882. Co z niej wynika dla sklepu:

  • usługi handlu elektronicznego to według art. 5 pkt 32 usługi oferowane na odległość przez strony internetowe i urządzenia mobilne, drogą elektroniczną i na indywidualne żądanie konsumenta w celu zawarcia umowy,
  • ustawa obejmuje je w art. 3 ust. 2, ale art. 4 pkt 1 wyłącza usługi mikroprzedsiębiorców,
  • art. 12 ust. 2 wymaga, żeby informacje o usłudze były podane w sposób zapewniający postrzegalność, funkcjonalność, zrozumiałość i kompatybilność, a strony internetowe i aplikacje mobilne były jednolite pod tymi względami,
  • art. 32 nakłada na usługodawcę obowiązek oceny zgodności usługi i podania w regulaminie lub równoważnym dokumencie informacji o tym, jak usługa spełnia wymagania dostępności; informacje trzeba przechowywać przez cały czas, gdy usługa jest w ofercie,
  • nadzór nad usługami handlu elektronicznego sprawuje minister właściwy do spraw informatyzacji (art. 38 ust. 3 pkt 2), a zawiadomienie o niespełnianiu wymagań może złożyć każdy do Prezesa Zarządu PFRON (art. 67).

Tekst ustawy nie odsyła do WCAG z nazwy. Art. 20 ust. 1 przewiduje domniemanie zgodności dla usług zgodnych z normami zharmonizowanymi lub specyfikacjami technicznymi. W praktyce przy audycie i przy opisie w regulaminie posługuję się WCAG 2.2 jako listą kontrolną, a ocenę prawną zostawiam twojemu prawnikowi.

#WCAG 2.2 i trzy kryteria, które wychodzą na sklepach

WCAG 2.2 jest rekomendacją W3C z 12 grudnia 2024 r. (w3.org). Dodała m.in. kryteria 2.4.11, 2.5.7, 2.5.8, 3.2.6, 3.3.7 i 3.3.8, a usunęła 4.1.1 Parsing. Trzy z nich najczęściej dotykają stron firmowych i sklepów:

KryteriumPoziomCo oznacza na stronie
2.4.11 Focus Not Obscured (Minimum)AAElement z fokusem nie może być w całości zasłonięty przez treść stworzoną przez autora strony. Dokumentacja W3C podaje jako przykłady przyklejony nagłówek, przyklejoną stopkę i niemodalne okna; baner zgód zasłaniający cały element z fokusem to błąd.
2.5.8 Target Size (Minimum)AACel dla wskaźnika ma mieć co najmniej 24 na 24 piksele CSS, z wyjątkami: odstęp, odpowiednik, tekst w zdaniu, kontrola przeglądarki i konieczność.
3.3.8 Accessible Authentication (Minimum)AALogowanie nie może wymagać testu poznawczego, jak zapamiętanie hasła, bez alternatywy. Wsparcie dla menedżerów haseł i wklejanie to akceptowane mechanizmy, a blokowanie wklejania hasła jest błędem.

W koszyku i zamówieniu patrzę też na 3.3.7 Redundant Entry, czyli na to, żeby nie kazać wpisywać tych samych danych dwa razy.

#Wrocław: standardy miejskie i deklaracja dostępności aplikacji

Wrocław ma od 2019 roku Wrocławskie standardy dostępności, przygotowane przez Fundację “Polska Bez Barier” na zlecenie miasta, według miejskiego serwisu szóste takie opracowanie w Polsce po Gdyni, Warszawie, Łodzi, Koninie i Poznaniu. Dotyczą przestrzeni fizycznej i są skierowane do architektów, planistów i urzędników, więc ze stroną internetową łączy je tylko to, że miasto samo uznało dostępność za rzecz do uregulowania.

#Kiedy lepiej zostać przy WordPressie

Dostępność nie jest powodem do zmiany technologii. Jeśli twój sklep działa na WooCommerce, a usterki siedzą w motywie, wtyczce płatności albo banerze zgód, często wystarczy poprawka w istniejącym motywie, bez nowego frontendu. Jeśli prowadzisz mikroprzedsiębiorstwo, ustawa o dostępności nie obejmuje twoich usług, więc nacisk prawny jest mniejszy, a argument zostaje biznesowy: klient z czytnikiem ekranu albo bez myszy po prostu kupi gdzie indziej. Astro wybieram, gdy i tak budujesz nowy frontend, na przykład przy przebudowie z Next.js albo przy stronie opartej na treści. Sklepy i wtyczki WordPressa opisuję na stronach o programiście WordPress we Wrocławiu i o WooCommerce we Wrocławiu. Gdy projekt wymaga aplikacji w React, zobacz programistę Next.js we Wrocławiu.

#Od briefu do odbioru

  1. Piszesz do mnie krótki brief: adres strony, cel, termin i obecny stack.
  2. Odpowiadam na piśmie pytaniami i wskazuję, co musisz mi przekazać: dostęp do repozytorium albo hostingu, projekt graficzny (arkusz układu, makiety), treści.
  3. Dostajesz pisemny zakres i założenia. Zmiany poza zakresem wyceniam osobno i zaczynam je po twojej akceptacji.
  4. Pracuję na stagingu, a wyniki audytu dostępności dostajesz jako listę: kryterium WCAG, miejsce na stronie, zalecana poprawka.
  5. Po odbiorze możesz zamówić opiekę, w której pilnuję aktualizacji zależności i powtarzam przegląd po większych zmianach.

Co przygotować przed startem:

  • adres strony i dostęp do kodu,
  • projekt graficzny od ciebie albo twojego projektanta,
  • informację, czy jesteś mikroprzedsiębiorcą, bo od tego zależy, czy ustawa cię obejmuje,
  • dotychczasowy regulamin sklepu, do którego dopiszę informację o dostępności.

Wydajność oceniam według progów Google z web.dev: LCP do 2,5 s, INP do 200 ms, CLS do 0,1.

#Najczęstsze pytania

#Czy ustawa o dostępności dotyczy mojego sklepu internetowego?

Obejmuje usługi handlu elektronicznego, czyli oferowane na odległość przez strony internetowe i urządzenia mobilne (art. 3 ust. 2 i art. 5 pkt 32 ustawy, Dz.U. 2024 poz. 731). Wyłączone są z niej usługi oferowane przez mikroprzedsiębiorców (art. 4 pkt 1). Czy jesteś mikroprzedsiębiorcą, sprawdzisz w przepisach o swobodzie działalności gospodarczej. Sklep większej firmy powinien zakładać, że ustawa go dotyczy.

#Czy Astro samo gwarantuje dostępność?

Nie. Astro domyślnie wysyła HTML bez JavaScriptu, co pomaga, ale znaczniki, kontrast, etykiety pól i obsługa klawiatury zależą od kodu komponentów i od projektu graficznego. Narzędzie deweloperskie Astro sprawdza tylko podstawowe rzeczy i nie zastępuje Pa11y ani Lighthouse.

#Czy strona w Astro musi być w całości statyczna, żeby była dostępna?

Nie. Wyspa z dyrektywą client:load, client:idle albo client:visible jest najpierw renderowana do HTML na serwerze. Tylko client:only pomija renderowanie po stronie serwera, więc nie używam jej dla nawigacji ani formularzy.

#Jak sprawdzasz dostępność przed odbiorem?

Przechodzę kluczowe ścieżki (formularz, koszyk, zamówienie) samą klawiaturą i czytnikiem ekranu, uruchamiam automatyczne audyty i spisuję wyniki na piśmie, z odniesieniem do kryteriów WCAG 2.2. Automat nie znajdzie wszystkiego, dlatego ręczny przegląd jest częścią zakresu.

#Kto dostarcza projekt graficzny?

Projekt graficzny i makiety dostarczasz ty albo twój projektant, a ja je wdrażam. Jeśli kontrast, rozmiar przycisków albo kolejność elementów kłóci się z WCAG, opisuję to na piśmie i proponuję poprawkę, zanim zacznie się kodowanie.

#Czy lepiej zostać przy WordPressie?

Często tak. Jeśli sklep działa na WooCommerce, a problemy dotyczą motywu i kilku wtyczek, poprawki w istniejącym motywie często wystarczą bez przebudowy na nowy stack. Astro ma sens, gdy i tak planujesz nowy frontend.

#Napisz do mnie

Wyślij mi adres strony, to, co ma osiągnąć, termin i obecny stack, a przygotuję pisemną odpowiedź z propozycją pierwszych kroków. Pierwsza wstępna wycena jest bezpłatna. Całość załatwiamy na piśmie przez formularz kontaktowy.

Zobacz też w innych miastach Polski

Najbliższe wydarzenia WordPress

Spotkaj się z nami na WordCampie

Dołącz do społeczności WordPress we Wrocławiu. Regularnie bywam na meetupach i WordCampach w całej Polsce - WordUp Trójmiasto, WordCamp Polska i WordCamp Europe. Podejdź i porozmawiajmy.

Dodaj kalendarz WP

Potrzebujesz usługi: Programista Astro we Wrocławiu?

Opisz projekt mailem. Odpowiadam w ciągu 48 godzin.

Opisz projekt

Sprawdź inne usługi WordPress i bazę wiedzy