首页 / 建站手册 / 翻页、共几条

翻页、共几条

翻页控件,以及「共 N 条」「没有结果」这类统计值 —— 少了它第二页永远进不去。

适用范围:列表页、搜索结果页、列表。

{naicha:page} 分页条

<!-- [列表] 分页条。紧跟在列表标签后面即可,它会复用那次列表的总数 -->
{naicha:list cid="{naicha:param name='cid'}" num="10" page="{naicha:param name='page'}"}
  <a href="{list.url}">{list.title}</a>
{/naicha:list}
{naicha:page}

<!-- [列表] 明确给数字,页码参数换成 pg(用户列表用的是 pg)-->
{naicha:page total="{total}" num="20" page="{page}" param="pg"}
total总条数。不传就复用最近一次 {naicha:list} / {naicha:shop} 的统计
num每页条数,要和列表标签写的一致
page当前页码
param页码参数名(默认 page,用户列表用的是 pg)

只有一页时它输出空串,所以外面不用判断。 链接会保留当前地址上的其它查询参数(筛选、搜索词),所以翻页不会把筛选条件丢掉。

列表统计变量

{listTotal}最近一次 {naicha:list} 的总条数(不是本页条数)
{listPages}总页数
{listItems}本次实际取到几条
{shopTotal} {shopItems}最近一次 {naicha:shop} 的同名统计

空状态要写一句人话

{naicha:if var="listTotal" eq="0"}
  <div class="empty">
    <p>这个栏目还没有内容。
      {naicha:if var="keyword" notempty="1"}换个关键词试试。{/naicha:if}
    </p>
  </div>
{/naicha:if}

<!-- [搜索页] 也可以给出条数 -->
{naicha:if var="listTotal" gt="0"}<p>共 {listTotal} 条结果</p>{/naicha:if}
⚠️ 统计变量和分页条一样,认的是「最近一次」那个列表。 一页里如果有多个 {naicha:list}(主列表 + 侧栏最新 5 篇), 取到的就是最后渲染的那个 —— 拿不准就在对应列表的紧后面写,别隔着别的列表用。
没找到答案? 可以在 联系我们 留言说明使用场景,我们会补充进文档。