SuperAPI AI 工具集

editing-blocks

前端与建站

查看项目

更新于 10-15 17:21

技能介绍

用途:当需要修改一个已存在的 WordPress 区块(文件已在工作区中)时使用此技能;从零创建新区块时不要使用。

主要能力与准则:修改前阅读所有现有区块文件,理解当前架构、属性和渲染方式;只做用户要求的最小、针对性改动;只触碰需要修改的文件,不重写无关文件;针对性改动用 edit 工具,仅当替换文件超过 50% 时才用 write;除非用户明确要求,不要转换静态与动态区块,也不要更改区块名称或 slug;新增或修改属性时,同步更新相关文件(block.json、edit.js,以及 save.js 或 render.php);改动后验证区块仍正确注册并能前台渲染;尽量使用 @wordpress/block-editor 的 InnerBlocks 组件。

交互性:为已有区块添加交互时,若尚非动态区块,先转为动态(新增 render.php、移除 save.js、在 block.json 加入 "render": "file:./render.php")。转换时在 block.json 加入 "viewScript": "file:./view.js",view.js 使用原生 JavaScript 与标准 DOM API(querySelector、addEventListener、classList 等),不要使用 WordPress Interactivity API。

参考文件:编辑前阅读本技能旁 references/ 目录中的相关参考。artefact-templates.md 用于核对文件结构、路径与资源引用;file-templates.md 提供各区块文件类型的补充准则;inner-blocks.md 供区块使用 InnerBlocks 或子区块时阅读;interactivity-api.md 供添加前端 JavaScript 交互行为时阅读。

限制:资料未提供更多功能、收费、价格、平台或效果信息。