# gt-next: General Translation Next.js SDK: деривация
URL: https://generaltranslation.com/ru/docs/next/api/strings/derive.mdx
---
title: деривация
description: Справочник по API строковой функции derive()
---

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


## Обзор

Функция деривации `derive` позволяет использовать в строке перевода статические вызовы функций и выражения переменных.
Это полезно для написания переиспользуемого кода, интернационализации фрагментированных предложений и сохранения грамматического согласования.

```jsx
const getDisplayName = (condition) => {
  return condition ? "User" : 'Admin';
};

gt(`${derive(getDisplayName(condition))} says hello.`);
// Создаёт две записи перевода:
// "User says hello." -> "Usuario dice hola."
// "Admin says hello." -> "Administrador dice hola."
```

Это работает за счёт генерации отдельных вариантов перевода для каждого возможного результата, что позволяет сохранять согласование слов, спряжение и изменения порядка слов в разных языках.

<Callout>
  **Несколько записей перевода:**
  Деривация `derive` создаёт отдельные записи перевода для каждого возможного результата обёрнутой функции, что может значительно увеличить количество переводов.
  Используйте эту возможность с осторожностью и отдавайте предпочтение ICU-выражениям `select`, если множитель становится слишком большим.
</Callout>

<Callout>
  **Статический анализ:**
  Деривация `derive` может анализировать только содержимое, известное на этапе сборки.
  Любое динамическое содержимое (переменные, вызовы API и т. д.) должно быть обёрнуто в `declareVar`.
</Callout>

## Справочник

### Параметры

| Name      | Type                                                         | Description                                                     |
| --------- | ------------------------------------------------------------ | --------------------------------------------------------------- |
| `content` | `T extends string \| boolean \| number \| null \| undefined` | Статический вызов функции, возвращающий переводимое содержимое. |

### Возвращаемое значение

Возвращает `content` типа `T`.

***

## Поведение

### Анализ на этапе сборки

В процессе сборки CLI-инструмент:

1. Анализирует функцию, обёрнутую в `derive`
2. Определяет все возможные значения, которые может вернуть функция (они должны поддаваться статическому анализу на этапе сборки)
3. Создаёт отдельные записи перевода для каждого уникального результата

### Влияние на производительность

Как и `<Derive>`, `derive` увеличивает число записей перевода.
Каждый вызов функции с несколькими возможными результатами создает отдельные переводы, а несколько вызовов `derive` в одной строке экспоненциально увеличивают общее число записей.

***

## Пример

### Переиспользуемый контент

Вы можете использовать `derive` для обработки фрагментированных предложений и переиспользуемого контента в вызовах функций.

```jsx copy
import { derive, gt } from 'gt-next';

function getSubject() {
  return "boy";
}

function Component() {
  const translation1 = gt(`The ${derive(getSubject())} is playing.`);
  const translation2 = gt(`The ${derive(getSubject())} is having fun.`);
  const translation3 = gt(`The ${derive(getSubject())} is having a great time.`);
  return <p>{translation1} {translation2} {translation3}</p>;
}
```


### Фрагментированные предложения

Вы можете использовать `derive` для работы с фрагментированными предложениями при вызовах функций.

```jsx copy
import { derive, gt } from 'gt-next';

function getSubject(gender) {
  return gender === 'male' ? 'boy' : 'girl';
}

function Component({ gender }) {
  const translation = gt(`The ${derive(getSubject(gender))} is playing.`);
  return <p>{translation}</p>;
}
```


### Согласование

Без `derive` перевод с согласованием получается синтаксически громоздким.
Нужно добавить конструкцию `select`, чтобы обработать согласование (число, род и т. д.).
Затем также нужно перечислить все возможные варианты.

```jsx copy
import { gt } from 'gt-next';

function getSubject(gender) {
  return gender === 'male' ? 'boy' : 'girl';
}

function Component({ gender }) {
  const translation = gt(
    '{gender, select, boy {The boy is playing.} girl {The girl is playing.} other {}}',
    {
      gender: getSubject(gender) ,
    },
  );
  return <p>{translation}</p>;
}
```

С `derive` согласование становится очень простым.
Не требуется ни `select`-выражение, ни явное перечисление всех возможных вариантов.

```jsx copy
import { derive, declareVar, gt } from 'gt-next';

function getSubject(gender) {
  return gender === 'male' ? 'boy' : 'girl';
}

function Component({ gender }) {
  const translation = gt(`The ${derive(getSubject(gender))} is playing.`);
  return <p>{translation}</p>;
}
```

При использовании `derive` CLI определяет, что у `getSubject` есть два возможных варианта, и создает отдельную запись перевода для каждого из них.
Благодаря этому согласование обрабатывается автоматически.

* &quot;The boy is playing&quot; -&gt; &quot;*El* niño está jugando&quot;
* &quot;The girl is playing&quot; -&gt; &quot;*La* niña está jugando&quot;


### С переменными

Вы можете использовать `derive` вместе с `declareVar` для работы с динамическим содержимым.

```jsx copy
import { derive, declareVar, gt } from 'gt-next';

function getGreeting(name) {
  return name ? `Hello, ${declareVar(name)}` : 'Hello, stranger';
}

function Component({ name }) {
  const translation = gt(`${derive(getGreeting(name))}! How are you?`);
  return <p>{translation}</p>;
}
```


### Сложные функции

Функции могут содержать несколько условных ветвей и операторов `return`.

```jsx copy
import { derive, gt } from 'gt-next';

function getStatusMessage(status, priority) {
  if (status === 'complete') {
    return priority === 'high' ? 'Urgent task completed' : 'Task completed';
  } else if (status === 'pending') {
    return priority === 'high' ? 'Urgent task pending' : 'Task pending';
  }
  return 'Task status unknown';
}

function Component({ status, priority }) {
  const message = gt(`${derive(getStatusMessage(status, priority))}.`);
  return <p>{message}</p>;
}
```


### Встроенные выражения и логика

Логику можно встроить прямо в вызов `derive`.

```jsx copy
import { derive, gt } from 'gt-next';

function Component({ gender }) {
  const message = gt(`The ${derive(gender === 'male' ? 'boy' : 'girl')} is playing.`);
  return <p>{message}</p>;
}
```

***


## Примечания

* Используйте `derive` с осторожностью, так как это может экспоненциально увеличить количество записей перевода
* Все возможные результаты должны поддаваться статическому анализу на этапе сборки
* Переменные внутри статических функций должны быть обёрнуты в `declareVar`

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

* См. [`declareVar`](/docs/next/api/strings/declare-var), чтобы помечать динамическое содержимое в статических функциях
* См. [`decodeVars`](/docs/next/api/strings/decode-vars), чтобы извлекать исходные значения из объявленных переменных
* См. [`<Derive>`](/docs/next/api/components/derive) — JSX-эквивалент
* Дополнительные сведения см. в [примечаниях к выпуску](/devlog/gt-next_v6_12_0)