dede arclist标签怎么用？参数有哪些？

arclist 标签，顾名思义，是“文章列表”的缩写，它的主要功能是从数据库中提取符合条件的文章、图集等文档，并以列表的形式展示在页面上，它是 DedeCMS 中使用频率最高的标签之一，几乎无处不在，比如首页、列表页、频道页等。

arclist 标签的基本语法

arclist 标签的基本结构非常简单，由属性和标签体组成。

{dede:arclist 属性='值' 属性='值' ...}
    <a href='[field:arcurl/]'>[field:title/]</a>
    <span>[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
{/dede:arclist}

• {dede:arclist ...}: 标签的开始，所有的属性都在这里定义。
• {/dede:arclist}: 标签的结束。
• 标签体: 开始和结束标签之间的 HTML 代码和内部标签（如 [field:title/]），这部分是用来定义列表项的显示样式的。

核心属性详解

arclist 的强大之处在于其丰富的属性，通过组合这些属性，可以实现各种复杂的需求。

基础筛选属性

示例：获取栏目ID为1下的最新10篇文章，标题显示30个字符。

{dede:arclist typeid='1' row='10' titlelen='30' orderby='pubdate'}
    <li><a href="[field:arcurl/]">[field:title/]</a></li>
{/dede:arclist}

高级筛选属性

示例：获取栏目ID为2下的所有头条文章。

{dede:arclist typeid='2' flag='h' row='5'}
    <div class="headline">
        <a href="[field:arcurl/]"><img src="[field:picname/]" alt="[field:title/]" /></a>
        <a href="[field:arcurl/]">[field:title/]</a>
    </div>
{/dede:arclist}

样式与输出控制属性

内部字段（循环体内的变量）

在 {dede:arclist} 和 {/dede:arclist} 之间，可以使用 [field:xxx/] 来调用当前文章的各个字段信息。

function 修饰符： function 用于对字段值进行二次处理，最常用的就是日期格式化。 MyDate('Y-m-d', @me) 的含义是：

• MyDate: DedeCMS 的一个内置函数。
• 'Y-m-d': 日期格式，Y代表四位年份，m代表月份，d代表日期。
• @me: 代表当前字段的原始值（这里是时间戳）。

常用实例

实例1：首页最新文章列表

<div class="news-list">
    <h3>最新文章</h3>
    <ul>
        {dede:arclist row='8' titlelen='40' orderby='pubdate'}
            <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}
    </ul>
</div>

实例2：带缩略图的图文列表

<div class="pic-list">
    {dede:arclist row='4' titlelen='20' orderby='pubdate' imgwidth='150' imgheight='100'}
        <div class="pic-item">
            <a href="[field:arcurl/]">
                <img src="[field:picname/]" alt="[field:title/]" width="150" height="100" />
                <span>[field:title/]</span>
            </a>
        </div>
    {/dede:arclist}
</div>

注意：imgwidth 和 imgheight 属性需要配合 DedeCMS 的自动缩略图功能使用，并且文章需要有图片。

实例3：调用指定子栏目的文章

假设当前栏目ID是 5，要调用其所有一级子栏目下的文章。

{dede:arclist typeid='sonof5' row='10' titlelen='30'}
    ...
{/dede:arclist}

typeid='sonof5' 这种写法是动态获取ID为5的子栏目，更推荐的方式是直接在后台获取到子栏目的ID，然后写死，如 typeid='6,7,8'。

与 list 标签的区别

初学者经常混淆 arclist 和 list 标签，这里简单区分一下：

简单记忆：

• 想在首页、侧边栏等地方调用某个或某几个栏目的文章，用 arclist。
• 想制作一个栏目列表页，展示该栏目下所有文章并分页，用 list。

arclist 是 DedeCMS 的瑞士军刀，掌握它是熟练使用 DedeCMS 的关键，你需要做的：

1. 理解基本结构：{dede:arclist}...{/dede:arclist}。
2. 熟悉核心属性：特别是 typeid, row, orderby, flag 等，知道它们的作用。
3. 掌握内部字段：知道如何用 [field:title/], [field:arcurl/] 等获取文章信息。
4. 学会使用 function：特别是日期格式化 MyDate()。
5. 区分 arclist 和 list：在正确的场景使用正确的标签。

多加练习,尝试组合不同的属性和字段，你就能制作出各种复杂的列表效果。