SKILL-06 — Éléments Obligatoires¶

Langue principale, changement de langue et titres d'écrans

Critères couverts¶

Pourquoi c'est important¶

Patterns¶

1. Langue principale [A]¶

Text("Bonjour tout le monde")
    // Généralement géré via Info.plist (CFBundleDevelopmentRegion)
    // Mais on peut forcer une locale pour un environnement spécifique
    .environment(\.locale, Locale(identifier: "fr-FR"))

// La locale principale est définie par le système Android
// ou via AppCompatDelegate.setApplicationLocales
// TalkBack utilise cette locale du système ou de l'application.

2. Changements de langue [A]¶

// Terme technique anglais dans un texte français
Text("Pour valider, cliquez sur le bouton ") + 
Text("Submit").accessibilityLanguage("en-US") + // (1)!
Text(" en bas de page.")

Text("Hello World, how are you?") // (2)!

Text(
    text = "To be or not to be, that is the question.",
    style = LocalTextStyle.current.copy(
        localeList = LocaleList(Locale("en-US")) // (1)!
    )
)

Text(
    buildAnnotatedString {
        append("Le terme technique est ")
        withStyle(style = SpanStyle(localeList = LocaleList(Locale("en-US")))) {
            append("Smartphone")
        }
        append(".")
    }
)

3. Titres d'écrans [A]¶

NavigationStack {
    List {
        NavigationLink("Voir les détails", destination: DetailView())
    }
    .navigationTitle("Liste des utilisateurs") // (1)!
}

Scaffold(
    topBar = {
        TopAppBar(
            title = { Text("Paramètres du compte") } // (1)!
        )
    }
) { paddingValues ->
    // ...
}

TopAppBar(
    title = { Text("Écran") } // (2)!
)

4. Titre de panneau (paneTitle) [A]¶

Sur tablette ou écran à panneaux (liste + détail), un seul TopAppBar ne suffit pas : TalkBack ne sait pas qu'un panneau vient d'apparaître.

Column(
    modifier = Modifier.semantics { paneTitle = "Détail du message" } // annoncé à l'apparition
) { Text(message) }

// Panneau de détail qui apparaît sans titre : TalkBack ne dit rien
Column { Text(message) }

Checklist [A]¶

• La langue par défaut de l'application est configurée dans le projet (Info.plist ou ressource).
• Tous les passages en langue étrangère utilisent un attribut de langue programmatiquement (.accessibilityLanguage ou localeList).
• Chaque écran possède un titre visuel ou sémantique pertinent.
• Les titres d'écran décrivent précisément le contenu de l'écran.
• Les titres d'écran sont uniques dans toute l'application.
• Lors d'un changement d'écran programmatique sans transition standard, une notification est envoyée.
• Les termes techniques étrangers sont correctement prononcés.
• La locale de l'application correspond aux textes affichés.
• Les alertes et modales ont des titres clairs et pertinents.
• Les titres d'écran ne sont pas redondants avec le nom de l'application.

Références¶

• RAAM 1.1 §6
• WCAG 3.1.1 Langue de la page