结论先行:WordPress 2026 年 9 月开发者月刊聚焦 Gutenberg 23.8 与 23.9 两版更新——最亮眼的是 Code Reference 现在能直接在浏览器里「运行」代码示例,区块变体和转换可以自己声明快捷键,Site Editor 进入 v2(可扩展)时代。这些改动不少是 7.2 发布前的「迁移前哨」,插件和主题开发者现在就该留意。
最值得关注的三个亮点
1. Code Reference 可运行代码示例
现在打开像 WP_HTML_Processor::class_list() 这样的函数页,点一下 Run,示例代码就会在 Playground 驱动的真实 WordPress 实例上执行。示例直接写在 DocBlock 里,用名为 php interactive 的代码围栏:
/**
* ```php interactive
* $p = new WP_HTML_Tag_Processor( "<div class='free lang-en'>" );
* $p->next_tag();
* foreach ( $p->class_list() as $class_name ) {
* echo "{$class_name} ";
* }
* // 输出: "free lang-en "
* ```
*/
2. 区块变体/转换可声明快捷键
Gutenberg 23.9 给区块快捷键加了可声明 API 。过去 Alt+Shift+2 把段落转成 H2 是硬编码在各编辑器包里的私有逻辑,现在变体用单个 shortcut 对象声明,转换则用复数 shortcuts 数组,一个转换还能带六个快捷键而只在块切换器里出现一次。
wp.blocks.registerBlockVariation( 'core/heading', {
name: 'h2',
title: 'Heading 2',
attributes: { level: 2 },
isActive: ( attrs ) => attrs.level === 2,
shortcut: {
name: 'core/block-editor/transform-to-heading-2',
description: __( 'Transform the selected block into a heading 2.' ),
keyCombination: { modifier: 'access', character: '2' },
},
} );
3. Site Editor 进入 v2(可扩展)
Gutenberg 23.9 围绕 Boot 包合入了约二十个 PR,推进 Site Editor v2:Identity 路由、带 Global Styles 编辑的主题预览页、已注册插件的挂载点、实体记录间的画布导航、未保存变更警告,以及按主题支持门控的主题页。贡献指南已要求站点编辑器相关特性必须落地到可扩展站点编辑器。
插件与工具层还有哪些改动?
- DataViews 去除私有 API:不再依赖 @wordpress/private-apis,Calendar 、 RangeCalendar 等组件迁到公共包,减少「 Cannot unlock an object 」类报错。
- 内块模板移入块设置:template / templateInsertUpdatesSelection 从 InnerBlocks 的 props 改为块类型设置,为实时协作做准备;约 20 个核心块已迁移,旧 props 已废弃,7.2 前建议改完。
- PHP-only 块 schema 支持:autoRegister 进入 block.json schema,编辑器自动补全更顺手。
- kebab-case 统一:JS 侧用 @wordpress/kebab-case,输出与 PHP 的 _wp_to_kebab_case 一致。
- 编辑器使用管理配色:getAdminThemeColors() 公开,自定义后台界面可自动跟随用户配色。
- DataViews 时间字段:新增 time 字段类型(HH:mm / HH:mm:ss),适合营业时间、预约时段等场景。
主题层:为 7.2 提前做准备
- States theme.json schema 修复:7.1 的响应式与伪类状态 schema 不完整,23.8 修好了,编辑器里不再把 states 标红。
- 样式 UI 可收起:blockStatesEditingEnabled / responsiveEditingEnabled 默认 true,可用 filter 关掉,方便锁定客户站。
- label 可经 Global Styles 定制:styles.elements.label 现在可用,覆盖 Search 、 Form Input 等块。
- Group 块双向间距:blockGap 现在支持 { top, left } 对象写法。
Playground 的彩蛋
Playground 现在支持 WebMCP——一个把页面动作暴露成 AI 智能体可调工具的浏览器草案 API 。配合 WordPress 的 Abilities,意味着你能在浏览器里让智能体直接驱动站点操作。想深入全站编辑可看 WordPress 全站编辑实战,7.1 新特性回顾见 WordPress 7.1 「 Mary Lou 」特性实测,theme.json 调校见 theme.json 配置手册。










评论 (0)