织梦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等,这些标签也是非常实用的。