核心基础标签:arclist
arclist 是织梦中最最核心、最常用的列表标签,用于调用文章、图集、软件等任意文档模型的内容,它功能强大,参数众多,几乎可以满足所有列表页的需求。

(图片来源网络,侵删)
基本语法
{dede:arclist flag='' typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='' channelid=''}
<a href='[field:arcurl/]'>[field:title/]</a>
<img src='[field:picname/]' width='[field:imgwidth/]' height='[field:imgheight/]' />
[field:info/]...
[field:pubdate function="MyDate('Y-m-d',@me)"/]
{/dede:arclist}
核心参数详解
| 参数 | 说明 | 示例 |
|---|---|---|
typeid |
指定栏目ID,调用指定栏目及其子栏目的文章,多个ID用逗号隔开。 | typeid='1,2' |
row |
调用条数,显示多少条记录。 | row='10' |
col |
分多少列显示(主要用于表格布局,现在多用CSS Grid/Flexbox,较少用)。 | col='2' |
infolen |
内容简介长度,截取多少个字符。 | infolen='100' |
imgwidth |
缩略图宽度。 | imgwidth='200' |
imgheight |
缩略图高度。 | imgheight='150' |
orderby |
排序方式,常用值:pubdate (发布时间)、hot (点击量)、sortrank (权重/置顶)、id (文章ID)。 |
orderby='hot' |
limit |
起始位置,调取条数,非常常用,用于分页或指定范围。 | limit='0,5' (从第0条开始,取5条) |
flag |
特定属性,常用值:c (推荐)、h (头条)、p (图片),可组合,如 flag='ch'。 |
flag='c' |
keyword |
关键词,调用包含指定关键词的文章。 | keyword='织梦,DedeCMS' |
channelid |
模型ID,默认为1(文章模型),其他常见:2 (图集), 3 (下载软件), -1 (所有模型)。 |
channelid='2' (调用图集) |
idlist |
指定文章ID列表,调用特定ID的文章,多个ID用逗号隔开。 | idlist='10,22,35' |
常用字段变量 (field)
| 字段 | 说明 |
|---|---|
[field:title/] |
|
[field:arcurl/] |
文章链接 |
[field:picname/] |
缩略图地址 |
[field:info/] |
简介(在后台“高级选项”中设置) |
[field:pubdate/] |
发布时间(时间戳格式) |
[field:pubdate function="MyDate('Y-m-d',@me)"/] |
发布时间(格式化为年-月-日) |
[field:click/] |
点击次数 |
[field:writer/] |
作者 |
[field:source/] |
来源 |
[field:typeid/] |
所属栏目ID |
[field:typelink/] |
所属栏目链接 |
[field:textlink/] |
<a> 标签形式的标题链接 |
[field:image/] |
<img> 标签形式的缩略图 |
arclist 实用案例
案例1:调用首页最新文章(不带缩略图)
{dede:arclist row='8' titlelen='24' orderby='pubdate'}
<li><a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a></li>
{/dede:arclist}
案例2:调用产品栏目(ID=5)下的产品,带缩略图,按点击量排序
{dede:arclist typeid='5' row='6' imgwidth='150' imgheight='120' orderby='click'}
<div class="product-item">
<a href="[field:arcurl/]"><img src="[field:picname/]" alt="[field:title/]" /></a>
<h3><a href="[field:arcurl/]">[field:title/]</a></h3>
</div>
{/dede:arclist}
案例3:调用带有“推荐”和“头条”属性的文章,只显示前5条
{dede:arclist flag='ch' row='5' titlelen='30'}
<strong><a href="[field:arcurl/]" target="_blank">[field:title/]</a></strong>
<p>[field:info/]...</p>
{/dede:arclist}
案例4:调用图集内容(channelid='2')
{dede:arclist channelid='2' row='4' imgwidth='200' imgheight='150'}
<a href="[field:arcurl/]">
<img src="[field:picname/]" alt="[field:title/]" />
<span>[field:title/]</span>
</a>
{/dede:arclist}
其他重要产品调用标签
除了 arclist,还有一些针对特定场景的标签也非常重要。
loop:万能循环标签
loop 是一个非常灵活的标签,可以直接执行SQL语句来查询数据,当 arclist 无法满足复杂需求时,loop 就派上用场了。
语法:
{dede:sql sql=''}
// 循环内容
{/dede:sql}
或者

(图片来源网络,侵删)
{dede:loop table='' sort='' row='' if=''}
// 循环内容
{/dede:loop}
案例:调用指定ID的栏目名称
{dede:sql sql="SELECT typename FROM `dede_arctype` WHERE id=5"}
当前栏目是:[field:typename/]
{/dede:sql}
myad:调用广告标签
用于在页面中预设的广告位调用。
语法:
{dede:myad name='广告位标识符'/}
使用方法:

(图片来源网络,侵删)
- 进入后台【核心】->【广告管理】。
- 添加一个广告,并获取其“广告位标识符”(
topbanner)。 - 在模板中使用
{dede:myad name='topbanner'/}即可调用。
channel:调用栏目列表标签
用于调用一级栏目,常用于网站主导航。
语法:
{dede:channel type='top' row='8'}
<a href='[field:typeurl/]'>[field:typename/]</a>
{/dede:channel}
参数:
type='top':只调用顶级栏目。type='son':调用当前栏目的子栏目。row='8':调用栏目数量。
type:获取栏目信息标签
用于在文章页或栏目页获取当前栏目的信息,如栏目名称、栏目链接等。
语法:
当前栏目名:{dede:type}[field:typename/]{/dede:type}
栏目链接:{dede:type}[field:typeurl/]{/dede:type}
flink:调用友情链接标签
用于调用网站底部的友情链接。
语法:
{dede:flink type='text' row='24' titlelen='24'}
<a href="[field:url/]" target="_blank">[field:name/]</a>
{/dede:flink}
参数:
type='text':文字链接。type='image':图片链接。row='24':调用数量,len='24'`:网站名称长度。
高级技巧与注意事项
自定义函数
field 标签支持使用PHP函数来处理输出内容,非常强大。
- 日期格式化:
[field:pubdate function="MyDate('Y-m-d H:i:s',@me)"/] - 去除HTML标签:
[field:info function='htmlspecialchars(@me)'/]或[field:info function='strip_tags(@me)'/] - 截取并加省略号:
[field:title function="cn_substr(@me, 30)"/](此方法不加省略号,要加省略号需要在后台系统基本参数中设置)
标签嵌套
织梦标签支持嵌套,可以实现更复杂的功能。
案例:调用每个栏目下的最新一篇文章
{dede:channel type='top' row='8'}
<dl>
<dt><a href="[field:typeurl/]">[field:typename/]</a></dt>
<dd>
{dede:arclist typeid='[field:id]' row='1'}
<a href="[field:arcurl/]">[field:title/]</a>
{/dede:arclist}
</dd>
</dl>
{/dede:channel}
性能优化
- 避免过多嵌套:过深的标签嵌套会增加服务器解析时间,影响性能。
- 合理使用缓存:织梦有页面缓存功能,对于不经常更新的列表页(如首页、列表页),开启缓存可以极大提升访问速度。
- 精准查询:在
arclist中尽量使用typeid,idlist,limit等参数来缩小查询范围,减少数据库负担。
总结表格
| 标签名 | 主要用途 | 核心参数/特点 |
|---|---|---|
arclist |
万能列表标签,调用文章、产品、图集等。 | typeid, row, orderby, limit, flag, channelid |
loop |
万能SQL查询标签,用于复杂或自定义数据调用。 | sql, table |
myad |
调用预设的广告位。 | name (广告位标识符) |
channel |
调用栏目列表,常用于导航。 | type (top, son), row |
type |
页获取当前栏目的信息。 | 无参数,获取 [field:typename/] 等 |
flink |
调用友情链接。 | type (text, image), row |
掌握以上这些标签,特别是 arclist,您就已经可以驾驭织梦CMS大部分的产品内容调用了,在实际使用中,建议多参考官方模板,并不断练习,才能熟练运用这些标签的强大功能。
