内容列表：{naicha:list}

适用范围：列表页；首页、详情页侧栏、任意需要「取一批内容」的地方。

基本写法

{naicha:list cid="3" num="10" page="{naicha:param name='page'}" order="publish desc"}
  <a href="{list.url}">{list.title}</a>
{/naicha:list}

全部参数

排序键（写错的会静默回落到 sort desc）

sort desc　sort asc　publish desc　publish asc hits desc　id desc　id asc　relevance（只在带 keyword 时有意义）

⚠️ 写错不报错，页面照常渲染，只是顺序不对。看着「正常」而顺序怪，先来这一行对一下。

循环体里能用的字段（一条不漏）

下面这些都写 {list.字段名}。列表查询取的是内容表整行，所以表里有的列模板里都能取， 包括平时用不到的。

基本

时间与状态

图片

⚠️ {list.thumb} 存的是相对路径（uploads/2026xx/a.png）。 在 /list/cid-3 这类多层地址下直接写进 src，浏览器会当成 /list/uploads/…，图全裂。 一律用 {list.thumb_url} —— 它还顺带处理了多语言前缀。

自定义字段与门槛

一份可以直接抄的列表页

<!-- [templates/default/list.html] -->
{naicha:include file="header.html"}

<div class="page-head">
  <h1>{sort.name}</h1>
  <p>{sort.intro}</p>
</div>

<div class="container">
  <!-- filters="1" 让这个列表响应地址栏上的筛选（排序 / 年份 / 标签）-->
  {naicha:filters show="sort,year,tag"}

  <div class="grid c3">
    {naicha:list cid="{naicha:param name='cid'}" num="12"
                 page="{naicha:param name='page'}" filters="1" order="publish desc"}
      <a class="card" href="{list.url}">
        {naicha:if var="list.has_thumb" eq="1"}
        <img src="{list.thumb_url}" alt="{list.title}">
        {/naicha:if}
        <h3>{list.title}</h3>
        <p>{list.summary excerpt="60"}</p>
        <span>{list.publish_time format="Y-m-d"} · 浏览 {list.hits}</span>
        {naicha:if var="list.is_new" eq="1"}<span class="badge">最新</span>{/naicha:if}
      </a>
    {/naicha:list}
  </div>

  <!-- 空结果要说一句人话，而不是留一片空白 -->
  {naicha:if var="listTotal" eq="0"}
    <div class="empty">
      <p>这个栏目还没有内容。{naicha:if var="keyword" notempty="1"}换个关键词试试。{/naicha:if}</p>
    </div>
  {/naicha:if}

  {naicha:page}
</div>

{naicha:include file="footer.html"}

同一栏目里放不同版式

<!-- [列表] 视频栏目用播放角标，其它用普通卡片 -->
{naicha:list cid="{naicha:param name='cid'}" num="12" media="1"}
  {naicha:if var="list.media_type" eq="video"}
    <span class="badge play">▶ {list.duration}</span>
  {naicha:elseif var="list.media_type" eq="audio"}
    <span class="badge audio">♪ {list.duration}</span>
  {naicha:else}
    <span class="badge">图文</span>
  {/naicha:if}
{/naicha:list}

{list.media_type} 是内容模型的扩展字段 —— 引擎在同名列找不到时会自动去 ext 里找，所以不用写 {list.ext.media_type}。

点赞 / 反对（后补的字段）

<!-- 点赞 / 反对。链接直接点就行，不用写 JS -->
<a class="like" href="{list.likeslink}">赞 <b>{list.likes}</b></a>
<a class="oppose" href="{list.opposelink}">踩 <b>{list.oppose}</b></a>

<!-- 想点完不跳页，加一个 fetch 即可（接口对 ajax=1 返回 JSON）-->
<script>
document.querySelectorAll('.like,.oppose').forEach(function (a) {
  a.addEventListener('click', function (ev) {
    ev.preventDefault();
    fetch(a.href + '&ajax=1').then(function (r) { return r.json(); }).then(function (d) {
      if (d.ok) { a.querySelector('b').textContent = d.likes || d.oppose; }
    });
  });
});
</script>

行所属栏目与作者（后补的字段）