OverflowList 设计文档
溢出折叠列表,严格镜像 Semi OverflowList。行为组件:展示列表并自适应展示尽可能多的项目,因过长而溢出的项折叠为一个元素,容器 resize 时重新计算可见项。renderMode="collapse"(默认)用 ResizeObserver 累加各项宽度找折叠点,溢出项收纳进 overflowRenderer 返回的节点,collapseFrom 决定从尾(end)/头(start)折叠,minVisibleItems 保底可见数;renderMode="scroll" 不折叠,可见层为可横向滚动容器,用 IntersectionObserver 观测各项,threshold 控制阈值,onIntersect/onVisibleStateChange 上报可见状态。渲染函数以 Svelte Snippet 形式提供(visibleItemRenderer/overflowRenderer)。
← API 文档使用建议
溢出折叠列表,严格镜像 Semi OverflowList。行为组件:展示列表并自适应展示尽可能多的项目,因过长而溢出的项折叠为一个元素,容器 resize 时重新计算可见项。renderMode="collapse"(默认)用 ResizeObserver 累加各项宽度找折叠点,溢出项收纳进 overflowRenderer 返回的节点,collapseFrom 决定从尾(end)/头(start)折叠,minVisibleItems 保底可见数;renderMode="scroll" 不折叠,可见层为可横向滚动容器,用 IntersectionObserver 观测各项,threshold 控制阈值,onIntersect/onVisibleStateChange 上报可见状态。渲染函数以 Svelte Snippet 形式提供(visibleItemRenderer/overflowRenderer)。
Accessibility
- 行为组件,不注入语义角色(对齐 Semi);DOM 结构 cd-overflow-list > cd-overflow-list-item / cd-overflow-list-overflow / cd-overflow-list-scroll-wrapper;可见/溢出/焦点语义由 visibleItemRenderer/overflowRenderer 提供的宿主内容决定。
设计变量
该组件暂无专属设计变量。