.NET MAUI uygulamalarında gözden kaçan sekiz erişilebilirlik sorunu
Bir geliştiricinin testlerinde ortaya çıkan sekiz .NET MAUI erişilebilirlik sorunu derlenmiş: AutomationId'nin ekran okuyucuda ad olarak kullanılması, başlık işaretleme, yazı boyutu ve tema kontrastı. Her sorun için somut bir çözüm de veriliyor.
Kilit noktalar
- AutomationId ekran okuyucuya ad olarak verilmez; SemanticProperties.Description ile insan dostu bir ad ekleyin.
- Başlık olması gereken metinlere SemanticProperties.HeadingLevel uygulayın.
- Android'de FontScale yapılandırma değişikliğini tek başına düzeltmez; kritik akışları yazı boyutu değiştirilerek test edin.
- iOS'ta yazı boyutu güncellemesi için Microsoft.Maui.Controls 10.0.100 veya sonrasını kullanın; şablon MauiVersion değerini sabitleyin.
- Büyük yazıda kaydırma için uzun sayfaları ScrollView içine alın ve en küçük hedef cihazda test edin.
- Şablon metin renklerini ve açık-koyu tema kontrastını WCAG 1.4.3 eşiklerine göre kontrol edin.
Bu yazı, MAUI uygulamalarını Android emülatörlerinde, iOS Simulator'larda ve gerçek telefonlarda test eden bir geliştiricinin bulgularını topluyor. Öne çıkan sorunlar arasında AutomationId'nin ekran okuyucuda kullanıcıya ham kimlik olarak okunması, başlıkların varsayılan olarak işaretlenmemesi, Android'de yazı boyutu değişince sayfanın sıfırlanması ve iOS'ta eski MAUI sürümlerinde yazının uygulama yeniden başlatılmadan büyümemesi yer alıyor.
Yazar ayrıca büyük yazıda kontrollerin ekran dışına itilmesi, şablon renklerinin WCAG kontrast oranlarını karşılamaması ve açık-koyu tema arasında sonuçların farklılaşması gibi konulara değiniyor. Çözüm olarak SemanticProperties.Description, SemanticProperties.HeadingLevel, ScrollView ve MauiVersion ile sürüm sabitleme öneriliyor. Ayrıntılı test adımları ve örnekler için orijinal yazıya bakmak faydalı olur.
Gerçek dünyada kullanımı
- Kurumsal bir MAUI uygulamasına erişilebilirlik uyumluluğu kazandırmak isteyen ekip.
- Yaşlı kullanıcılar için büyük yazı desteği sunan bir sağlık veya bankacılık uygulaması.
- Ekran okuyucu kullanıcılarıyla test yapılacak bir mobil uygulamanın yayın öncesi kontrolü.
Neden önemli
Bu sorunların çoğu XAML derlemesinde görünmez, yalnızca cihazda ekran okuyucu, büyük yazı veya tema değişikliğiyle ortaya çıkar. Yayın öncesi bu kontrolleri yapmak, kullanıcıların uygulamanızda kaybolmasını ve erişilemez kontroller bulmasını engeller.