Ir al contenido

Internacionalización

Define la configuración regional, la dirección y el texto adaptado a cada sistema de escritura en páginas renderizadas en el servidor.

Establece el idioma y la dirección del documento en el servidor. Renderiza <html lang={locale} dir={direction}> desde la ruta para que la tecnología de asistencia, el algoritmo bidireccional del navegador y los estilos :lang() reciban los valores correctos desde la primera visualización. No detectes la configuración regional en el código de cliente después de la hidratación.

Etiquetas de componentes

Pasa los textos traducidos mediante la prop labels del componente. Las etiquetas que necesitan cantidades usan plantillas de texto como "{index} of {count}"; pasa locale para dar formato a los números. formatLabel reemplaza los marcadores de posición con nombre y da formato a los valores numéricos con Intl.NumberFormat.

Dirección y posición

La dirección proviene del dir del elemento en el DOM. El comportamiento de teclado usa resolveDirection(element) para seguir esa dirección; una prop de dirección explícita puede reemplazarla. side de Popup es físico (top, bottom, left, right). align de Popup es lógico (start, center, end), por lo que sigue la dirección de escritura.

Manejo personalizado del teclado

Si un campo usa un IME, deja que termine la composición antes de manejar las teclas de navegación. Comprueba isComposingKeyEvent(event) antes de responder a Enter, las flechas o Escape; esto también cubre los navegadores que informan el código de tecla 229 al terminar la composición.

Tipografía y alternativa de idioma

La hoja de estilos selecciona fuentes y saltos de línea adecuados al sistema de escritura mediante :lang(). Reemplaza --font-sans-ja, --font-sans-zh-hans o --font-sans-ar cuando tu aplicación proporcione sus propias fuentes. Envuelve el inglés sin traducir con lang="en" dir="ltr" para conservar su pronunciación, selección de fuente y orden del texto dentro de otra configuración regional.