Sayfa Dili

Kısaca

Ekran okuyucunun hangi dili okuduğunu bilmesi gerekir. Türkçe bir sayfa Türkçe olarak işaretlenmemişse, okuyucu sözcükleri İngilizce kurallarla telaffuz edebilir ve sonuç anlaşılmaz olur. Aynı bilgi tarayıcıların doğru yazı tiplerini ve heceleme kurallarını seçmesini, çeviri araçlarının kaynak dili bulmasını ve altyazıların doğru görünmesini sağlar.

Bu kriter, her web sayfasının varsayılan insan dilinin programatik olarak belirlenebilmesini ister. HTML'de bu, html öğesinde geçerli bir lang özniteliği demektir.

Neleri kapsar?

• Varsayılan dil: Sayfanın bütünü için kullanılan dil. Sayfada diller karışıksa varsayılan, en çok kullanılandır. Eşit kullanılıyorsa, ilk kullanılandır.
• Nasıl belirtilir: HTML'de html öğesine lang koyun (H57). PDF'de belge kataloğundaki /Lang girdisini ayarlayın (PDF16).
• Geçerli kodlar: en ya da tr gibi geçerli bir dil etiketi (BCP 47) kullanın. en-GB gibi bölge alt etiketine izin verilir.
• Her sayfa: Dil her sayfada belirtilmelidir; hata sayfaları, açılır pencere sayfaları ve üretilmiş sayfalar dahil.
• Sayfa içindeki dil değişimleri: AA seviyesindeki 3.1.2 (Parçaların Dili) kapsamındadır. Çok dilli sayfalar için W3C, 3.1.2'ye de uymayı güçlü biçimde önerir.
• İstisna yok: Kriterin kendisi hiçbir istisna listelemez.

Kimleri etkiler?

Doğru telaffuz kurallarına ihtiyaç duyan ekran okuyucu kullanıcıları. Daha kolay okumak için konuşma sentezi kullanan, disleksili ve diğer okuma ya da öğrenme engelli kişiler. Yazılımı doğru braille tablosunu seçen braille kullanıcıları. Doğru dilde görünen altyazılara güvenenler. Çeviri araçları ve arama motorları da yararlanır.

EAA ve EN 301 549'da

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. Programatik olarak erişilebilir sayfa dili, "anlaşılabilirlik" ilkesinin parçasıdır.

Teknik karşılığı EN 301 549 standardında bulunur. Standart, WCAG 3.1.1'i atıfla alır ve ortama göre ayrı maddelere dönüştürür.

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. 3.1.1 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

Web için kod örnekleri

1. Eksik lang özniteliği

Olmadığında ekran okuyucu, sayfa için yanlış olabilecek bir varsayılana döner (H57).

<!DOCTYPE html>
<html>
<head><title>Hoş geldiniz</title></head>

<!DOCTYPE html>
<html lang="tr">
<head><title>Hoş geldiniz</title></head>

2. Dil kodu olmayan bir değer

Değer geçerli bir dil etiketi olmalıdır.

<html lang="turkce">

<html lang="tr">

3. İçerikle uyuşmayan dil

Türkçe yazılmış ama İngilizce olarak işaretlenmiş bir sayfa yanlış telaffuzla okunur.

<html lang="en">
<body><h1>Erişilebilirlik kontrol listesi</h1>

<html lang="tr">
<body><h1>Erişilebilirlik kontrol listesi</h1>

4. Bölgesel varyant

Bölge alt etiketine izin verilir ve yazım ile telaffuza yardımcı olabilir.

<html lang="en_GB"> <!-- alt çizgi geçerli değil -->

<html lang="en-GB">

5. body değil html öğesine koyun

Varsayılan dil, başlık dahil tüm belgeye uygulanması için kök öğede olmalıdır.

<html>
<body lang="fr">

<html lang="fr">
<body>

6. Sayfayı güncelleyen bir dil değiştirici

Görünen içeriğin dilini değiştiren betik lang özniteliğini de değiştirmelidir.

showEnglish(); // içerik değişir, lang "tr" kalır

showEnglish();
document.documentElement.lang = "en";

Mobil için kod örnekleri

Yerel uygulamalarda lang özniteliği yoktur. Dili platformun seçtiği yerelleştirmeden alırlar; bu yüzden sabit kodlu dizeler yerine uygun yerelleştirilmiş kaynaklar sağlayın.

iOS (SwiftUI)

import SwiftUI

struct WelcomeView: View {
    var body: some View {
        // Anahtar, kullanıcının dili için Localizable.strings içinde aranır;
        // böylece metin kullanıcının seçtiği dille eşleşir
        Text("welcome_title")
    }
}

// Localizable.strings (en)
// "welcome_title" = "Welcome";
// Localizable.strings (tr)
// "welcome_title" = "Hoş geldiniz";

Android (Jetpack Compose)

import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.res.stringResource

@Composable
fun WelcomeTitle() {
    // Dize, platformun seçtiği dil için res/values (varsayılan)
    // ya da res/values-tr içinden gelir
    Text(stringResource(R.string.welcome_title))
}

// res/values/strings.xml
// <string name="welcome_title">Welcome</string>
// res/values-tr/strings.xml
// <string name="welcome_title">Hoş geldiniz</string>

Nasıl test edilir?

• Kaynağı görüntüleyin: Sayfa kaynağını ya da geliştirici araçlarını açın. html öğesinde lang özniteliği var mı?
• Değeri kontrol edin: Geçerli bir dil etiketi mi ve sayfanın ana diliyle eşleşiyor mu?
• Her şablonu kontrol edin: Ana sayfa, içerik, hata, giriş, ödeme ve açılır pencere sayfalarını test edin. Her birinde öznitelik olmalı.
• Üretilen sayfaları kontrol edin: Web sayfası olarak işlenen e-postalar, yazdırma görünümleri ve gömülü çerçeveler özniteliği kaybedebilir.
• Dinleyin: Sayfayı bir ekran okuyucuyla okuyun. Telaffuz dile uygun mu?
• Dokümanları kontrol edin: PDF'de belge özelliklerinde belge dilini kontrol edin.
• Denetleyiciyi başlangıç olarak kullanın: axe gibi araçlar (html-has-lang ve html-lang-valid kuralları) eksik ve geçersiz değerleri bulur. Değerin içerikle uyuşup uyuşmadığını söyleyemezler; onu bir kişi kontrol etmelidir.

Sık yapılan hatalar

• lang özniteliğinin olmaması: En yaygın hata ve düzeltmesi en kolay olanı (H57).
• Yanlış dil: Başka dildeki sayfalar için kullanılan lang="en" şablonu.
• Geçersiz değerler: lang="turkce", lang="en_US" ya da boş değer.
• body ya da bir sarmalayıcıda belirtmek: Belge başlığı ve kök işaretsiz kalır.
• lang güncellemeyen dil değiştirici: İçerik değişir, bildirim değişmez.
• PDF ve dokümanları unutmak: Dil belge özelliklerinde de ayarlanmalıdır.
• Yalnızca ana sayfanın doğru olması: Diğer şablonlar gözden kaçar.
• 3.1.2'nin bunun yerini tuttuğunu sanmak: Parçaları işaretlemek varsayılan dil ihtiyacını ortadan kaldırmaz.

Kaynaklar

• Understanding SC 3.1.1: Language of Page (W3C), İngilizce, yeni sekmede açılır
• H57: Using the language attribute on the HTML element (W3C), İngilizce, yeni sekmede açılır
• Declaring language in HTML (W3C Internationalization), İngilizce, yeni sekmede açılır
• Directive (EU) 2019/882, European Accessibility Act (EUR-Lex), İngilizce, yeni sekmede açılır
• EN 301 549 V4.1.1 (ETSI), İngilizce, yeni sekmede açılır
• The European accessibility standard EN 301 549 has been updated (AccessibleEU), İngilizce, yeni sekmede açılır

Standart sürümü: EN 301 549 V4.1.1 (2026-09), WCAG 2.2. Bu sayfa bilgilendirme amaçlıdır ve hukuki tavsiye niteliği taşımaz; bağlayıcı metin için Avrupa Erişilebilirlik Yasası'nın (Direktif (AB) 2019/882) ve EN 301 549 standardının resmî metinlerini esas alın.