用途：<sgds-pagination> 用于为长列表或数据表格渲染分页导航控件，组件内部管理全部导航逻辑，开发者只需根据 dataLength、itemsPerPage 与 currentPage 三个属性驱动显示。
主要能力：dataLength 为记录总数（默认 0）；itemsPerPage 为每页条数（默认 5）；currentPage 为当前页，从 1 开始计数（默认 1）。variant 控制外观，可选 default（仅图标前后翻页，默认）、number（显示页码按钮）、button、description（仅显示上一页/下一页并带说明标签）；navigation 控制翻页控件样式，可选 button 或 icon-button（默认 icon-button）；size 可选 sm 或 md（默认 md）。当 dataLength 为 0 时不显示任何页。
使用方式：在页面中放置组件并设置三个数据属性，例如 <sgds-pagination id="my-pagination" dataLength="200" itemsPerPage="10" currentPage="1"></sgds-pagination>；再通过 document.getElementById("my-pagination").addEventListener("sgds-page-change", e => { const { currentPage } = e.detail; loadData(currentPage); }) 监听事件。用户点击页码或上一页/下一页时触发 sgds-page-change，事件 detail 为 { currentPage: number }，据此重新获取或过滤该页数据。安装与框架集成（React 19+ 与 React ≤18、Vue、Angular）参见 sgds-components-setup。
适用场景：需要分页浏览的列表、数据表格等长内容页面。
限制：组件不暴露自定义属性与 CSS part，无法修改其 CSS 样式；组件没有公开方法；currentPage 为 1 索引；本资料未提供价格、平台及其他未列出的功能信息。