layout
模板设计;define/template
标签支持跨模板调用(同一模板路径包括子目录下的模板文件);include
标签支持任意路径的模板文件引入;通用视图管理即使用原生的模板引擎gview
模块来实现模板管理,包括模板读取展示,模板变量渲染等等。可以使用通过方法gview.Instance
来获取视图单例对象,并可以按照单例对象名称进行获取。同时也可以通过对象管理器g.View()
来获取默认的单例gview
对象。
接口文档:
https://pkg.go.dev/github.com/gogf/gf/v2/os/gview
简要说明:
gview.Get
用于根据给定的一个模板目录路径,获得对应的单例模板引擎对象;gview.New
同样可以根据给定的模板目录路径创建模板引擎对象,但没有单例管理;SetPath/AddPath
用于设置/添加当前模板引擎对象的模板目录路径,其中SetPath
会覆盖所有的模板目录设置,推荐使用AddPath
;Assign/Assigns
用于设置模板变量,通过该模板引擎解析的所有模板均可以使用这些模板变量;BindFunc
用于绑定模板函数,具体使用方法参考后续示例程序;Parse/ParseContent
用于解析模板文件/内容,可以在解析时给定临时的模板变量及模板函数;SetDelimiters
用于设置该模板引擎对象的模板解析分隔符号,默认为{{ }}
(与vuejs
前端框架有冲突);需要注意,从goframe v1.16
版本开始,所有模板的解析方法都额外增加了第一个输入参数为Context
上下文变量的传递。
index.tpl
id:{{.id}}, name:{{.name}}
main.go
package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/net/ghttp"
)
func main() {
s := g.Server()
s.BindHandler("/template", func(r *ghttp.Request) {
r.Response.WriteTpl("index.tpl", g.Map{
"id": 123,
"name": "john",
})
})
s.SetPort(8199)
s.Run()
}
执行后,访问 http://127.0.0.1:8199/template 可以看到解析后的内容为:id:123, name:john
package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/net/ghttp"
)
func main() {
s := g.Server()
s.BindHandler("/template", func(r *ghttp.Request){
tplContent := `id:{{.id}}, name:{{.name}}`
r.Response.WriteTplContent(tplContent, g.Map{
"id" : 123,
"name" : "john",
})
})
s.SetPort(8199)
s.Run()
}
执行后,访问 http://127.0.0.1:8199/template 可以看到解析后的内容为:id:123, name:john
在项目中我们经常会遇到Golang
默认模板变量分隔符号与Vue
的变量分隔符号冲突的情况(都使用的是{{ }}
),我们可以使用SetDelimiters
方法来自定义全局的Golang
模板变量分隔符号:
// main.go
package main
import (
"context"
"fmt"
"github.com/gogf/gf/v2/frame/g"
)
func main() {
v := g.View()
v.SetDelimiters("${", "}")
b, err := v.Parse(
context.TODO(),
"gview_delimiters.tpl",
map[string]interface{}{
"k": "v",
})
fmt.Println(err)
fmt.Println(b)
}
<!-- gview_delimiters.tpl -->
test.tpl content, vars: ${.}
执行后,输出结果为:
<nil>
test.tpl content, vars: map[k:v]
gf
框架的模板引擎支持非常灵活的多目录自动搜索功能,通过SetPath
可以修改模板目录为唯一的一个目录地址,同时,我们可以通过AddPath
方法添加多个搜索目录,模板引擎底层将会按照添加目录的顺序作为优先级进行自动检索。直到检索到一个匹配的文件路径为止,如果在所有搜索目录下查找不到模板文件,那么会返回失败。
默认目录配置:
gview
视图对象初始化时,默认会自动添加以下模板文件搜索目录:
template
目录:例如当前的工作目录为/home/www
时,将会添加/home/www
及/home/www/template
;template
目录:例如二进制文件所在目录为/tmp
时,将会添加/tmp
及/tmp/template
;main
源代码包所在目录及其下的template
目录(仅对源码开发环境有效):例如main
包所在目录为/home/john/workspace/gf-app
时,将会添加/home/john/workspace/gf-app
及/home/john/workspace/gf-app/template
;我们可以通过以下方式修改视图对象的模板文件搜索目录,视图对象将会只在该指定目录执行配置文件检索:
View
对象,通过SetPath
方法手动修改;gf.gview.path
;GF_GVIEW_PATH
;例如,我们的执行程序文件为main
,那么可以通过以下方式修改模板引擎的模板目录(Linux
下):
1、通过单例模式(推荐)
g.View().SetPath("/opt/template")
2、通过命令行参数
./main --gf.gview.path=/opt/template/
3、通过环境变量
GF_GVIEW_PATH=/opt/config/; ./main
genv
模块来修改环境变量:genv.Set("GF_GVIEW_PATH", "/opt/template")
模板引擎使用了精心设计的缓存机制,当模板文件第一次被读取后会被缓存到内存,下一次读取时将会直接从缓存中获取,以提高执行效率。并且,模板引擎提供了对模板文件的自动检测更新机制,当模板文件在外部被修改后,模板引擎能够即时地监控到并刷新模板文件的缓存内容。
生成值的汇总的另一个办法是为 QuerySet 的每一个对象生成独立汇总。比如,如果你想检索书籍列表,你可能想知道每一本书有多...
为什么 Django 使用自动提交在 SQL 规范中,每一个 SQL 查询会启动事务,除非一个事务已经处于活动状态。然后必须显式地提交或回...
WebSecurity - IsCurrentUser()WebSecurity 对象定义 IsCurrentUser() 方法把提供的用户名与已登录用户的用户名进行比较。C# 和 ...
WebSecurity 属性 - IsAuthenticatedWebSecurity 对象定义 IsAuthenticated 属性是一个布尔值,指示当前用户是否已通过身份验证...
ASP.NET TableRow HorizontalAlign 属性 TableRow 控件定义和用法 HorizontalAlign 属性用于设置或返回 TableRow 控件中内容的水...
ASP.NET HyperLink NavigateUrl 属性 HyperLink 控件定义和用法 NavigateURL 属性用于设置或返回 HyperLink 控件的 URL。 语法as...
ASP.NET Height 属性 Web 控件标准属性参考手册定义和用法 Height 属性用于设置或返回控件的高度。 语法asp:webcontrol id="id" ...
grid.tooltip.position |string, Array, Function提示框浮层的位置,默认不设置时位置会跟随鼠标的位置。可选:Array通过数组表...