📁 当前栏目 / 指定栏目

最后更新：2026-10-02

📋 当前栏目字段

以下字段在栏目页（如 /products/glass/）中直接可用。

{{.CategoryName}}当前栏目名称（栏目页 hero 大标题直接读数据库栏目名）文本

{{.CategorySubTitle}}当前栏目副标题（栏目名下方一行，后台「栏目管理 → 副标题」填写；频道页 products/news/cases/jobs 也按对应栏目 link 透传）文本

{{.CategoryDescription}}栏目描述1文本

{{.CategoryDescription2}}栏目描述2文本

{{.CategoryDescription3}}栏目描述3文本

{{.CategoryRedirectURL}}跳转链接（访问该栏目时直接跳转）URL

{{.CategoryPermissionDeniedMessage}}权限不足提示文本文本

{{.CategoryThumbnail}}栏目缩略图地址URL

{{.CategoryImage}}栏目大图/横幅地址URL

{{.CategoryLink}}当前栏目链接URL

{{.SEOTitle}}当前栏目 SEO 标题SEO

{{.SEOKeywords}}当前栏目 SEO 关键词SEO

{{.SEODescription}}当前栏目 SEO 描述SEO

📋 栏目控制参数 NEW

以下变量在所有页面可用（全局注入），可在任意模板中调用栏目信息。

{{.CurrentCategory.Name}}当前栏目对象（含 ID/Name/Link/ParentID/Type/SubTitle/Description/Description2/Description3/RedirectURL/PermissionDeniedMessage/Thumbnail/Image/ViewPermission/PermissionType）对象

{{.CurrentCategory.SubTitle}}当前栏目副标题（对象写法，等同顶层 {{.CategorySubTitle}}）文本

{{.CategoryMeta.Image}}频道页（products/news/cases/jobs）栏目大图，通过 {{.CategoryMeta}} 对象读取URL

{{.ParentCategory.Name}}父级栏目（直接父栏目对象）对象

{{range .ChildCategories}}子栏目列表（当前栏目的直接子栏目）数组

{{range .TopCategories}}顶级栏目列表（全部一级栏目，用于导航/栏目树）数组

🧭 栏目控制参数速查

场景	Go 模板写法	说明
当前栏目	`{{.CurrentCategory.Name}}`	栏目页显示当前栏目名
父级栏目	`{{if .ParentCategory}}{{.ParentCategory.Name}}{{end}}`	当前栏目的父级（用于面包屑）
子栏目	`{{range .ChildCategories}}...`	遍历当前栏目的子栏目
顶级栏目	`{{range .TopCategories}}`	遍历所有一级栏目（导航/侧栏栏目树）
指定栏目	`{{range list "type=news&scode=栏目链接"}}`	调取指定栏目（含子栏目）内容

每条栏目对象含字段：ID（栏目ID）、Name（栏目名）、Link（栏目链接）、Type（内容模型编码：news 文章 / product 产品 / case 案例 / job 招聘 / page 单页 / 或自定义模型编码 如 certificate）。栏目的「内容模型」在后台添加/编辑栏目时从下拉选择，下拉项即后台「内容模型」里启用的模型。

💻 使用示例

<!-- 栏目页 hero 大标题（读数据库栏目名） -->
<h1>{{.CategoryName}}</h1>

<!-- 栏目副标题（后台「栏目管理 → 副标题」填写；留空则回退默认文案） -->
{{if .CategorySubTitle}}<p class="page-hero-desc">{{.CategorySubTitle}}</p>{{end}}

<!-- 侧栏栏目树：顶级栏目 + 子栏目 -->
{{range .TopCategories}}
<a href="{{.Link}}">{{.Name}}</a>
{{end}}

<!-- 面包屑：父级 / 当前 -->
{{if .ParentCategory}}<a href="{{.ParentCategory.Link}}">{{.ParentCategory.Name}}</a> / {{end}}{{.CategoryName}}

<!-- 栏目页内容列表：按栏目「内容模型」选择对应变量 -->
<!-- 文章栏目（默认）→ .Posts / .News -->
{{range .Posts}}<a href="{{.URL}}">{{.Title}}</a>{{end}}

<!-- 产品栏目 → .Products（同时兼容 .Posts） -->
{{range .Products}}<a href="{{.URL}}">{{.Title}}</a>{{end}}

<!-- 案例栏目 → .Cases -->
{{range .Cases}}<a href="{{.URL}}">{{.Title}}</a>{{end}}

<!-- 招聘栏目 → .Jobs（含 .Location/.Salary/.EmploymentType） -->
{{range .Jobs}}<a href="{{.URL}}">{{.Title}}</a>{{end}}

<!-- 自定义内容模型栏目 → .CustomItems / .List（通用别名 .Posts/.News 也可用） -->
{{range .CustomItems}}<a href="{{.URL}}">{{.Title}}</a>{{end}}

🎯 指定栏目（自由标签 scode）

通过 list 函数的 scode 参数，调取指定栏目（含子栏目）的内容。

<!-- 取新闻栏目最新6条 -->
{{range list "type=news&num=6&order=date"}}
<a href="{{.URL}}">{{.Title}}</a>
{{end}}

<!-- 取产品栏目（含子栏目）推荐产品 -->
{{range list "type=product&num=6&order=istop&scode=display-glass"}}
<a href="{{.URL}}">{{.Title}}</a>
{{end}}

🧩 自定义内容模型栏目 NEW

后台「内容模型」里可创建自定义模型（数据表 model_<code>，如证书 certificate），并在「添加栏目」时把该栏目的「内容模型」选为这个自定义模型。这类栏目的前台渲染走通用列表分支：

注入变量	说明
`{{.CustomItems}}` / `{{.List}}`	自定义模型内容数组（主变量）
`{{.Posts}}` / `{{.News}}`	兼容别名，指向同一数组（方便复用文章列表模板）
`{{.ModelCode}}`	当前自定义模型编码（如 `certificate`）
`{{.URL}}`（每条）	详情链接，系统自动生成 `/m/<url_name或code>/<id>`，务必用 .URL 而非手写

数组每条可用字段：.Title / .Summary / .Image / .Thumbnail / .CreatedAt / .IsRecommend / .URL，以及后台为该模型定义的扩展字段（字段名即数据库列名，如 {{.cert_no}}）。

<!-- 自定义模型栏目列表（如 /category/cert） -->
{{range .CustomItems}}
  <div class="card">
    <a href="{{.URL}}">{{.Title}}</a>
    <p>{{.Summary}}</p>
    {{if .cert_no}}<span>证书号：{{.cert_no}}</span>{{end}}
  </div>
{{end}}

详情页写法见「内容详情」章节的自定义内容模型详情（model_detail.html）。自定义模型内容保存在独立数据表，与文章/产品互不影响；后台「内容模型 → 模型内容」录入。

← 幻灯片轮播内容列表 →