List 设计文档
列表:数据驱动渲染(dataSource + renderItem)或声明式内嵌 <List.Item>,支持 header/footer(string 或 Snippet)、bordered 外框、split 分隔线、layout(vertical/horizontal)、grid 栅格(复用 Row/Col)、loading(复用 Spin)与空态(缺省 locale emptyText)。严格镜像 Semi List API。
← API 文档使用建议
列表:数据驱动渲染(dataSource + renderItem)或声明式内嵌 <List.Item>,支持 header/footer(string 或 Snippet)、bordered 外框、split 分隔线、layout(vertical/horizontal)、grid 栅格(复用 Row/Col)、loading(复用 Spin)与空态(缺省 locale emptyText)。严格镜像 Semi List API。
Accessibility
ARIA role:list
- ul/li 原生列表语义(cd-list-items > cd-list-item)
- loading 由 Spin 包裹提供 role=status(aria-live=polite)
- 空态文案缺省来自 locale List.emptyText
设计变量
| 变量 | 默认值 | 用法 |
|---|---|---|
--cd-color-list-default-border-default | var(--cd-color-border) | 列表描边颜色($color-list_default-border-default) |
--cd-color-list-empty-text-default | var(--cd-color-text-2) | 空状态下列表文字颜色($color-list_empty-text-default) |