# @cloud-ru/ds-ai-attachment > Плитка вложения 88×88 для AI-компонентов — картинка с превью или файл с именем, загрузка и ошибка. Docs: /snack-v2/components/ai-attachment/ ## Установка ```sh pnpm add @cloud-ru/ds-ai-attachment ``` ## Когда использовать - Ряд вложений в поле ввода сообщения (`@cloud-ru/ds-ai-field-input`). - Вложения в сообщениях ленты и других местах, где нужен единый вид файла. ### Когда не нужен - Карточка файла с названием, описанием и скачиванием: - используйте `@cloud-ru/ds-attachment`. ## API ### AiAttachment | 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`. | #### Related types - `AttachmentState` = `default | error | loading` - `AttachmentType` = `file | image` ## Примеры ### Clickable ```tsx import { AiAttachment, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment'; import { useState } from 'react'; export function Clickable() { const [opened, setOpened] = useState(0); return (
setOpened(prev => prev + 1)} /> Открыто: {opened}
); } ``` ### RemoveAndRetry ```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 (
{files.map(file => ( setFiles(prev => prev.filter(name => name !== file))} onRetry={() => setFailed('')} /> ))}
); } ``` ### States ```tsx import { AiAttachment, ATTACHMENT_STATE, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment'; export function States() { return (
); } ```