织梦arclist标签调用方法

标签简介

{dede:arclist} 是织梦CMS最核心、最常用的全局标签，用于在任意页面调用文章列表。它支持按栏目、属性、关键词、时间等多维度筛选，支持自定义排序、分页、字段输出。掌握 arclist 是织梦模板开发的基本功，几乎每个页面都会用到。

原因分析

1. 首页推荐位调用

首页需要展示最新文章、推荐文章、头条文章，全部依赖 arclist。

2. 侧栏热门文章

侧栏的「热门文章」「最新评论」等区块都需要 arclist 实现。

3. 栏目页列表调用

栏目页虽然可以用 {dede:list}，但 arclist 在跨栏目调用时更灵活。

基础语法

{dede:arclist 参数1='值1' 参数2='值2' row='10'}
  模板内容，用 [field:字段名/] 输出
{/dede:arclist}

核心参数

筛选类参数

• typeid：栏目ID，多个用逗号分隔，留空调用全站。
• flag：自定义属性，如 flag='h' 调头条。
• channel：内容模型ID，1=文章，2=图片集，3=软件。
• keyword：关键词筛选。

排序类参数

• orderby：排序字段，常用 pubdate（发布时间）、click（点击）、weight（权重）、id、rand（随机）。
• orderway：desc 倒序（默认），asc 正序。

数量与分页

• row：调用条数。
• titlelen：标题长度，按字节计算。
• infolen：摘要长度。
• pagesize：分页大小（配合 list 标签使用）。

调用示例

调用最新文章

{dede:arclist row='10' orderby='pubdate' orderway='desc'}
  <li>
    <span class="date">[field:pubdate function="MyDate('m-d',@me)"/]</span>
    <a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a>
  </li>
{/dede:arclist}

调用头条推荐

{dede:arclist flag='h' row='5' titlelen='40' infolen='120'}
  <div class="headline">
    <h2><a href="[field:arcurl/]">[field:title/]</a></h2>
    <p>[field:info/]...</p>
  </div>
{/dede:arclist}

调用指定栏目

{dede:arclist typeid='2,3,5' row='15' orderby='pubdate'}
  <li><a href="[field:arcurl/]">[field:title/]</a></li>
{/dede:arclist}

调用带缩略图文章

{dede:arclist flag='p' row='6' titlelen='20'}
  <div class="img-item">
    <a href="[field:arcurl/]">
      <img src="[field:litpic/]" alt="[field:title/]">
      <span>[field:title/]</span>
    </a>
  </div>
{/dede:arclist}

排除指定文章

{dede:arclist typeid='1' row='10' idlist='15,20'}
  <a href="[field:arcurl/]">[field:title/]</a>
{/dede:arclist}

按权重排序

{dede:arclist typeid='1' row='10' orderby='weight' orderway='desc'}
  <a href="[field:arcurl/]">[field:title/]</a>
{/dede:arclist}

常用字段

[field:arcurl/]      文章URL
[field:title/]      标题
[field:fulltitle/]  完整标题（不截断）
[field:litpic/]     缩略图URL
[field:description/] 摘要
[field:info/]       简介内容（自动截断）
[field:pubdate/]    发布时间戳
[field:click/]      点击数
[field:typename/]   栏目名
[field:typeurl/]    栏目URL
[field:writer/]     作者
[field:source/]     来源

注意事项

• titlelen 按字节计算，中文占 2 字节，标题截断可能不完整。
• 跨栏目调用时 typeid 用逗号分隔，不要加空格。
• arclist 不能在文档详情页调用本文，需用 {dede:field} 标签。
• 调用条数 row 不要设置过大（建议 ≤30），影响性能。
• 缓存开启时，arclist 结果会缓存到 data/tplcache/，更新文章后需清缓存。

建议与行动

arclist 是织梦模板的灵魂标签，熟练掌握能让站点页面千变万化。建议把常用的调用代码整理成「代码片段库」，按首页、栏目页、详情页、侧栏分类存放，开发时直接复用，效率倍增。同时关注标签的性能影响，对调用频繁的位置开启缓存，避免每次访问都查询数据库。今天就先把站点现有的 arclist 调用梳理一遍，看看哪些可以优化参数、哪些可以加缓存。