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.

ProyectoPunto de partida útil
React + ViteMensajes de componentes, extracción y carga de catálogos.
Next.js PagesMensajes de páginas y rutas que tienen en cuenta el idioma.
Módulos de TypeScriptDatos 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.
iOSRecursos de Apple y selección nativa de idioma.
AndroidDirectorios de recursos y búsqueda de cadenas.
FlutterMetadatos ARB y mensajes generados.
MarkdownRutas de documentos y metadatos de encabezado.
Markdoc + Next.jsPropiedades traducibles de etiquetas y renderizado de documentos.
OpenAPIDescripciones legibles para personas dentro de una especificación de API.
RailsYAML con el idioma como clave raíz y búsqueda mediante el framework.
LaravelArchivos 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.