组件文档 · 主题组件

那十九个你不认识的名字，
是主题的零件

在「添加区块」面板里往下翻，会看到 site-nav、hero-cinematic、capability-grid 这些。它们不是给正文用的内容块，而是一套版式拆开之后的零件 —— 这一页讲清楚它们各自归在哪、以及为什么大多数时候不该动。

先理解这一层

主题本身就是用这些组件搭出来的

一套主题不是一张图，而是一份「哪一个位置放哪个组件」的清单。你换主题，换的就是这份清单。

layout.json区域固定：顶部 / 页头 / 首屏 / 正文 / 页脚

一个页面从上到下被切成五段：顶部工具条、页头、首屏、正文、页脚。主题决定这五段里各放什么组件、按什么顺序摆、用多宽多高。
正文那一段才是你自由堆内容的地方 —— 前面四篇讲的 11 个区块，全部落在正文里。

所以「添加区块」面板之所以把十九个名字一起列出来，是因为它列的是全部可用的组件，而不是"全部你能加的位置"。列表里能选，不等于这里该放。

第一类 · 6 个

页头、页脚、顶部信息条。它们出现在每一个页面上，改一次全站生效 —— 所以它们在左侧「页头页脚」里编辑，不在「页面内容」里。

外壳组件（表格可左右滑动查看）
技术名	中文名	在哪改	它是干什么的
`utility-bar`	顶部工具条	页头页脚 · 顶部	最上方那条细信息条：公告、语言切换、电话。多数主题只放一两项。
`site-logo`	品牌标志	页头页脚 · 页头	Logo 图与站点名。改图去「站点设置」，这里只管摆在哪。
`site-nav`	主导航	页头页脚 · 页头	菜单项来自页面列表。加一个页面并发布，它才会出现在可选范围里。
`header-cta`	页头按钮	页头页脚 · 页头	页头右上角那个按钮，一般指向 /contact。
`locale-switcher`	语言切换	页头页脚 · 顶部或页头	只在开通了两种以上语言时才有意义；单语言站点加上去是个空壳。
`site-footer`	页脚	页头页脚 · 页脚	多栏链接与版权行。

导航菜单的菜单项不是在这里手敲的：它读的是你已发布的页面列表。新建一个页面并发布，菜单里才会出现可选的那一项（具体出现在哪一条，由主题的导航位置决定）。

第二类 · 5 个

它们渲染的都是"标题 + 说明 + 按钮 + 图"，区别只在构图。一个页面只能留一个：点另一个是替换，不是叠加。

首屏的五个组件（表格可左右滑动查看）
技术名	中文名	差别在哪
`hero`	首屏	通用首屏：文字一栏、图一栏。上一页讲过全部字段。
`hero-split`	分栏首屏	同一套骨架，图片比例与文字栏宽按当前主题调过。
`hero-cinematic`	全幅首屏	图占满一屏宽度，文字压在图上或紧贴下方。适合有强视觉的主打产品。
`hero-editorial`	居中大字首屏	标题居中放大、图在下方。像样本册的扉页，适合品牌感强的站。
`hero-carousel`	轮播首屏	多张图轮换，每张带自己的标题与按钮。注意：它比单图重，首屏是整页最慢的一屏。

该用哪个：跟着主题走就好。主题挑的那个和它自己的字体、间距、图片比例是配套的，换一个通常要重新调尺寸。除非你明确想要某种构图（比如主打产品需要全幅图），否则不用动。

第三类 · 9 个

这些是主题作者用来组出一套完整站点的段落组件。它们能加进正文，但样式是为当前主题调的 —— 换主题之后，同样的内容会长得不一样。

正文段的九个组件（表格可左右滑动查看）
技术名	中文名	什么时候会用到
`section-heading`	小节标题	一个标题加一句说明。用来分节，本身不含内容。
`capability-grid`	能力卡网格	一组能力/工艺卡片。和「图文内容」的区别是有统一的卡片样式。
`feature-split`	图文分栏	一边图一边文字，左右可换。讲工艺流程、设备、车间时用。
`partner-cards`	伙伴卡片	带说明的伙伴/渠道卡片，比纯 Logo 墙信息量大。
`steps`	流程步骤	带编号的步骤条。下单流程、质检流程、合作流程。
`case-grid`	案例网格	项目案例卡片，通常链到案例详情。
`stats-band`	数据条	一排大数字：年产能、出口国家数、良品率。数字必须有出处。
`article-grid`	文章网格	资讯/技术文章的列表。没有文章内容时它是空的。
`product-main`	商品详情主体	商品详情页的主体（图集 + 参数 + 询盘）。由主题用在详情页，不该手动加。

所以

不是"不允许"，是加进去之后页面会变得很难解释 —— 而且不会报错。

已经加了怎么办

在「页面内容」里找到那个区块，点它右上角的删除。正文区的区块可以随便删，不影响页头和页脚 —— 那两个在「页头页脚」里，是另一套数据。

如果你只是想要"页头有个按钮"，去「页头页脚」改「页头按钮」的文案和链接，不用在正文里再放一个。

把你的页面清单发过来，我们告诉你换哪套不用重排、换哪套要调一遍。