Sélecteur de langue et RTL
Interface utilisateur du sélecteur de langue
HTML brut
Pour une page sans framework, chargez i18n.js et pointez data-locale-select vers un <select> (ou data-locale-list vers un élément qui doit devenir des liens). Le script remplit le contrôle à partir de ui-languages.json, bascule la locale sur place, et définit <html lang> et dir. N'ajoutez pas de seconde redirection basée sur la langue du navigateur. Détails, balisage et script complet : Applications en HTML brut.
Pour un site statique qui génère un fichier HTML par locale, utilisez la liste des langues générée dans les pages HTML au lieu de ce runtime.
Utilisez le manifeste ui-languages.json pour créer un sélecteur de langue. ai-i18n-tools exporte deux assistants d'affichage — consultez Assistants d'exécution → Assistants d'affichage pour les signatures.
Exemple de composant LanguageSelect (React)
import { useMemo } from 'react';
import { useTranslation } from 'react-i18next';
import {
getUILanguageLabel,
getUILanguageLabelNative,
type UiLanguageManifestRow,
} from 'ai-i18n-tools/runtime';
import uiLanguages from './locales/ui-languages.json';
import { loadLocale } from './i18n';
function LanguageSelect({
value,
onChange,
}: {
value: string;
onChange: (code: string) => void;
}) {
const { t, i18n } = useTranslation();
const options = useMemo(
() =>
(uiLanguages as UiLanguageManifestRow[]).map((lang) => ({
code: lang.code,
// Settings/content dropdowns: shows translated name when available
label: getUILanguageLabel(lang, t),
// Header globe menu: shows "English / Deutsch"-style label, no t() call
nativeLabel: getUILanguageLabelNative(lang),
})),
[t]
);
const handleChange = async (code: string) => {
await loadLocale(code);
await i18n.changeLanguage(code);
onChange(code);
};
return (
<select value={value} onChange={(e) => handleChange(e.target.value)}>
{options.map((row) => (
<option key={row.code} value={row.code}>
{row.label}
</option>
))}
</select>
);
}Le gestionnaire ci-dessus bascule la langue après que l'application est déjà affichée. Restaurez également une locale enregistrée avant le premier rendu : Locale de démarrage.
getUILanguageLabel(lang, t) - affiche t(englishName) lorsqu'il est traduit, ou englishName / t(englishName) lorsque les deux diffèrent. Convient pour les écrans de paramètres.
getUILanguageLabelNative(lang) - affiche englishName / label (aucun appel t() sur chaque ligne). Convient pour les menus d'en-tête où vous souhaitez que le nom natif soit visible.
Le manifeste ui-languages.json est un tableau JSON d'entrées "{ code, label, englishName, direction }" (direction est "ltr" ou "rtl"). Exemple :
[
{ "code": "en-GB", "label": "English (UK)", "englishName": "English (UK)", "direction": "ltr" },
{ "code": "pt-BR", "label": "Português (BR)", "englishName": "Portuguese (BR)", "direction": "ltr" },
{ "code": "de", "label": "Deutsch", "englishName": "German", "direction": "ltr" },
{ "code": "fr", "label": "Français", "englishName": "French", "direction": "ltr" },
{ "code": "ar", "label": "العربية", "englishName": "Arabic", "direction": "rtl" }
]Le manifeste est généré par generate-ui-languages ou extract à partir de sourceLocale + targetLocales et du catalogue maître groupé. Il est écrit dans languagesManifestPath (par défaut {ui.flatOutputDir}/ui-languages.json s'il est omis). Si vous modifiez les paramètres régionaux dans la configuration, exécutez à nouveau generate-ui-languages ou extract pour actualiser le fichier.
Langues RTL
ai-i18n-tools exporte getTextDirection(lng) et applyDirection(lng) — consultez Assistants d'exécution → Assistants RTL.
import { getTextDirection, applyDirection } from 'ai-i18n-tools/runtime';
getTextDirection('ar') // 'rtl'
getTextDirection('en-GB') // 'ltr'
// Applied automatically via i18n.on('languageChanged', applyDirection) — see Wire i18nextapplyDirection définit document.documentElement.dir (navigateur) ou ne fait rien (Node.js). Passez un argument facultatif element pour cibler un élément spécifique. Connectez-le dans votre amorce i18n — Connecter i18next.
Pour les chaînes pouvant contenir des flèches →, inversez-les dans les mises en page RTL :
import { flipUiArrowsForRtl } from 'ai-i18n-tools/runtime';
const { i18n } = useTranslation();
const isRtl = getTextDirection(i18n.language) === 'rtl';
const label = flipUiArrowsForRtl(t('Next → Step'), isRtl);