易优eyoucms程序 范围判断(range)标签使用说明
一、标签基础说明
- 标签名称:
{eyou:range}{/eyou:range}
- 作用:用于在模板中对变量进行范围判断,支持
in
、notin
、between
、notbetween
四种判断类型 - 适用场景:根据栏目ID、文章ID或其他变量值控制内容显示逻辑,如不同栏目展示不同模板样式等
二、使用语法
smarty
{eyou:range name='$eyou.field.typeid' value='1,2,3,4' type='in'} <!-- 当 typeid 在 1,2,3,4 范围内时输出的内容 --> 这是栏目ID为1~4的页面内容 {/eyou:range}
三、属性说明
属性名 | 必填 | 说明 |
---|---|---|
name |
是 | 要判断的变量,例如 $eyou.field.typeid 、$eyou.global.web_status 等 |
value |
是 | 判断的范围值,格式如下:<br> - in/notin :逗号分隔的多个值,如 '1,2,3,4' <br> - between/notbetween :两个值之间,用逗号分隔,如 '1,10' 表示 1~10 |
type |
是 | 判断类型,可选值如下:<br> - in :变量值在指定列表范围内<br> - notin :变量值不在指定列表范围内<br> - between :变量值在指定区间范围内<br> - notbetween :变量值不在指定区间范围内 |
四、使用示例
示例1:判断栏目ID是否在指定列表中(type='in')
smarty
{eyou:range name='$eyou.field.typeid' value='1,2,3,4' type='in'} <p>当前栏目属于推荐栏目</p> {/eyou:range}
示例2:判断栏目ID不在指定列表中(type='notin')
smarty
{eyou:range name='$eyou.field.typeid' value='5,6,7' type='notin'} <p>当前栏目不属于特殊栏目</p> {/eyou:range}
示例3:判断文章ID在某个区间(type='between')
smarty
{eyou:range name='$eyou.field.id' value='100,200' type='between'} <p>该文章ID在100到200之间</p> {/eyou:range}
示例4:判断文章ID不在某个区间(type='notbetween')
smarty
{eyou:range name='$eyou.field.id' value='300,400' type='notbetween'} <p>该文章ID不在300到400之间</p> {/eyou:range}
五、注意事项
value
的值必须为字符串格式,多个值之间用英文逗号,
分隔;between
和notbetween
支持数字和字符串比较,但建议统一为数字类型;- 变量
name
必须以$
开头,表示模板变量; - 该标签可用于控制区块显示、切换模板片段、动态加载资源等逻辑处理。
六、典型应用场景
场景描述 | 使用方式 |
---|---|
栏目页差异化展示 | 判断栏目ID是否在特定范围内,展示不同的头部或侧边栏模块 |
文章分类处理 | 判断文章ID是否在某区间,决定是否显示广告、推荐内容等 |
权限控制 | 判断用户角色ID是否在允许访问的范围内 |
模块开关控制 | 结合全局变量,判断是否开启某功能模块 |
七、总结
{eyou:range}
标签是一个非常实用的条件判断工具,适用于各种需要根据变量值范围进行逻辑判断的场景。通过灵活组合 in
、notin
、between
、notbetween
类型,可以实现复杂的模板控制逻辑,提升网站开发效率与灵活性。
✅ 推荐结合{eyou:if}
、{eyou:else}
等条件标签一起使用,构建更完整的模板逻辑控制体系。
更新时间:2025-05-06 10:38:43
上一篇:易优eyoucms程序 应用插件(weapp)调用说明