Mensajes con texto enriquecido

Traduce frases completas sin perder los destinos de los enlaces ni el comportamiento de React, que se quedan en el código de la aplicación.

Es habitual que un enlace vaya en mitad de una frase. Si traduces por separado lo que va antes, dentro y después del enlace, la traducción queda atada al orden de palabras del idioma de origen. l.rich mantiene la frase entera traducible y deja que la plantilla traducida coloque los elementos de React con nombre justo donde les corresponde.

Mantén la frase de una 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 seleccionan la entrada del catálogo igual que con l.text. La plantilla traducida decide las palabras y dónde van las etiquetas; el callback 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 acepta tags: Record<string, (children: ReactNode) => ReactNode>. Los nombres de las etiquetas deben coincidir exactamente, así que <link> necesita un callback 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 añade un icono 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. Se admiten tanto <icon/> como <icon />. Para los elementos anidados, usa nombres distintos, como <link><strong>refund policy</strong></link>, y proporciona ambos callbacks. 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 emparejada o de cierre automático no tiene callback, se queda como texto literal. Lo mismo ocurre con una etiqueta de apertura sin su cierre correspondiente. Así el mensaje se sigue pudiendo renderizar, pero quien lo lea puede encontrarse con <link> en lugar de un enlace que funcione.

Prueba la plantilla traducida con sus callbacks reales. Comprueba el texto del enlace y href, e incluye un caso en el que falte una etiqueta 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 basa en etiquetas con nombre, no en HTML arbitrario. Define los atributos en el callback en lugar de escribirlos en la traducción. Si usaras dangerouslySetInnerHTML para gestionar una etiqueta sin pareja, perderías esa separación.

Usa valores simples en los mensajes enriquecidos #

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