AiSuggestionPanel
Полоса коротких вопросов к ассистенту: пользователь задаёт вопрос одним нажатием, компонент сообщает, какой вопрос нажат. Полоса второстепенна на странице — цветной в ней только логотип Giga.
Когда использовать
- Рядом с контекстом, по которому ассистент может ответить: алерт, ресурс, страница сервиса.
- Когда вопросы известны заранее и их немного — до нескольких штук в одну строку.
Когда не нужен:
- Вопрос нужно ввести свободным текстом:
- используйте поле запроса
@cloud-ru/ds-ai-field-request.
- используйте поле запроса
- Подсказка одна и стоит отдельно от полосы:
- используйте
AiSuggestionSimpleиз@cloud-ru/ds-ai-suggestion.
- используйте
Компонент не решает, когда показываться и скрываться, не отправляет вопрос ассистенту и не включает загрузку сам — это делает потребитель.
Анатомия
Слева направо:
- Кнопка Giga — открывает тултип со ссылкой на документацию ассистента, сообщает о нажатии через
onLogoClick. - Вопросы — по одному сегменту на элемент
items, между сегментами разделители. - «+N» — появляется, когда вопросы не помещаются по ширине: открывает список скрытых вопросов.
- Кнопка закрытия — справа от рамки. Показывается, если передан
onClose.
Size (default s)
s— высота 32.m— высота 40.
Размеры
import { AiSuggestionPanel, SIZE } from '@cloud-ru/ds-ai-suggestion-panel';
const ITEMS = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
];
export function Sizes() {
return (
<div style={{ display: 'flex', flexDirection: 'column', gap: 12, alignItems: 'flex-start' }}>
<AiSuggestionPanel items={ITEMS} size={SIZE.S} />
<AiSuggestionPanel items={ITEMS} size={SIZE.M} />
</div>
);
}Состояния вопроса
disabled— подпись блёклая, нажатие не обрабатывается.loading— после подписи индикатор загрузки, повторное нажатие не обрабатывается.
Hover, pressed и focus реализованы через CSS (:hover, :active, :focus-visible). Кнопка закрытия на устройствах с курсором появляется при наведении на полосу или фокусе внутри неё, на сенсорных устройствах видна всегда.
Перенос в «+N»
Подпись вопроса занимает одну строку и не обрезается. Полоса не переносит сегменты и не прокручивает их: те, что не помещаются в ширину контейнера, уходят в список «+N». Хотя бы один вопрос остаётся в полосе всегда.
Установка
pnpm add @cloud-ru/ds-ai-suggestion-panel
import { AiSuggestionPanel, SIZE } from '@cloud-ru/ds-ai-suggestion-panel';
Примеры использования
Базовый
Нажмите на вопрос
import { AiSuggestionPanel } from '@cloud-ru/ds-ai-suggestion-panel';
import { Typography } from '@cloud-ru/ds-typography';
import { useState } from 'react';
const ITEMS = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-monitoring', label: 'Как настроить мониторинг всех ВМ?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
{ value: 'alert-vm-off', label: 'Как создать алерт, если ВМ выключена?' },
{ value: 'vm-metrics', label: 'Какие проблемы видны по метрикам ВМ?' },
];
export function Basic() {
const [selected, setSelected] = useState<string>();
const selectedLabel = ITEMS.find(item => item.value === selected)?.label;
return (
<div style={{ display: 'flex', flexDirection: 'column', gap: 12, alignItems: 'flex-start' }}>
<AiSuggestionPanel items={ITEMS} onItemClick={setSelected} />
<Typography variant='body' size='s'>
{selectedLabel ? `Выбран вопрос: ${selectedLabel}` : 'Нажмите на вопрос'}
</Typography>
</div>
);
}Загрузка ответа
import { AiSuggestionPanel, AiSuggestionPanelItem } from '@cloud-ru/ds-ai-suggestion-panel';
import { useEffect, useState } from 'react';
const QUESTIONS: AiSuggestionPanelItem[] = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-monitoring', label: 'Как настроить мониторинг всех ВМ?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
];
/** Время «ответа ассистента» в демо. */
const ANSWER_DELAY_MS = 2000;
export function LoadingFlow() {
const [pendingValue, setPendingValue] = useState<string>();
useEffect(() => {
if (!pendingValue) return;
const timer = setTimeout(() => setPendingValue(undefined), ANSWER_DELAY_MS);
return () => clearTimeout(timer);
}, [pendingValue]);
const items = QUESTIONS.map(question => ({ ...question, loading: question.value === pendingValue }));
return <AiSuggestionPanel items={items} onItemClick={setPendingValue} />;
}Кнопка закрытия
import { AiSuggestionPanel } from '@cloud-ru/ds-ai-suggestion-panel';
import { Button } from '@cloud-ru/ds-button';
import { useState } from 'react';
const ITEMS = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
];
export function WithClose() {
const [visible, setVisible] = useState(true);
if (!visible) {
return <Button label='Показать подсказки' view='outline' appearance='neutral' onClick={() => setVisible(true)} />;
}
return <AiSuggestionPanel items={ITEMS} onClose={() => setVisible(false)} />;
}Props
Types
AiSuggestionPanelProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
className | string | — | no | CSS-класс корня. |
data-test-id | string | — | no | |
docsUrl | string | https://cloud.ru/docs/ai_assistant_cloudia/ug/index | no | Ссылка «Документация» в тултипе кнопки Giga. |
innerRef | Ref<HTMLDivElement> | — | no | Ссылка на корневой элемент. |
items | AiSuggestionPanelItem[] | — | yes | Вопросы полосы. Те, что не помещаются по ширине, компонент переносит в сегмент «+N» со списком. |
layoutPresets | Partial<Record<LayoutType, Partial<AiSuggestionPanelLayoutDefaults>>> | — | no | Переопределение пресетов раскладки (`mobile`, `desktop`, …) для `size`. |
onClose | (() => void) | — | no | Нажатие на кнопку закрытия. Без колбэка кнопка не показывается. Полосу компонент не скрывает. |
onItemClick | ((value: string) => void) | — | no | Нажатие на вопрос — в полосе или в списке «+N». |
onLogoClick | (() => void) | — | no | Нажатие на кнопку Giga. |
size | "m" | "s" | — | no | Размер полосы: `s` — высота 32, `m` — высота 40. По умолчанию `s`, на mobile-раскладке — `m`. Явное значение задаёт desktop; mobile переопределяется через `layoutPresets.mobile`. |
Unions
Types
AiSuggestionPanelProps
AiSuggestionPanelItem
AiSuggestionPanelLayoutDefaults
Unions
Size
Related props
LayoutPresets
Адаптивность
AiSuggestionPanel — адаптивный компонент класса preset-defaults: DOM один, по раскладке меняются только дефолты пропсов. Раскладку компонент читает из контекста @cloud-ru/ds-adaptive — отдельного пропа layoutType нет.
На mobile полоса размера m и повторяет макет мобильной раскладки: высота 40, подпись 14/20, кнопка Giga 40, кнопка закрытия 32.
| Проп | desktop | mobile |
|---|---|---|
size | s | m |
Источник mobile-дефолтов — экспортируемая константа AI_SUGGESTION_PANEL_LAYOUT_PRESETS.
Как переопределить
Приоритет (от высшего к низшему): layoutPresets[layout] (инстанс) → DS-пресет AI_SUGGESTION_PANEL_LAYOUT_PRESETS → явный проп (= desktop-значение) → базовый дефолт.
import { AiSuggestionPanel } from '@cloud-ru/ds-ai-suggestion-panel'
// Явный проп задаёт desktop-значение, на mobile полоса остаётся размера m
<AiSuggestionPanel items={items} size='m' />
// Оставить размер s на mobile
<AiSuggestionPanel items={items} layoutPresets={{ mobile: { size: 's' } }} />
Storybook
Figma
Смотри также
@cloud-ru/ds-ai-suggestion— отдельная подсказка-чип и раскрывающаяся группа.@cloud-ru/ds-ai-button-giga— кнопка Giga, из которой собрана ячейка логотипа.