# gt-next: General Translation Next.js SDK: Компоненты ветвления
URL: https://generaltranslation.com/ru/docs/next/guides/branches.mdx
---
title: Компоненты ветвления
description: Как использовать компоненты ветвления для условного контента в переводах
---

{/* СГЕНЕРИРОВАНО АВТОМАТИЧЕСКИ: Не редактируйте напрямую. Вместо этого изменяйте шаблон в content/docs-templates/. */}

Компоненты ветвления позволяют условно отображать содержимое внутри компонентов [`<T>`](/docs/next/api/components/t). Они обрабатывают динамическую логику, например конструкции if/else и правила множественного числа, при этом обеспечивая корректный перевод всех вариантов содержимого.


## Доступные компоненты

* [`<Branch>`](/docs/next/api/components/branch): Условный контент в зависимости от значений или состояний
* [`<Plural>`](/docs/next/api/components/plural): Автоматическая плюрализация по правилам локали

## Краткое руководство

Компоненты ветвления работают внутри [`<T>`](/docs/next/api/components/t) и позволяют обрабатывать условную логику:

```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> is currently online</p>}
        away={<p><Var>{user.name}</Var> is away</p>}
      >
        <p><Var>{user.name}</Var> status unknown</p>
      </Branch>
      
      <Plural
        n={messageCount}
        one={<p>You have <Num>{messageCount}</Num> message</p>}
        other={<p>You have <Num>{messageCount}</Num> messages</p>}
      />
    </T>
  );
}
```


## Как работают компоненты ветвления

Компоненты ветвления решают задачу условного рендеринга в переводах следующим образом:

1. **Заменяют тернарные операторы** и условную логику внутри [`<T>`](/docs/next/api/components/t)
2. **Предоставляют запасной вариант контента**, если условия не соответствуют ожидаемым значениям
3. **Позволяют переводить** все возможные варианты контента
4. **Автоматически применяют правила локали** для образования множественного числа

```jsx
// ❌ Это не работает — условная логика внутри <T>
<T><p>{isActive ? 'User is active' : 'User is inactive'}</p></T>

// ✅ Это работает — условная логика с ветвлением
<T>
  <Branch 
    branch={isActive} 
    true={<p>User is active</p>}
    false={<p>User is inactive</p>}
  />
</T>
```


## Руководство по компонентам

### Branch — Условный контент

Используйте [`<Branch>`](/docs/next/api/components/branch) для условного рендеринга на основе значений или состояний:

```jsx
// Отображение статуса пользователя
<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>

// Булевы условия
<T>
  <Branch 
    branch={isLoggedIn}
    true={<p>Welcome back!</p>}
    false={<p>Please log in</p>}
  />
</T>

// Уровни подписки
<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 — Умная плюрализация

Используйте [`<Plural>`](/docs/next/api/components/plural) для контента, который меняется в зависимости от количества:

```jsx
// Базовая плюрализация
<T>
  <Plural
    n={itemCount}
    one={<p><Num>{itemCount}</Num> item in cart</p>}
    other={<p><Num>{itemCount}</Num> items in cart</p>}
  />
</T>

// Обработка нулевого значения
<T>
  <Plural
    n={notifications}
    zero={<p>No new notifications</p>}
    one={<p><Num>{notifications}</Num> notification</p>}
    other={<p><Num>{notifications}</Num> notifications</p>}
  />
</T>

// Сложная плюрализация (следует правилам Unicode CLDR)
<T>
  <Plural
    n={days}
    zero={<p>Due today</p>}
    one={<p>Due in <Num>{days}</Num> day</p>}
    few={<p>Due in <Num>{days}</Num> days</p>}
    many={<p>Due in <Num>{days}</Num> days</p>}
    other={<p>Due in <Num>{days}</Num> days</p>}
  />
</T>
```


### Сочетание с переменными компонентами

Компоненты ветвления и переменные компоненты легко сочетаются друг с другом:

```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>
```


## Когда использовать компоненты ветвления

### Замените тернарные операторы

Преобразуйте условную логику для использования внутри компонента [`<T>`](/docs/next/api/components/t):

```jsx
// ❌ Нельзя использовать тернарный оператор в <T>
<T>{isActive ? <p>Active user</p> : <p>Inactive user</p>}</T>

// ✅ Используйте Branch вместо него
<T>
  <Branch 
    branch={isActive}
    true={<p>Active user</p>}
    false={<p>Inactive user</p>}
  />
</T>
```


### Обработка нескольких условий

Замените конструкции switch или несколько условий if/else:

```jsx
// ❌ Сложная условная логика
<T>
  {status === 'loading' ? <p>Loading...</p> : 
   status === 'error' ? <p>Error occurred</p> : 
   status === 'success' ? <p>Success!</p> : 
   <p>Unknown status</p>}
</T>

// ✅ Чистая логика ветвления
<T>
  <Branch
    branch={status}
    loading={<p>Loading...</p>}
    error={<p>Error occurred</p>}
    success={<p>Success!</p>}
  >
    <p>Unknown status</p>
  </Branch>
</T>
```


### Правила плюрализации

Замените ручную обработку форм множественного числа:

```jsx
// ❌ Ручная плюрализация
<T>{count === 1 ? <p>1 item</p> : <p>{count} items</p>}</T>

// ✅ Автоматическая плюрализация
<T>
  <Plural
    n={count}
    one={<p><Num>{count}</Num> item</p>}
    other={<p><Num>{count}</Num> items</p>}
  />
</T>
```


## Автономное использование

Компоненты ветвления можно использовать вне [`<T>`](/docs/next/api/components/t), если нужна только логика, без перевода:

```jsx
// Чистый условный рендеринг
<Branch
  branch={theme}
  dark={<DarkModeIcon />}
  light={<LightModeIcon />}
>
  <DefaultIcon />
</Branch>

// Чистая плюрализация
<Plural
  n={count}
  one={<SingleItemComponent />}
  other={<MultipleItemsComponent />}
/>
```


## Распространённые проблемы

### Отсутствуют ключи ветвей

Всегда указывайте запасной вариант контента для значений, для которых нет совпадения:

```jsx
// ❌ Нет запасного варианта контента для неожиданных значений
<Branch
  branch={userRole}
  admin={<AdminPanel />}
  user={<UserPanel />}
  // Что если userRole равно "moderator"?
/>

// ✅ Всегда указывайте запасной вариант контента
<Branch
  branch={userRole}
  admin={<AdminPanel />}
  user={<UserPanel />}
>
  <DefaultPanel /> {/* Запасной вариант контента для любого другого значения */}
</Branch>
```


### Неполные формы множественного числа

Укажите необходимые формы множественного числа для локали по умолчанию:

```jsx
// ❌ Отсутствует форма "other"
<Plural
  n={count}
  one={<p>1 item</p>}
  // А как насчёт 0, 2, 3 и т.д.?
/>

// ✅ Укажите необходимые формы
<Plural
  n={count}
  zero={<p>No items</p>}
  one={<p>1 item</p>}
  other={<p>{count} items</p>}
/>
```


### Сложная вложенная логика

Хотя это работает, мы рекомендуем делать логику ветвления простой и избегать глубокой вложенности:

```jsx
// ❌ Сложная вложенная ветвящаяся логика
<Branch branch={status}>
  <Branch branch={subStatus}>
    {/* Сложно читать и поддерживать */}
  </Branch>
</Branch>

// ✅ Упростите логику или используйте несколько компонентов
<Branch
  branch={`${status}-${subStatus}`}
  active-online={<ActiveOnline />}
  active-offline={<ActiveOffline />}
  inactive-online={<InactiveOnline />}
>
  <DefaultState />
</Branch>
```

<Callout>
  Подробнее о правилах плюрализации см. в [документации Unicode CLDR](https://cldr.unicode.org/index/cldr-spec/plural-rules).
</Callout>


## Следующие шаги

* [Руководство по переводу строк](/docs/next/guides/strings) - Переводите обычный текст без JSX
* [Руководство по динамическому контенту](/docs/key-concepts/dynamic-content) - Настройте перевод во время выполнения
* Справочник API:
  * [Компонент `<Branch>`](/docs/next/api/components/branch)