JavaScript y React
Traduce contenido en un servidor, renderiza catálogos de mensajes en React y conecta el enrutamiento por idioma con tu aplicación.
Las aplicaciones JavaScript usan la traducción en dos partes. El servidor envía contenido a un motor de localización y guarda el resultado. La interfaz de usuario carga los mensajes traducidos y los renderiza con los valores, la gramática y el formato adecuados. Elige el paquete según la parte que estés desarrollando.
Traduce desde tu servidor #
Usa la guía de la API de JavaScript para crear trabajos de traducción con fetch nativo, consultar su progreso y descargar los archivos completados. Mantén la clave de API en el servidor y conserva el identificador de cada trabajo junto con la revisión del contenido fuente que traduce.
Las aplicaciones que usan LingoDotDevEngine cuentan con una referencia del SDK v0 independiente. Su API de sincronización y el procesamiento por lotes del lado del cliente siguen documentados allí.
Renderiza mensajes en React #
React conserva el mensaje fuente y su contexto en el componente. El catálogo proporciona la plantilla traducida; el entorno de ejecución inserta los valores y crea los elementos de React que controla tu aplicación. Para renderizar, no se necesita una clave de API de traducción.
Empieza con un componente traducido y un catálogo local. Después, extrae y carga catálogos a medida que crezca tu aplicación. Las guías prácticas de Next.js Pages y TanStack Start conectan esos catálogos con las solicitudes, las rutas y el cambio de idioma. Si usas tu propio enrutador, locale-router proporciona la lógica de base para resolver las URL y las preferencias de idioma.
Conecta una aplicación de Payload #
El plugin de Payload CMS expone el esquema de campos y avisa a Lingo.dev cuando cambia el contenido fuente. La integración con Payload permite configurar qué contenido traducir y dónde guardar las traducciones.
Proyectos de ejemplo #
Estos repositorios muestran cómo se integran los archivos fuente con la carga en la aplicación. Revisa las versiones de las dependencias y la configuración de cada proyecto antes de adaptarlo; algunos usan una generación del paquete distinta de la que se describe en estos manuales. Si creas una bifurcación, conecta tu propio proyecto de Lingo.dev antes de enviar trabajos de traducción.
| Proyecto | Punto de partida útil |
|---|---|
| React + Vite | Mensajes de componentes, extracción y carga de catálogos. |
| Next.js Pages | Mensajes de páginas y rutas que tienen en cuenta el idioma. |
| Módulos de TypeScript | Datos estáticos de idioma exportados. Usa la estructura de exportación predeterminada que admite el controlador de TypeScript; las exportaciones no compatibles pueden dejarte sin unidades de traducción. |
| iOS | Recursos de Apple y selección nativa de idioma. |
| Android | Directorios de recursos y búsqueda de cadenas. |
| Flutter | Metadatos ARB y mensajes generados. |
| Markdown | Rutas de documentos y metadatos de encabezado. |
| Markdoc + Next.js | Propiedades traducibles de etiquetas y renderizado de documentos. |
| OpenAPI | Descripciones legibles para personas dentro de una especificación de API. |
| Rails | YAML con el idioma como clave raíz y búsqueda mediante el framework. |
| Laravel | Archivos de recursos y carga mediante el framework. |
Los recursos nativos y los documentos usan la CLI y sus controladores de formato. No necesitan el entorno de ejecución de React por el solo hecho de aparecer en esta colección de ejemplos.