# gt-next: General Translation Next.js SDK: Componentes de uso de ramas
URL: https://generaltranslation.com/es/docs/next/guides/branches.mdx
---
title: Componentes de uso de ramas
description: Cómo usar componentes de uso de ramas para contenido condicional en las traducciones
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. Edita la plantilla en content/docs-templates/. */}

Los componentes de uso de ramas permiten renderizar contenido de forma condicional dentro de los componentes [`<T>`](/docs/next/api/components/t). Manejan lógica dinámica, como sentencias if/else y reglas de pluralización, y garantizan que todas las variaciones de contenido puedan traducirse correctamente.


## Componentes disponibles

* [`<Branch>`](/docs/next/api/components/branch): Contenido condicional en función de valores o estados
* [`<Plural>`](/docs/next/api/components/plural): Pluralización automática mediante reglas específicas de la configuración regional

## Inicio rápido

Los componentes de uso de ramas se usan dentro de [`<T>`](/docs/next/api/components/t) para manejar lógica condicional:

```jsx
import { T, Branch, Plural, Num, Var } from 'gt-next';

function NotificationPanel({ user, messageCount }) {
  return (
    <T>
      <Branch 
        branch={user.status}
        online={<p><Var>{user.name}</Var> está en línea</p>}
        away={<p><Var>{user.name}</Var> está ausente</p>}
      >
        <p>Estado de <Var>{user.name}</Var> desconocido</p>
      </Branch>
      
      <Plural
        n={messageCount}
        one={<p>Tienes <Num>{messageCount}</Num> mensaje</p>}
        other={<p>Tienes <Num>{messageCount}</Num> mensajes</p>}
      />
    </T>
  );
}
```


## Cómo funcionan los componentes de uso de ramas

Los componentes de uso de ramas resuelven el renderizado condicional dentro de las traducciones de la siguiente manera:

1. **Reemplazan los operadores ternarios** y la lógica condicional dentro de [`<T>`](/docs/next/api/components/t)
2. **Proporcionan contenido alternativo** cuando las condiciones no coinciden con los valores esperados
3. **Permiten traducir** todas las posibles variaciones de contenido
4. **Siguen automáticamente las reglas de pluralización de la configuración regional**

```jsx
// ❌ Esto falla - lógica condicional en <T>
<T><p>{isActive ? 'User is active' : 'User is inactive'}</p></T>

// ✅ Esto funciona - lógica condicional con uso de ramas
<T>
  <Branch 
    branch={isActive} 
    true={<p>User is active</p>}
    false={<p>User is inactive</p>}
  />
</T>
```


## Guía de componentes

### Branch - Contenido condicional

Usa [`<Branch>`](/docs/next/api/components/branch) para cualquier caso de renderizado condicional basado en valores o estados:

```jsx
// Visualización del estado del usuario
<T>
  <Branch 
    branch={user.role}
    admin={<p>Administrator Dashboard</p>}
    user={<p>User Dashboard</p>}
    guest={<p>Guest Access</p>}
  >
    <p>Access level unknown</p>
  </Branch>
</T>

// Condiciones booleanas
<T>
  <Branch 
    branch={isLoggedIn}
    true={<p>Welcome back!</p>}
    false={<p>Please log in</p>}
  />
</T>

// Niveles de suscripción
<T>
  <Branch
    branch={subscription.tier}
    free={<p>Upgrade to unlock premium features</p>}
    premium={<p>Enjoy your premium experience</p>}
    enterprise={<p>Contact support for enterprise solutions</p>}
  >
    <p>Subscription status unavailable</p>
  </Branch>
</T>
```


### Plural - Pluralización inteligente

Usa [`<Plural>`](/docs/next/api/components/plural) para contenido que cambia según la cantidad:

```jsx
// Pluralización básica
<T>
  <Plural
    n={itemCount}
    one={<p><Num>{itemCount}</Num> artículo en el carrito</p>}
    other={<p><Num>{itemCount}</Num> artículos en el carrito</p>}
  />
</T>

// Manejo del cero
<T>
  <Plural
    n={notifications}
    zero={<p>Sin notificaciones nuevas</p>}
    one={<p><Num>{notifications}</Num> notificación</p>}
    other={<p><Num>{notifications}</Num> notificaciones</p>}
  />
</T>

// Pluralización compleja (sigue las reglas Unicode CLDR)
<T>
  <Plural
    n={days}
    zero={<p>Vence hoy</p>}
    one={<p>Vence en <Num>{days}</Num> día</p>}
    few={<p>Vence en <Num>{days}</Num> días</p>}
    many={<p>Vence en <Num>{days}</Num> días</p>}
    other={<p>Vence en <Num>{days}</Num> días</p>}
  />
</T>
```


### Combinación con componentes de variable

El uso de ramas y los componentes de variable se integran sin problemas:

```jsx
<T>
  <Branch
    branch={order.status}
    pending={
      <p>
        Order <Var>{order.id}</Var> is pending. 
        Total: <Currency currency="USD">{order.total}</Currency>
      </p>
    }
    shipped={
      <p>
        Order <Var>{order.id}</Var> shipped on <DateTime>{order.shippedDate}</DateTime>
      </p>
    }
    delivered={
      <p>Order <Var>{order.id}</Var> was delivered successfully</p>
    }
  >
    <p>Order status unknown</p>
  </Branch>
</T>
```


## Cuándo usar el componente de uso de ramas

### Reemplazar operadores ternarios

Convierte la lógica condicional para usarla dentro de [`<T>`](/docs/next/api/components/t):

```jsx
// ❌ No se puede usar el operador ternario en <T>
<T>{isActive ? <p>Active user</p> : <p>Inactive user</p>}</T>

// ✅ Usa Branch en su lugar
<T>
  <Branch 
    branch={isActive}
    true={<p>Active user</p>}
    false={<p>Inactive user</p>}
  />
</T>
```


### Maneja múltiples condiciones

Reemplaza las sentencias switch o varias condiciones if/else:

```jsx
// ❌ Lógica condicional compleja
<T>
  {status === 'loading' ? <p>Loading...</p> : 
   status === 'error' ? <p>Error occurred</p> : 
   status === 'success' ? <p>Success!</p> : 
   <p>Unknown status</p>}
</T>

// ✅ Lógica de uso de ramas limpia
<T>
  <Branch
    branch={status}
    loading={<p>Loading...</p>}
    error={<p>Error occurred</p>}
    success={<p>Success!</p>}
  >
    <p>Unknown status</p>
  </Branch>
</T>
```


### Reglas de pluralización

Reemplaza la gestión manual del plural:

```jsx
// ❌ Pluralización manual
<T>{count === 1 ? <p>1 item</p> : <p>{count} items</p>}</T>

// ✅ Pluralización automática
<T>
  <Plural
    n={count}
    one={<p><Num>{count}</Num> item</p>}
    other={<p><Num>{count}</Num> items</p>}
  />
</T>
```


## Uso independiente

Los componentes de uso de ramas pueden usarse fuera de [`<T>`](/docs/next/api/components/t) para lógica pura, sin traducción:

```jsx
// Renderizado condicional puro
<Branch
  branch={theme}
  dark={<DarkModeIcon />}
  light={<LightModeIcon />}
>
  <DefaultIcon />
</Branch>

// Pluralización pura
<Plural
  n={count}
  one={<SingleItemComponent />}
  other={<MultipleItemsComponent />}
/>
```


## Problemas comunes

### Claves de rama faltantes

Proporciona siempre contenido alternativo para los valores que no coincidan:

```jsx
// ❌ Sin alternativa para valores inesperados
<Branch
  branch={userRole}
  admin={<AdminPanel />}
  user={<UserPanel />}
  // ¿Qué pasa si userRole es "moderator"?
/>

// ✅ Incluye siempre una alternativa
<Branch
  branch={userRole}
  admin={<AdminPanel />}
  user={<UserPanel />}
>
  <DefaultPanel /> {/* Alternativa para cualquier otro valor */}
</Branch>
```


### Formas de plural incompletas

Proporciona las formas de plural necesarias para tu configuración regional predeterminada:

```jsx
// ❌ Falta la forma "other"
<Plural
  n={count}
  one={<p>1 item</p>}
  // ¿Y qué pasa con 0, 2, 3, etc.?
/>

// ✅ Incluir las formas necesarias
<Plural
  n={count}
  zero={<p>No items</p>}
  one={<p>1 item</p>}
  other={<p>{count} items</p>}
/>
```


### Lógica anidada compleja

Aunque esto funciona, recomendamos mantener sencilla la lógica de uso de ramas y evitar un anidamiento profundo:

```jsx
// ❌ Uso de ramas anidadas complejo
<Branch branch={status}>
  <Branch branch={subStatus}>
    {/* Difícil de leer y mantener */}
  </Branch>
</Branch>

// ✅ Simplifica la lógica o usa múltiples componentes
<Branch
  branch={`${status}-${subStatus}`}
  active-online={<ActiveOnline />}
  active-offline={<ActiveOffline />}
  inactive-online={<InactiveOnline />}
>
  <DefaultState />
</Branch>
```

<Callout>
  Obtener más información sobre las reglas de pluralización en la [documentación de Unicode CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules).
</Callout>


## Próximos pasos

* [Guía de traducción de cadenas](/docs/next/guides/strings) - Traduce texto sin formato sin JSX
* [Guía de contenido dinámico](/docs/key-concepts/dynamic-content) - Gestiona la traducción en tiempo de ejecución
* Referencias de la API:
  * [Componente `<Branch>`](/docs/next/api/components/branch)