苹果CMS V10分页标签配置与完整调用代码教程

一、分页标签使用基础规则

苹果CMS V10分页功能适用于分类页、内容筛选页、搜索结果页、专题首页、评论、留言本等动态列表页面。所有分页效果生效的核心前提：页面数据调用标签中必须开启 paging="yes" 参数，开启后系统才会自动统计数据总量、生成分页路由、渲染分页结构。

分页配置中 pageurl 为核心隐藏必填参数，用于绑定当前页面路由标识，适配网站伪静态规则。未配置该参数或参数匹配错误，会直接导致分页链接错乱、分页失效、页面404等问题。

二、各页面专属pageurl参数对照表

不同功能页面需对应配置专属pageurl参数，严格匹配页面模块属性，保障分页链接正常跳转，全站适配参数如下：

• 视频分类页：vod/type

• 视频筛选页：vod/show

• 视频搜索页：vod/search

• 网站首页列表：index/index

• 文章分类页：art/type

• 文章筛选页：art/show

• 文章搜索页：art/search

三、带分页的数据调用基础示例

以视频分类列表分页为例，结合分页开启参数与路由参数，完整数据调用标签如下，可根据需求修改num参数调整单页展示数量：

{maccms:vod num="10" paging="yes" pageurl="vod/type"} {/maccms:vod}

四、全站通用完整分页前端代码

以下为适配苹果CMS V10的完整版分页组件代码，包含数据统计、首页、上一页、页码遍历、下一页、尾页及手动页码跳转功能，兼容视频、文章、搜索、筛选等所有分页场景，直接放入模板对应位置即可生效：

<div class="mac_pages">
    <div class="page_tip">共{$__PAGING__.record_total}条数据,当前{$__PAGING__.page_current}/{$__PAGING__.page_total}页</div>
    <div class="page_info">
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=1}" title="首页">首页</a>
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$__PAGING__.page_prev}" title="上一页">上一页</a>
        {maccms:foreach name="$__PAGING__.page_num" id="num"}
        {if condition="$__PAGING__['page_current'] eq $num"}
        <a class="page_link page_current" href="javascript:;" title="第{$num}页">{$num}</a>
        {else}
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$num}" title="第{$num}页">{$num}</a>
        {/if}
        {/maccms:foreach}
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$__PAGING__.page_next}" title="下一页">下一页</a>
        <a class="page_link" href="{$__PAGING__.page_url|mac_url_page=$__PAGING__.page_total}" title="尾页">尾页</a>
        <input class="page_input" type="text" placeholder="页码" id="page" autocomplete="off" style="width:40px">
        <button class="page_btn mac_page_go" type="button" data-url="{$__PAGING__.page_url}" data-total="{$__PAGING__.page_total}" data-sp="{$__PAGING__.page_sp}">GO</button>
    </div>
</div>

五、分页使用注意事项

分页样式可通过自定义CSS修改 mac_pages、page_link、page_current 等class类名，适配模板整体风格。手动跳转功能依托系统原生JS事件实现，无需额外编写交互代码，保证模板原生兼容性。