作为一名资深安企CMS网站运营人员，我深知内容呈现的细节对于用户体验和网站SEO至关重要。分页导航便是其中一个基础而关键的组成部分，它不仅帮助用户高效地浏览大量内容，也让搜索引擎能够更好地抓取和索引网站信息。今天，我将详细阐述如何在安企CMS的列表页，如文章列表、搜索结果页等，实现和优雅地显示分页导航。
安企CMS中的分页机制概览
在安企CMS中，实现分页功能是直观且高效的。系统内置的模板标签提供了强大的灵活性，让我们可以轻松地对不同类型的内容列表进行分页处理。无论是文章、产品、标签下的文档，甚至是评论列表，安企CMS都通过统一的type="page"参数配合limit属性，来指示列表标签生成可分页的数据集。当列表标签被配置为type="page"时，它会将数据进行划分，并将分页所需的所有元数据（如总页数、当前页码、前后页链接等）传递给专门的分页导航标签进行渲染。这种设计将数据获取与分页显示逻辑解耦，使得模板代码更为清晰和易于维护。
核心：分页导航标签 (pagination) 的使用
实现分页导航的核心在于安企CMS提供的pagination标签。这个标签专门用于接收经过分页处理的数据集，并将其渲染成用户友好的分页链接组。
这个标签的使用语法如下：{% pagination pages with show="5" %}。
其中，pages是我们定义的一个变量名，它会承载所有分页相关的数据。show参数是可选的，它决定了在分页导航中最多显示多少个页码按钮，例如show="5"会显示当前页码周围的5个页码。另一个高级参数prefix允许重定义页码的URL模式，但通常情况下，安企CMS的伪静态规则已能良好处理，无需手动设置。
pages变量中包含了丰富的属性，供我们在模板中调用，以构建完整的分页导航：
TotalItems：总的文章或记录数量。TotalPages：总的页码数量。CurrentPage：当前访问的页码。FirstPage：指向首页的对象，包含Name（如“首页”）和Link（首页URL）。LastPage：指向末页的对象，包含Name（如“尾页”）和Link（末页URL）。PrevPage：指向上一个页面的对象，包含Name（如“上一页”）和Link（上一页URL），如果当前是第一页则为空。NextPage：指向下一个页面的对象，包含Name（如“下一页”）和Link（下一页URL），如果当前是最后一页则为空。Pages：一个数组，包含了中间部分的页码对象，每个对象同样包含Name（页码数字）、Link（页码URL）和IsCurrent（是否为当前页）等属性。
下面是一个标准的pagination标签渲染代码示例，它构建了一个包含首页、上一页、中间页码、下一页和尾页的完整分页导航：
<div class="pagination-container">
{% pagination pages with show="5" %}
<ul class="pagination">
{# 显示总信息，例如总条数、总页码数、当前页码 #}
<li>总计：{{pages.TotalItems}}条，共：{{pages.TotalPages}}页，当前第{{pages.CurrentPage}}页</li>
{# 首页链接 #}
<li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}">
<a href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a>
</li>
{# 上一页链接，仅当前不是第一页时显示 #}
{% if pages.PrevPage %}
<li class="page-item">
<a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a>
</li>
{% endif %}
{# 中间页码循环显示 #}
{% for item in pages.Pages %}
<li class="page-item {% if item.IsCurrent %}active{% endif %}">
<a href="{{item.Link}}">{{item.Name}}</a>
</li>
{% endfor %}
{# 下一页链接，仅当前不是最后一页时显示 #}
{% if pages.NextPage %}
<li class="page-item">
<a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a>
</li>
{% endif %}
{# 尾页链接 #}
<li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}">
<a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a>
</li>
</ul>
{% endpagination %}
</div>
通过上述代码结构，我们可以根据网站的CSS样式灵活美化分页导航，提供直观的用户交互。
在不同列表页面的分页实践
分页导航的实现是与内容列表紧密结合的。以下我们将结合具体场景，演示如何将内容列表标签与pagination标签配合使用。这些代码通常会放置在安企CMS模板目录中对应的列表模板文件里，例如分类列表页会在{模型table}/list.html，搜索页在search/index.html，标签列表页在tag/list.html或tag/index.html。
文章列表页的分页
在一个典型的文章分类列表页，我们需要展示该分类下的文章，并提供分页浏览。这通常通过archiveList标签实现。
{# 在 {模型table}/list.html 模板文件中 #}
<div class="article-list-container">
{% archiveList archives with type="page" limit="10" %} {# type="page" 启用分页，limit="10" 每页显示10篇文章 #}
{% for item in archives %}
<article class="article-item">
<h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
<p>{{item.Description}}</p>
<div class="meta">
<span>发布时间: {{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>浏览量: {{item.Views}}</span>
</div>
</article>
{% empty %}
<p>当前分类下暂无文章。</p>
{% endfor %}
{% endarchiveList %}
</div>
{# 紧随其后放置分页导航 #}
<div class="pagination-area">
{% pagination pages with show="5" %}
{# 这里放置上面提供的标准分页导航代码 #}
<ul class="pagination">
{# ... (分页链接代码) ... #}
</ul>
{% endpagination %}
</div>
搜索结果页的分页
搜索结果页是另一个常见的需要分页的场景。用户输入关键词进行搜索后，结果通常会很长，需要分页显示。安企CMS的archiveList标签支持通过q参数接收搜索关键词。如果URL中已包含q=关键词的查询参数，archiveList在type="page"模式下会自动读取并应用。
首先，我们通常会有一个搜索表单：
{# 搜索表单，通常放置在公共头部或侧边栏 #}
<form method="get" action="/search"> {# 假设搜索结果页的URL是 /search #}
<input type="text" name="q" placeholder="请输入关键词" value="{{urlParams.q}}">
<button type="submit">搜索</button>
</form>
然后，在search/index.html等搜索结果模板文件中，我们这样实现分页列表：
{# 在 search/index.html 模板文件中 #}
<div class="search-results-container">
<h2>搜索结果：{{urlParams.q}}</h2>
{% archiveList archives with type="page" limit="10" %} {# q参数会自动从URL中获取 #}
{% for item in archives %}
<article class="search-result-item">
<h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
<p>{{item.Description}}</p>
<div class="meta">
<span>发布时间: {{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
</div>
</article>
{% empty %}
<p>抱歉，没有找到与“{{urlParams.q}}”相关的结果。</p>
{% endfor %}
{% endarchiveList %}
</div>
{# 紧随其后放置分页导航 #}
<div class="pagination-area">
{% pagination pages with show="5" %}
{# 这里放置上面提供的标准分页导航代码 #}
<ul class="pagination">
{# ... (分页链接代码) ... #}
</ul>
{% endpagination %}
</div>
Tag 文档列表页的分页
当用户点击一个标签（Tag）时，会跳转到该标签下的文档列表页面。这个页面也需要分页功能来展示所有相关的文章。这可以通过tagDataList标签来实现。
{# 在 tag/list.html 或 tag/index.html 模板文件中 #}
<div class="tag-documents-container">
<h2>标签 “{% tagDetail with name="Title" %}” 下的文档</h2>
{% tagDataList archives with type="page" limit="10" %} {# tagId 会自动从URL中获取 #}
{% for item in archives %}
<article class="tag-document-item">
<h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
<p>{{item.Description}}</p>
<div class="meta">
<span>发布时间: {{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>浏览量: {{item.Views}}</span>
</div>
</article>
{% empty %}
<p>当前标签下暂无相关文档。</p>
{% endfor %}
{% endtagDataList %}
</div>
{# 紧随其后放置分页导航 #}
<div class="pagination-area">
{% pagination pages with show="5" %}
{# 这里放置上面提供的标准分页导航代码 #}
<ul class="pagination">
{# ... (分页链接代码) ... #}
</ul>
{% endpagination %}
</div>
通过以上示例，我们可以看到，安企CMS在内容列表的分页处理上保持了一致性和高度的可复用性。只需在内容列表标签中使用type="page"参数，并随后引入pagination标签，即可在各种列表页面上轻松实现功能完善的分页导航。这种模块化的设计，极大地简化了模板开发和内容管理的工作流程。
常见问题 (FAQ)
为什么我的分页导航没有显示，或者显示不正确？
首先，请确保您的内容列表标签（如archiveList、tagDataList等）中正确设置了type="page"参数。这是启用分页功能的关键。如果缺少此参数，列表标签将不会生成分页所需的数据。其次，检查limit参数是否设置得当，它定义了每页显示多少条记录。如果记录总数未超过limit值，分页导航自然不会出现。最后，核对pagination标签中的变量名（例如pages）是否与列表标签内部生成的分页数据变量名一致。如果您在模板中使用了自定义样式，也请检查相关CSS是否正确应用。
我能否自定义分页导航的样式和结构？
当然可以。安企CMS提供的pagination标签只负责提供分页所需的数据和链接，具体的HTML结构和CSS样式完全由模板开发者控制。您可以在{% pagination pages with show="5" %}和{% endpagination %}之间自由编写HTML代码，并结合pages变量的各个属性（如pages.CurrentPage、item.Link、item.IsCurrent等）来构建出符合您网站设计风格的分页导航。通过添加自定义的CSS类，您可以实现从简单的数字分页到包含“第一页”、“最后一页”等复杂导航的各种样式。
如果我希望在URL中移除页码，或者使用不同的页码命名方式，应该如何操作？
安企CMS默认的伪静态规则已经对页码进行了优化，通常会生成如/list-1.html、/list-2.html这样的SEO友好型URL。如果您有更高级的URL定制需求，例如不显示第一页的页码，或者使用?p=2而不是/page/2，这通常需要在安企CMS后台的功能管理->伪静态规则中进行配置。伪静态规则支持通过变量组合来定义URL结构，例如分页页码可以通过(-{page})的形式在伪静态规则中配置。请务必谨慎修改伪静态规则，错误的配置可能导致页面无法访问。