一、指定内容多图遍历基础用法
| 项目 |
说明 |
| 适用范围 |
全站任意地方均可使用 |
| 标签作用 |
依次输出指定内容的多张图片 |
| 基本语法 |
{pboot:pics id=* num=*} ... {/pboot:pics} |
| 示例代码 |
<img src="[pics:src]" alt="[pics:title]"> |
二、控制参数说明
| 参数名称 |
说明 |
是否必填 |
默认值 |
id=* |
内容ID号，用于控制需要输出图片的内容<br>支持自适应写法如 id={content:id} 或 id=[list:id] |
是 |
无 |
num=* |
输出图片的数量，非必填 |
否 |
输出所有图片 |
field=* |
多图字段名称（V3.1.0+），默认为系统默认的多图字段 pics |
否 |
pics |
三、可使用的多图标签分类
1. 序号类
| 标签 |
含义 |
[pics:n] |
图片序号，从0开始计数 |
[pics:i] |
图片序号，从1开始计数 |
2. 图片信息类
| 标签 |
含义 |
[pics:src] |
图片地址 |
[pics:title] |
图片标题（V3.0.6+） |
四、注意事项
- 域名处理：所有图片地址（如
[pics:src]）均以 域名/ 替代具体网址。
- 扩展字段：如果使用非默认的多图字段，请务必在
field=* 参数中指定字段名称。
- 图片数量控制：
num=* 参数可以限制输出图片的数量，若不填写则默认输出所有图片。
- 自适应写法：
id={content:id} 和 id=[list:id] 可根据当前内容或列表动态适配，简化代码逻辑。
五、示例场景
场景1：输出指定内容的所有图片
{pboot:pics id=1}
<img src="[pics:src]" alt="[pics:title]">
{/pboot:pics}
场景2：输出指定内容的前3张图片
{pboot:pics id=1 num=3}
<img src="[pics:src]" alt="[pics:title]">
{/pboot:pics}
场景3：使用扩展字段输出图片
{pboot:pics id=1 field=custom_pics}
<img src="[pics:src]" alt="[pics:title]">
{/pboot:pics}
