JavaScript y React

Traduce contenido en un servidor, renderiza catálogos de mensajes en React e integra el enrutamiento por idioma en tu aplicación.

Las aplicaciones JavaScript utilizan la traducción en dos ámbitos. 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 que corresponda a 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, seguir su progreso y descargar los archivos terminados. Mantén la clave de API en el servidor y conserva el identificador de cada trabajo junto con la revisión del contenido de origen que traduce.

Las aplicaciones que utilizan LingoDotDevEngine cuentan con una referencia del SDK v0 independiente. Su API síncrona y el procesamiento por lotes en el cliente siguen documentados allí.

Renderiza mensajes en React #

React conserva el mensaje de origen y su contexto en el componente. Un 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 hace falta 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 la 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 utilizas tu propio enrutador, locale-router aporta la lógica subyacente para gestionar las URL y las preferencias de idioma.

Conecta una aplicación de Payload #

El complemento de Payload CMS expone el esquema de los campos y avisa a Lingo.dev cuando cambia el contenido de origen. La integración de Payload permite configurar qué contenido se traduce y dónde se guarda la traducción.

Proyectos de ejemplo #

Estos repositorios muestran cómo se relacionan los archivos de origen y la carga en la aplicación. Revisa las versiones de las dependencias y la configuración de cada proyecto antes de adaptarlo; algunos utilizan una generación de paquetes distinta de la que se describe en estos manuales. En una bifurcación del repositorio, 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 adaptadas al 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 no generar ninguna unidad 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 cabecera.
Markdoc + Next.jsPropiedades traducibles de etiquetas y renderizado de documentos.
OpenAPIDescripciones legibles para las personas dentro de una especificación de API.
RailsYAML con el idioma como raíz y búsqueda mediante el marco de trabajo.
LaravelArchivos de recursos y carga mediante el marco de trabajo.

Los recursos nativos y los documentos utilizan la CLI y sus controladores de formato. No necesitan el entorno de ejecución de React por el mero hecho de aparecer en esta colección de ejemplos.