tx()

Resumen

La función tx() es una función del lado del servidor para traducir cadenas de texto.

await tx('Hello, world!'); // returns 'Hola, mundo!'

Referencia

Parámetros

Devuelve

Una promesa que se resuelve en una cadena que contiene el contenido traducido, o el contenido original si no se necesita traducción.

Comportamiento

La función tx() traduce cadenas en tiempo de ejecución. Esto significa que las traducciones se realizan en vivo, por lo que puedes traducir contenido que solo se conoce en tiempo de ejecución. La desventaja es que hay un retraso mientras se espera que se cargue una traducción bajo demanda, lo cual es significativamente más lento.

Nuestro consejo es traducir todo lo que puedas en tiempo de compilación usando getGT(), useGT(), o <T>, y solo usar traducciones bajo demanda, como tx() y <Tx>, cuando sea necesario.

Asegúrate de seguir la guía de despliegue aquí.

Ejemplo

Uso Básico

Puedes usar tx() para traducir cadenas.

import { tx } from 'gt-next/server';
 
export default async function translateGreeting() {
    return await tx("Hello, world!"); 
}

Añadiendo contexto

Puedes personalizar la traducción proporcionando un contexto a considerar al traducir.

import { tx } from 'gt-next/server';
 
export default async function TranslateWithOptions() {
    return await tx("Hello, world!", {
        context: 'Traducir informalmente'
    });
}

Uso de Variables

Para pasar valores a tu cadena, debes (1) asignar un identificador y (2) referenciar el identificador en el campo variables.

import { tx } from 'gt-next/server';
 
export default async function translateWithVariables() {
    return await tx("The cost is {price}", {
        variables: { price : 29.99 },
        variableOptions: { price : { style: 'currency', currency: 'MXN' } }
    });
}

Especificando una Localidad

Puedes especificar una localidad para usar en la traducción. Por defecto, la localidad se establece en el idioma preferido del usuario.

import { tx } from 'gt-next/server';
 
export default async function translateWithLocale() {
    return await tx("Hello, world!", { locale: 'fr' }); 
}

Notas

• tx() es exclusivamente para uso del lado del servidor y no se puede usar en componentes del lado del cliente.
• Las traducciones con tx() ocurren en tiempo de ejecución, lo que significa que se traducen en vivo. Esto es significativamente más lento que las traducciones en tiempo de compilación.

Próximos Pasos

• Consulte useGT() y getGT() para traducir cadenas antes del despliegue.
• Para traducir jsx, consulte <T> y <Tx>.
• Consulte RuntimeTranslationOptions para obtener más información sobre cómo personalizar traducciones.