Seletor de idioma e RTL
UI do seletor de idioma
HTML puro
Para uma página sem framework, carregue i18n.js e aponte data-locale-select para um <select> (ou data-locale-list para um elemento que deve se tornar links). O script preenche o controle a partir de ui-languages.json, altera a localidade no local e define <html lang> e dir. Não adicione um segundo redirecionamento com base no idioma do navegador. Detalhes, marcação e o script completo: Aplicativos em HTML puro.
Para um site estático que gera um arquivo HTML por localidade, use a lista de idiomas gerada em páginas HTML em vez deste runtime.
Use o manifesto ui-languages.json para construir um seletor de idioma. ai-i18n-tools exporta dois auxiliares de exibição — consulte Auxiliares de tempo de execução → Auxiliares de exibição para assinaturas.
Componente LanguageSelect de exemplo (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>
);
}O manipulador acima alterna o idioma depois que o app já está sendo exibido. Restaure uma localidade salva antes da primeira renderização também: Localidade de inicialização.
getUILanguageLabel(lang, t) - mostra t(englishName) quando traduzido, ou englishName / t(englishName) quando ambos diferem. Adequado para telas de configurações.
getUILanguageLabelNative(lang) - mostra englishName / label (sem chamada t() em cada linha). Adequado para menus de cabeçalho onde você deseja que o nome nativo seja visível.
O manifesto ui-languages.json é uma matriz JSON de entradas "{ code, label, englishName, direction }" (direction é "ltr" ou "rtl"). Exemplo:
[
{ "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" }
]O manifesto é gerado por generate-ui-languages ou extract a partir de sourceLocale + targetLocales e do catálogo mestre empacotado. Ele é gravado em languagesManifestPath (o padrão é {ui.flatOutputDir}/ui-languages.json quando omitido). Se você alterar os locais na configuração, execute generate-ui-languages ou extract novamente para atualizar o arquivo.
Idiomas RTL
ai-i18n-tools exporta getTextDirection(lng) e applyDirection(lng) — consulte Auxiliares de tempo de execução → Auxiliares 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 define document.documentElement.dir (navegador) ou não faz nada (Node.js). Passe um argumento opcional element para direcionar um elemento específico. Conecte-o no seu bootstrap de i18n — Conecte o i18next.
Para strings que podem conter setas →, inverta-as para layouts RTL:
import { flipUiArrowsForRtl } from 'ai-i18n-tools/runtime';
const { i18n } = useTranslation();
const isRtl = getTextDirection(i18n.language) === 'rtl';
const label = flipUiArrowsForRtl(t('Next → Step'), isRtl);