讲师中心 微信公众号
AI工具推荐 视频效率加速

Revel框架模板传值教程:Render参数与变量输出

千浩大大_9958

千浩大大_9958

发布时间:2026-10-16 11:31:25

|

471人浏览过

|

来源于php中文网

原创

Revel模板传参需用Render传命名参数或map/结构体,变量须导出;输出用{{.x}}自动转义,遍历前须判空;range双变量解构需dict或map传参,自定义变量名必须加$前缀。

revel框架模板传值教程:render参数与变量输出 - php中文网

在Revel框架中向HTML模板传递数据时,必须明确Render方法如何接收参数、模板中如何引用这些值,否则会出现变量未定义或渲染为空的问题。

控制器中调用Render传参的两种写法

方法一:直接传入多个命名参数(推荐)
在控制器action中写:c.Render("title", "首页", "users", users, "count", len(users))。Revel会自动将每对参数转为键值对存入c.RenderArgs,模板中可直接用{{.title}}、{{.users}}访问。

方法二:传入结构体或map
调用c.Render(map[string]interface{}{"title": "首页", "data": data})。此时模板根上下文就是该map,必须用{{.title}}访问,不能省略点号;若传结构体,则字段必须首字母大写且有导出权限。

【传参时若使用未导出字段(小写开头)或nil切片,模板中对应变量将为空且不报错】

模板中安全输出变量的三类写法

基础输出:{{.title}} 直接渲染字符串,无转义。适用于已知安全内容,如页面标题。

HTML转义输出:{{.content | safe}} → 错误写法。safe不是内置函数,Revel默认不注册该函数。正确做法是用{{.content}}(自动HTML转义),或改用{{.RawContent}}(需控制器提前赋值为template.HTML类型)。

条件判空后输出:
{{if .items}}
  {{range .items}}
    

{{.Name}}


  {{end}}
{{else}}
  

暂无数据

Revel框架 0.19.0
Revel框架 0.19.0

Revel框架 0.19.0 版本源码包下载,适合关注 Referrer-Policy、vendor 识别、Gorp 事务抽象和 CSRF 修复的开发团队。

下载


{{end}}
这一步必须加{{if .items}},否则当.items为nil时模板执行会panic。

遍历切片并同时传递索引与元素给子模板

第一步:在控制器中确保传入的是非nil切片
func (c App) List() revel.Result {
  templates := []string{"header", "main", "footer"}
  return c.Render(templates)
}

第二步:主模板中用双变量range解构
{{if .}}
{{range $i, $t := .}}
  {{template "item.html" (dict "Index" $i "Value" $t)}}
{{end}}
{{end}}

第三步:子模板item.html中接收并使用

{{$Value}}


注意:dict函数需在app/init.go中手动注册,否则此处会报错“function \"dict\" not defined”。

第四步:若未注册dict,改用map字面量(Go 1.18 +支持)
{{template "item.html" (map "Index" $i "Value" $t)}}

避免变量名冲突的关键细节

模板中不要用和控制器传入参数同名的range变量,例如控制器传了{{.Index}},就不要再写{{range $Index, $Item := .List}}——否则内层的$Index会覆盖外层的.Index值。

所有自定义变量名前必须加$,如{{$i}},否则在嵌套{{with}}或{{range}}块中会被静默覆盖,导致后续逻辑读到错误值。

如果子模板需要同时访问当前元素和全局参数(如.PageTitle),必须显式传入:{{template "sub.html" (dict "Item" $t "Title" $.PageTitle)}},其中$.表示根上下文。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

Lovart
Lovart Hot

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

立刻MV
立刻MV Hot

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

蛙蛙写作

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

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

豆包大模型

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

相关专题

更多
Golang Beego框架
Golang Beego框架

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

3320

2025.08.27

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

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

6681

2025.09.10

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

0

2026.10.15

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

0

2026.10.15

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

0

2026.10.15

C++ 开发环境怎么搭建
C++ 开发环境怎么搭建

C++开发环境专题汇集Windows、Linux下的编译器与IDE安装配置教程,涵盖GCC、Clang、Visual Studio、CLion和VS Code,以及编译运行首个程序的步骤。

0

2026.10.15

Python 虚拟环境是什么
Python 虚拟环境是什么

Python虚拟环境专题介绍项目依赖隔离的作用,汇集venv与uv创建、激活、退出及解释器切换的相关文章,并覆盖Windows、Linux和VS Code中的常见配置问题。

0

2026.10.15

Python 怎么安装并配置环境变量
Python 怎么安装并配置环境变量

Python安装与环境变量配置专题汇集Windows、macOS和Linux的安装步骤、PATH设置、pip配置及常见报错排查文章,帮助完成解释器安装并验证命令行可以正常运行。

0

2026.10.15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Revel 官方入门教程
Revel 官方入门教程

共0课时 | 0人学习

Revel 官方开发手册
Revel 官方开发手册

共0课时 | 0人学习

Revel 官方开发手册
Revel 官方开发手册

共0课时 | 0人学习

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

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