AiFieldBanner

AiFieldBanner — компактный баннер под полем ввода из набора AI Components. Показывает подсказку, предупреждение или контекст действия с опциональной иконкой, кнопкой справа и дополнительным слотом снизу.

Ширину задаёт родитель (400px в макете — пример). Высота подстраивается под содержимое: при одной строке текста s — 40px, m — 48px; с нижним слотом 16px — 64px и 72px.

Когда использовать

  • Подсказки и валидация у AI-полей (information, help, warning, critical).
  • Контекст безопасности или агентного сценария (security, agentic).
  • Дополнительный контент под основной строкой — ссылка, чип, короткий список (bottomContent).

Когда не нужен

  • Полноразмерный inline-alert в контенте страницы — используйте @cloud-ru/ds-alert.
  • Системный баннер по верхней кромке — используйте AlertTop из @cloud-ru/ds-alert.

Анатомия

Variant

Семантика фона (проп variant):

  • information, security, help, agentic — полупрозрачная подложка с размытием фона;
  • warning, critical — непрозрачная подложка, иконка окрашена акцентом варианта.

Иконка не подставляется автоматически — передайте icon явно. У всех вариантов обводка по периметру и одинаковое скругление.

Size (default s на desktop, m на mobile)

Размер (Figma: Mobile Off → s, Mobile On → m). Как размер выбирается на mobile — раздел «Адаптивность».

  • s — Field Banner: иконка 16, текст body/s, кнопка действия и крестик 24, промежутки 4.
  • m — Field Banner Mobile: иконка 24, текст body/m, кнопка действия и крестик 32, промежутки 8.

Content

Текст основной строки. Длинный текст переносится на две строки, дальше обрезается многоточием.

Icon

Опциональный ReactNode слева от контента. Без icon иконка не рендерится.

import { AiFieldBanner } from '@cloud-ru/ds-ai-field-banner'
import { PlaceholderSVG } from '@cloud-ru/ds-icons'

<AiFieldBanner icon={<PlaceholderSVG />} content='…' />

Action

Текстовая кнопка справа рендерится через AlertButton из @cloud-ru/ds-alert и использует его state layer (:hover, :focus-visible, :active). Рендерится только при actionLabel. onActionClick — обработчик клика.

Close

Крестик справа от кнопки действия (AiButtonClose: s для размера s, m для m). Показывается, когда передан onClose; убрать баннер решает потребитель. Крестик не зависит от варианта и не заменяет кнопку действия.

Bottom content

bottomContent под основной строкой — произвольный контент. Слот скрыт, если не задан.

Установка

pnpm add @cloud-ru/ds-ai-field-banner
import { AiFieldBanner, SIZE, VARIANT } from '@cloud-ru/ds-ai-field-banner'

Примеры использования

Default

DefaultInformation с иконкой, описанием и действием
Description
tsx
import { AiFieldBanner, VARIANT } from '@cloud-ru/ds-ai-field-banner';
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';

export function Default() {
  return (
    <AiFieldBanner
      variant={VARIANT.Information}
      content='Description'
      actionLabel='Label text'
      icon={<PlaceholderSVG />}
      onActionClick={() => undefined}
    />
  );
}

Variants

VariantsВсе семантические варианты
Description
Description
Description
Description
Description
Description
tsx
import { AiFieldBanner, VARIANT_ORDER } from '@cloud-ru/ds-ai-field-banner';
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';

const variants = VARIANT_ORDER;

export function Variants() {
  return (
    <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 400 }}>
      {variants.map(variant => (
        <AiFieldBanner
          key={variant}
          variant={variant}
          content='Description'
          actionLabel='Label text'
          icon={<PlaceholderSVG />}
        />
      ))}
    </div>
  );
}

Закрытие

ЗакрытиеКрестик скрывает баннер, состояние хранит родитель
Баннер закрывается крестиком
tsx
import { AiFieldBanner, VARIANT } from '@cloud-ru/ds-ai-field-banner';
import { Button } from '@cloud-ru/ds-button';
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';
import { useState } from 'react';

export function Dismiss() {
  const [visible, setVisible] = useState(true);

  if (!visible) {
    return <Button label='Показать баннер' onClick={() => setVisible(true)} />;
  }

  return (
    <AiFieldBanner
      variant={VARIANT.Information}
      content='Баннер закрывается крестиком'
      icon={<PlaceholderSVG />}
      onClose={() => setVisible(false)}
    />
  );
}

Mobile

MobileРазмер `m` — Field Banner Mobile
Description
tsx
import { AiFieldBanner, SIZE, VARIANT } from '@cloud-ru/ds-ai-field-banner';
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';

export function Mobile() {
  return (
    <AiFieldBanner
      size={SIZE.M}
      variant={VARIANT.Agentic}
      content='Description'
      actionLabel='Label text'
      icon={<PlaceholderSVG />}
    />
  );
}

Bottom content

Bottom contentДополнительный контент под основной строкой
Description
Additional content
tsx
import { AiFieldBanner, VARIANT } from '@cloud-ru/ds-ai-field-banner';
import { PlaceholderSVG } from '@cloud-ru/ds-icons/interface/system';

export function WithBottomContent() {
  return (
    <AiFieldBanner
      variant={VARIANT.Information}
      content='Description'
      bottomContent='Additional content'
      actionLabel='Label text'
      icon={<PlaceholderSVG />}
      onActionClick={() => undefined}
    />
  );
}

Props

Types

PropsAiFieldBannerProps
PropTypeDefaultRequiredDescription
actionLabelstring—noПодпись кнопки действия справа. Кнопка не рендерится, если не задана.
bottomContentReactNode—noДополнительный слот под основной строкой. Не рендерится, если не задан.
classNamestring—noДоп. класс корня.
contentReactNode—noТекст или контент основной строки. Не рендерится, если не задан.
data-test-idstringai-field-bannerno
iconReactNode—noИконка слева от текста
layoutPresetsPartial<Record<LayoutType, Partial<AiFieldBannerLayoutDefaults>>>—noOverride mobile-дефолтов адаптива для этого инстанса (deep-merge поверх `AI_FIELD_BANNER_LAYOUT_PRESETS`). Escape-hatch: обычно не нужен — DS-пресет применяется автоматически по `AdaptiveProvider`.
onActionClick((event: MouseEvent<HTMLButtonElement, MouseEvent>) => void)—noОбработчик клика по кнопке действия.
onClose((event: MouseEvent<HTMLButtonElement, MouseEvent>) => void)—noНажатие на крестик. Крестик показывается, только если обработчик передан; убрать баннер решает потребитель.
size"m" | "s"—noРазмер на desktop: `s` — Field Banner, `m` — Field Banner Mobile. Высота по содержимому: при одной строке `s` 40, `m` 48. На mobile размер задаёт пресет `AI_FIELD_BANNER_LAYOUT_PRESETS` (`m`); изменить его — через `layoutPresets`.
variant"agentic" | "critical" | "help" | "information" | "security" | "warning"informationnoСемантический вариант баннера (ось `Variant` в Figma). По умолчанию `information`.

Unions

Types

AiFieldBannerProps

Unions

Адаптивность

Размер баннера зависит от раскладки AdaptiveProvider. Обычный проп size задаёт размер на desktop, а на mobile действует пресет AI_FIELD_BANNER_LAYOUT_PRESETS:

Раскладкаsize без пропаsize с пропом
desktops (Field Banner)значение пропа
mobilem (Field Banner Mobile)m

Чтобы изменить размер на mobile, передайте layoutPresets={{ mobile: { size: 's' } }}. Пресет нужен потому, что макет задаёт отдельный мобильный баннер.

Storybook

Figma