组件 • 列表和列表项
列表和列表项
§List — 一个通用的列表组件,用作容器,其中数据行组织成单个垂直列。该组件会对其子列表项元素进行排序,支持多种尺寸,并启用键盘选择控制和过滤。
§List 结构

➊ 过滤区域
➋ 列表项
➌ 滚动条
➍ 鼠标悬停的列表项
§List-item 结构

➊ 排序图标
➋ 列表项图标
➌ 文本块
➍ 附加操作按钮(鼠标悬停时显示)
§尺寸

List-item
所有列表项(List-item)都支持 4 种尺寸的渲染:S、M、L、XL。这些尺寸和内边距与组件交互的库项(如 select、input 和 button)相对应,这些库项支持类似的尺寸变量。

List
默认情况下,List 组件的宽度是动态的,根据列表中最长项的宽度计算得出。宽度可以设置为固定值,或继承触发列表显示的对象的宽度(select、input)。
§状态

§内容 类型

§List-item 功能

多图标支持
List-item 元素可以在组件的左侧和右侧放置一个或多个图标。

更改排序顺序
对于列表中的项,您可以激活列表项排序。默认情况下,排序图标始终显示在列表的顶部。
§List 功能

列表主容器高度可自定义
列表项的高度或返回高度值的函数可以动态设置,或以像素(px)为单位指定精确值。如果列表项超出最大高度,则会出现滚动条。高度可以手动设置或动态调整。

单选和多选
该组件支持单选和多选。

过滤和搜索
可选地,该组件可以包含一个输入字段,用于快速过滤列表中的项。默认情况下,过滤器的占位符可以根据组件的任务进行更改。

触发器
默认情况下,列表组件由与页面其他元素(如 select、label 和 button)的交互触发,并作为 Input 组件的建议功能。

虚拟化
当启用虚拟化标志时,浏览器一次只渲染一部分行,从而显著减少重新渲染组件所需的时间。通过这种方法,也称为“无限加载”,当用户滚动到特定的阈值项(触发器)时,新项会被添加到列表中。