Bir kontrolün erişilebilir adının görünen etiket metnini içermesini ister; konuşma kullanıcıları gördüklerini söyleyerek çalıştırabilsin.
Konuşma tanıma kullanan kişiler, ekranda gördükleri şeyi söyleyerek bir kontrolü çalıştırır: "Ara düğmesine tıkla". Görünen etiket "Ara" ama arkasındaki erişilebilir ad "Ürün bul" ise, komut hiçbir şey yapmaz. Görme engelli olmayan bir meslektaşının yüksek sesle okuduğundan farklı bir şey duyan ekran okuyucu kullanıcısı da kafası karışır.
Bu kriter, metin ya da metin görseli içeren etiketleri olan kullanıcı arayüzü bileşenlerinde, erişilebilir adın görsel olarak sunulan metni içermesini ister.
Gördüklerini söyleyen konuşma tanıma yazılımı kullananlar. Görenlerle çalışan ya da görünür metne gönderme yapan yönergeleri izleyen ekran okuyucu kullanıcıları. Duyduğu şey ile gördüğü uyuşmayınca kafası karışan bilişsel engelli kişiler.
Avrupa Erişilebilirlik Yasası (Direktif (AB) 2019/882) 28 Haziran 2025'ten sonra piyasaya sunulan kapsamdaki ürün ve hizmetler için geçerlidir. Yasanın 47. gerekçesi web siteleri ve mobil uygulamalar için dört ilkeyi sayar: algılanabilirlik, işletilebilirlik, anlaşılabilirlik ve sağlamlık. Görünen etiketle eşleşen bir ad, "işletilebilirlik" ilkesinin parçasıdır.
Teknik karşılığı EN 301 549 standardında bulunur. Standart, WCAG 2.5.3'i atıfla alır ve ortama göre ayrı maddelere dönüştürür.
| Madde | Ortam | Ne ister? |
|---|---|---|
| 9.2.5.3 | Web sayfaları | Web içeriğinin WCAG 2.5.3 kriterini karşılamasını ister. |
| 10.2.5.3 | Web dışı dokümanlar (PDF, Office dosyaları) | Standardın kriteri dokümanlara uyguladığı yerlerde, dokümanların adları görünen etiketlerini içermelidir. |
| 11.2.5.3 | Web dışı yazılım (yerel mobil uygulamalar) | Yazılımın erişilebilir adları görünen etiket metnini içermelidir. |
Kriterin web dışı dokümanlara uygulanıp uygulanmadığı ve nasıl uygulandığı standardın 10. maddesinde belirtilir. Madde numaraları EN 301 549'un "9. + WCAG numarası" düzenine göredir. V3.2.1'de yazılım maddesi, açık ve kapalı işlevsellik için ayrı alt maddelere bölünmüştür. Kaynak gösterirken tam numaraları standarttan kontrol edin.
Standart sürümü: EN 301 549 V4.1.1 (Eylül 2026), WCAG 2.2'yi esas alan ve EAA için hazırlanan ilk sürümdür. Henüz AB Resmî Gazetesi'nde atıf almamıştır; bu nedenle EAA gereksinimlerini karşılamanın gönüllü teknik yolu olarak görülmelidir. Atıf yapıldığında EAA ile ilgili uygunluk karinesi sağlayacaktır. 2.5.3 kriterinin metni WCAG 2.1 ve 2.2'de aynıdır.
EAA bağlamında dikkat: Yasanın Madde 2/4 hükmü bazı içerikleri gereksinimlerin dışında bırakır; örneğin 28 Haziran 2025'ten önce yayımlanmış ofis dosya biçimleri ve bu tarihten sonra güncellenmeyen arşivler. Bu tarihten sonra yayımladığınız ya da değiştirdiğiniz içerik bu istisnaların kapsamında değildir.
Directive (EU) 2019/882, EUR-Lex, İngilizce, yeni sekmede açılır
Erişilebilir ad görünen metnin yerini alır. Farklıysa, konuşma kullanıcıları okuduklarına göre kontrolü çalıştıramaz (F96).
EN<button aria-label="Ürün bul">Ara</button><button>Ara</button>
<!-- ya da daha fazla ayrıntı gerekiyorsa: -->
<button aria-label="Ara: ürünler">Ara</button>Ayrıntı eklerken görünen sözcükleri başta tutun.
<a href="/sepet" aria-label="Sepetinizi açın (3 ürün)">3 ürün</a><a href="/sepet" aria-label="3 ürün, sepetinizde">3 ürün</a>Görünen metnin ad olması için label kullanın.
<span>E-posta</span>
<input aria-label="İletişim adresi"><label for="email">E-posta</label>
<input id="email" type="email">Görünen metnin ardına eklenen gizli metin adı doğru tutar.
<button><span class="sr-only">Öğeyi kaldır</span> Sil</button><button>Sil<span class="sr-only"> öğe 3</span></button>Ad başka öğelerden oluşturuluyorsa, görünen etiketin adın parçası olduğundan emin olun.
<button id="b" aria-labelledby="other">Kaydet</button>
<span id="other">Formu gönder</span><button id="b" aria-labelledby="b ctx">Kaydet</button>
<span id="ctx" class="sr-only">profil</span>Görünür metin etiketi olmayan bir kontrolün yalnızca anlamlı bir ada ihtiyacı vardır (4.1.2).
<button aria-label=""><svg>…</svg></button><button aria-label="Kapat"><svg aria-hidden="true">…</svg></button>Aynısı yerel kontroller için de geçerlidir. Erişilebilirlik etiketinin görünen metinle başladığından ya da onu içerdiğinden emin olun ve görünen etiketi ilgisiz biriyle ezmeyin.
import SwiftUI
struct SearchButton: View {
var body: some View {
// Kaçının: görünür "Ara" ve ilgisiz bir erişilebilirlik etiketi
// Button("Ara") { }.accessibilityLabel("Ürün bul")
// Varsayılan: görünen başlık etikettir
Button("Ara") { search() }
// Daha fazla ayrıntı gerekiyorsa görünen metinle başlayın
Button("Ara") { search() }
.accessibilityLabel("Ara: ürünler")
}
}import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.semantics
@Composable
fun SearchButton() {
// Varsayılan: düğme metni erişilebilir addır
Button(onClick = { search() }) { Text("Ara") }
// Kaçının: görünen metni içermeyen bir açıklama
// Modifier.semantics { contentDescription = "Ürün bul" }
// Daha fazla ayrıntı gerekiyorsa görünen metinle başlayın
Button(
onClick = { search() },
modifier = Modifier.semantics { contentDescription = "Ara: ürünler" }
) { Text("Ara") }
}aria-label ve aria-labelledby arayın.aria-label: En yaygın hata (F96).Corpowid, dijital erişilebilirlik alanındaki yenilikçi yaklaşımı ve performansı nedeniyle dünyanın önde gelen araştırma ve danışmanlık şirketlerinden biri olan Gartner tarafından takdir edilmiştir. Bu rozetler, yapay zeka destekli ve kapsayıcı web deneyimleri oluşturma konusundaki kararlılığımızı yansıtmaktadır.
