Web erişilebilirlik denetimi

Denetim sözleşmesi

Erişilebilirlik paketi, F8-013 ile kabul edilen üretim Next.js okuyucusunu ve kapalı loopback fixture API’sini kullanır. İkinci bir test sunucusu, canlı Supabase, secret veya corpus materialization yoktur. Kısa fixture bir terkip, bir yıldızlı not ve bir tekrar annotation’ı sunar; eklenen annotation’lar Latin ve Osmanlıca exact reconstruction sonucunu değiştiremez.

reader-accessibility.spec.mjs üç tamamlayıcı sınırı denetler:

1. Axe ile home, Latin, Osmanlıca, terkip, not, tekrar, İngilizce alignment ve 390px mobil durumlarında WCAG 2.0/2.1 A ve AA kuralları.
2. Dil, yazı ve tema kontrolleri; terkip sekmeleri; not ve tekrar diyalogları; Escape sonrası çağıran kontrole odak dönüşü dahil klavye akışları.
3. Landmark, accessible name, role, aria-expanded, aria-pressed, seçili tab, canlı durum mesajı, lang ve dir değerleri.

Çalıştırma

Chromium ilk kez kurulacaksa:

make web-browser-install

Görsel ve erişilebilirlik senaryolarını birlikte çalıştırmak için:

make web-browser-check

Yalnız erişilebilirlik senaryosunu geliştirirken:

pnpm --filter @munderecat/web exec playwright test \
  --config playwright.config.mjs reader-accessibility.spec.mjs

Fixture’ın production contract parser ve reconstruction katmanlarıyla uyumu normal web test paketinde doğrulanır:

pnpm --filter @munderecat/web test

Değişiklik ilkesi

Yeni bir kontrol ancak açık bir kullanıcı riski veya doğrulanmış regresyon için eklenmelidir. Bir sunum değişikliği DB, corpus, çeviri veya Osmanlıca pipeline kontrolü gerektirmez. Exact metin otoritesi core reconstruction katmanıdır; axe, erişilebilirlik ağacı ve screenshot kontrolleri metin doğruluğunun yerine geçmez.

Otomatik axe sonucu da manuel yardımcı teknoloji denetiminin tamamı değildir. Paket pinned Chromium davranışını güvenceye alır; farklı browser ve proprietary screen-reader birleşimleri ancak destek matrisi genişletildiğinde ayrı kabul senaryolarıyla eklenmelidir.