我的知识记录

易优EyouCMS artlist 标签示例与使用详解

🧾 简介

{eyou:artlist} 是易优EyouCMS中用于获取文档列表的核心标签之一，常用于首页、栏目页或内容页中展示文章、产品、图集等内容模型的列表数据。
该标签支持多种属性设置，如排序、筛选、分页（配合 {eyou:arcpagelist} 实现 AJAX 瀑布流分页）等，功能强大且灵活。

📌 基础用法


 
html
{eyou:artlist typeid='2' limit='0,10' titlelen='30'} <a href="{$field.arcurl}">{$field.title}</a> {/eyou:artlist}
✅ 说明：调用栏目ID为2的文章，显示前10条，标题长度限制为30个字符。

⚙️ 主要属性说明

属性名 可选值/说明
typeid 指定栏目ID，多个栏目用逗号分隔（需同模型），如：typeid='1,2,3'
notypeid 排除指定栏目ID
tagid 配合 {eyou:arcpagelist} 使用，实现AJAX瀑布流分页
limit 限定记录范围，格式：起始ID,数量，如：limit='0,10'
loop 返回文档总数，不建议与 limit 同时使用
titlelen 标题长度限制
infolen 内容简介长度限制
orderby 排序方式：<br>hot（点击量）、add_time（发布时间）、update_time（更新时间）、aid（ID）、sort_order（排序号）、rand（随机）等
ordermode 排序类型：desc（降序）、asc（升序）
flag 文档属性筛选，如推荐 [c]、跳转 [j] 等
noflag 排除指定属性
keyword 关键词匹配，多个关键词用逗号分隔
modelid 指定模型ID，优先级高于栏目ID
thumb 是否启用缩略图：on / off
arcrank 是否展示阅读权限信息：on / off
empty 当无数据时显示的内容（支持HTML）
mod 每隔N行输出特定内容，常用于样式控制
id 自定义变量名，默认是 field，避免嵌套冲突

🧩 示例说明

示例1：每隔3条输出文档记录


 
html
{eyou:artlist typeid='2' limit='0,10' mod='3'} {eyou:eq name='mod' value='0'} <a href='{$field.arcurl}'>{$field.title}</a> {/eyou:eq} {/eyou:artlist}

示例2：每隔3条添加CSS类名


 
html
{eyou:artlist typeid='2' limit='0,10' mod='3'} <li {eyou:eq name='mod' value='0'}class="highlight"{/eyou:eq}> <a href='{$field.arcurl}'>{$field.title}</a> </li> {/eyou:artlist}

示例3：输出索引和顺序编号


 
html
{eyou:artlist typeid='2' limit='0,5'} {$key} - {$i} {/eyou:artlist}
  • $key：从0开始的索引；
  • $i：从1开始的顺序编号；

示例4：无数据时显示提示语


 
html
{eyou:artlist typeid='2' limit='0,10' empty='暂时没有数据'} <a href='{$field.arcurl}'>{$field.title}</a> {/eyou:artlist}

示例5：自定义字段调用（如价格、规格）


 
html
{eyou:artlist typeid='2' addfields='price,spec' id='field2'} <p>{$field2.title} - 价格：{$field2.price} 规格：{$field2.spec}</p> {/eyou:artlist}

示例6：显示会员等级信息


 
html
{eyou:artlist typeid='2' arcrank='on'} 会员等级名称：{$field.level_name}<br/> 会员等级值：{$field.level_value} {/eyou:artlist}

🔄 高级用法：配合 arcpagelist 实现 AJAX 瀑布流分页


 
html
<!-- artlist 列表 --> {eyou:artlist typeid='2' tagid='waterfall_list' limit='0,10'} <div class="item"> <a href="{$field.arcurl}"><img src="{$field.litpic}" /></a> <h3>{$field.title}</h3> </div> {/eyou:artlist} <!-- 分页按钮 --> {eyou:arcpagelist tagid='waterfall_list' listsize='2'} <div class="load-more">加载更多</div> {/eyou:arcpagelist}
✅ 功能说明：
  • tagid 必须一致；
  • listsize 表示每次加载多少条；
  • 结合 JS 可实现无限滚动加载效果；

📁 数据库字段参考（ey_archives 表）

字段名 描述
aid 文档ID
typeid 所属栏目ID
title 标题
litpic 缩略图地址
arcurl 文档链接
click 点击数
level_name 会员等级名称
level_value 会员等级值
add_time 添加时间
update_time 更新时间
flag 文档属性标记
arcrank 阅读权限等级

📝 温馨提示

  • 修改模板后请清除缓存或重新生成静态页面；
  • 若开启了伪静态，请确保分页URL可正常访问；
  • 使用 mod 和 id 属性时注意避免嵌套冲突；
  • 如需更复杂的查询逻辑，可通过 SQL 查询或插件扩展实现。

标签：

更新时间：2025-05-06 09:47:48

上一篇：易优EyouCMS 升级至 1.6.9 版本提示报错的解决方法

下一篇：易优EyouCMS 模板目录结构与文件说明（2024年更新）

转载请注明原文链接：https://www.muzicopy.com/suibi/11506.html

关注热点