首页/开发手册/内容多图遍历标签

开发手册

SoeayCMS 安装、标签使用与二次开发完整指南

内容多图遍历标签

内容多图遍历标签

内容多图遍历标签({soeay:pics})用于遍历当前内容的多图字段,输出每张图片的地址和标题。该标签只能在内容详情页中使用,自动读取当前内容的多图数据。

基本语法

{soeay:pics}
    <div class="gallery-item">
        <img src="[soeay:pic]" alt="[soeay:title]">
        <p>[soeay:title]</p>
    </div>
{/soeay:pics}

可用变量

变量说明
[soeay:pic]图片地址
[soeay:url]图片地址(与 pic 相同)
[soeay:title]图片标题(从 picstitle 字段获取)
[soeay:i] / [soeay:num]循环序号,从1开始

使用场景

通常在「内容详情页模板」中配合 {soeay:content} 或 {soeay:content.title} 使用,用于展示产品图集、案例图片、新闻配图等多图内容。多图数据在后台内容编辑页的「多图上传」区域维护。

注意事项

  • {soeay:pics} 不支持 id、num、order 等属性,它自动读取当前内容详情页 viewData 中的多图数据。
  • 如果当前内容没有上传多图,该标签输出空字符串,建议配合 {soeay:if} 判断后展示占位提示。
  • 图片标题可能为空,输出前建议判断 [soeay:title] 是否非空。