Skip to content

HTML 片段 ​

菜单:内容 → HTML 片段
深链:/_Admin/content/htmlblocks?SiteId={站点GUID}
编辑:/_Admin/content/htmlBlock/edit?SiteId=...&id={片段Id}(新建无 id)

HTML 片段(HtmlBlock)用于在后台集中维护一段 HTML 内容,在多个 Page、Layout、View 中复用。前台渲染时按当前站点语言输出对应版本,避免同一段页脚、广告条在多处复制粘贴。

与 View、标签的区别

HTML 片段View标签
后台菜单内容 → HTML 片段开发 → View内容 → 标签
内容形态富文本/HTML 块模板片段(常含绑定)短文案字符串
模板引用<htmlblock id="..."><view id="...">k.label()

前置:多语言(可选)

与 标签 相同:若站点启用多种语言,编辑页会为每种语言提供 内容 字段;须在 站点设置 → 基础设置 中先配置语言。单语言站点只显示一个 内容 输入区。

如何打开 ​

  1. 进入站点后台(地址栏带 SiteId)。
  2. 左侧 内容 → HTML 片段。
HTML 片段列表

列表页 ​

列 / 操作说明
名称片段标识,与模板中 id 一致;建议英文,如 footer_links、promo_banner
引用被哪些 Page / Layout / View 等资源引用(可点击查看)
最后修改更新时间
编辑进入编辑页
版本版本历史(站点日志权限允许时)

工具栏 新建 进入编辑页(无 id)。勾选多行可 批量删除(权限 htmlBlock · delete)。

编辑页 ​

全屏表单 + 底部 保存 / 取消。

字段说明
名称新建时填写,须唯一、1~50 字符、符合资源命名规则;保存后不可改名(编辑时只读展示)
内容 · {语言}每种已启用语言一行,使用 富文本/HTML 编辑器(KEditor)维护该语言下的 HTML
多语言选择器右上角切换当前编辑侧重(各语言字段仍按语言列出)

离开页面前若有未保存修改,会提示确认。

编辑 HTML 片段

在模板中引用 ​

片段 名称 与下列写法中的 id / 绑定值一致(大小写以站点内资源名为准):

标签形式(常用) ​

在 Page、Layout 或 View 的 HTML 中:

html
<htmlblock id="footer_links"></htmlblock>

绑定属性 ​

也可使用渲染绑定(与引擎 k-htmlblock / v-htmlblock 对应):

html
<div k-htmlblock="footer_links"></div>

渲染时输出该片段在当前请求语言下的 HTML;找不到片段时行为以引擎为准(开发环境可对照资源名排查)。

与 Layout 占位

片段常放在 Layout 的 <placeholder> 内,或与 <view> 并列使用,用于全站统一的页脚、侧栏公告等。Page 结构见 模板引擎 · Page。

其它入口 ​

场景说明
在线编辑若站点开启「编辑 HTML 片段」,可在预览页选中已绑定的片段块,右键/工具条进入编辑(保存后刷新预览)
页面树页面 列表的 页面树 视图中,可将选中节点 转换成 HTML 代码块(新建或合并到已有片段),便于把重复 DOM 抽成片段
开发 · 代码搜索可跳转到片段编辑页

相关 ​

文档说明
内容模块概述内容分组菜单
标签多语言短文案
View可复用视图片段
在线编辑前台可视化改片段
k.utils.inlineHtml将外部资源内联进 HTML 导出(与 HtmlBlock 管理无关)