Langues et sens de lecture

Définissez la langue et le sens de lecture des documents et des sous-arbres localisés à l’aide des métadonnées de langue de l’environnement d’exécution.

Le texte traduit et le sens de lecture du document doivent correspondre. Fournir un catalogue en arabe modifie les messages, mais le navigateur a aussi besoin de dir="rtl" pour organiser la page dans le sens de lecture prévu. Utilisez la langue résolue à la fois pour le fournisseur et pour les attributs du document.

Définir la langue et le sens de lecture ensemble #

Dans le composant qui définit le document ou la structure de la page de votre framework, déduisez les attributs de la langue sélectionnée pour cette requête :

tsx
import type { ReactNode } from "react";
import { createLingo, LingoProvider, type Messages } from "@lingo.dev/react";

export function LocalizedDocument({ locale, messages, children }: {
  locale: string;
  messages: Messages;
  children: ReactNode;
}) {
  const l = createLingo(locale);
  return (
    <html lang={l.locale} dir={l.direction}>
      <body>
        <LingoProvider locale={locale} messages={messages}>
          {children}
        </LingoProvider>
      </body>
    </html>
  );
}

Conservez les composants d’en-tête, de script et d’hydratation requis par votre framework autour de ce modèle. Pour un sous-arbre localisé au sein d’une page rédigée dans une autre langue, définissez plutôt lang et dir sur son élément conteneur à partir du résultat useLingo() de ce sous-arbre. Un attribut défini sur une section ne remplace pas la langue du document entier.

Appliquez les attributs dès le HTML initial, lorsque c’est possible. Si vous ne mettez à jour le sens de lecture qu’après l’hydratation, la page risque de s’afficher d’abord avec une mise en page incorrecte.

Interpréter les métadonnées avec précision #

MembreSignification
locale: stringLa langue fournie en entrée, sans modification.
direction: "ltr" | "rtl"Le sens de lecture natif de Intl.Locale.textInfo lorsqu’il est disponible ; sinon, la valeur de repli de l’environnement d’exécution, déterminée à partir de la langue.
script: string | undefinedLe système d’écriture probable obtenu en maximisant la langue avec Intl.Locale.
region: string | undefinedLa région probable issue de la même maximisation.

Par exemple, createLingo("en") peut déduire Latn et US. Cette opération complète les sous-étiquettes probables de la langue ; elle ne localise pas la personne qui lit et ne détermine pas le pays de facturation. Utilisez les données réelles du compte ou de localisation lorsque l’application a besoin de ces informations.

Si Intl.Locale est indisponible ou si l’étiquette est invalide, le système d’écriture et la région peuvent rester indéfinis, et le sens de lecture est déterminé à partir de la liste de langues de repli. D’autres outils de formatage natifs peuvent néanmoins rejeter une étiquette invalide. Résolvez la langue en fonction de l’ensemble des langues prises en charge par l’application avant le rendu.

Adapter la mise en page au sens de lecture #

Utilisez des propriétés CSS logiques telles que margin-inline-start et padding-inline-end pour que les espacements suivent le sens du texte. Vérifiez chaque icône : une flèche de navigation peut devoir être inversée, alors qu’une image représentant un objet physique n’en a pas forcément besoin. Les métadonnées de langue indiquent le sens de lecture ; la conception du composant détermine la manière dont il doit influencer l’interface.

Le fournisseur ne négocie pas de langue et ne récupère pas de messages. Le routeur de langues définit les règles relatives aux URL et aux préférences. L’enveloppe Next Pages synchronise le sens de lecture, mais laisse à l’application le soin de définir le lang du document ; une structure TanStack définit les deux à partir du contexte de la requête.

Après un changement de langue, vérifiez conjointement les attributs du document et le catalogue chargé. La section Rendu côté serveur explique pourquoi la même langue, les mêmes messages et les mêmes données de formatage doivent aussi être transmis à l’hydratation.