跳到主内容

WordPress Gutenberg 23.8/23.9 新特性:可运行代码示例、区块快捷键与 Site Editor v2

100%
WordPress Gutenberg 23.8/23.9 新特性:可运行代码示例、区块快捷键与 Site Editor v2

结论先行: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 } 对象写法。
升级前哨:内块模板和若干已废弃 props 会在 7.2 前要求迁移;如果你的主题/插件用 InnerBlocks 的 template prop,现在就该改到块类型设置。

Playground 的彩蛋

Playground 现在支持 WebMCP——一个把页面动作暴露成 AI 智能体可调工具的浏览器草案 API 。配合 WordPress 的 Abilities,意味着你能在浏览器里让智能体直接驱动站点操作。想深入全站编辑可看 WordPress 全站编辑实战,7.1 新特性回顾见 WordPress 7.1 「 Mary Lou 」特性实测,theme.json 调校见 theme.json 配置手册。


Gutenberg 23.8/23.9 需要手动升级吗?
Gutenberg 是插件,可单独更新;它通常随 WordPress 主版本收敛,想提前体验可在测试站更新插件。

内块模板改动会影响我的主题吗?
如果你用 InnerBlocks 的 template / templateInsertUpdatesSelection props,它们已废弃,7.2 前建议改到块类型设置,否则实时协作下会出现重复插入。

可运行代码示例要怎么写?
在 DocBlock 里用 “`php interactive 围栏写示例,WordPress 会用 Playground 实例执行并展示结果。

Site Editor v2 现在能用吗?
还在实验阶段,但已要求相关特性必须落地到可扩展站点编辑器,主题/插件扩展者值得提前关注。

查看 WordPress 开发者官方月刊
这篇有帮助吗?
云上的幻象
云上的幻象查看主页

七彩云博客,分享 WordPress 建站实战与 AI 工具测评,覆盖服务器运维、站长工具、软件资源与电商运营干货,专注原创实用的主题插件、网站加速与安全优化教程。

847文章4评论

相关文章

评论 (0)

欢迎你,新朋友,感谢参与互动!文明发言,理性交流 · 首次评论将在审核后展示