Descubrimiento de tokens
El "descubrimiento de tokens" es la forma en que el SDK determina qué se debe traducir, de manera automática, a partir de cómo escribes tu interfaz. Hay cuatro bloques de construcción, cada uno para un tipo distinto de contenido.
t(): una cadena en línea
El caballo de batalla. Llámalo con el texto de origen y devuelve la traducción para el idioma actual (o el propio texto de origen si ese idioma aún no está listo). La categoría opcional agrupa frases relacionadas y se envía al traductor automático como contexto; los params rellenan los {placeholders}.
const t = useT();
// t(phrase, category?, params?)
t('Hello, {name}!', 'Greetings', { name });<Translate>: un bloque de contenido
Envuelve una región de marcado y el SDK la tokeniza en un bloque de contenido (cada nodo de texto se convierte en una frase) y luego vuelve a traducir el bloque completo cada vez que cambia la configuración regional. Se identifica con un id estable derivado de su contenido y su categoría, de modo que el mismo bloque se reconoce entre renderizados y recargas.
<Translate category="Home">
<p>Welcome to our store. Browse the catalog in your language.</p>
</Translate><Phrase>: una oración, con marcado
Cuando una oración contiene marcado en línea o interpolación, <Phrase> la mantiene como una única unidad traducible, de modo que "Hola Sarah, tienes 3 artículos" se traduce como una oración natural y no como fragmentos sueltos. Admite parámetros y pluralización.
<Phrase category="Cart" params={{ name: 'Sarah', count: 3 }}>
Hi %name%, you have %count% items in your cart.
</Phrase>Marcadores de posición. Escribe la interpolación como {name}. Dentro del marcado donde un framework ya reserva { } (JSX, Vue, Svelte), escribe %name% en su lugar: el SDK lo normaliza de vuelta a {name} cuando captura la frase.
<DontTranslate>: déjalo como está
Nombres de marca, código, identificadores, direcciones: marca una región para que nunca se traduzca. Se renderiza como translate="no" y el descubrimiento la omite por completo.
<p>Welcome! <DontTranslate>This sentence always stays in English.</DontTranslate> Thanks for visiting!</p>El descubrimiento solo ocurre con una clave de escritura. En el navegador se distribuye una clave de solo lectura, por lo que el SDK nunca registra nada: solo obtiene las traducciones que ya existen. El registro es una actividad propia de la etapa de desarrollo. Consulta Claves y entornos.