分页标签用于在列表页生成分页导航组件，常与 {soeay:pagelist} 配合使用。

分页条

在模板中单独输出分页控件与页码信息：

{soeay:page}

当总条数不超过每页数量时，{soeay:page} 自动不输出，无需额外判断。

分页列表

{soeay:pagelist} 遍历当前页内容，由控制器按栏目注入分页数据：

{soeay:pagelist num=10}
    <a href="[soeay:link]">[soeay:title]</a>
{/soeay:pagelist}

分页列表排序

{soeay:pagelist} 默认按栏目规则输出当前页（置顶在前，sorting 排序号从小到大，同值按 ID 倒序），也支持与 {soeay:list} 相同的 order、dir 参数对当前页内容重新排序：

{soeay:pagelist num=10 order=date}       当前页按发布时间从新到旧
{soeay:pagelist num=10 order=sorting}    当前页按排序号从小到大

order 可选 id/date/visits/sorting/istop/isrecommend，各字段含义与省略 dir 时的默认方向同「内容列表标签」；其中 date 指后台「内容编辑 → 高级选项 → 发布时间」中可手动修改的发布时间。置顶内容始终排在最前，排序值相同时按 ID 倒序。

注意：order/dir 的重新排序只对当前页数据生效；数据超过一页时，跨页先后仍以控制器的栏目默认排序取数。需要列表始终严格按发布时间排列时，应在栏目/控制器层面配置列表默认排序。

面包屑

面包屑展示"首页 » 栏目 » 正文"的层级路径，详情页与列表页通用：

{soeay:position}

支持参数：separator（分隔符，默认 »）、indextext（首页文字，默认"首页"）。

使用场景

分页标签通常成对出现在列表页模板中：

• {soeay:pagelist}：遍历当前页的内容列表，与 {soeay:list} 类似，但数据由控制器按分页注入。
• {soeay:page}：输出页码导航组件。
• {soeay:position}：输出面包屑路径。

分页样式自定义

{soeay:page} 默认输出包含 soeay-pagination 类名的 HTML 结构：

<div class="soeay-pagination">
    <ul class="pagination-list">...</ul>
    <div class="pagination-info">共 N 条，第 X / Y 页</div>
</div>

您可以在 CSS 中通过上述类名自定义分页样式。

注意事项

• 当总记录数不超过每页数量时，{soeay:page} 会自动不输出，无需额外判断。
• {soeay:page} 的分页链接基于当前 URL 拼接 ?page=N，因此伪静态规则需正确配置。
• 面包屑 {soeay:position} 支持 separator、indextext、separatoricon、indexicon 参数，可自定义分隔符和首页文案。