Accessibility Check

28 Haziran 2025'ten beri Avrupa Erişilebilirlik Yasası (Direktif (AB) 2019/882), AB'de tüketicilere satılan birçok hizmet için geçerli; çevrimiçi mağazalar da bunlara dahil. Web sitelerinin "algılanabilir, işletilebilir, anlaşılabilir ve sağlam" olması gerekiyor ve Avrupa standardı EN 301 549 ayrıntılar için artık WCAG 2.2'yi gösteriyor. Hizmet veren çok küçük şirketler (10 kişiden az) muaf, ama birçok çevrimiçi mağaza muaf değil.

Böyle bir işletmenin sahibi genellikle web sitesinin ne durumda olduğunu bilmez. Profesyonel bir denetim para ister; axe gibi araçlar ise her seferinde tek bir sayfayı kontrol eder ve geliştiricinin dilini konuşur. Mağaza sahibinin okuyup web geliştiricisine iletebileceği ilk bir rapor istedim: ne yanlış, hangi sayfada ve neyin değişmesi gerekiyor.

• Sitenin adresini girersiniz. Kibar bir tarayıcı (crawler) aynı sitedeki en fazla 20 sayfayı okur, robots.txt'e uyar ve her istekten sonra yarım saniye bekler.
• Her sayfanın HTML'inde 17 kontrol çalışır: alt metni olmayan görseller, etiketi olmayan form alanları, eksik sayfa başlığı ve dil bilgisi, metni olmayan ikon bağlantıları ve düğmeler, engellenmiş yakınlaştırma, başlığı olmayan çerçeveler, kendiliğinden oynayan medya ve iki rengin de HTML'de yazılı olduğu yerlerde renk kontrastı.
• Her bulgu seviyesiyle birlikte bir WCAG 2.2 başarı kriterine bağlanır; tek satırlık bir düzeltmesi ve soruna yol açan HTML parçası vardır.
• Rapor sonucu kritere, kurala ve sayfaya göre gösterir; tek bir HTML dosyası ya da JSON olarak indirilebilir. Raporlar SQLite'ta saklanır.
• "Explain for a shop owner" sade bir özet yazar: çevrimdışı hazır metinlerden ya da Claude ile İngilizce, Almanca, Rusça veya Türkçe olarak.
• Rapor neyi kontrol edemediğini açıkça söyler: ekranda görünen renkler, klavyeyle kullanım, odak sırası ve ekran okuyucunun gerçek davranışı hâlâ elle test edilmeli.

• Python 3.12
• asyncio
• httpx
• FastAPI
• Jinja2
• BeautifulSoup
• lxml
• SQLite
• Anthropic API
• pytest
• Docker

Tarayıcı httpx ve asyncio ile çalışır: iki işçi, bir sayfa sınırı ve her istekten sonra bir bekleme. robots.txt'i RFC 9309'a uyan kendi ayrıştırıcım okur, çünkü Python'un yerleşik ayrıştırıcısı en uzun kuralı değil ilk eşleşen satırı uygular ve * joker karakterini anlamaz. HTML, BeautifulSoup ve lxml ile ayrıştırılır. Özel ağlara çıkan adresler reddedilir; böylece aracın herkese açık bir kopyası sunucunun kendi ağını yoklamak için kullanılamaz.

Kontrast kontrolü doğrudan WCAG 2.2 formüllerini kullanır. Beyaz üzerinde #777 4.48:1 çıkar; normal boyuttaki metnin ihtiyaç duyduğu 4.5:1'in hemen altında:

def _channel(value_8bit: int) -> float:
    c = value_8bit / 255
    return c / 12.92 if c <= 0.04045 else ((c + 0.055) / 1.055) ** 2.4


def relative_luminance(color: RGBA) -> float:
    return 0.2126 * _channel(color.r) + 0.7152 * _channel(color.g) + 0.0722 * _channel(color.b)


def contrast_ratio(a: RGBA, b: RGBA) -> float:
    la, lb = relative_luminance(a), relative_luminance(b)
    lighter, darker = max(la, lb), min(la, lb)
    return (lighter + 0.05) / (darker + 0.05)

Ana sayfa iki kez analiz edildi, bu yüzden sorunları iki kez sayıldı

if page.final_url != page.url and page.final_url in self._final_urls:
    page.error = page.error or f"Redirects to {page.final_url}, which is already scanned"
    page.soup = None
self._final_urls.add(page.final_url)

if page.final_url != page.url and page.final_url in self._final_urls:
    page.duplicate_of = self._final_urls[page.final_url]
elif page.body_hash and page.body_hash in self._hashes:
    page.duplicate_of = self._hashes[page.body_hash]
if page.duplicate_of:
    page.soup = None  # same document: do not analyse it or follow its links again
else:
    self._final_urls.setdefault(page.final_url, page.url)
    if page.body_hash:
        self._hashes[page.body_hash] = page.url

• 208 otomatik test (110 test fonksiyonu): her kural geçen ve kalan HTML ile, kontrast hesabı bilinen değerlerle ve tarayıcı sahte web sitelerinde (robots.txt, sayfa sınırı, yönlendirmeler, eşzamanlılık) test ediliyor.
• Bozuk örnek mağaza: 4 sayfada 10 başarısız kontrol ve 7 uyarı. Düzeltilmiş sürüm: 16 kontrol geçiyor, 0 başarısız. Her tarama kibar beklemelerle birlikte yaklaşık 2 saniye sürüyor.
• Kendi portfolyo sitemin gerçek taraması: 7,5 saniyede 15 sayfa, 0 başarısız kontrol, 13 geçen, 4 uygulanamaz (form, HTML içinde renk ve çerçeve yok).

• GitHub'da kaynak kod↗
• Canlı demo→