织梦dedecms模板建站之list列表标签使用方法

织梦dedecms是一个优秀的中文CMS系统，广泛应用于各种网站的建设之中。在网站建设中，如何使用模板标签是一项必须掌握的技能。其中，list列表标签是非常常用的标签之一，可以用于列表展示、文章归档等多种场景。本文将详细介绍list列表标签的使用方法及其常用属性。

一、list标签的基本语法

list标签是一种用于展示内容列表的标签，其基本语法如下：

——

{dede:list typeid=\'1\' row=\'10\' titlelen=\'30\'}

{loop $data $r}

<li><a href=\"{$r[\'arcurl\']}\">{$r[\'title\']}</a></li>

{/loop}

{/dede:list}

——

其中，typeid表示列表所属的栏目ID，row表示每页展示的文章数量，titlelen表示标题截取的长度，具体的含义后面会详细讲解。

二、list标签的常用属性

1. typeid

该属性用于指定列表所属的栏目ID，可以是单个栏目ID，也可以是多个栏目ID，多个栏目ID之间用逗号隔开。例如：

——

{dede:list typeid=\'1,2,3\' row=\'10\'}

...

{/dede:list}

——

2. row

该属性用于指定每页展示的文章数量，默认为20篇。例如：

——

{dede:list typeid=\'1\' row=\'10\'}

...

{/dede:list}

——

3. titlelen

该属性用于指定标题截取的长度，默认为30个字符。如果标题过长，可以使用该属性控制截取的长度。例如：

——

{dede:list typeid=\'1\' row=\'10\' titlelen=\'20\'}

...

{/dede:list}

——

4. orderby

该属性用于指定列表的排序方式，可以是按文章发布时间、点击次数、评论次数等进行排序，具体的排序方式如下：

- id：文章ID

- sortrank：排序系数

- typeid：栏目ID

- flag：属性标记

- channel：频道类型

- senddate：发布时间

- description：描述

- click：点击数

- goodpost：是否为精华

- badpost：是否为拒绝

- scores：评分总数

- ftempid：未知

- ismake：是否生成

- arcrank：审核状态

- mid：会员ID

- uname：会员姓名

- dutyadmin：编辑姓名

默认为按发布时间排序，如果需要按点击数进行排序，可以使用以下语法：

——

{dede:list typeid=\'1\' row=\'10\' orderby=\'click\'}

...

{/dede:list}

——

5. orderway

该属性用于指定列表的排序方式，可以是升序（ASC）或降序（DESC），默认为DESC（降序）。例如：

——

{dede:list typeid=\'1\' row=\'10\' orderby=\'click\' orderway=\'ASC\'}

...

{/dede:list}

——

6. limit

该属性用于指定列表的起始位置和数量，常用于分页显示或取出特定范围的数据。该属性有两种写法，一种是使用英文逗号分隔起始位置和数量，例如：

——

{dede:list typeid=\'1\' row=\'10\' limit=\'0,10\'}

...

{/dede:list}

——

表示取出第1条到第10条数据；另一种是使用冒号（:）分隔起始位置和数量，例如：

——

{dede:list typeid=\'1\' row=\'10\' limit=\'0:10\'}

...

{/dede:list}

——

也表示取出第1条到第10条数据，两种写法等价。

三、可用的变量

在list标签中，有一些可用的变量，可以用于展示文章的各个方面。以下是常用的变量：

- $r[\'id\']：文章ID

- $r[\'typeid\']：栏目ID

- $r[\'typename\']：栏目名称

- $r[\'channel\']：频道类型，文字、图片等

- $r[\'title\']：文章标题

- $r[\'shorttitle\']：文章短标题

- $r[\'litpic\']：缩略图地址

- $r[\'click\']：点击次数

- $r[\'pubdate\']：发布时间

- $r[\'writer\']：作者

- $r[\'source\']：来源

- $r[\'description\']：文章描述

- $r[\'keywords\']：文章关键词

- $r[\'url\']：文章链接地址

- $r[\'arcurl\']：文章内容页地址

如果需要展示文章的其他元素，可以参考dedecms的模板标签手册。

四、总结

通过本文的介绍，相信大家已经掌握了list列表标签的基本语法及其常用属性。在实际项目中，我们往往需要根据具体的需求来灵活运用这些属性，通过list标签来展示网站内容。当我们遇到list标签无法满足需求的时候，还可以结合dedecms提供的其他标签来进一步展示和定制网站内容，例如dede:channelartlist、dede:channelartmap、dede:pagelist等，这些标签也是非常实用的。