SuperAPI AI 工具集

wp-block-development

编程与开发

查看项目

更新于 10-16 07:22

技能介绍

用途:辅助 WordPress 区块(Gutenberg)开发工作,包括新建或更新区块、修改 block.json(脚本/样式/supports/属性/render/viewScriptModule)、排查“区块无效/不保存/属性未持久化”、添加动态渲染(render.php / render_callback)、处理区块废弃与迁移,以及区块构建工具(@wordpress/scripts、@wordpress/create-block、wp-env)。

主要能力与流程:先做项目甄别与区块定位,运行 node skills/wp-project-triage/scripts/detect_wp_project.mjs 与 node skills/wp-block-development/scripts/list_blocks.mjs,确定 block.json 所在目录及所属插件/主题。新建区块优先用 @wordpress/create-block 脚手架,需要 Interactivity API 时用 interactive 模板。确保 apiVersion 3(WordPress 6.9+),并注意 WordPress 7.0 编辑器 iframe 下的样式隔离。选择静态(实现 save())或动态(用 render 或 render_callback)区块模型。更新 block.json 后确认注册与元数据一致,优先 PHP 元数据注册以支持动态渲染、翻译和条件加载。实现编辑/保存/渲染时编辑器用 useBlockProps(),静态保存用 useBlockProps.save(),动态 PHP 渲染用 get_block_wrapper_attributes();容器区块用 useInnerBlocksProps()。修改已保存标记或属性前先确认属性存储位置(注释分隔符/HTML/上下文),并为旧版本添加 deprecated 条目与 migrate。

使用方式:按资料提供的参考文档逐项执行(创建新区块、block-json、注册、supports 与 wrappers、动态渲染、内部区块、属性与序列化、废弃、工具与测试、调试)。验证步骤为:区块可插入、保存重载不出现“Invalid block”、前端输出符合预期、资源在编辑器与前端正确加载、运行仓库推荐的 lint/build/tests。失败时查阅 debugging、attributes-and-serialization、deprecations 参考。上游行为或版本支持不确定时,先查 WordPress 开发者资源与 Gutenberg 仓库文档。

限制与未提供:资料未说明具体价格、平台支持范围、性能效果或安装命令细节;所需输入包括仓库根与目标(插件/主题/整站)、区块名称/命名空间与位置、目标 WordPress 版本范围。部分功能依赖具体 WordPress 版本与仓库现有工具链,缺失事实暂未提供。