术语表

局部模板装饰器(partial decorator)

充当包装组件的特殊局部模板。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 判断什么时候该用装饰器而不是普通局部模板,并知道被包裹的内容要注入到哪个位置

接着读:局部模板装饰器

局部模板装饰器(partial decorator)是一种特定类型的 partial template,充当 wrapper component。普通的局部模板只是在固定模板中渲染数据,而装饰器使用组合来包裹整块内容。它借助 templates.Inner 函数作为占位符,精确指定外部内容应注入到包装布局中的哪个位置。

参见:局部模板装饰器

为什么重要

页头、卡片、告示框这类「外壳固定、内容多变」的结构用装饰器最省事:调用方只写内容,外壳由装饰器统一维护,样式也就不会在各页之间逐渐跑偏。 关键差别在调用方式——装饰器必须用内嵌(block)形式调用,把内容传进去;当成普通局部模板直接调用时,templates.Inner 的位置是空的,渲染出来只剩外壳、看不到正文。

延伸阅读:局部模板装饰器 · templates.Inner