Selector de idioma y RTL
Interfaz de usuario del selector de idioma
HTML puro
Para una página sin framework, cargue i18n.js y apunte data-locale-select a un <select> (o data-locale-list a un elemento que deba convertirse en enlaces). El script rellena el control desde ui-languages.json, cambia la configuración regional in situ y establece <html lang> y dir. No añada una segunda redirección basada en el idioma del navegador. Detalles, marcado y el script completo: Aplicaciones en HTML puro.
Para un sitio estático que genera un archivo HTML por cada configuración regional, utilice la lista de idiomas generada en páginas HTML en lugar de este entorno de ejecución.
Utilice el manifiesto ui-languages.json para crear un selector de idioma. ai-i18n-tools exporta dos ayudantes de visualización; consulte Ayudantes de tiempo de ejecución → Ayudantes de visualización para ver las firmas.
Componente LanguageSelect de ejemplo (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>
);
}El controlador anterior cambia el idioma después de que la aplicación ya se esté mostrando. Restaure una configuración regional guardada antes del primer renderizado también: Configuración regional de inicio.
getUILanguageLabel(lang, t) - muestra t(englishName) cuando está traducido, o englishName / t(englishName) cuando ambos difieren. Adecuado para pantallas de configuración.
getUILanguageLabelNative(lang) - muestra englishName / label (sin llamada t() en cada fila). Adecuado para menús de cabecera donde desea que el nombre nativo sea visible.
El manifiesto ui-languages.json es un array JSON de entradas "{ code, label, englishName, direction }" (direction es "ltr" o "rtl"). Ejemplo:
[
{ "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" }
]El manifiesto es generado por generate-ui-languages o extract a partir de sourceLocale + targetLocales y el catálogo maestro incluido. Se escribe en languagesManifestPath (por defecto {ui.flatOutputDir}/ui-languages.json cuando se omite). Si cambia las configuraciones regionales en la configuración, ejecute generate-ui-languages o extract de nuevo para actualizar el archivo.
Idiomas RTL
ai-i18n-tools exporta getTextDirection(lng) y applyDirection(lng); consulte Ayudantes de tiempo de ejecución → Ayudantes 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 establece document.documentElement.dir (navegador) o es una no-op (Node.js). Pasa un argumento opcional element para apuntar a un elemento específico. Conéctalo en tu inicialización de i18n — Configurar i18next.
Para cadenas que puedan contener flechas →, inviértalas en diseños RTL:
import { flipUiArrowsForRtl } from 'ai-i18n-tools/runtime';
const { i18n } = useTranslation();
const isRtl = getTextDirection(i18n.language) === 'rtl';
const label = flipUiArrowsForRtl(t('Next → Step'), isRtl);