dede标签:arclist标签使用大全

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

特别提示：arclist是(shi)织梦建站系统中最重要(yao)的标(biao)签，同(tong)时(shi)也是(shi)最基础的标(biao)签，希望大家熟(shu)练掌握，可(ke)以说是(shi)学(xue)习织梦必备知识。

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

{/dede:arclist}


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

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

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

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


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



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




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



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




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


按ID排序顺序排列,从小到大


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


调用含有缩图的文档


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


日期(qi)的各种格式


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


底层字段


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



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

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

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

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

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

{/dede:arclist}

底层模板字段：
ID(同(tong) 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"格式)
其(qi)中：
textlink =
typelink =
imglink =
image =
字段调(diao)用(yong)方法(fa)：[field:varname/]
如：
{dede:arclist infolen='100'}
[field:textlink/]


[field:infos/]


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