WordPress Gutenberg 编辑器在 20.8 与 20.9 这两版中,重点围绕编辑体验、可访问性、性能和代码质量做了多项打磨。具体有什么变化,这里帮你快速掌握新版亮点。
![图片[1]-古腾堡 20.8 和 20.9 更新亮点全面解析](https://www.361sale.com/wp-content/uploads/2025/06/20250618104001354-image.png)
一、整体概览
- 可访问性 :核心团队进一步清理重复 HTML 元素,自动检测多余
<main>标签,避免屏幕阅读器出现混乱。 - 编辑流畅度 :模板交换模式(template swap mode)加入搜索栏,查找模板过程更直观。
- 组件升级 :弹出窗口新增虚拟填充,防止贴边;小工具编辑器在焦点离开插入器时不再意外关闭。
- 性能与底层 :大量代码重构与错误修复,确保运行更轻量也更可靠。
二、20.8 版本重点
| 分类 | 更新内容 |
|---|---|
| 可访问性 | 预防重复 <main> 元素,自动校验 HTML 结构 |
| 模板交换 | 搜索功能初登场,方便快速定位模板 |
| 组件 | “创建区块”命令行工具支持 --textdomain 参数,i18n 流程更顺畅 |
| 弹出窗口 | 引入虚拟内边距,避免弹窗贴到浏览器边缘 |
为什么重要?
不少主题开发者喜欢自定义模板,但如果误放两个 <main>,辅助技术会把内容读两遍。新版提供校验,减少这种低级错误。
![图片[2]-古腾堡 20.8 和 20.9 更新亮点全面解析](https://www.361sale.com/wp-content/uploads/2025/06/20250618104229382-image.png)
三、20.9 版本重点
| 分类 | 更新内容 |
|---|---|
| 搜索块 | 设置面板移入检查器侧边栏,全部样式选项排列在最上方 |
| HTML 元素 | 重复 <main> 检测功能继续优化,提示信息更友好 |
| 模板交换 | 搜索体验升级:输入关键字即可过滤所有可用模板 |
| 编辑器视图 | 仅在桌面视图且画布位于 iframe 时启用元框分屏; 交互更专注 |
| 小工具 | 聚焦离开插入器时不再自动关闭,避免编辑中断 |
亮点解析
- 搜索块改版:原本分散在多个位置的配置项,如图标大小、边框样式,现已集中到检查器面板顶端,操作步骤更少。
![图片[3]-古腾堡 20.8 和 20.9 更新亮点全面解析](https://www.361sale.com/wp-content/uploads/2025/06/20250618105547695-image.png)
移至Styles侧边栏导航的顶部。将样式导航项移至站点编辑器主侧边栏导航的顶部位置,位于导航、页面、模板和模式之前。
![图片[4]-古腾堡 20.8 和 20.9 更新亮点全面解析](https://www.361sale.com/wp-content/uploads/2025/06/20250618105716962-image.png)
- 模板交换搜索 2.0:原生模板,和自定义模板都可搜索检索,复杂站点管理效率明显提升。
![图片[5]-古腾堡 20.8 和 20.9 更新亮点全面解析](https://www.361sale.com/wp-content/uploads/2025/06/20250618104258653-image.png)
四、对开发者与站长的意义
- 更安全的标记结构
重复<main>虽然不影响渲染,但严重干扰读屏器。新版自动验证,大幅降低可访问性风险。 - 快捷模板管理
以前在几十个模板里滚动查找非常浪费时间;现在输入关键字,一秒直达目标。 - 命令行国际化
create-block --textdomain让区块开发初期就绑定文本域,后期翻译不再返工。 - 界面细节升级
弹窗防贴边与侧边栏排序,看似小改动,却让内容创作流畅不少。
五、更新详情与开发者关注点
除了可访问性提升和模板搜索功能,这两次更新还包含大量面向开发者和高级用户的增强功能、错误修复与文档补充,涵盖区块、组件、API、测试、性能等多个维度。
1. 增强功能亮点
- 创建区块 CLI 工具:新增
--textdomain参数,更方便为区块项目绑定国际化域,符合翻译标准流程。 - 弹出组件体验优化:引入虚拟填充,防止弹窗贴边造成视觉溢出或操作误触。
- 指南导航按钮:允许自定义“下一步 / 上一步”文本内容,提升可用性与品牌一致性。
- 小部件锁定控制:支持对小工具编辑器操作增加“锁定”机制,避免无意修改。
2. 错误修复与体验优化
更新中修复了大量细节问题,提升稳定性与开发体验:
- 图像块:修复从媒体库重新选择同一张图片时的 URL 错误,避免使用旧路径。
- 块合并行为调整:在“禁用编辑模式”下禁用块合并操作,防止意外数据覆盖。
- 日历区块:禁用 HTML 编辑,避免破坏结构。
- 导航块:修复子菜单与链接块的未定义键值警告。
- 退出登录区块:更新当前 URL 获取方式,避免逻辑错误。
- 媒体占位符:修复媒体 URL 输入类型问题,重新支持本地路径。
特别值得注意的是,HTML 格式支持与块容器之间的交互逻辑也得到了修复和强化,防止宽度溢出和结构错乱。
3. 可访问性细节更新
- 恢复了“access + z”键作为删除块的快捷键,提升键盘操作的一致性;
- 添加了
HTMLElementControl组件,用于更细致地控制 HTML 元素行为和可访问性标签结构。
4. 文档与开发支持增强
这次更新还同步改进了 Gutenberg 开发文档,内容更清晰,示例更完整:
- 为
setAttributes更新器函数添加了版本说明; - Block Bindings API 新增关于“帖子元字段”的限制说明;
- 修复了多个教程中的导入语法和注释错误;
- 简化了
theme.json属性顺序,提升结构一致性。
对于正在自定义主题或扩展块功能的开发者而言,这些文档更新将极大降低学习成本与出错率。
5. 性能与代码质量提升
ServerSideRender模块重构为使用useCallback与refs,减少重复请求;- 内部组件结构优化,如
useHasBlockToolbar的条件判断逻辑被进一步精简; - 测试框架中跳过了不稳定的 Storybook 冒烟测试,提高持续集成稳定性。
六、升级前的准备动作
| 步骤 | 说明 |
|---|---|
| 备份 | 使用 UpdraftPlus 或主机快照保留完整副本 |
| 检测兼容性 | 在测试站点启用 Gutenberg 20.9,确认主题与插件表现正常 |
清理自定义 <main> | 若主题模板里硬编码多个 <main>,建议及时调整 |
| 更新文档 | 开发团队应同步 README 与帮助手册,说明新参数与界面变动 |
古腾堡 20.8 / 20.9 技术更新速览表
| 类别 | 更新内容 | 描述 |
|---|---|---|
| 🔧 增强功能 | --textdomain 参数 | create-block CLI 工具新增,方便多语言支持 |
| 自定义 next/previous 文本 | 指南组件按钮文本支持自定义 | |
| 弹出窗口虚拟填充 | 避免弹窗贴边,提升视觉体验 | |
| 模板交换搜索功能 | 模板列表支持关键词搜索 | |
| 小工具锁定控制 | 控制是否允许编辑小工具 | |
| 插入器聚焦保持 | 焦点离开插入器不再自动关闭 | |
| 元框分屏优化 | 仅在桌面 iframe 模式下分屏显示 | |
| 🛠 新 API / 组件 | HTMLElementControl | 新增组件用于处理自定义 HTML 元素选项 |
| 🐞 错误修复 | ServerSideRender 优化 | 使用 useCallback 重构数据加载逻辑 |
| 多处块兼容性修复 | 图像块、作者块、导航子菜单等警告 与错误处理 | |
| 日历区块 | 禁用 HTML 编辑支持 | |
| 媒体 URL 回归修复 | 允许本地路径输入 | |
| 块合并限制 | 禁用模式下阻止块合并行为 | |
| FontSizePicker 崩溃处理 | 避免字体大小数据缺失时出错 | |
| 双色调按钮逻辑修复 | 修复无法取消设置的问题 | |
useCustomUnits 默认值 | 避免变更 ALL_CSS_UNITS | |
| SVG 优化 | 删除宽高属性以提升响应性 | |
| 双边框视觉问题 | ItemGroup 最后一项焦点优化 | |
| ⚙️ 性能优化 | 延迟加载作者信息 | 提升内容编辑器初始渲染性能 |
| 最新帖子块优化 | 仅查询必要字段,控制延迟渲染 | |
| 📚 文档更新 | create-block 文档补充 | README 添加 --textdomain 示例说明 |
setAttributes 更新说明 | 明确函数支持的 WordPress 版本 | |
| Block Bindings 限制说明 | 添加对元字段限制的说明 | |
| 教程代码修复 | 修正导入缺失与 @return 标签冗余 | |
| 🧪 测试与 CI | Storybook 测试跳过 | 稳定性调整,避免冒烟测试阻塞 |
| 粘贴块样式测试 | 新增列表视图键盘粘贴端到端测试 | |
wp-polyfill 单测修复 | 处理脚本依赖加载失败问题 | |
| 💡 代码质量 | Stylelint 格式迁移 | 从 JSON 改为 JS,便于维护 |
theme.json 属性顺序规范化 | 提升结构一致性 | |
| 条件选择器简化 | 精简 useHasBlockToolbar 内部逻辑 |
小结
20.8 与 20.9 虽然属于常规小版本,却集中解决了可访问性痛点,而且在模板与搜索板块带来实用改进。无论是开发者还是内容编辑人员,升级后都能感受到流程更顺滑、错误更少。
| 联系我们 | |
|---|---|
| 教程看不懂?联系我们为您免费解答!免费助力个人,小企站点! |
客服微信
|
| ① 电话:020-2206-9892 | |
| ② QQ咨询:1025174874 | |
| ③ 邮件:info@361sale.com | |
| ④ 工作时间:周一至周五,9:30-18:30,节假日休息 | |
THE END





















![表情[wozuimei]-光子波动网 | 专业WordPress修复服务,全球范围,快速响应](https://www.361sale.com/wp-content/themes/zibll/img/smilies/wozuimei.gif)
![表情[baoquan]-光子波动网 | 专业WordPress修复服务,全球范围,快速响应](https://www.361sale.com/wp-content/themes/zibll/img/smilies/baoquan.gif)

暂无评论内容