wordpress标签说明,wp:group
这段代码是 WordPress 块编辑器(Gutenberg) 的标记,用于创建一个 <main> 容器组(Group Block),并应用特定的样式和布局设置。以下是详细解析:
代码结构
<!-- wp:group {"tagName":"main","style":{"spacing":{"margin":{"top":"var:preset|spacing|60"}}},"layout":{"type":"constrained"}} -->这是一个 WordPress 块编辑器的 HTML 注释语法,用于定义一个 Group 块,并传递 JSON 格式的属性参数。
属性解析
tagName":"main"指定该 Group 块渲染为 HTML 的
<main>标签(默认为<div>)。<main>是语义化标签,表示页面的主要内容区域。style":{"spacing":{"margin":{"top":"var:preset|spacing|60"}}}上边距(margin-top) 使用 WordPress 的预设间距变量
var:preset|spacing|60。这里的
60是主题预设的间距值(具体像素值取决于主题配置,可能是60px或相对单位)。设置 CSS 样式:
layout":{"type":"constrained"}内容宽度受主题的全局容器限制(通常与
max-width对齐)。子元素会继承此布局约束。
定义布局类型为 "constrained"(约束布局),表示:
渲染后的 HTML 结构最终生成的 HTML 大致如下:
<main class="wp-block-group" style="margin-top:var(--wp--preset--spacing--60)"> <!-- 子区块内容 --> </main>
功能作用
语义化容器
用
<main>包裹页面主要内容,提升 SEO 和可访问性。样式控制
通过预设间距系统(
spacing scale)保持设计一致性。布局管理
constrained布局确保内容宽度与主题整体设计协调。
适用场景
在 模板文件(如
single.html、page.html)中定义主要内容区域。在 文章/页面 中通过块编辑器手动添加 Group 块并设置属性。
如何修改?
通过 WordPress 编辑器
在 Group 块的侧边栏中调整
间距或布局选项。通过主题 JSON
在
theme.json中修改预设间距值(如将spacing-60从60px改为其他值)。
对比其他布局类型
布局类型 (layout.type) | 作用 |
| constrained | 限制子块宽度,与主题容器对齐 |
| default | 子块默认流式布局(无宽度约束) |
| flex | 启用 Flexbox 布局(需额外配置) |
如果需要进一步自定义,可以结合 CSS 变量或子区块的嵌套使用。
对比其他布局类型 布局类型 (layout.type) 作用 constrained 限制子块宽度,与主题容器对齐 default 子块默认流式布局(无宽度约束) flex 启用 Flexbox 布局(需额外配置) 如果需要进一步自定义,可以结合 CSS 变量或子区块的嵌套使用。


发表评论