AiAttachment
AiAttachment — плитка одного вложения фиксированного размера 88×88. Показывает картинку с превью или файл с именем и сообщает о трёх событиях отдельно: нажатие крестика (onRemove), повтора загрузки (onRetry) и самой плитки (onClick). Лимиты количества и размера файлов плитка не хранит: превышение потребитель показывает состоянием error.
Когда использовать
- Ряд вложений в поле ввода сообщения (
@cloud-ru/ds-ai-field-input). - Вложения в сообщениях ленты и других местах, где нужен единый вид файла.
Когда не нужен
- Карточка файла с названием, описанием и скачиванием:
- используйте
@cloud-ru/ds-attachment.
- используйте
Анатомия
Плитка состоит из контейнера, крестика в правом верхнем углу и, по состоянию, индикатора загрузки или кнопки повтора в центре.
Type (default image)
image— превью картинки заливкой контейнера, без имени.file— иконка типа (icon, по умолчанию файл) и имя, обрезанное посередине.
State (default default)
default— непрозрачный контейнер.loading— полупрозрачный контейнер и индикатор загрузки.error— красная обводка и кнопка повтора; у файла имя окрашено красным.
Раскладка
Плитка закреплена на платформе webDesktop на обеих раскладках: размер 88×88 не меняется.
- Desktop — крестик
xsпоявляется сразу при наведении или фокусе, подсказка (tooltip) — через 300 мс после наведения. - Mobile — крестик
sвиден всегда, подсказки нет.
Установка
pnpm add @cloud-ru/ds-ai-attachment
import { AiAttachment } from '@cloud-ru/ds-ai-attachment'
Примеры использования
Состояния
quarterly-report-final.pdfquarterly-report-final.pdf
budget.xlsxbudget.xlsx
notes.txtnotes.txt
tsx
import { AiAttachment, ATTACHMENT_STATE, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment';
export function States() {
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<AiAttachment type={ATTACHMENT_TYPE.File} fileName='quarterly-report-final.pdf' tooltip='PDF, 2 МБ' />
<AiAttachment type={ATTACHMENT_TYPE.File} state={ATTACHMENT_STATE.Loading} fileName='budget.xlsx' />
<AiAttachment
type={ATTACHMENT_TYPE.File}
state={ATTACHMENT_STATE.Error}
fileName='notes.txt'
tooltip='Файл больше 20 МБ'
/>
</div>
);
}Удаление и повтор
report.pdfreport.pdf
budget.xlsxbudget.xlsx
notes.txtnotes.txt
tsx
import { AiAttachment, ATTACHMENT_STATE, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment';
import { useState } from 'react';
export function RemoveAndRetry() {
const [files, setFiles] = useState(['report.pdf', 'budget.xlsx', 'notes.txt']);
const [failed, setFailed] = useState('budget.xlsx');
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
{files.map(file => (
<AiAttachment
key={file}
type={ATTACHMENT_TYPE.File}
state={file === failed ? ATTACHMENT_STATE.Error : ATTACHMENT_STATE.Default}
fileName={file}
tooltip={file === failed ? 'Не удалось загрузить' : file}
onRemove={() => setFiles(prev => prev.filter(name => name !== file))}
onRetry={() => setFailed('')}
/>
))}
</div>
);
}Нажатие на плитку
contract.docxcontract.docx
tsx
import { AiAttachment, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment';
import { useState } from 'react';
export function Clickable() {
const [opened, setOpened] = useState(0);
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<AiAttachment type={ATTACHMENT_TYPE.File} fileName='contract.docx' onClick={() => setOpened(prev => prev + 1)} />
<span>Открыто: {opened}</span>
</div>
);
}Props
Types
Props
AiAttachmentProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
className | string | — | no | Доп. класс корня. |
data-test-id | string | ai-attachment | no | |
fileName | string | — | no | Имя файла — для `type='file'`. |
icon | ReactNode | — | no | Иконка типа файла. Подставляется снаружи (AT-7.3). |
onClick | (() => void) | — | no | Нажатие на плитку. |
onRemove | (() => void) | — | no | Нажатие на крестик. |
onRetry | (() => void) | — | no | Нажатие на кнопку повтора в состоянии `error`. |
src | string | — | no | Адрес превью картинки. |
state | "default" | "error" | "loading" | default | no | Состояние плитки. По умолчанию `default`. |
tooltip | ReactNode | — | no | Подсказка при наведении (только desktop). |
type | "file" | "image" | image | no | Тип плитки: картинка с превью или файл с именем. По умолчанию `image`. |