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

梦宇同学_2272

梦宇同学_2272

2026-11-19

498人浏览

原创

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}}@@##@@{{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>@@##@@<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}}@@##@@{{end}}{{else}}<p>暂无图片</p>{{end}}
  • 或者用 {{with}}(它对空切片也视为 false):
    {{with .images}}{{range .}}@@##@@{{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}} 这类自定义函数容易误用,不如在传参前就掐死非法值。

{{.Alt}}

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Golang Beego框架
Golang Beego框架

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

2025.08.27

4380

8

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

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

2025.09.10

8381

12

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

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

2026.03.19

377

21

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

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

2026.11.17

0

15

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

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

2026.11.17

20

15

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

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

2026.11.17

0

15

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

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

2026.11.17

0

10

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

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

2026.11.17

0

11

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

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

2026.11.17

0

16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gin框架快速入门指南
Gin框架快速入门指南

共0课时 | 0人学习

Gin框架官方中文文档
Gin框架官方中文文档

共0课时 | 0人学习

Go语言Gin框架全套实战教程
Go语言Gin框架全套实战教程

共0课时 | 0人学习