arclist 文档列表(配合arcpagelist标签可实现ajax瀑布流分页)
\[基础用法\]
名称:arclist
功能:获取系统主从表模型(如:文章、软件、图集、产品等)的一列文档,也称自由列表块标记。
语法:
{eyou:arclist typeid='栏目ID' limit='0,10' flag='c' titlelen='30' infolen='160' orderby='add\_time'}
{$field.title}
{/eyou:arclist}
参数:
typeid='' 栏目ID,在列表模板和内容页模板中一般不需要指定,在首页模板中允许用","分开表示多个栏目,但必须是同一个模型下的多个栏目ID,比如:文章模型、产品模型、图集模型等;
notypeid='' 同typeid,但这里是表示不包含这些属性,与typeid不能同时存在;
tagid='' 在所有的arclist标签中是唯一不可重复,对应[arcpagelist标签](http://www.eyoucms.com/doc/label/list/6279.html#dt_67)的tagid名称,与arcpagelist配合使用可实现ajax瀑布流分页;
row='10' 返回文档列表总数(建议不要与limit属性同时存在,否则row无效)
limit='起始ID,记录数' (起始ID从0开始)表示限定的记录范围(如:limit='1,3' 表示在3条记录中,排除前面1条,也就是只取得剩余的后面所有记录)
titlelen='30' 标题长度
infolen='160' 表示内容简介长度
addfields='' 自定义字段名,多个字段之间用英文逗号隔开,比如:addfields='price,spce'
orderby='new' 文档排序方式
\----orderby='hot' 或 orderby='click' 表示按点击数从高到低排序
\----orderby='add\_time' 按发布时间最新排序
\----orderby='aid' 按ID从大到小排序
\----orderby='sort\_order' 按排序号从大到小排序
\----orderby='rand' 随机排序
\----orderby='is\_recom desc, sort\_order asc' 自定义多字段组合排序
orderway='desc' 排序类型:desc表示从大到小,asc表示从小到大
channelid='' 频道ID,优先级高于栏目ID,仅次于文档ID
flag='t,c' 自定义属性值:推荐\[c\]跳转\[j\]
noflag='' 同flag,但这里是表示不包含这些属性
empty='' 没有数据时显示的文案
mod='' 每隔N行输出的内容
thumb='on' 默认使用缩略图,on为开启,off为关闭
id='' 可以任意指定循环里的变量名替代field,假设id='field1',模板调用如:{$field.title} 变成 {$field1.title}
底层字段:
请查阅易优Cms官方提供的数据字典,找到表名 ey\_archives
\-------------------------------效果展示--------------------------------
1,调用指定栏目文章
模板调用代码
{eyou:arclist typeid='2' row='5' titlelen='30' }
{$field.title}
{/eyou:arclist}
网站前端显示效果(css样式请自行填充)
![](https://www.eyoucms.com/uploads/allimg/180926/5-1P9261HJ23M.png)
【更多示例】
\-------------------------------示例1--------------------------------
描述:每隔3条输出文档记录
{eyou:arclist typeid='文档ID' limit='0,10' mod='3'}
{eyou:eq name='mod' value='0'}
{$field.title}
{/eyou:eq}
{/eyou:arclist}
\-------------------------------示例2--------------------------------
描述:mod属性还用于控制一定记录样式,每隔3条增加样式,比如:3、6、9……
{eyou:arclist typeid='文档ID' limit='0,10' mod='3'}
{$field.title}
{/eyou:arclist}
\-------------------------------示例3--------------------------------
描述:内置变量输出数据索引与记录顺序,key 表示索引,默认从0开始;i 表示顺序,默认从1开始。
{eyou:arclist typeid='文档ID' limit='0,5'}
{$key} - {$i}
{/eyou:arclist}
效果:
0 - 1
1 - 2
2 - 3
3 - 4
4 - 5
\-------------------------------示例4--------------------------------
描述:没有记录时输出文案提示,属性empty支持直接传入html语法(html里只支持双引号,禁止单引号)
{eyou:arclist typeid='文档ID' limit='0,10' empty='暂时没有数据'}
> {$field.title}
{/eyou:arclist}
\-------------------------------示例5--------------------------------
描述:自定义变量名
{eyou:arclist typeid='文档ID' limit='0,10' id='field2'}
{$field2.title}
{/eyou:arclist}
typeid='' 栏目ID,在列表模板和内容页模板中一般不需要指定,在首页模板中允许用","分开表示多个栏目,但必须是同一个模型下的多个栏目ID,比如:文章模型、产品模型、图集模型等;
- 序言
- 基础使用
- 如何安装
- 安装 Eyoucms
- 本地安装运行环境
- 栏目管理
- 栏目类型介绍
- 如何管理栏目
- 如何设置栏目
- 页面设置
- 网站基本信息设置
- 内容管理
- 添加发布内容
- 发布内容管理
- 留言内容管理
- 后台指南
- 邮箱发送配置
- 配置支持生成静态功能
- 去掉URL中的index.php
- 企业认证小程序
- 留言模型验证码调用
- 通用微信小程序
- 留言表单如何使用上传功能
- 手机站域名的正确配置方式
- 文档评论插件
- 微信分享插件
- 百度分享插件
- 中文简繁体切换插件
- 蜘蛛访问统计插件
- ip访问限制插件
- 短信配置
- 微信扫码登录插件
- QQ登录插件
- 微信支付配置、网页授权、获取收货地址
- 文档定时发布插件
- 留言表单属性的手机号码、邮箱地址的格式验证
- 百度智能小程序
- 标签手册
- 全局标签
- arclist 文档列表
- channel 获取栏目列表标签
- channelartlist 当前频道循环标签
- type 指定栏目调用标签
- include 导入指定模板文件标签
- arcview 单条文档调用标签
- position 面包屑标签
- assign 模板文件中定义变量标签
- empty 判断变量是否为空标签
- notempty 判断变量不为空标签
- foreach 数据循环输出标签
- volist 数据循环输出标签
- if 条件判断标签
- switch 条件判断标签
- compare 比较标签
- adv 广告列表标签
- load 加载资源文件标签
- global 全局配置变量标签
- field 获取channelartlist标签的字段值
- tag TAG调用标签
- searchform 搜索标签
- 标签常用函数
- flink 友情链接
- weapp 网站应用插件标签
- range 范围判断标签
- for 数据循环输出标签
- ad 单条广告调用标签
- attribute 栏目属性列表
- user 登录注册标签
- diyurl 内置URL调用标签
- php php标签
- 列表标签
- list 列表数据标签
- pagelist 列表分页标签
- arcpagelist 瀑布流分页列表
- screening 筛选标签
- 内容标签
- arcclick 文档浏览量
- guestbookform 留言表单标签
- prenext 获取上一篇、下一篇内容
- downcount 文档下载次数
- likearticle 相关文档
- 更多附加标签
- 装修标签
- ui 模板可视化标签
- uitext 纯文本可视化标签
- uihtml 带html富文本可视化标签
- uiupload 图片上传可视化标签
- uitype 单个栏目可视化标签
- uiarclist 文档列表可视化标签
- uichannel 栏目列表可视化标签
- 多语言标签
- language 多语言列表标签
- lang 语言包变量标签
- 插件开发
- 易优CMS数据字典
- 易优CMS目录结构
- 插件规范与结构说明
- 插件common.php全局函数文件
- 插件config.php配置文件
- 插件html.php页面缓存配置
- 插件route.php路由配置
- 插件制作教程指南
- 模板制作
- 准备工作
- 标签用法
- 页面引用