Skip to content

The open alternative to Salesforce, designed for AI.

5.1 KB
Raw Blame
---
title: Секция
description: Сгруппируйте содержимое с заголовком, дополнительным описанием и необязательным действием.
---

import { PageBanner } from "/snippets/page-banner.mdx"

import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';
import SectionReference from '/snippets/ui/generated/components/layout/section.mdx';

## Обзор

`Section.Root` группирует связанное содержимое. `Section.Header` объединяет [Заголовок](/ru/ui/primitives/typography/heading) с описанием и необязательным содержимым `actions`. Описания — это обычный текст, связанный с заголовком, поэтому они не добавляют уровни в структуру документа.

<StoryEmbed storyId="ui-components-section--display" title="Пример раздела" height={150} />

## Использование

```tsx
import { Section } from 'twenty-ui/components/layout';
import { Text } from 'twenty-ui/primitives/typography';

export const WorkspaceSection = () => (
  <Section.Root>
    <Section.Header
      title="Workspace settings"
      description="Manage your workspace name and preferences."
    />
    <Text>Workspace preferences appear here.</Text>
  </Section.Root>
);
```

## Добавьте описание и действие

```tsx
import { Section } from 'twenty-ui/components/layout';
import { Button } from 'twenty-ui/primitives/input';
import { Text } from 'twenty-ui/primitives/typography';

export const WorkspaceSection = () => (
  <Section.Root>
    <Section.Header
      title="Workspace settings"
      description="Manage your workspace name and preferences."
      actions={<Button>Edit workspace</Button>}
    />
    <Text>Workspace preferences appear here.</Text>
  </Section.Root>
);
```

`Section.Root` по умолчанию представляет собой `div` на всю ширину с выравниванием по левому краю и основным цветом текста. Используйте `align`, `color` и `fullWidth`, чтобы настроить обёртку содержимого.

`Section.Header` также можно использовать отдельно. Его `level`, `size` и `color` настраивают заголовок и по умолчанию имеют значения `2`, `md` и `primary`. После заголовка есть один отступ spacing-4. Используйте нативные `style` или `className`, чтобы настроить этот отступ.

## Переполнение описания

Описания строк отображаются не более чем в пяти строках. Установите для `descriptionLineClamp` положительное целое число, чтобы выбрать другое ограничение, или `false`, чтобы отобразить полное описание без всплывающей подсказки при переполнении. При наведении отображается текст, не помещающийся в строке. Описания по умолчанию не добавляют точку остановки Tab; установите `isDescriptionFocusable`, чтобы включить доступ к всплывающей подсказке с помощью фокуса. Клавиша Escape закрывает всплывающую подсказку.

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

Передайте узел React для более насыщенного дополнительного содержимого. Расширенные описания отображаются в переданном виде, без автоматического усечения или всплывающих подсказок.

## Композиция

Обе части передают нативные атрибуты, refs, имена классов, стили и `render` своему внешнему элементу. Например, `Section.Root render={<section aria-label="Workspace settings" />}` предоставляет именованный раздел, а `Section.Header render={<header />}` использует контейнер заголовка.

При миграции замените `adornment` на `actions`. При необходимости включайте фокусировку описания с помощью `isDescriptionFocusable`. `SectionRootProps` и `SectionHeaderProps` экспортируются из `twenty-ui/components/layout`.

## Свойства

<SectionReference />

<PageBanner illustration="layout" />