Golang Echo Labstack框架如何在模板视图中调用自定义函数/方法

Go标准库html/template要求自定义函数必须在模板解析前完成注册，Echo没有封装独立的函数注册接口，直接在自定义模板渲染器初始化阶段按标准库规则配置即可，和你在Gin中使用的逻辑完全兼容。

具体实现步骤 #

• 第一步：定义自定义函数映射，和Gin中使用的template.FuncMap格式完全一致

import "html/template"

// 全局模板自定义函数映射
var templateFuncs = template.FuncMap{
    "AddTS":            util.AddTS,
    "Encrypt":          util.EncryptGeneral,
    "CombineVariable":  util.CombineVariable,
    // 其余自定义函数可直接追加在此处
}

• 第二步：修改模板渲染器初始化逻辑，严格遵循先注册函数、后解析模板的顺序

func main() {
    e := echo.New()

    // 初始化模板：先创建空模板实例，绑定函数映射后再解析模板文件
    tplEngine := template.New("")
    // 注册所有自定义函数
    tplEngine = tplEngine.Funcs(templateFuncs)
    // 解析模板文件，该步骤必须放在Funcs调用之后，否则会报函数找不到错误
    tplEngine = template.Must(tplEngine.ParseGlob("templates/*/*.tmpl"))

    // 初始化渲染器
    renderer := &TemplateRenderer{
        templates: tplEngine,
    }
    e.Renderer = renderer

    e.Static("/static", "static")
    
    e.Use(middleware.Logger())
    e.Use(middleware.Recover())
    e.Logger.Fatal(e.Start(":8183"))
}

你原有TemplateRenderer的Render方法不需要修改，其中动态注入的reverse路由反向生成函数和全局自定义函数互不冲突，可以正常使用。

模板调用方式 #

和你在Gin框架中的写法完全一致，不需要调整原有模板代码：

{{ range .Data }}
    <div>
        {{ .data_value | AddTS }}
        {{ .data_value | Encrypt }}
    </div>
{{ end }}

注意事项 #

• 禁止调换Funcs()和ParseGlob/ParseFiles的调用顺序，否则模板解析阶段会抛出找不到函数的panic
• 自定义函数遵循标准库模板规则：支持返回单个值，或返回「值+error」两个返回值
• 如果需要加载多个目录下的模板文件，在绑定完函数映射后依次调用ParseGlob解析对应路径即可

内容的提问来源于stack exchange，提问作者Charas