# UGList 列表

> 适配器：Vue；状态：available；slug：`list`。

为文件、成员、通知和对象摘要提供稳定的媒体、内容与操作列布局。

## 适用场景

- 以稳定的媒体、主内容和操作列展示文件、成员、通知或对象摘要。

## 不适用场景

- 二维对比数据使用 Table；菜单导航使用 Menu 或 NavigationMenu。

## 公开入口

- 包入口：`@ug666/ui-vue/components`
- 公开成员：`UGList`、`UGListItem`、`UGListItemContent`、`UGListItemTitle`、`UGListItemDescription`、`UGListItemActions`
- 交互文档：[https://ui.ug666.top/vue/components/list](https://ui.ug666.top/vue/components/list)

```vue
import { UGList, UGListItem, UGListItemContent, UGListItemTitle, UGListItemDescription, UGListItemActions } from '@ug666/ui-vue/components'
```

## 使用规则

- UGListItem 只提供行布局；点击、链接和按钮语义由行内真实交互元素承担。
- 双向值优先使用组件声明的 v-model 参数。
- 事件、插槽和 expose 以 Vue 类型为准，不照搬 React 回调名。
- 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。

## 相关候选

- [table](https://ui.ug666.top/ai/vue/components/table.md)
- [card](https://ui.ug666.top/ai/vue/components/card.md)
- [avatar](https://ui.ug666.top/ai/vue/components/avatar.md)

## 生成前检查

- 当前适配器是否真实提供该组件。
- 导入路径、组件名和 API 是否存在于当前版本类型声明。
- 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。