Mensajes con texto enriquecido

Traduce oraciones completas y mantén los destinos de los enlaces y el comportamiento de React en el código de la aplicación.

Es común que un enlace esté dentro de una oración. Si traduces por separado las palabras de antes, de dentro y de después del enlace, la traducción queda atada al orden de palabras del idioma de origen. l.rich mantiene la oración completa como una unidad traducible y deja que la plantilla traducida ubique los elementos de React con nombre justo donde van.

Mantén la oración en una sola pieza #

tsx
import { useLingo } from "@lingo.dev/react";

export function PurchaseNotice({ product }: { product: string }) {
  const l = useLingo();
  return (
    <p>
      {l.rich("Read the <link>refund policy</link> before buying {product}.", {
        context: "Purchase notice linking to the refund policy",
        values: { product },
        tags: {
          link: (children) => <a href="/refund-policy">{children}</a>,
        },
      })}
    </p>
  );
}

Renderiza este componente dentro de un proveedor. El texto de origen y el contexto eligen la entrada del catálogo igual que con l.text. La plantilla traducida decide las palabras y dónde van las etiquetas; la función de devolución de llamada aporta el destino, los atributos, los estilos y el comportamiento.

l.rich devuelve un ReactNode. Su RichOptions requiere context, acepta un mapa values de cadenas o números y también acepta tags: Record<string, (children: ReactNode) => ReactNode>. Los nombres de las etiquetas deben coincidir de forma exacta, así que <link> necesita una función de devolución de llamada link.

Inserta un elemento sin hijos #

Una etiqueta de cierre automático llama a su función de renderizado con null como hijos. Por ejemplo, esta confirmación agrega un ícono decorativo después del mensaje:

tsx
const confirmation = l.rich("Saved <icon/>", {
  context: "Confirmation that account settings were saved",
  tags: {
    icon: () => <span aria-hidden="true">✓</span>,
  },
});

Aquí, l es el resultado useLingo() del componente. Puedes usar tanto <icon/> como <icon />. Para elementos anidados, usa nombres distintos, como <link><strong>refund policy</strong></link>, y proporciona ambas funciones de devolución de llamada. El analizador toma la siguiente etiqueta de cierre que coincida; anidar repetidamente etiquetas con el mismo nombre no se admite como estructura HTML equilibrada.

Revisa las etiquetas traducidas, no solo las palabras #

Si una etiqueta de apertura y cierre o de cierre automático no tiene función de devolución de llamada, se queda como texto literal. Lo mismo ocurre con una etiqueta de apertura que no tiene su cierre correspondiente. Así el mensaje se sigue renderizando, pero quien lo lea podría ver <link> en lugar de un enlace funcional.

Prueba la plantilla traducida con sus funciones de devolución de llamada reales. Verifica el texto del enlace y href, e incluye un caso con una etiqueta faltante para que cualquier marcado accidental salte a la vista durante el desarrollo. Las pruebas de renderizado no necesitan ninguna solicitud de traducción.

El marcado admitido se compone de etiquetas con nombre, no de HTML arbitrario. Define los atributos en la función de devolución de llamada en lugar de escribirlos en la traducción. Usar dangerouslySetInnerHTML para manejar una etiqueta sin pareja rompería esa separación.

Usa valores simples en los mensajes enriquecidos #

El texto enriquecido sustituye valores simples {name} en los segmentos de texto, pero no ejecuta el formateador ICU complejo que usa l.text. Para la gramática que depende de la cantidad, usa plurales y selecciones, o diseña la interfaz con mensajes gramaticalmente completos que la representación enriquecida admitida pueda expresar. Un plural ICU sin procesar dentro de una plantilla enriquecida no va a pluralizar solo por tener llaves.