Accessibility Trait: özü, türleri ve geliştirmede nasıl çalıştığı

Accessibility Trait Nedir

Accessibility Trait, VoiceOver'a anlamsal rolünü belirtmek için bir UIView öğesinde ayarlanan bir bayraktır. Trait, Apple'ın erişilebilirlik üçlüsünün üç bileşeninden biridir: Label (ad), Hint (açıklama), Trait (rol). iOS, her bitin belirli bir role karşılık geldiği UIAccessibilityTraits bit maskesini (UInt64) kullanır. VoiceOver, Label ve Hint'ten sonra rolü okur: “Gönder Düğmesi. Bir form açacak” — UIAccessibilityTraitButton trait sayesinde “Düğme” eklenir.

Varsayılan olarak, UIButton UIAccessibilityTraitButton alır, UILabel UIAccessibilityTraitStaticText alır, UIImageView UIAccessibilityTraitImage alır. Özel kontroller kullanılırken, geliştiricinin traiti manuel olarak ayarlaması gerekir. Apple Human Interface Guidelines, 2024, bunu “erişilebilirliği sağlamanın en kritik adımlarından biri” olarak adlandırır.

Doğru trait olmadan, kullanıcı hangi hareketi uygulayacağını bilemez: tek dokunuş (düğme etkinleştirme), çift dokunuş (yakınlaştırma) veya kaydırma hareketi (değiştirme). Trait, öğede hangi VoiceOver hareketlerinin etkinleştirileceğini belirler.

UIAccessibilityTraits'in Teknik Uygulaması

UIAccessibilityTraits bir typealias UInt64'tür. Her trait, tam olarak bir biti ayarlanmış bir sabittir. Örneğin, UIAccessibilityTraitButton = 0x0000000000000001, UIAccessibilityTraitLink = 0x0000000000000002, UIAccessibilityTraitHeader = 0x0000000000000008. Kombinasyonlar, bit düzeyinde VEYA ile elde edilir: 0x0001 | 0x0008 = 0x0009. VoiceOver maskeyi analiz eder ve davranışı belirler.

iOS Traitlerinin Ana Türleri

iOS, 15'ten fazla trait sabiti sağlar. %90 senaryoda kullanılan ana türleri inceleyelim:

Sabitler, iOS 3.0'dan beri UIKit'te mevcuttur. iOS 14+, .accessibilityAddTraits() değiştiricisi aracılığıyla SwiftUI'de UIAccessibilityTraits desteğini eklemiştir.

Nadir Ancak Kullanışlı Traitler

UIAccessibilityTraitAdjustable — ayarlanabilir değerler için (kaydırıcılar, seçiciler, ses kaydırıcıları). VoiceOver, accessibilityIncrement ve accessibilityDecrement ile tanımlanan bir adımla değeri değiştirmek için yukarı/aşağı kaydırmaya izin verir. UIAccessibilityTraitUpdatesFrequently — sık değişen değerlere sahip öğeler için (zamanlayıcı, ilerleme göstergesi). VoiceOver her değişiklikte değeri okumaz, bir duraklama yapar. UIAccessibilityTraitAllowsDirectInteraction — kullanıcının VoiceOver hareketlerini atlayarak doğrudan etkileşime girebileceği öğeler için (klavye, çizim).

Traitleri Birleştirme

Tek bir öğe aynı anda birden çok traite sahip olabilir — kombinasyon bit düzeyinde VEYA (|) kullanılarak ayarlanır. Örnek: şu anda seçili olan bir düğme — Button | Selected. VoiceOver şunu duyuracaktır: “Seçili. Fiyata göre filtrelendi. Düğme.”

Kodda traitleri ayarlama:

filterButton.accessibilityTraits.insert(.button)
filterButton.accessibilityTraits.insert(.selected)

// Veya maske aracılığıyla:
filterButton.accessibilityTraits = [.button, .selected]

Traitin varsayılan olarak ayarlanmadığı özel UIView için:

class CustomToggle: UIControl {
    override var accessibilityTraits: UIAccessibilityTraits {
        get {
            if isOn {
                return [.button, .selected]
            } else {
                return .button
            }
        }
        set {}
    }
}

Birleştirme kuralı: öğe başına en fazla 3-4 trait. Aşırı traitler (örneğin, Button + Link + Header), VoiceOver duyurusunu çok uzun ve kafa karıştırıcı hale getirir. Apple'a göre, “her ek özellik kullanıcının bilişsel yükünü artırır.”

SwiftUI: Trait Değiştiricileri

SwiftUI'de traitler, .accessibilityAddTraits() ve .accessibilityRemoveTraits() değiştiricileri kullanılarak ayarlanır. Örnek: Text(“Başlık”).font(.largeTitle).accessibilityAddTraits(.isHeader). .isHeader değiştiricisi UIAccessibilityTraitHeader ekler. SwiftUI trait listesi: .isButton, .isHeader, .isLink, .isSelected, .isImage, .isSearchField, .isKeyboardKey, .isStaticText, .isSummaryElement, .isToggle, .playsSound, .startsMediaSession, .updatesFrequently, .allowsDirectInteraction, .causesPageTurn, .isModal, .tabBar.

Trait Seçiminde Tipik Hatalar

Button yerine StaticText — görsel olarak düğmeye benzeyen özel bir kontrol, varsayılan olarak StaticText traitini alır. VoiceOver bir etkinleştirme hareketi sunmaz, bu nedenle kullanıcı öğeye “basamaz”. Çözüm: açıkça .button ayarlayın.

Traitsiz resim — erişilebilirliği etkinleştirilmiş UIImageView, aslında fotoğrafı büyütmek için bir düğme olsa bile Image traitini alır. .button ve Label “Fotoğrafı büyüt” atayın. WWDC 2023, “Deliver an Exceptional Accessibility Experience”'e göre, yeni uygulama sürümlerindeki erişilebilirlik gerilemelerinin %40'ı trait uyuşmazlığından kaynaklanır.

Her öğede Header — Header trait'i ekranın yapısal başlıkları içindir. Her UILabel bir başlık yapılırsa, VoiceOver döner “Başlıklar” modunda işe yaramaz hale gelir — her kelimede durur.

Nasıl Düzeltilir: Kontrol Listesi

• Her etkileşimli özel öğe Button, Link veya Adjustable traitini alır
• Bölüm başlıkları Header traitini alır (StaticText değil)
• Resim düğmeleri seçili durumda Button + Selected traitini alır
• Hareketi olmayan öğeler — StaticText veya Image (salt okunur)

UIButton'dan UIControl'e Geçişte Gerileme Hataları

Trait kaybının yaygın bir nedeni yeniden düzenlemedir: geliştirici, özel görüntüleme için UIButton'ı UIControl ile değiştirir. UIButton otomatik olarak Button traitini alır, UIControl almaz. Yeniden düzenlemeden sonra, açıkça accessibilityTraits = .button ayarlamanız gerekir. Kod incelemesine bir kontrol ekleyin: “UIButton'ı UIControl ile değiştirdiyseniz — traiti kontrol edin.”

Traitler ve Dinamik Durumlar

Değişen duruma sahip öğeler için (örneğin, beğeni düğmesi), trait dinamik olarak değişmelidir. “Beğenilmedi” durumunda — Button, “Beğenildi” durumunda — Button + Selected + Image (simge varsa). VoiceOver duyuruyu değiştirir: “Beğen. Düğme.” vs “Seçili. Beğen. Düğme.” Selected trait yetersizse durumu iletmek için accessibilityValue kullanın. Abone düğmeleri, favoriler, filtreler ve anahtarlar için geçerlidir.

Android Karşılığı: role ve className

Android'de traitlerin doğrudan bir karşılığı yoktur. Bit maskesi yerine aşağıdakiler kullanılır:

• className — AccessibilityNodeInfo.className değeri (android.widget.Button, android.widget.TextView)
• role — bir XML niteliği (rol, View türüne göre belirlenir)
• stateDescription — Selected karşılığı: durum açıklaması ekleme (etkin/devre dışı)

Android'de özel View'ler için onInitializeAccessibilityNodeInfo geçersiz kılınmalıdır:

class CustomButton @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null
) : View(context, attrs) {

    override fun onInitializeAccessibilityNodeInfo(
        info: AccessibilityNodeInfo
    ) {
        super.onInitializeAccessibilityNodeInfo(info)
        info.className = "android.widget.Button"
        info.isClickable = true
    }
}

Flutter geliştiricileri, Semantics widget'ında semanticsRole parametresini kullanmalıdır: button, header, image, link, textField ve diğerleri. Ek olarak, semanticsLabel ve semanticsHint mevcuttur — iOS üçlüsü Label + Hint + Trait'in tam karşılığı.

Web Karşılıkları: WAI-ARIA role

Mobil uygulamaların web sürümleri (PWA, WebView) için WAI-ARIA'dan role niteliği kullanılır: role="button", role="heading", role="link". Bu, accessibilityTraits'in doğrudan karşılığıdır. Karma uygulamalarda, WebView'in ARIA rollerini yerel erişilebilirlik katmanına ilettiğini doğrulayın. Bunun için iOS'ta UIAccessibilityContainerDataTable protokolünü veya Android'de setAccessibilityDelegate'ı kullanın. JavaScript etkinleştirilmiş bir WebView, ARIA rollerini doğru şekilde iletmeyebilir — ayrı olarak test edin.

AccessibilityNodeInfo: Ek Eylemler

Android'de, AccessibilityNodeInfo'ya özel eylemler ekleyebilirsiniz: AccessibilityNodeInfo.AccessibilityAction.ACTION_CLICK ve ACTION_LONG_CLICK. Bu, ek hareketlerle Button trait'inin karşılığıdır. Kaydırıcılar için ACTION_SET_PROGRESS kullanın — Adjustable karşılığı. Spinner ve DatePicker için — ACTION_SET_SELECTION, ACTION_SET_DATE ve ACTION_SET_TIME.

Traitlerin Kontrolü ve Test Edilmesi

Xcode Accessibility Inspector iOS için birincil araçtır: bir öğe seçin ve Traits alanını görüntüleyin. Ayarlanan traitlerin listesini gösterecektir. “Öğeler” modundaki VoiceOver döneri, ekrandaki tüm kontrollerde gezinmeyi sağlar.

Bir traiti kontrol etmek için otomatik Swift testi:

func testSubmitButtonTrait() {
    let app = XCUIApplication()
    app.launch()
    let submitButton = app.buttons["Gönder"]
    XCTAssertTrue(submitButton.isEnabled)
    // XCUIElement traitlere doğrudan erişim sağlamaz
    // Hareket etkinleştirme yoluyla kontrol
    submitButton.tap()
    XCTAssertTrue(app.staticTexts["Form gönderildi"].exists)
}

VoiceOver aracılığıyla manuel kontrol: VoiceOver'ı açın, öğeye kaydırın, çift dokunun — öğe bir Button ise etkinleşmelidir. Öğe çift dokunuşa yanıt vermezse, trait yanlıştır. Rotor hareketini kullanarak modlar arasında geçiş yapın (“Başlıklar”, “Bağlantılar”, “Düğmeler”) — her mod yalnızca ilgili traite sahip öğeleri gösterir.

iOS'ta Traitlerin Birim Testi

iOS 14'ten önce, birim testlerinin accessibilityTraits'e doğrudan erişimi yoktu. iOS 14'ten itibaren, özellik kullanılabilir: XCTAssertEqual(customButton.accessibilityTraits, .button). Özel kontrolleri doğrulamak için birim testlerinde bunu kullanın. Özellikle yeniden düzenleme veya üst sınıf değişikliğinden sonra, her yeni özel UIView'in trait doğruluğu açısından test edilmesi önerilir.