编辑“︁Gin模板包含”︁

{{DISPLAYTITLE:Gin模板包含}}

== 概述 ==
'''Gin模板包含'''是Gin框架中实现HTML模板复用的一种核心机制，允许开发者通过<code>{{`{{ template }}`}}</code>指令将公共模板片段（如页眉、页脚、导航栏）嵌入到多个页面中，遵循[[wikipedia:Don't_repeat_yourself|DRY原则]]。该功能基于Go标准库的<code>html/template</code>包实现，支持动态数据绑定与嵌套逻辑。

== 基础语法 ==
Gin模板包含通过以下语法实现：
<syntaxhighlight lang="go">
{{`{{ template "模板名称" . }}`}}
</syntaxhighlight>
* <code>"模板名称"</code>：被包含模板的文件名（不带扩展名）
* <code>.</code>：传递当前作用域的上下文数据

=== 示例目录结构 ===
<mermaid>
graph TD
    A[templates/] --> B[base.html]
    A --> C[header.html]
    A --> D[footer.html]
    A --> E[home.html]
</mermaid>

== 实现步骤 ==

=== 1. 定义基础模板 ===
创建<code>base.html</code>作为布局框架：
<syntaxhighlight lang="html">
<!DOCTYPE html>
<html>
<head>
    <title>{{`{{ .Title }}`}}</title>
</head>
<body>
    {{`{{ template "header" }}`}}
    <main>
        {{`{{ template "content" . }}`}}
    </main>
    {{`{{ template "footer" }}`}}
</body>
</html>
</syntaxhighlight>

=== 2. 创建子模板 ===
'''header.html'''（注意无需定义<code>define</code>）：
<syntaxhighlight lang="html">
<header>
    <h1>网站导航</h1>
    <nav>...</nav>
</header>
</syntaxhighlight>

'''home.html'''（必须用<code>define</code>声明）：
<syntaxhighlight lang="html">
{{`{{ define "content" }}`}}
    <h2>欢迎页面</h2>
    <p>当前用户：{{`{{ .Username }}`}}</p>
{{`{{ end }}`}}
</syntaxhighlight>

=== 3. 加载模板（Gin代码） ===
<syntaxhighlight lang="go">
router := gin.Default()
router.LoadHTMLGlob("templates/*.html") // 加载所有HTML模板

router.GET("/", func(c *gin.Context) {
    c.HTML(200, "base.html", gin.H{
        "Title":    "首页",
        "Username": "访客",
    })
})
</syntaxhighlight>

== 高级用法 ==

=== 嵌套包含 ===
支持多级模板嵌套，例如在<code>product.html</code>中复用组件：
<syntaxhighlight lang="html">
{{`{{ define "content" }}`}}
    {{`{{ template "product_header" }}`}}
    <div class="details">...</div>
{{`{{ end }}`}}
</syntaxhighlight>

=== 数据传递 ===
通过<code>.</code>传递不同层级的数据：
<syntaxhighlight lang="go">
c.HTML(200, "base.html", gin.H{
    "Title": "产品页",
    "Product": map[string]interface{}{
        "Name":  "Go编程书",
        "Price": 99.9,
    },
})
</syntaxhighlight>

在模板中访问：
<syntaxhighlight lang="html">
{{`{{ .Product.Name }}`}} - 价格：{{`{{ .Product.Price }}`}}元
</syntaxhighlight>

== 错误处理 ==
常见问题及解决方案：

{| class="wikitable"
|-
! 错误类型 !! 解决方案
|-
| <code>template: no template "header"</code> || 确保模板文件扩展名与加载模式匹配（如<code>*.html</code>）
|-
| 变量未渲染 || 检查数据键名是否匹配，确保传递了<code>.</code>上下文
|-
| 模板循环引用 || 避免A包含B，B又包含A的死循环
|}

== 性能优化 ==
* 使用<code>router.SetHTMLTemplate(tpl *template.Template)</code>预编译模板
* 开发环境禁用模板缓存：<code>gin.SetMode(gin.DebugMode)</code>
* 对频繁变动的模板部分使用<code>{{`{{ block }}`}}</code>指令

== 实际案例 ==
'''电商网站模板结构'''：
<mermaid>
graph TB
    subgraph 模板组
        A[layout.html] --> B[header.html]
        A --> C[product_card.html]
        A --> D[cart_summary.html]
        E[category.html] -.->|嵌入| C
        F[search.html] -.->|复用| D
    end
</mermaid>

实现代码片段：
<syntaxhighlight lang="html">
<!-- product_card.html -->
<div class="card">
    <img src="{{`{{ .ImageURL }}`}}">
    <h3>{{`{{ .Name }}`}}</h3>
    {{`{{ template "price_tag" .Price }}`}}
</div>
</syntaxhighlight>

== 数学公式支持 ==
当需要计算模板中的动态值时（如折扣率）：
<math>
\text{折扣价} = \begin{cases} 
\text{原价} \times 0.8 & \text{if VIP等级} \geq 3 \\
\text{原价} \times 0.9 & \text{otherwise}
\end{cases}
</math>

== 参见 ==
* [[Gin框架模板基础]]
* [[Go模板条件语句]]
* [[前端组件化开发]]

[[Category:后端框架]]
[[Category:Gin]]
[[Category:Gin模板渲染]]