Betekenisvolle Toegankelijke Naam

Wat We Controleren

De toegankelijke naam van een element mag het toegankelijkheidseigenschap niet bevatten. VoiceOver kondigt het eigenschap automatisch aan, dus het opnemen ervan in de naam zorgt ervoor dat het twee keer wordt voorgelezen.

Deze regel handhaaft een best practice ingesteld door Apple's Human Interface Guidelines. U kunt deze regel uitschakelen vanuit de Mobiele Dashboard of door de regel te negeren in tests geschreven voor iOS.

In Een Oogopslag

• Deze regel heeft een kleine impact voor gebruikers
• De toegankelijke naam van een element moet zijn toegankelijkheidseigenschap niet herhalen - VoiceOver kondigt het eigenschap automatisch aan
• Bijvoorbeeld, een knop met de naam „Volgende knop“ zorgt ervoor dat VoiceOver de overbodige aankondiging doet: „Volgende knop, knop“

Impact op Gebruikers

VoiceOver-gebruikers worden het meest getroffen. Wanneer een toegankelijke naam het eigenschap van het element bevat, kondigt VoiceOver het eigenschap twee keer aan - bijvoorbeeld, „Volgende knop, knop“ in plaats van „Volgende, knop.“ Dit is overbodig en kan verwarrend of afleidend zijn voor schermlezergebruikers.

Bevestig Betekenisvolle Toegankelijke Naam Probleem

1. Zet VoiceOver aan
2. Focus op het element
3. Een van de volgende zal gebeuren:
   • Onafhankelijk: VoiceOver kondigt het toegankelijkheidseigenschap van het element twee keer aan - als onderdeel van de toegankelijke naam, en daarna opnieuw als het eigenschap (bijv., „Volgende knop, knop“)
   • Toegankelijk: VoiceOver kondigt de toegankelijke naam aan, gevolgd door het eigenschap (bijv., „Volgende, knop“)

Los Problemen Op

Om een Betekenisvolle Toegankelijke Naam probleem op te lossen, zorg ervoor dat de toegankelijke naam het toegankelijkheidseigenschap van het element niet bevat. VoiceOver voegt het eigenschap automatisch toe, dus het opnemen ervan in de naam resulteert in een overbodige aankondiging.

UIKit

Oplossing in Storyboard:

1. Selecteer het element met een MeaningfulAccessibleName probleem.
2. Zorg ervoor dat het Inspectorspaneel zichtbaar is.
3. Selecteer de Identiteitsinspecteur.
4. Onder Toegankelijkheid, voer een label in dat overeenkomt met de zichtbare tekst en niet het toegankelijkheidseigenschap van het element bevat.

Om het in code te verhelpen, zorg ervoor dat de waarde van het toegankelijkheidslabel overeenkomt met of alle zichtbare tekst op het element bevat, en niet het toegankelijkheidseigenschap bevat:

button.title = "Next"
button.accessibilityTraits = .button

SwiftUI

Stel een toegankelijkheidslabel in dat de zichtbare tekst bevat en niet het toegankelijkheidseigenschap van het element bevat:

Button(action: {
    openMenu()
}) {
    Text("Next")
}.accessibility(label: Text("Next"))

React Native

Zorg ervoor dat het element accessibilityLabel niet de waarde van het element bevat accessibilityRole :

<Button title='Order now' accessibilityLabel='order now' accessibilityRole='button'/>

Flutter

Toegankelijke namen moeten het doel van het element beschrijven. Vermijd generieke namen zoals „knop“ of „afbeelding“, en neem de rol niet op in de naam. De schermlezer kondigt de rol apart aan.

  // Failing — name includes the role, screen reader says "Search button, button"
  IconButton(
    icon: const Icon(Icons.search),
    tooltip: 'Search button',
    onPressed: () {},
  )

  // Passing — name describes the action, screen reader says "Search, button"
  IconButton(
    icon: const Icon(Icons.search),
    tooltip: 'Search',
    onPressed: () {},
  )

Kan Ik Deze Regel Negeren?

Betekenisvolle Toegankelijke Naam heeft een Kleine impact voor gebruikers en handhaaft een Apple best practice in plaats van een strenge WCAG-vereiste. U kunt deze regel volledig uitschakelen vanuit de Mobiele Dashboard, of negeer individuele bevindingen in je iOS-tests. Lees meer over regels negeren.

Middelen

Andere Middelen

• Apple Human Interface Richtlijnen
  • VoiceOver — Beschrijvingen