可组合性

关于可组合性的技术文章和开发文档。

关于 Interactivity API

【WordPress区块编辑器手册】关于 Interactivity API

Interactivity API 是专为 WordPress Gutenberg 区块设计的标准指令系统,用于添加前端交互性。它采用声明式代码和 PHP 优先策略,确保服务器端渲染与客户端水合一致,完美支持 SEO。该 API 具有高性能、可扩展及原子化特性,允许开发者轻松构建计数器、即时搜索等复杂体验,并实现无需刷新页面的全页客户端导航。同时,它保持向后兼容,能与 jQuery 等现有库共存,简化开发流程,促进代码复用与协作。

2026-10-17 1 后端开发

【WordPress区块编辑器手册】复合

本文介绍基于 WAI-ARIA 复合角色的 React 复合组件,支持方向键导航与焦点循环。涵盖 activeId、focusLoop、virtualFocus 等属性配置,提供 Group、Item、Row 等子组件及 Typeahead 类型提示功能,适用于构建高可访问性的组合小部件与网格界面。

2026-10-17 2 后端开发

【WordPress区块编辑器手册】核心概念

本文深入解析内容构建中的核心概念——区块。介绍区块作为抽象单元的定义、层级结构及序列化形式。详细阐述可重用区块的同步机制、区块模式的快速布局功能,以及模板编辑器对全站结构的编辑能力。同时涵盖全局样式配置与区块转换等高级特性,帮助用户高效管理网站内容与设计。

2026-10-17 3 后端开发
@wordpress/dataviews

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

这是一个关于表单字段筛选功能的配置说明文档,详细描述了如何配置字段的筛选器属性、操作符(如大于、包含、等于等)、布局类型(Regular, Panel, Card, Row, Details)以及相关的显示格式和摘要字段设置。该文档还提到了项目作为 Gutenberg 包的一部分,采用 monorepo 组织形式。

2026-10-17 1 后端开发

【WordPress区块编辑器手册】常见问题解答

本文深入解析 WordPress Interactivity API 的工作原理,探讨为何选择 Preact 而非 React 或 Alpine.js。文章详细说明了该 API 如何通过 HTML 指令实现服务端渲染与客户端交互的无缝结合,确保与 WordPress 钩子及国际化功能的完美兼容。同时,内容涵盖了其安全性设计、性能优势以及对开发者工作流的简化,是构建高性能交互式区块的标准指南。

2026-10-17 2 后端开发

【WordPress区块编辑器手册】键盘快捷键数据

本文详细介绍键盘快捷键数据的相关功能,包括获取快捷键组合、原始表示及别名。支持按名称或类别查询,提供显示字符串、纯文本标签等属性。涵盖注册与取消注册动作,并返回对应的快捷方式描述和按键组合信息,适用于全局状态管理。

2026-10-17 1 后端开发

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

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

2026-10-17 2 后端开发

【WordPress区块编辑器手册】跨 WordPress 版本测试已发布的软件包

本文介绍如何在 WordPress 生态中进行跨版本测试,确保捆绑包与不同版本的 WordPress 及依赖项兼容。涵盖公共和私有 API 的向后兼容策略、入口点加载检查、依赖项提取验证以及新旧版本混合场景下的发布流程与安全回退机制,帮助开发者维护生产环境的稳定性并规划平滑迁移路径。

2026-10-17 2 后端开发

【WordPress区块编辑器手册】使用 WordPress 设计系统包

本文深入解析 WordPress 设计系统的核心概念与最佳实践。内容涵盖公共包与私有 API 的边界界定、Gutenberg 组件过渡策略、MCP 服务器及 Storybook 的使用指南。重点讨论了设计令牌的语义化应用、样式预设的配置方法,以及在迁移现有组件时如何保持行为一致性与无障碍性。同时提供了关于 API 兼容性验证、测试覆盖率选择及跨版本契约管理的详细建议,帮助开发者构建稳健的 WordPress 应用程序。

2026-10-17 2 后端开发

【WordPress区块编辑器手册】转换

本文详细介绍 Block Transforms API,涵盖从短代码、文件、正则表达式及原始 DOM 节点等多种实体的块转换机制。内容包括 to 和 from 方向的配置方法、transform 回调函数定义、优先级控制、键盘快捷键注册以及 InnerBlocks 嵌套处理等核心功能,帮助开发者构建灵活的编辑器体验。

2026-10-17 3 后端开发