[基础用法]
描述:获取列表
模板中的列表内容。比如文章、图集、产品等
注意:一个列表模板里不能存在两个list标签
用法:
{eyou:list loop='10' titlelen='30' infolen='160' orderby='add_time'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:list}
属性:
arc_level_id=‘’ 会员权限级别,比如级别输入2那么就只显示会员级别2的相关文章。
timewode=‘’ 筛选时间访问内的相关文章数据,时间范围内的所有帖子,单位格式:d为天,w为周,m为月,q为季度,h为半年,y为年【数+单位】 。如果不写单位表示实际天数。
orderzd='top' 文章置顶,文章有这个选项的列表里就会靠前显示,orderzd='top' 中top为默认值,当然也可以自定义如在逆序者工功能里面新建一个【功能属性:xxx】那么调用的时候便是orderzd='xxx'。
titlelen='30' 标题字数
infolen='160' 表示内容简介字数
loop='10' 分页大小
addfields='' 自定义字段名,多个字段之间用英文逗号隔开,比如:addfields='price,spce'
idlist='' 指定多个文档ID,以逗号分隔开
idrange='' 筛选aid范围,如idrange='1-3' aid在1-3区间的数据(aid等于1,2,3)
orderby='now' 文档排序方式
----orderby='hot' 或 orderby='click' 表示按点击数从高到低排序
----orderby='add_time' 按发布时间最新排序
----orderby='update_time' 按更新时间最新排序
----orderby='aid' 按ID从大到小排序
----orderby='sort_order' 按排序号从大到小排序
----orderby='is_recom desc, sort_order asc' 自定义多字段组合排序
ordermode='desc' 排序类型:desc表示从大到小,asc表示从小到大
modelid='' 频道ID,优先级高于栏目ID,仅次于文档ID
typeid='' 栏目ID,在列表模板和内容页模板中一般不需要指定,在首页模板中允许用","分开表示多个栏目,但必须是同一个模型下的多个栏目ID,比如:文章模型、产品模型、图集模型等;
notypeid='' 同typeid,但这里是表示不包含这些属性,与typeid不能同时存在;
flag='c' 自定义属性值:推荐[c]跳转[j],其他更多属性值参考“功能地图>文档相关>文档属性,”
noflag='' 同flag,但这里是表示不包含这些属性
empty='' 没有数据时显示的文案
mod='' 每隔N行输出的内容
thumb='' 缩略图,默认为开启,on为开启,off为关闭
arcrank='' 阅读权限,默认为关闭,on为开启,off为关闭,示例在下方
id='' 可以任意指定循环里的变量名替代field,假设id='field1',模板调用如:{$field.title} 变成 {$field1.title}
涉及表字段:
请查阅易优数据字典,找到表名 ey_archives
-------------------------------效果展示--------------------------------1,调用列表模板中的列表内容代码模板调用代码 <ul class="news">
{eyou:list loop="10" titlelen="30"}
<li><a href="{$field.arcurl}" title="<b>{$field.title}</b>"><b>{$field.title}</b></a><span>[{$eyou.field.update_time|MyDate='Y-m-d',###}]</span></li>
{/eyou:list}
</ul>
网站前端显示效果(CSS样式请自行填充)
【更多示例】
-------------------------------示例1--------------------------------
描述:每隔3条输出文档记录
{eyou:list loop='10' mod='3'}
{eyou:eq name='mod' value='0'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:eq}
{/eyou:list}
-------------------------------示例2--------------------------------
描述:mod属性还用于控制一定记录的换行,每3条记录换行一次
{eyou:list loop='10' mod='3'}
<a href='{$field.arcurl}'>{$field.title}</a>
{eyou:eq name='mod' value='0'}
<br/>
{/eyou:eq}
{/eyou:list}
-------------------------------示例3--------------------------------
描述:内置变量输出数据索引与记录顺序,key 表示索引,默认从0开始;i 表示顺序,默认从1开始。
{eyou:list loop='5'}
{$key} - {$i}
{/eyou:list}
效果:
0 - 1
1 - 2
2 - 3
3 - 4
4 - 5
-------------------------------示例4--------------------------------
描述:没有记录时输出文案提示,属性empty支持直接传入html语法(html里只支持双引号,禁止单引号)
{eyou:list loop='10' empty='暂时没有数据'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:list}
-------------------------------示例5--------------------------------
描述:自定义变量名
{eyou:list loop='10' id='field2'}
<a href='{$field2.arcurl}'>{$field2.title}</a>
{/eyou:list}
-------------------------------示例6--------------------------------
描述:列表显示阅读权限的会员等级值和会员等级名称
{eyou:list typeid='文档ID' limit='0,10' id='field'}
会员等级名称:{$field.level_name}
会员等级值:{$field.level_value}
{/eyou:list}