SuperAPI AI 工具集

editing-blocks

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

用途:这是一个用于修改工作区中已存在 WordPress 区块的技能指南。仅适用于编辑现有区块文件,不适用于从零创建新区块。

主要能力与规范:编辑前先完整阅读现有区块文件,理解现有架构、属性与渲染方式;只做用户要求的、最小范围的针对性改动,不重写无关文件;优先使用 edit 工具做定点修改,仅当替换文件超过 50% 时才用 write;除非用户明确要求,不将静态区块与动态区块互相转换,也不更改区块名称或别名。

属性处理:新增或修改属性时,需同步更新所有相关文件,包括 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",并用标准 DOM API(querySelector、addEventListener、classList 等)以纯 JavaScript 编写 view.js,不使用 WordPress Interactivity API。

参考文件:编辑前阅读本技能同级 references/ 目录中的相关文档,包括 artefact-templates.md(校验文件结构、路径与资源引用,尤其是 register_block_type 路径和 block.json 资源文件名)、file-templates.md(各区块文件类型的附加指南)、inner-blocks.md(涉及 InnerBlocks 或子区块时)、interactivity-api.md(需前端 JavaScript 交互行为时)。

限制:资料未提供具体版本、依赖、平台或收费信息。