本技能用于生成可直接粘贴进 WordPress 编辑器、并尽量一次通过校验的 Kadence Blocks 区块标记,内容依据 Kadence Blocks 3.7.10 与 WordPress 7.1 验证。它覆盖布局、内容、复合区块:rowlayout、column、advancedheading、advancedbtn、singlebtn、infobox、iconlist、icon、image、spacer、accordion、tabs、testimonials、table、posts、advanced-form、countup、countdown、progress-bar、advancedgallery、videopopup、googlemaps、lottie 等。
生成时需遵守几条关键规则:动态区块只保存注释,静态区块必须给出与其 save() 完全一致的 HTML,否则编辑器会提示内容无效并尝试恢复,从而丢失样式;类名通常由 uniqueID 无分隔符拼接(如 kadence-columnabc123),少数用连字符,且不要放进 className;只能使用真实存在的属性,编造的属性名会被静默丢弃;rowlayout、column、infobox、googlemaps、advancedgallery、testimonials 六个区块必须带 "kbVersion":2,否则前端渲染异常,其他区块不要添加。
随附参考文件:reference/save-markup.md 给出每个区块的保存 HTML 与类名公式;reference/block-attributes.md 收录全部 62 个区块、2705 个属性及类型默认值;reference/block-schema.json 为机器可读版本。样式文件按场景划分,包括 hero、features、CTA、pricing、testimonials、FAQ、tabs、table、forms、media、stats、pages、snippets。
常用属性:颜色建议用 palette1–palette9 主题调色板,也可用十六进制;响应式有三种写法,三值数组 [desktop, tablet, mobile]、四值数组 [top, right, bottom, left] 以及按断点分列属性,注意是 tabSize 而非 tabletSize;行尺寸可用 align、inheritMaxWidth、maxWidth、topPadding、topPaddingM、verticalAlignment。每个区块应有独立 uniqueID,避免样式串扰。
校验方式:python3 tools/lint-attributes.py path/to/markup.html 可检查属性名与类型错误;python3 tools/extract-examples.py /tmp/all.html 可汇总示例并进行编辑器回灌验证;python3 tools/extract-schema.py _reference/kadence-blocks 可在插件更新后重新生成属性参考。不确定时应优先复用已验证的样式,只改属性表中确认过的属性,随后先 lint 再验证。