Перейти к содержимому

Group

Компонент для визуальной группировки связанных элементов интерфейса. Обеспечивает единое стилевое оформление, управление отступами и разделителями между блоками контента.

Group можно вкладывать в другой Group. Чаще всего вложенным компонентам нужно задать mode="plain" — это даёт прозрачный фон и скрывает рамки.

Заголовок группы. Передаётся либо в свойство header, либо в начале children, либо в Group.Header.

СвойствоРасположениеРекомендуемый размер
beforeСлева от всего контента28px
beforeTitleСлева от заголовка16px
afterTitleСправа от заголовка16px
beforeSubtitleСлева от подзаголовка12px
afterSubtitleСправа от подзаголовка12px
  • indicator — отображает счётчик/статус:

    <Header indicator={<Badge mode="prominent">12</Badge>}>Уведомления</Header>
  • after — контент справа от всего заголовка:

    <Header after={<Switch label="Настройки" />}>Настройки</Header>

Компенсирует внутренние отступы Group.

Собрать Group самостоятельно можно с помощью следующих подкомпонентов:

  • Group.Container – служит оберткой, отвечающей за скругления и отступы внутри группы. Принимает все основные свойства Group, кроме header и description.

  • Group.Header – отвечает за отрисовку заголовка. Соответствует свойству header у Group. Рекомендуется использовать подкомпонент Header в качестве содержимого.

  • Group.Description – отвечает за отрисовку подписи в нижней части группы. Соответствует свойству description у Group.

СвойствоОписание
ComponentElementType<any, keyof IntrinsicElements>
По умолчанию: -
descriptionReactNode

Подпись под содержимым.

По умолчанию: -
getRootRefRef<HTMLElement>
По умолчанию: -
headerReactNode

Элемент заголовка группы.

По умолчанию: -
mode"card" | "plain"

Режим отображения. Если установлен card, выглядит как карточка c обводкой и внешними отступами. Если plain — без отступов и обводки. По умолчанию режим отображения зависит от viewWidth (card при SMALL_TABLET и plain при MOBILE) В модальных окнах по умолчанию plain.

По умолчанию: -
padding"s" | "m"

Отвечает за отступы вокруг контента в режиме card.

По умолчанию: -
render((props: AllHTMLAttributes<HTMLElement> & HasRootRef<HTMLElement>) => ReactNode)

Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные className и style). Используется вместо Component.

Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер.

По умолчанию: -
separator"auto" | "show" | "hide"

show (только для mode="plain") - разделитель всегда показывается hide - разделитель всегда спрятан, auto - разделитель рисуется автоматически между соседними группами.

По умолчанию: -
СвойствоОписание
ComponentElementType<any, keyof IntrinsicElements>
По умолчанию: -
getRootRefRef<HTMLElement>
По умолчанию: -
mode"card" | "plain"

Режим отображения. Если установлен card, выглядит как карточка c обводкой и внешними отступами. Если plain — без отступов и обводки. По умолчанию режим отображения зависит от viewWidth (card при SMALL_TABLET и plain при MOBILE) В модальных окнах по умолчанию plain.

По умолчанию: -
padding"s" | "m"

Отвечает за отступы вокруг контента в режиме card.

По умолчанию: m
render((props: AllHTMLAttributes<HTMLElement> & HasRootRef<HTMLElement>) => ReactNode)

Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные className и style). Используется вместо Component.

Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер.

По умолчанию: -
separator"auto" | "show" | "hide"

show (только для mode="plain") - разделитель всегда показывается hide - разделитель всегда спрятан, auto - разделитель рисуется автоматически между соседними группами.

По умолчанию: auto
СвойствоОписание
ComponentElementType<any, keyof IntrinsicElements>
По умолчанию: -
getRootRefRef<HTMLElement>
По умолчанию: -
СвойствоОписание
ComponentElementType<any, keyof IntrinsicElements>
По умолчанию: -
getRootRefRef<HTMLElement>
По умолчанию: -
render((props: AllHTMLAttributes<HTMLElement> & HasRootRef<HTMLElement>) => ReactNode)

Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные className и style). Используется вместо Component.

Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер.

По умолчанию: -
СвойствоОписание
ComponentElementType<any, keyof IntrinsicElements>
По умолчанию: -
direction"inline" | "block"

Направление отображения контента.

По умолчанию: inline
getRootRefRef<HTMLElement>
По умолчанию: -
render((props: AllHTMLAttributes<HTMLElement> & HasRootRef<HTMLElement>) => ReactNode)

Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные className и style). Используется вместо Component.

Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер.

По умолчанию: -
СвойствоОписание
afterReactNode

Допускаются иконки, текст, Link.

По умолчанию: -
afterSubtitleReactNode

Иконка справа от subtitle (рекомендуется использовать размер 12px).

По умолчанию: -
afterTitleReactNode

Иконка справа от title (рекомендуется использовать размер 16px).

По умолчанию: -
beforeReactNode

Иконка слева (рекомендуется использовать размер 28px).

По умолчанию: -
beforeSubtitleReactNode

Иконка слева от subtitle (рекомендуется использовать размер 12px).

По умолчанию: -
beforeTitleReactNode

Иконка слева от title (рекомендуется использовать размер 16px).

По умолчанию: -
ComponentElementType<any, keyof IntrinsicElements>
По умолчанию: h2
getRootRefRef<HTMLElement>
По умолчанию: -
indicatorReactNode

Допускаются текст, Indicator.

По умолчанию: -
multilineboolean

Возможность отображения текста в несколько строк.

По умолчанию: -
render((props: AllHTMLAttributes<HTMLElement> & HasRootRef<HTMLElement>) => ReactNode)

Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные className и style). Используется вместо Component.

Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер.

По умолчанию: -
size"s" | "m" | "l" | "xl"

Размер компонента.

По умолчанию: m
subtitleReactNode

Подпись под основным текстом.

По умолчанию: -
subtitleComponentElementType<any, keyof IntrinsicElements>

Позволяет задать тип элемента в который будет обёрнут subtitle.

По умолчанию: span
СвойствоОписание
ComponentElementType<any, keyof IntrinsicElements>
По умолчанию: footer
render((props: AllHTMLAttributes<HTMLElement> & HasRootRef<HTMLElement>) => ReactNode)

Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные className и style). Используется вместо Component.

Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер.

По умолчанию: -