2025年6月11日,古腾堡编辑器迎来 21.0 版本更新。此次更新聚焦于编辑结构控制、设置界面统一、无障碍增强、Bug 修复以及文档与代码质量优化等多个方面。以下是本次更新的完整亮点解析。
一、按钮与分隔符区块新增 HTML 元素切换功能
按钮区块在高级设置中增加了 HTML 元素选择项,支持在 <a> 和 <button> 之间切换,便于更灵活地构建语义结构和提升屏幕阅读器兼容性。
分隔符区块也提供了 <hr> 与 <div> 两种元素切换选项,方便构建自定义样式的分隔效果。
二、大规模 ToolsPanel 接口重构:统一区块设置体验
为统一设置面板结构,多个区块的属性配置界面进行了全面改造,统一使用了 ToolsPanel 接口。此次涉及的区块包括:
评论区块:评论日期、评论作者名、评论编辑链接、评论标题、评论分页
常用区块:按钮、嵌入、文件、列表、文章标题、RSS、最新文章、表单与输入字段
导航相关:导航主区块、导航链接与子菜单链接
设置项界面更规整,参数更集中,查找和操作效率明显提升。
三、键盘交互与焦点控制全面改进
多个区块和控件组件获得了可访问性支持:
按钮区块修复解除链接后焦点消失的问题
列区块对设置面板控件使用逻辑做出调整
详情区块提升了键盘操作的响应性,并使嵌套区块在列表视图中更易选中
工具栏按钮颜色方案调整,提升在深色模式下的对比度表现
四、常用区块与组件功能增强与修复
多个区块获得了结构和样式控制能力的提升,并解决了常见问题:
按钮区块不再出现空白控制插槽
画廊图像标题层级点击穿透问题修复
Pullquote 区块现在支持通过主题样式文件覆盖引用样式
社交链接支持服务名称本地化翻译,尺寸设置调整到更合适的控制区域
其他增强包括:
短代码区块支持新增角色属性以增强语义结构
视频区块支持设定默认字幕轨道
导航链接和子菜单控件隐藏了部分 UI 控制项,但仍保留底层属性支持
表单和输入字段区块采用统一的设置面板呈现方式
五、组件逻辑与内部 API 优化
组合框控件支持 Unicode 匹配逻辑,输入多语言内容时表现更稳定
拖放组件支持覆盖默认图标,更具可定制性
图像焦点选择器修复了未指定宽度的 SVG 图像无法正确显示的问题
表单 Token 字段在处理长字符串筛选时不再卡顿
Flex Layout 中垂直对齐控制的默认数值逻辑得到修复
在交互式 API 模块中,部分函数的参数变为可选项,提升灵活性。同时已移除“全页面客户端导航”实验模块,保持核心功能更轻量。
六、文档与开发体验提升
针对开发者文档和配置文件进行了系统性优化:
所有图片补全了 ALT 属性
修正函数文档中缺失的返回类型说明
清理并统一 JSON Schema 的参考地址字段
更新术语表达,替换过时字段描述
多份教程文件使用更新后的代码语法格式
useDropZone 和其他钩子的文档也采用了新版函数书写方式,更符合当前古腾堡编辑器的项目标准。
七、测试覆盖扩展与代码整洁优化
本版本包含多项端到端与单元测试覆盖提升:
新增 FocalPointPicker 功能的 E2E 测试
添加模板锁定功能的综合测试
修复区块 API 的测试用例覆盖逻辑
调整 PHP 测试配置,使测试端口适应不同环境设置
代码方面,移除了 InputControl 控件中不必要的强制聚焦逻辑,清理了 SuggestionsList 中未被调用的遗留代码。同时,视频区块的字幕轨道项增加了唯一键值,避免列表渲染异常。
总结
古腾堡编辑器21.0版本是一次具有广度与深度的更新,涵盖语义控制、界面结构、交互逻辑、文档标准、开发接口、测试框架等多个维度。对内容创作者、设计人员、主题开发者和插件开发者而言,本次版本将带来更一致的设置路径、更顺畅的操作反馈和更合理的代码接口结构。
更多详情,请前往WordPress社区查阅了解。