讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

Gin框架怎么在模板中循环展示多张图片链接

梦宇同学_2272

梦宇同学_2272

发布时间:2026-11-19 05:41:03

|

498人浏览过

|

来源于php中文网

原创

Gin模板中需用{{range}}遍历图片URL切片,后端须传[]string或导出字段结构体(如URL首字母大写),不可传逗号分隔字符串;空切片或nil时{{range}}自动跳过,加{{if}}或{{with}}可处理“暂无图片”提示;用户输入URL须在后端校验scheme并过滤伪协议,模板不负责安全校验。

gin框架怎么在模板中循环展示多张图片链接

模板里用 {{range}} 遍历图片 URL 列表

Gin 默认用 Go 的 html/template,不支持数组索引访问或内联表达式,必须靠 {{range}} 遍历切片。你传入的图片链接得是 []string 或 []struct{URL string} 这类可 range 的类型,不能是逗号分隔的单个字符串。

常见错误:后端把图片链接拼成 "a.jpg,b.jpg,c.jpg" 传过去,模板里写 {{.Images}} 只会原样输出一长串,{{range .Images}} 会报 range can't iterate over string。

  • 后端要传切片:c.HTML(200, "index.html", gin.H{"images": []string{"1.jpg", "2.jpg", "3.jpg"}})
  • 模板里写:
    {{range .images}}<img src="{{.}}" alt=""/>{{end}}
  • 如果结构体字段名是大写(如 URL),模板中必须用 .URL;小写字段(如 url)在模板里不可见,会被忽略

图片带标题或额外字段时用结构体 + {{.FieldName}}

单纯展示链接够用,但加 caption、宽高、alt 文字等就得用结构体。Gin 不限制传什么类型,只要字段首字母大写且可导出,模板就能访问。

容易踩的坑:字段名拼错、忘记大写、或用 map[string]interface{} 时 key 写成小写导致模板取不到值。

  • 定义结构体:
    type ImageItem struct { URL, Alt, Caption string }
  • 传参:c.HTML(200, "index.html", gin.H{"items": []ImageItem{{URL: "a.jpg", Alt: "猫"}, {URL: "b.jpg", Alt: "狗"}}})
  • 模板:
    {{range .items}}<figure><img src="{{.URL}}" alt="{{.Alt}}"/><figcaption>{{.Caption}}</figcaption></figure>{{end}}

空列表时怎么避免渲染空白或报错

{{range}} 遇到 nil 或空切片会直接跳过,不执行内部内容,这是安全的。但如果你希望显示“暂无图片”提示,得用 {{with}} 或 {{if}} 包一层。

注意:{{if .images}} 对 nil 切片返回 false,对空切片([]string{})返回 true —— 这点常被忽略,导致空列表时仍进 if 分支却 range 不出内容。

Gin框架 1.9.0
Gin框架 1.9.0

Gin框架 1.9.0版本源码包下载,版本号 1.9.0,适合需要 sonic JSON 支持、路由修复和内容协商改进的 Go Web 开发场景。

下载
  • 稳妥写法(兼容 nil 和空切片):
    {{if .images}}{{range .images}}<img  src="{{.}}" alt="Gin框架怎么在模板中循环展示多张图片链接" >{{end}}{{else}}<p>暂无图片</p>{{end}}
  • 或者用 {{with}}(它对空切片也视为 false):
    {{with .images}}{{range .}}<img  src="{{.}}" alt="Gin框架怎么在模板中循环展示多张图片链接" >{{end}}{{else}}<p>暂无图片</p>{{end}}

Gin 传参时别漏掉 html.EscapeString 风险

图片 URL 如果来自用户输入(比如表单上传后存的路径),直接塞进模板可能触发 XSS —— 虽然 html/template 默认会对 {{.}} 做 HTML 转义,但它**不会校验 URL 格式**。如果 URL 是 javascript:alert(1) 或 " onerror="alert(1),放进 src 仍可能执行。

所以关键不是模板怎么做,而是后端要提前过滤:

  • 只允许 http://、https://、/ 开头的 URL,其他一律丢弃或替换为占位图
  • 用 net/url.Parse 检查 scheme 是否合法,避免伪协议
  • 不要依赖前端或模板层做安全控制,Gin 渲染前就该把不可信数据清洗掉

模板本身没能力救这种问题,{{.URL | safeURL}} 这类自定义函数容易误用,不如在传参前就掐死非法值。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
Golang Beego框架
Golang Beego框架

本专题聚焦 Golang 全栈式 Web 框架 Beego 的学习与实战,内容涵盖 MVC 模式、路由控制、ORM 数据库操作、模块化开发、日志管理与 RESTful API 构建。通过企业管理系统、电商后端与微服务架构等实战案例,帮助学员掌握使用 Beego 高效开发企业级应用的核心能力。

4380

2025.08.27

go语言 beego框架
go语言 beego框架

本专题整合了go语言中beego框架相关内容,阅读专题下的文章了解更多详细内容。

8381

2025.09.10

Go Web框架Gin接口开发与中间件设计实践
Go Web框架Gin接口开发与中间件设计实践

本专题围绕 Go 在 Web 后端开发中的主流框架 Gin 展开,系统讲解高性能接口开发与中间件机制设计。内容涵盖路由分组、请求绑定、参数校验、统一响应封装、日志与鉴权中间件实现,以及接口限流与异常处理策略。通过实战项目案例,帮助开发者构建结构清晰、性能优良的 Go Web 服务体系,提升接口开发效率与系统可维护性。

377

2026.03.19

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

0

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn