主题与外观

theme.*、template.*、chrome.* 共 4 个操作。

本页由 docs:sync 从 OperationRegistry 生成,请勿手工编辑。

chrome.clear_custom_code

清除公共页头(header)或页脚(footer)的自定义代码,恢复默认结构化页头/页脚(导航/Logo/联系/风格不受影响)。客户说「页头/页脚改回原来的/默认的」时用。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
slot string:header / footer 是

chrome.set_custom_code

给全站公共页头(header)或页脚(footer)写自定义 HTML/CSS/JS(站点级,所有页面生效)。仅当结构化操作(nav.update 导航、company.update Logo/名称、contact.update 联系方式、theme.update 页头页脚风格)表达不了客户想法时才用。代码在隔离沙箱渲染:页头/页脚里的链接用「站点根相对路径」(如 products/、news/、cases/,首页用空字符串),发布后点击可正常跳转、预览态只看样式不跳转。沙箱内不能提交表单、不能加载外部脚本/样式/iframe,CSS/JS 都写成内联。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
slot string:header / footer 是 header 公共页头 / footer 公共页脚

业务参数 params

字段 类型 必填 说明
html string 否 页头/页脚 HTML(导航链接用站点根相对路径)
css string 否 内联 CSS(作用域仅本页头/页脚)
js string 否 内联 JS(沙箱内执行)

template.patch_css

修改本站私有模板的 CSS(find/replace 局部替换,find 必须在样式表中唯一出现)。只在结构化操作表达不了的视觉细节时使用(字号/间距/阴影/悬停动效等)——配色用 theme.update、版式用 section.set_layout、区块参数用 section.set_params。禁止外部资源引用;改动只影响本站,重建后生效。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

业务参数 params

字段 类型 必填 说明
find string 是 要替换的原文片段(先 query.template_css 查看,逐字符一致且唯一;过短易不唯一)
replace string 是 替换后的内容(可为空串=删除该片段)

theme.update

修改站点主题(主色、容器宽度等)。可修改的键和取值范围由当前模板声明,超出范围会返回允许的选项。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

业务参数 params

字段 类型 必填 说明
primary_color string 否 主色,十六进制颜色值
accent_color string 否 强调色/CTA 与装饰色,十六进制颜色值
secondary_color string 否 辅助/品牌色,用于强调分区底色等,十六进制颜色值
background_tone string 否 整体背景色调,可选值由模板声明(如 light/warm/cool)
corner_radius string 否 圆角风格,可选值由模板声明(如 sharp/rounded/pill)
font string 否 字体风格,可选值由模板声明(如 sans/serif/rounded)
header_style string 否 公共页头风格(全站),可选值由模板声明(如 light/solid/dark)
header_sticky string 否 公共页头是否吸顶(全站),可选值由模板声明(如 yes/no)
footer_style string 否 公共页脚风格(全站),可选值由模板声明(如 dark/light)
container_width integer 否 内容容器宽度(px)