Ece Tunalı

form-izi: erişilebilir form doğrulama

Hata mesajlarını doğru alana bağlayan ve ekran okuyucuya Türkçe duyuran 4 KB'lık bir form doğrulama katmanı yazdım.

Yıl
2023
Rol
Yazar ve bakımcı
Müşteri
Açık kaynak kişisel proje
Teknoloji
TypeScript, ARIA
form-izi: erişilebilir form doğrulama ekran görüntüsü

Bağlam

Türkçe arayüzlerde form hataları çoğunlukla sayfanın üstünde kırmızı bir kutu olarak çıkar ve hangi alanla ilgili olduğu ekran okuyucuya söylenmez. form-izi, bu sorunu çözmek için yazdığım küçük bir açık kaynak kütüphane. Bir formu izler, hatayı doğru alana aria-describedby ile bağlar, alanı aria-invalid ile işaretler ve hata özetinden ilk hatalı alana odak taşır.

Tasarım kararları

  • Bağımlılık yok; sıkıştırılmış hali 4 KB civarında.
  • Mesajlar varsayılan olarak Türkçe ve tarih biçimi GG.AA.YYYY.
  • Doğrulama, kullanıcı alanı terk ettiğinde başlar; yazarken hata göstermez.

Test

Birim testleri Vitest ile, gerçek tarayıcı davranışı Playwright ile sınanıyor. Her sürümden önce NVDA ve VoiceOver ile elle bir tur atıyorum, çünkü otomatik testler duyurunun gerçekten okunup okunmadığını söylemiyor.

Durum

Kütüphane kararlı sürümde. Şu sıralar tarih alanı için gün, ay ve yılı ayrı alanlarda soran bir bileşen üzerinde çalışıyorum.

Yazan: Ece Tunalı. Son güncelleme:

Tüm projelere dönün