分页标签

列表页使用

在CMS的文章列表页、自定义表单列表页、TAG标签列表页，我们可以直接使用{cms:pageinfo /}分页标签用于显示分页信息。

{cms:pagelist id="item"}
    //可调用主表字段和副表字段
    //{$item.字段名|htmlentities}
{/cms:pagelist}

//pageinfo标签必需配合pagelist标签使用，不支持单独使用
{cms:pageinfo /}

如果不使用CMS默认模板的分页，可以在{/cms:pagelist}标签后使用

{:$__LIST__->render()}

进行渲染输出HTML，此时将直接输出分页的HTML。
如果需要修改分页渲染输出的HTML，可以自行二次开发addons/cms/library/Bootstrap.php。

非列表页使用

如果我们在自定义页面中需要显示分页信息时，在以下几个标签都可以进行分页，如下：

//文章列表页
{cms:arclist id="item" row="8" orderby="id" orderway="desc" condition="`views` > 0" paginate="true"}
    {$item.title|htmlentities}
{/cms:arclist}
{:$__LIST__->render()}

//栏目列表页
{cms:channellist id="channel" paginate="true"}
    {$channel.name|htmlentities}
{/cms:channellist}
{:$__LIST__->render()}

//单页列表
{cms:spagelist id="item" paginate="true"}
    {$item.title|htmlentities}
{/cms:spagelist}
{:$__LIST__->render()}

//用户列表
{cms:userlist id="item" paginate="true"}
    {$item.nickname|htmlentities}
{/cms:userlist}
{:$__LIST__->render()}

//区块列表
{cms:blocklist id="item" paginate="true"}
    {$item.title|htmlentities}
{/cms:blocklist}
{:$__LIST__->render()}

//专题列表
{cms:speciallist id="item" paginate="true"}
    {$item.title|htmlentities}
{/cms:speciallist}
{:$__LIST__->render()}

我们可以看到在标签的最后一行，都有一个{:$__LIST__->render()}用于显示分页信息，其次需要注意的是我们的标签属性中都有一个paginate="true"用于控制启用分页功能。我们还可以使用paginate="20"来控制分页大小。

其它属性

paginate支持多个自定义属性配置，如下：

paginate="true"
paginate="20" //分页大小为20
paginate="20,true" //启用简单分页，并设定分页大小为20
paginate="20,true,mypage" //启用简单分页，并设定分页大小为20，并且自定义分页名称为mypage
paginate="20,true,mypage,/customurl/query" //自定义分页名称mypage和自定义URL

自定义分页HTML

如果需要修改分页渲染输出的HTML，可以自行二次开发addons/cms/library/Bootstrap.php。