AiHistoryLine
Вертикальная лента шагов AI-диалога — запросы пользователя, ответы агента, вызовы инструментов, чекпоинты
Демо
- b12cb69Добавлены сценарии для существующего репозитория и первой настройки.+83/-26
Когда использовать
Вертикальная лента событий: запрос, ответ, группа вызовов, чекпоинт. Содержимое строки передаёт потребитель. Индикатор, степпер, запрос, аккордеон и чекпоинт можно поставить и отдельно от ленты. Карточка группы раскрывается сама. Уже показанную группу раскрывают снаружи через open и onOpenChange. Кольцо в ленте одно: его id задают value или defaultValue. Клик по индикатору с id переключает это кольцо. Запись адреса и прокрутку к строке делает потребитель в onIndicatorClick.
Анатомия
AiHistoryLine— список,ul.AiHistoryLine.Item— строка: степпер, индикатор и слот тела.AiHistoryLine.Indicator— колодец 24×24.background={false}убирает подложку у аватара. Кольцо задаётactive, своё состояние выбора компонент не хранит.AiHistoryLine.Stepper— верхний и нижний коннекторы вокруг индикатора. Высоту верхней линии задаётoffset.showLeadingConnector={false}скрывает линию и сохраняет место. Нижняя линия есть приshowClosingConnector. В ленте смещение считает строка: центр кружка совпадает с центром первой строки, у первой строки линия не видна.AiHistoryLine.AgentContent— обёртка ответа агента: отступ сверху и расстояние между соседними блоками.AiHistoryLine.Request,AiHistoryLine.Accordion,AiHistoryLine.Checkpoint— карточки. Аккордеон хранит раскрытие внутри себя, аopenиonOpenChangeпередают его наружу.
Установка
pnpm add @cloud-ru/ds-ai-history-line
import { AiHistoryLine } from '@cloud-ru/ds-ai-history-line'
Props
Types
Props
AiHistoryLineProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
as | ElementType | — | no | Полиморфный тег корня. По умолчанию `ul`. |
children | ReactNode | — | no | Элементы ленты. |
className | string | — | no | Дополнительный класс корня. |
data-test-id | string | — | no | |
defaultValue | string | — | no | `id` индикатора, выбранного при первом рендере. |
innerRef | any | — | no | Ref на корневой элемент. |
onIndicatorChange | ((value: string) => void) | — | no | Сообщает `id` выбранного индикатора. Повторный клик по нему передаёт `undefined`. |
value | string | — | no | `id` выбранного индикатора. Вместе с `onIndicatorChange` выбор управляемый. |