约定

关于约定的技术文章和开发文档。

【WordPress区块编辑器手册】@wordpress/data

返回一个包含预绑定到状态的存储选择器的对象,这样您只需要提供额外的参数,并且经过修改后它们在运行任何 resolvers 后会返回解析为其最终值的 promises。

2026-10-17 2 后端开发

【WordPress区块编辑器手册】代理与技能

本文介绍 Gutenberg 仓库中面向 AI 编码代理的文档组织原则与技能系统。通过渐进式发现机制,仅加载任务所需内容以控制上下文膨胀。公共文档供人类与代理共享,代理文件避免冗余复制。技能采用轻量级 YAML 格式,包含触发条件与程序化步骤,支持测试、发布等特定任务,确保代理高效执行且文档易于维护更新。

2026-10-17 1 后端开发
仪表盘小工具系统

【WordPress区块编辑器手册】仪表盘小工具系统

本文档详解 WordPress 仪表盘小工具系统的架构与开发流程。涵盖从文件夹约定、构建清单生成到服务端注册表填充的完整流水线,阐述 REST 记录与客户端契约的交互机制。介绍 Widget Primitives 包如何作为作者与宿主间的稳定接口,实现元数据标注、组件渲染及动态依赖管理,确保系统各阶段独立演进。

2026-10-17 3 后端开发
区块样式表

【WordPress主题开发手册】区块样式表

本文详解 WordPress 区块样式表的创建与注册方法。在 theme.json 无法满足需求时,通过 wp_enqueue_block_style() 函数为特定区块加载独立 CSS 文件。文章涵盖命名规范、CSS 类选择器编写及 functions.php 中的注册步骤,帮助开发者优化主题性能并管理复杂样式。

2026-10-05 7 后端开发
页面模板

【WordPress主题开发手册】页面模板

本文详细介绍 WordPress 页面模板的构建与应用方法。内容涵盖全局与专用模板的区别、文件命名规范(如 page-{slug}.php)、如何为特定文章类型添加模板支持,以及利用条件标签和内置函数进行动态渲染。适合开发者优化主题结构与用户自定义需求。

2026-10-05 7 后端开发

【WordPress插件开发手册】常见问题

本文汇总了 WordPress 插件审查团队在审核过程中遇到的常见问题与安全准则。内容涵盖输入数据清理、验证与转义的最佳实践,防止 XSS 和 SQL 注入漏洞;详细说明了命名空间、前缀规范及 GPL 许可证合规要求;同时涉及 WPDB 安全调用、第三方库依赖管理、国际化翻译标准以及文件上传与远程资源调用的安全策略,旨在帮助开发者提升插件安全性与兼容性。

2026-10-07 3 后端开发

【WordPress区块编辑器手册】@wordpress/ui

@wordpress/ui 是 WordPress 设计系统的 React UI 组件包,提供基于设计令牌的灵活组件。支持 NPM 安装与主题定制,包含按钮、链接等基础元素及复合组件。遵循一致的模式实现自定义渲染、Ref 转发和状态管理,区分受控与非受控用法,确保在编辑器内外都能开箱即用并保持一致的视觉体验。

2026-10-17 3 后端开发

【WordPress区块编辑器手册】@wordpress/video-conversion

WordPress 客户端视频转换包,专为媒体上传期间将动画 GIF 转换为 MP4 或 WebM 格式设计。该包利用浏览器原生 API 解码 GIF 帧,并通过 WebCodecs 和 mediabunny 库在 Web Worker 中重新编码,确保主线程响应流畅。支持 TypeScript 5+ 及 Chromium 浏览器,提供取消操作、尺寸限制等高级功能,实现高效优雅的视频转换体验。

2026-10-17 1 后端开发

【WordPress区块编辑器手册】@wordpress/widget-dashboard

本文介绍 WordPress Gutenberg 项目的 WidgetDashboard 软件包,这是一个用于构建小工具仪表盘的无状态渲染引擎。它支持拖拽重排、调整大小及模态插入等编辑功能。文章详细解析了其组件架构、样式系统、网格模型配置以及基于策略的用户权限治理机制,适用于在 WordPress 核心或外部环境中开发自定义仪表盘界面。

2026-10-17 2 后端开发