spz-pagination 分页#

#何时使用

• 当加载/渲染所有数据将花费很多时间时；
• 可切换页码浏览数据。

#代码演示

#基本用法

分页组件必须结合 spz-list 组件一起使用才生效。它可以自定义上一页下一页的图标，将图标放在分页组件内部且带有 role="arrow" 属性。

<spz-list id="collection-list" manual ...><!-- ... --></spz-list>

<spz-pagination layout="container" list-id="collection-list">
  <svg role="arrow" ...><!-- ... --></svg>
</spz-pagination>

#属性

#AI 摘要（LLM Ready）

• 组件标识：spz-pagination
• 用途一句话：采用分页的形式分隔长列表，每次只加载一个页面。
• 可识别属性条目：3
• 可识别方法小节：0
• 可识别事件小节：0
• 关键属性名（Top）：list-id、num-display-active、show-single-page
• 关键方法名（Top）：无（待补充）
• 关键事件名（Top）：无（待补充）
• 阅读顺序建议：先看「何时使用」与「代码演示」，再核对属性/方法/事件。
• 关联文档：/guide/actions-and-events/ 、/guide/layouts/