dede标签:arclist标签使用大全

发布时间：2015-08-19 14:42:41点击：2760字号：T|T

特(te)别提示：arclist是织(zhi)梦建站系统中(zhong)最重要的标签，同时也是最基础的标签，希望大(da)家熟练掌(zhang)握(wo)，可以说(shuo)是学习(xi)织(zhi)梦必备(bei)知识。

标签名(ming)称：arclist
标记简介：织(zhi)梦(meng)常用标记，也称为自由列表标记，其中imglist、imginfolist、specart、coolart、autolist都是(shi)由该标记所定义的不(bu)同属性延(yan)伸出来(lai)的别名标记。
功能说明(ming)：获取(qu)指定文(wen)档列(lie)表
适(shi)用范围：全局使用
基本(ben)语(yu)法(fa)：
{dede:arclist  flag='h' typeid='' row='' col='' titlelen='' infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword='' limit='0,1'}

{/dede:arclist}


typeid='' 栏目ID,在列表模(mo)板(ban)和档案模(mo)板(ban)中一般不需要(yao)指(zhi)定(ding)，在上海(hai)娱(yu)乐网模(mo)板(ban)中允(yun)许用","分开表示多个栏目；

orderby='sortrank' 文档排序方式(shi)
§ orderby='hot' 或 orderby='click' 表(biao)示按点击数(shu)排(pai)列
§ orderby='sortrank' 或(huo) orderby='pubdate' 按出版时(shi)间排列
§ orderby='near'
§ orderby=='lastpost' 按最后评论时间
§ orderby=='scores' 按(an)得分排序(xu)
§ orderby='id' 按(an)文章ID排序
§ orderby='rand' 随(sui)机获得指定条件的文档列表

idlist ='' 提(ti)取特定文档(dang)(dang)（文档(dang)(dang)ID） 调(diao)用指(zhi)定id文档(dang)(dang) 例子(zi)idlist ='4,45,78,237'
limit='起(qi)始(shi)ID,记(ji)录(lu)(lu)数'  （起(qi)始(shi)ID从0开始(shi)）表示限定的记(ji)录(lu)(lu)范围（如：limit='1,2'  表示从ID为1的记(ji)录(lu)(lu)开始(shi)，取(qu)2条记(ji)录(lu)(lu)）
keyword='' 含有指定关键字(zi)的文档列表，多个关键字(zi)用","分(fen)
orderway='desc' 值为 desc 或 asc ，指(zhi)定排(pai)序(xu)(xu)方式(shi)是(shi)降序(xu)(xu)还是(shi)顺向排(pai)序(xu)(xu)，默认为降序(xu)(xu)

使用实例(li)
调用推荐(jian)文章


{dede:arclist flag="c" channelid='' row='10' titlelen='60' orderby=''}



{/dede:arclist}
row='10' 调(diao)用10条,  titlelen='60'标题长度为30汉(han)字(zi)  flag="c" 推荐文章 orderby='' 默认为按发布时间排(pai)序
flag = 'c' 自(zi)定义属(shu)性值：头条(tiao)[h]  推荐[c]  图(tu)片(pian)[p]  幻(huan)灯(deng)[f]  滚动[s]  跳转[j]  图(tu)文[a]  加粗
调用最新文(wen)章(zhang)按发布时间排序




{dede:arclist  channelid='' row='10' titlelen='60'}



{/dede:arclist} row='10' 调(diao)用10条,  titlelen='60'标题长度为30汉字
按ID排序降序排列(lie),从大到(dao)小




{dede:arclist  channelid='' row='10' titlelen='60' orderby='id' } {/dede:arclist} row='10' 调用10条,  titlelen='60'标题长度为30汉字 orderby='id'  按ID,降序排列


按(an)ID排(pai)序顺序排(pai)列,从小到大


{dede:arclist  channelid='' row='10' titlelen='60' orderby='id' orderway='asc' } {/dede:arclist} row='10' 调用10条,  titlelen='60'标题长度(du)为30汉字 orderby='id'  按ID,orderway='desc' 值为 desc 或 asc ，指定排(pai)(pai)序方式是(shi)降序还是(shi)顺向排(pai)(pai)序，默认为降序


调用(yong)含有缩图的文(wen)档


{dede:arclist flag="p" row='10' titlelen='60'} {/dede:arclist} flag = 'p' 自定义属(shu)性值：头条[h]  推荐[c]  图片[p]  幻(huan)灯[f]  滚(gun)动(dong)[s]  跳转[j]  图文[a]  加粗(cu)


日(ri)期的(de)各种格式(shi)


08                   [field:pubdate function=strftime('%d',@me)/] 08 日(ri)                [field:pubdate function=strftime('%d日(ri)',@me)/] 06-08                [field:pubdate function=strftime('%m-%d',@me)/] 06月08日(ri)             [field:pubdate function=strftime('%m月%d日(ri)',@me)/] 09-06-08             [field:pubdate function=strftime('%y-%m-%d',@me)/] 2009-06-08           [field:pubdate function=strftime('%Y-%m-%d',@me)/] 09年(nian)06月(yue)08日         [field:pubdate function=strftime('%y年(nian)%m月(yue)%d日',@me)/] 2009年06月08日       [field:pubdate function=strftime('%Y年%m月%d日',@me)/] 2009-06-08  13:28    [field:pubdate function=strftime('%Y-%m-%d %H:%M',@me)/]


底层字(zi)段


[field:id /] 文章的(de)ID,对应dede_archives 的(de)ID字(zi)段 [field:typeid /] 文章所在栏目的ID * [field:title/] 文章标(biao)题(ti)(控制条件包(bao)括titlelen=''字节数(shu),后(hou)台发(fa)布文档(dang)时(shi)所(suo)选的标题颜色(se),加粗) * [field:fulltitle/] 文章标(biao)题(标(biao)题完整,无样式) * [field:click /] 点击数(shu) [field:shorttitle /] 短标题 * [field:writer /] 作者 * [field:source /] 来源 * [field:litpic /] 缩图地址 与(yu) [field:picname /]相同 [field:picname /] 缩(suo)图地址(zhi) 与(yu)[field:litpic /]相同 * [field:pubdate /] 发(fa)布日期 08              [field:pubdate function=strftime('%d',@me)/] 08 日           [field:pubdate function=strftime('%d日',@me)/] 06-08           [field:pubdate function=strftime('%m-%d',@me)/] 06月(yue)08日(ri)        [field:pubdate function=strftime('%m月(yue)%d日(ri)',@me)/] 09-06-08        [field:pubdate function=strftime('%y-%m-%d',@me)/] 2009-06-08      [field:pubdate function=strftime('%Y-%m-%d',@me)/] 09年(nian)06月(yue)08日    [field:pubdate function=strftime('%y年(nian)%m月(yue)%d日',@me)/] 2009年06月08日(ri)  [field:pubdate function=strftime('%Y年%m月%d日(ri)',@me)/] 2009-06-08  13:28[field:pubdate function=strftime('%Y-%m-%d %H:%M',@me)/] [field:lastpost /] 最后(hou)评(ping)论时(shi)间 用法同(tong) [field:pubdate /] [field:scores /] 评论得(de)分 [field:goodpost /] 好评 [field:badpost/] 差评 * [field:description /] 简介 等同(tong)于 [field:info /] ,[field:infos /] 字数(shu)控(kong)制(zhi)  [field:description   function="cn_substr(@me,120)"/] 60汉字 infolen='160' 表示(shi)内容简介长度(du) 等同(tong)于infolength（只控(kong)制infos，并不控(kong)制description的内容） * [field:info /] 简(jian)介 等(deng)同于 [field:description /] ,[field:infos /] 字(zi)数控制  [field:info  function="cn_substr(@me,120)"/] 60汉字(zi) infolen='160' 表示内容(rong)简介长(zhang)度 等同于infolength（只(zhi)控制infos，并(bing)不控制description的(de)内容(rong)） * [field:infos /] 简介 等同于 [field:info /] ,[field:description /] 字(zi)数控制  [field:infos   function="cn_substr(@me,120)"/] 60汉字(zi) infolen='160' 表示内容简(jian)介长度 等同于infolength（只(zhi)控制infos，并(bing)不控制description的内容） [field:filename /] 文章(zhang)连接地址(zhi) 等同(tong)于[field:arcurl /] * [field:arcurl /] 文章链接地址 等(deng)同于[field:filename /] * [field:textlink /] 文章标题(ti)+地址 等同于 * [field:litpic /] 缩图地址 等同(tong)于  [field:picname /] * [field:picname /] 缩(suo)图(tu)地址(zhi) 等同于  [field:litpic /] * [field:image /] 等同于(yu) imgwidth='120' 缩略(lve)图宽度(du) imgheight='90' 缩略图高度 * [field:imglink /] 等同(tong)于imglink = * [field:typename /] 栏目标题 * [field:typeurl /] 栏目地址 * [field:typelink /] 等同于 [field:plusurl /] pius文(wen)件夹(jia)地址 等同于 [field:global name=plusurl/] [field:memberurl /] 会员(yuan)文件夹地址 等(deng)同于(yu) [field:global name=memberurl/] [field:templeturl /] 模板(ban)文(wen)文(wen)件夹地址(zhi) 等同于 [field:global name=templeturl /] * [field:global name=autoindex/] 最常用的底层标签,生成顺序数字1,2,3,4,5,6,7..... 可CSS控制可做成各种样式效(xiao)果(guo),比(bi)如隔行换色, 列表前加(jia)入1-10数字(zi)序号,每隔几(ji)行换行等(deng)(deng)等(deng)(deng) 于PHP搭配,可制作出(chu)各(ge)种效果,为DEDE最重要(yao)代(dai)码之(zhi)一



相关函数：
文件\include\taglib\arclist.lib.php第7行
function lib_arclist(&$ctag,&$refObj)
参(can)数说明(ming)：
col='' 分多少列显示（默认为单(dan)列），5.3版中本属性(xing)可以通过多种方式进行多行显示
如果col='1'要多列显示的可用div+css实现
以(yi)下为通过div+css实(shi)现多(duo)列(lie)的示例：

{dede:arclist row='10' titlelen='24' orderby='pubdate' idlist='' col='2'}
?[field:textlink/]([field:pubdate function=MyDate('m-d',@me)/])

{/dede:arclist}
当col>1将(jiang)使用原来的(de)table多列方式显示
row='10' 返回文档列表总数
typeid='' 栏目ID,在列(lie)表(biao)模(mo)板和档案模(mo)板中(zhong)一般不(bu)需要指定，在上海(hai)娱(yu)乐(le)网模(mo)板中(zhong)允许用(yong)","分开表(biao)示多(duo)个(ge)栏目；
getall='1' 在(zai)没(mei)有指(zhi)定这属性的(de)(de)情况下,在(zai)栏(lan)目页(ye)、文章页(ye)模板,不会获取(qu)以","分(fen)开的(de)(de)多个栏(lan)目的(de)(de)下级子(zi)类
titlelen = '30' 标题(ti)长度 等同于titlelength
infolen='160' 表示内(nei)容简介(jie)长度 等同于infolength（只控制(zhi)infos，并(bing)不控制(zhi)description的内(nei)容）
imgwidth='120' 缩略图宽度
imgheight='90' 缩略图高度
listtype='all' 栏(lan)目类型 image含有缩略图 commend推荐
orderby='sortrank' 文档排(pai)序方式
§ orderby='hot' 或 orderby='click' 表示按(an)点击数排列
§ orderby='sortrank' 或 orderby='pubdate' 按出版时间排列(lie)
§ orderby='near'
§ orderby=='lastpost' 按最(zui)后评论时间
§ orderby=='scores' 按(an)得分排序
§ orderby='id' 按文(wen)章ID排序
§ orderby='rand' 随机获(huo)得指(zhi)定条件的(de)文(wen)档列表
keyword='' 含有(you)指定关键字的文(wen)档列表，多个关键字用","分
innertext = '' 单条记(ji)录样式(shi)
aid='' 指定(ding)文档ID
idlist ='' 提取特定文(wen)档(dang)（文(wen)档(dang)ID）
channelid 频(pin)道ID
limit='起始(shi)ID,记(ji)录(lu)(lu)(lu)数'  （起始(shi)ID从0开始(shi)）表示限(xian)定的(de)记(ji)录(lu)(lu)(lu)范围（如：limit='1,2'  表示从ID为1的(de)记(ji)录(lu)(lu)(lu)开始(shi)，取(qu)2条(tiao)记(ji)录(lu)(lu)(lu)）
flag = 'h' 自(zi)定(ding)义属性值：头条(tiao)[h]推荐[c]图片[p]幻灯[f]滚动[s]跳转[j]图文[a]加粗
noflag = '' 同flag，但这(zhei)里是表(biao)示不包含(han)这(zhei)些属性(xing)
orderway='desc' 值为 desc 或 asc ，指(zhi)定(ding)排序(xu)方式(shi)是(shi)降序(xu)还是(shi)顺向(xiang)排序(xu)，默认(ren)为降序(xu)
subday='天(tian)数' 表示在多少(shao)天(tian)以内的文档

用arclist调用于附加表字段的方(fang)法(fa)：

要获取附加(jia)表内容，必须符合(he)两(liang)个条件(jian)
1、指定(ding) channelid 属性
2、指定要获得(de)的字(zi)段(duan) addfields='字(zi)段(duan)1,字(zi)段(duan)'
如：
{dede:arclist addfields='filetype,language,softtype' row='8' channelid='3'}
[field:textlink /] - [field:softtype /]

{/dede:arclist}

底层模板字段：
ID(同 id),typeid,sortrank,flag,ismake,channel,arcrank,click,money,title,shorttitle,color,writer,
source,litpic(同picname),pubdate,senddate,mid, lastpost,scores,goodpost,badpost,notpost,
description(同infos),filename, image, imglink, fulltitle, textlink, typelink,plusurl, memberurl, templeturl,
stime(pubdate 的"0000-00-00"格式)
其中：
textlink =
typelink =
imglink =
image =
字段(duan)调(diao)用方法(fa)：[field:varname/]
如：
{dede:arclist infolen='100'}
[field:textlink/]


[field:infos/]


{/dede:arclist}
注：底层(ceng)模板里的Field实现也是织梦标记的一种(zhong)形式(shi)，因此支持使用PHP语法，Function扩展等(deng)功能。
如(ru)： 给当天发布的(de)内容加上 (new) 标志
[field:senddate runphp='yes']
$ntime = time();
$oneday = 3600 * 24;
if(($ntime - @me)<$oneday) @me = "(new)";
else @me = "";
[/field:senddate]