List 列表
通用列表组件,对齐 Ant Design List。
示例
API
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| dataSource | 数据源 | ListItem[] | [] |
| header | 头部 | ReactNode | - |
| footer | 底部 | ReactNode | - |
| bordered | 是否有边框 | boolean | true |
| size | 尺寸 | 'sm' | 'md' | 'lg' | 'md' |
| loading | 加载中 | boolean | false |
| renderItem | 自定义渲染 | (item, index) => ReactNode | - |
| grid | 网格配置 | { cols?: number; gap?: number } | - |
可访问性
loading开启时,根节点会设置aria-busy="true",加载文案会以role="status"和aria-live="polite"暴露,便于辅助技术感知列表内容正在更新。- 加载中不会渲染
dataSource条目,避免用户在过期内容和加载状态之间产生混淆。 - 可通过
aria-label为外层列表容器提供页面内唯一名称,尤其适用于同页存在多个列表的场景。