Enumeración / Plurielisation
Cómo Funciona la Enumeración
En Intlayer, la enumeración se logra a través de la función enu, que asigna claves específicas a su contenido correspondiente. Estas claves pueden representar valores numéricos, rangos o identificadores personalizados. Cuando se usa con React Intlayer o Next Intlayer, el contenido apropiado se selecciona automáticamente según la configuración regional de la aplicación y las reglas definidas.
Configuración de la Enumeración
Para configurar la enumeración en tu proyecto Intlayer, necesitas crear un módulo de contenido que incluya definiciones de enumeración. Aquí tienes un ejemplo de una enumeración simple para el número de coches:
1import { enu, type DeclarationContent } from "intlayer";
2
3const carEnumeration = {
4 key: "car_count",
5 content: {
6 numberOfCar: enu({
7 "<-1": "Menos de menos un coche",
8 "-1": "Menos un coche",
9 "0": "No hay coches",
10 "1": "Un coche",
11 ">5": "Algunos coches",
12 ">19": "Muchos coches",
13 }),
14 },
15} satisfies DeclarationContent;
16
17export default carEnumeration;En este ejemplo, enu asigna varias condiciones a contenido específico. Cuando se usa en un componente de React, Intlayer puede elegir automáticamente el contenido apropiado según la variable dada.
Uso de la Enumeración con React Intlayer
Para usar la enumeración en un componente de React, puedes aprovechar el hook useIntlayer del paquete react-intlayer. Este hook recupera el contenido correcto basado en el ID especificado. Aquí tienes un ejemplo de cómo usarlo:
1import { useIntlayer } from "react-intlayer";
2
3const CarComponent = () => {
4 const content = useIntlayer("car_count");
5
6 return (
7 <div>
8 <p>{content.numberOfCar(0)}</p> {/* Salida: No hay coches */}
9 <p>{content.numberOfCar(6)}</p> {/* Salida: Algunos coches */}
10 <p>{content.numberOfCar(20)}</p> {/* Salida: Muchos coches */}
11 </div>
12 );
13};
14
15export default CarComponent;En este ejemplo, el componente ajusta dinámicamente su salida según el número de coches. El contenido correcto se elige automáticamente, dependiendo del rango especificado.
Notas Importantes
- El orden de declaración es crucial en las enumeraciones de Intlayer. La primera declaración válida es la que se seleccionará.
- Si se aplican múltiples condiciones, asegúrate de que estén ordenadas correctamente para evitar comportamientos inesperados.
Mejores Prácticas para la Enumeración
Para asegurar que tus enumeraciones funcionen como se espera, sigue estas mejores prácticas:
- Nombres Consistentes: Usa IDs claros y consistentes para los módulos de enumeración para evitar confusiones.
- Documentación: Documenta tus claves de enumeración y sus salidas esperadas para asegurar la mantenibilidad futura.
- Manejo de Errores: Implementa manejo de errores para gestionar casos donde no se encuentre una enumeración válida.
- Optimiza el Rendimiento: Para aplicaciones grandes, reduce la cantidad de extensiones de archivos monitoreados para mejorar el rendimiento.
Recursos Adicionales
Para obtener información más detallada sobre configuración y uso, consulta los siguientes recursos:
Estos recursos proporcionan más información sobre la configuración y uso de Intlayer en diferentes entornos y con varios frameworks.
Si tienes una idea para mejorar esta documentación, no dudes en contribuir enviando una pull request en GitHub.
Enlace de GitHub a la documentación