Muestra tu primer mensaje traducido
Muestra un saludo en español, sustituye un nombre y verifica cómo se usa el texto de origen como respaldo con un catálogo local.
Muestra Hola, Ana. a partir de un mensaje de origen en inglés. Este ejemplo incluye su propia traducción al español para que veas exactamente cómo trabajan juntos un componente, un catálogo y un proveedor. No necesitas una cuenta de Lingo.dev ni una clave de API.
Instala el paquete en una aplicación de React 19 #
npm install @lingo.dev/react@1.17.1Usa una aplicación existente de React 19 para este ejemplo. Aunque el paquete declara React 18 y 19 como dependencias pares, su proveedor usa la sintaxis abreviada de React 19 para proveedores de contexto. Instalar el paquete en un proyecto de React 18 no demuestra que pueda renderizarse allí.
Agrega el saludo y el catálogo #
Coloca este componente en src/App.tsx y renderízalo desde el punto de entrada existente de tu aplicación:
import { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";
const messages = {
[computeKey("Hello, {name}.", "Greeting on the account dashboard")]:
"Hola, {name}.",
};
function Greeting() {
const l = useLingo();
return (
<h1>
{l.text("Hello, {name}.", {
context: "Greeting on the account dashboard",
values: { name: "Ana" },
})}
</h1>
);
}
export default function App() {
return (
<LingoProvider locale="es" messages={messages}>
<Greeting />
</LingoProvider>
);
}Ejecuta el comando de desarrollo de tu aplicación y abre la página. El encabezado muestra Hola, Ana. En tiempo de ejecución, se calcula la misma clave a partir del texto de origen y el contexto, se encuentra la plantilla en español y se reemplaza {name} por Ana.
El catálogo contiene la oración completa, así que la traducción puede cambiar el orden de las palabras. El nombre es un valor, no parte de la clave; si usas otro nombre, se utiliza la misma entrada del catálogo. Mantén el texto de origen y el contexto como literales en la llamada a l.text para que el extractor pueda detectarlos más adelante.
Verifica qué pasa cuando no hay una traducción #
Pasa temporalmente messages={{}} al proveedor. Ahora el encabezado muestra Hello, Ana. El texto de origen se usa como plantilla de respaldo y la sustitución de valores sigue funcionando. Una entrada cuyo valor es "" también hace que se use el texto de origen.
Restablece messages y luego cambia solo el contexto de la llamada a "Greeting on the profile page". Esto cambia la identidad del mensaje, por lo que la traducción original ya no coincide. Restablece el contexto original para volver a Hola, Ana. Estas pruebas permiten distinguir entre un catálogo ausente y una falta de coincidencia entre el mensaje solicitado y el traducido.
Reemplaza el mapa local por catálogos extraídos #
El componente está listo para la extracción. Extracción y carga de catálogos explica cómo generar locales/en.jsonc, seleccionarlo en la configuración de la CLI, obtener una traducción al español y cargarla de forma segura. Esa es la siguiente tarea completa; el ejemplo local anterior sigue siendo útil como prueba de renderizado.
Para una aplicación con enrutamiento, continúa con Next.js Pages o TanStack Start. Al cambiar de idioma, el nuevo idioma y sus mensajes deben cargarse juntos para que la interfaz nunca combine el texto de un idioma con el formato de otro.