PbootCMS指定内容多图调取与标签详解

一、指定内容多图遍历基础用法

项目	说明
适用范围	全站任意地方均可使用
标签作用	依次输出指定内容的多张图片
基本语法	{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+）

---

四、注意事项

1. 域名处理：所有图片地址（如 [pics:src]）均以 域名/ 替代具体网址。
2. 扩展字段：如果使用非默认的多图字段，请务必在 field=* 参数中指定字段名称。
3. 图片数量控制：num=* 参数可以限制输出图片的数量，若不填写则默认输出所有图片。
4. 自适应写法：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}