Cadenas
Cómo internacionalizar cadenas de texto simples con useGT
La traducción de cadenas permite acceder directamente a traducciones de texto sin JSX, ideal para atributos, propiedades de objetos y valores de texto sin formato. Usa useGT en componentes de React para traducir cadenas.
Comenzar rápido
import { useGT } from 'gt-react';
function MyComponent() {
  const t = useGT();
  return (
    <input 
      placeholder={t('Ingresa tu email')}
      title={t('Campo de email')}
    />
  );
}Cuándo usar la traducción de cadenas
La traducción de cadenas es ideal cuando necesitas texto simple en lugar de JSX:
Atributos de HTML
const t = useGT();
<input 
  placeholder={t('Buscar productos...')}
  aria-label={t('Campo de búsqueda de productos')}
  title={t('Escribe para buscar en nuestro catálogo')}
/>Propiedades de los objetos
const t = useGT();
const user = {
  name: 'John',
  role: 'admin',
  bio: t('Desarrollador de software con experiencia y 5 años trabajando con React'),
  status: t('Actualmente disponible para proyectos')
};Configuración y constantes
const t = useGT();
const navigationItems = [
  { label: t('Inicio'), href: '/' },
  { label: t('Productos'), href: '/products' },
  { label: t('Contacto'), href: '/contact' }
];Cuándo usar <T> en su lugar
Usa el componente <T> para contenido JSX:
// ✅ Usa <T> para contenido JSX
<T><p>Bienvenido a <strong>nuestra tienda</strong>!</p></T>
// ✅ Usa traducción de cadenas para texto plano
<input placeholder={t('Buscar productos')} />Uso de variables
Variables básicas
Sustituye los marcadores de posición por valores dinámicos:
const t = useGT();
const itemCount = 5;
// Cadena con marcador de posición
const message = t('Tienes {count} artículos en tu carrito', { count: itemCount });
// Resultado: "Tienes 5 artículos en tu carrito"Varias variables
const t = useGT();
const order = { id: 'ORD-123', total: 99.99, date: '2024-01-15' };
const confirmation = t(
  'El pedido {orderId} por ${total} fue realizado el {date}',
  { 
    orderId: order.id, 
    total: order.total, 
    date: order.date 
  }
);Formato de mensajes ICU
Para un formato avanzado, usa la sintaxis de ICU:
const t = useGT();
translate('Hay {count, plural, =0 {ningún artículo} =1 {un artículo} other {{count} artículos}} en el carrito', { count: 10 });Obtén más información sobre ICU message format en la documentación de Unicode.
Ejemplos
Campos de formulario
import { useGT } from 'gt-react';
function ContactForm() {
  const t = useGT();
  
  return (
    <form>
      <input 
        type="email"
        placeholder={t('Ingresa tu dirección de correo electrónico')}
        aria-label={t('Campo de entrada de correo electrónico')}
      />
      <textarea 
        placeholder={t('Cuéntanos sobre tu proyecto...')}
        aria-label={t('Descripción del proyecto')}
      />
      <button type="submit">
        {t('Enviar mensaje')}
      </button>
    </form>
  );
}Menú de navegación
import { useGT } from 'gt-react';
function Navigation() {
  const t = useGT();
  
  const menuItems = [
    { label: t('Inicio'), href: '/', icon: 'home' },
    { label: t('Acerca de'), href: '/about', icon: 'info' },
    { label: t('Servicios'), href: '/services', icon: 'briefcase' },
    { label: t('Contacto'), href: '/contact', icon: 'mail' }
  ];
  return (
    <nav>
      {menuItems.map((item) => (
        <a key={item.href} href={item.href} title={item.label}>
          <Icon name={item.icon} />
          {item.label}
        </a>
      ))}
    </nav>
  );
}Fábrica de contenido dinámico
// utils/productData.js
export function getProductMessages(t) {
  return {
    categories: [
      { id: 'electronics', name: t('Electrónicos') },
      { id: 'clothing', name: t('Ropa') },
      { id: 'books', name: t('Libros') }
    ],
    statusMessages: {
      available: t('En stock y listo para envío'),
      backordered: t('Actualmente en lista de espera - se envía en 2-3 semanas'),  
      discontinued: t('Este artículo ha sido descontinuado')
    },
    errors: {
      notFound: t('Producto no encontrado'),
      outOfStock: t('Lo sentimos, este artículo está actualmente agotado')
    }
  };
}
// components/ProductCard.jsx
import { useGT } from 'gt-react';
import { getProductMessages } from '../utils/productData';
function ProductCard({ product }) {
  const t = useGT();
  const messages = getProductMessages(t);
  
  return (
    <div>
      <h3>{product.name}</h3>
      <p>{messages.statusMessages[product.status]}</p>
      <span>{messages.categories.find(c => c.id === product.categoryId)?.name}</span>
    </div>
  );
}Componente con título del documento
import { useGT } from 'gt-react';
import { useEffect } from 'react';
function ProductPage() {
  const t = useGT();
  
  useEffect(() => {
    document.title = t('Catálogo de Productos - Encuentra lo que necesitas');
    
    // Actualizar meta descripción
    const metaDescription = document.querySelector('meta[name="description"]');
    if (metaDescription) {
      metaDescription.setAttribute('content', t('Explora nuestra amplia colección de productos de alta calidad'));
    }
  }, [t]);
  
  return (
    <div>
      <h1>{t('Productos Destacados')}</h1>
      <p>{t('Descubre nuestros artículos más recientes y populares')}</p>
    </div>
  );
}Problemas frecuentes
Contenido dinámico en tiempo de ejecución
Las cadenas deben estar definidas en tiempo de compilación; no puedes traducir contenido dinámico.
// ❌ El contenido dinámico no funcionará
function MyComponent() {
  const [userMessage, setUserMessage] = useState('');
  const t = useGT();
  
  return <p>{t(userMessage)}</p>; // Esto fallará
}
// ✅ Usa cadenas predefinidas
function MyComponent() {
  const [messageType, setMessageType] = useState('welcome');
  const t = useGT();
  
  const messages = {
    welcome: t('¡Bienvenido a nuestra aplicación!'),
    goodbye: t('¡Gracias por visitarnos!')
  };
  
  return <p>{messages[messageType]}</p>;
}Infracciones de las reglas de hooks
Sigue las reglas de hooks de React al usar useGT:
// ❌ No llames hooks condicionalmente
function MyComponent({ showMessage }) {
  if (showMessage) {
    const t = useGT(); // Violación de la regla de hooks
    return <p>{t('¡Hola!')}</p>;
  }
  return null;
}
// ✅ Siempre llama hooks en el nivel superior
function MyComponent({ showMessage }) {
  const t = useGT();
  
  if (showMessage) {
    return <p>{t('¡Hola!')}</p>;
  }
  return null;
}Para contenido realmente dinámico que necesita traducción en tiempo de ejecución, consulta la Guía de contenido dinámico.
Próximos pasos
- Guía de contenido dinámico - Gestiona traducciones en tiempo de ejecución
- Guía de cadenas compartidas - Organiza traducciones reutilizables
- Referencia de API:
¿Qué te ha parecido esta guía?

