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.
| 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 adaptadas al 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 no generar ninguna unidad 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 cabecera. |
| Markdoc + Next.js | Propiedades traducibles de etiquetas y renderizado de documentos. |
| OpenAPI | Descripciones legibles para las personas dentro de una especificación de API. |
| Rails | YAML con el idioma como raíz y búsqueda mediante el marco de trabajo. |
| Laravel | Archivos 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.