¿Qué hace react-admin?
Directrices para internacionalizar una aplicación react-admin o shadcn admin kit. Úsalo al agregar soporte i18n, crear archivos de traducción, traducir cadenas en inglés hardcodeadas en JSX o revisar PRs de i18n en un proyecto react-admin. Cubre convenciones de espacios de nombres, interpolación, pluralización, formato sensible a la configuración regional y el flujo de trabajo completo para convertir una aplicación solo en inglés a multiidioma. Activa esta habilidad cada vez que el usuario mencione i18n, internacionalización, traducción, localización, lo...
Convenciones de Espacios de Nombres
- Usa espacios de nombres anidados para organizar las traducciones por funcionalidad o componente.
- Ejemplo:
resources.users.fields.nameen lugar deusers.name. - Mantén los espacios de nombres consistentes con la estructura de la aplicación.
Interpolación
- Usa la sintaxis de
{{variable}}para insertar valores dinámicos en las cadenas traducidas. - Ejemplo:
"Hola, {{name}}!". - Asegúrate de que las variables coincidan con los nombres utilizados en el código.
Pluralización
- Define formas singulares y plurales usando claves como
itemeitem_plural. - El paquete i18n (por ejemplo,
react-adminusara-i18n-polygloto similar) maneja automáticamente la elección según el conteo.
Formato Sensible a la Configuración Regional
- Usa funciones como
Intl.DateTimeFormatoIntl.NumberFormatpara formatear fechas y números según la configuración regional actual. - React-admin ya proporciona componentes como
<DateField>y<NumberField>que respetan la configuración regional definida.
Flujo de Trabajo Completo
- Identificar cadenas hardcodeadas: Busca texto en inglés en componentes JSX.
- Agregar claves de traducción: Envuelve las cadenas con
translate()o el componente<Translate>proporcionado por react-admin. - Crear archivos de traducción: Define un archivo JSON o JS por idioma (ej.
en.json,es.json). - Configurar el proveedor i18n: Usa
i18nProviderde react-admin y pasa las traducciones. - Probar la aplicación: Cambia el idioma dinámicamente y verifica que todas las cadenas se muestren correctamente.
Cuándo Activar esta Habilidad
- Cuando el usuario mencione i18n, internacionalización, traducción, localización.
- Para revisar PRs que añaden soporte multiidioma.
- Para iniciar un proyecto desde cero con soporte i18n.
Nota: Esta habilidad asume que utilizas react-admin versión 3.x o superior y que tu proyecto ya tiene configurado un paquete de internacionalización básico.