Skip to content

List 列表

通用列表组件,对齐 Ant Design List。

示例

API

属性说明类型默认值
dataSource数据源ListItem[][]
header头部ReactNode-
footer底部ReactNode-
bordered是否有边框booleantrue
size尺寸'sm' | 'md' | 'lg''md'
loading加载中booleanfalse
renderItem自定义渲染(item, index) => ReactNode-
grid网格配置{ cols?: number; gap?: number }-

可访问性

  • loading 开启时,根节点会设置 aria-busy="true",加载文案会以 role="status"aria-live="polite" 暴露,便于辅助技术感知列表内容正在更新。
  • 加载中不会渲染 dataSource 条目,避免用户在过期内容和加载状态之间产生混淆。
  • 可通过 aria-label 为外层列表容器提供页面内唯一名称,尤其适用于同页存在多个列表的场景。