如何在Echo框架中获取模板渲染结果并以JSON返回供AJAX调用

问题1：有没有办法在Echo框架中获取模板渲染的结果？ #

可以实现。通过自定义模板渲染器，在执行模板渲染时先将结果写入内存缓冲区，再把缓冲区的字符串内容存入Echo的上下文（Context）中，后续就能从上下文里取出渲染好的内容。

你提供的示例代码已经采用了这个思路：在自定义的Render方法里，用bytes.Buffer捕获模板执行后的输出，再通过c.Set("tmpl", buf.String())将内容存入上下文，之后通过c.Get("tmpl")就能获取到渲染结果。

问题2：如何将模板渲染的结果赋值并以JSON形式返回，用于AJAX调用？ #

基于上述获取渲染结果的方式，将结果封装成JSON结构返回即可。不过要注意，手动拼接JSON容易因特殊字符导致格式错误，建议用encoding/json包进行标准序列化。

优化后的代码示例 #

自定义模板渲染器

func (t *TemplateRenderer) Render(w io.Writer, name string, data interface{}, c echo.Context) error {
    var buf bytes.Buffer

    // 执行模板渲染到内存缓冲区
    err := t.templates.ExecuteTemplate(&buf, name, data)
    if err != nil {
        return err
    }

    // 将渲染结果存入上下文
    c.Set("tmpl", buf.String())

    // AJAX场景无需输出HTML到响应体，直接返回nil
    return nil
}

请求处理函数

func Load(c echo.Context) error {
    params := map[string]any{
        "btn_style":  "btn-light btn-sm",
    }
    
    // 触发模板渲染，结果会存入上下文
    if err := c.Render(http.StatusOK, "test.tmpl", params); err != nil {
        return err
    }
    
    // 从上下文取出渲染内容，同时做类型检查
    tmplContent, ok := c.Get("tmpl").(string)
    if !ok {
        return echo.NewHTTPError(http.StatusInternalServerError, "获取模板渲染内容失败")
    }
    
    // 用标准库生成合法JSON返回
    return c.JSON(http.StatusOK, map[string]string{
        "payload": tmplContent,
    })
}

关键提示 #

• AJAX场景下，自定义渲染器不需要再把结果输出到响应体（即去掉原代码中return t.templates.ExecuteTemplate(w, name, data)），因为我们最终要返回的是JSON格式数据，而非HTML页面。
• 避免手动拼接JSON字符串，encoding/json会自动处理渲染内容中的双引号、换行符等特殊字符，确保JSON格式合法。
• 从上下文取值时添加类型断言检查，能避免类型不匹配导致的程序崩溃。

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