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)