WordPress 7.2 与 Gutenberg 24.1 开发者更新盘点

本期内容 somewhat 延迟了一些。我上周生病了，而且躺在沙发上整理两次 Gutenberg 发布以及一个月以来的 Make 文章，似乎比平时更费劲。我现在已经康复，本月也尝试了一些新做法。

与以往冗长地逐一介绍项目各个角落不同，这篇文章聚焦于我认为最重要的变化——如果你基于 WordPress 开发，无论是运营代理公司、自由职业，还是发布插件和主题。其他所有内容都链接在末尾的 Want more? 部分，以防我在重点内容中遗漏了重要事项。

7.2 开发周期即将结束。Beta 1 将于 2026 年 10 月 20 日推出，RC1 于 11 月 17 日推出，最终版本于 12 月 8 日发布。9 月还发布了三个安全版本，因此，如果你维护的任何网站不知为何错过了自动更新，请先处理好这件事，再阅读本文其余部分。

与往常一样，你可以运行 WordPress trunk 并搭配最新的 Gutenberg 版本来测试最新功能，或者启动一个 Playground 实例，完全无需进行设置。

目录

1. 7.2 路线图出炉
2. wp_kses() 将基于 HTML API 重构
3. 区块可以构建响应式自定义控件
4. 认识 Ipsum，全新的默认主题
5. 插件发布现在会接受自动化安全审查
6. 几乎所有 Core 区块都支持区块支持功能
7. Core 图标现在使用描边，而非填充
8. 图标集合现在可以设为私有
9. 文字阴影成为支持预设的区块支持功能
10. 7.2 默认关闭 NO_BACKSLASH_ESCAPES SQL 模式
11. 五个组件将被移除
12. 图库的网格变体及按视口设置的选项
13. Playground 新增终端和收件箱
14. Want more?
    1. 发布版本与时间表
    2. 编辑器与后台管理
    3. API 与数据
    4. 组件与界面
    5. 主题与区块

7.2 路线图出炉

WordPress 7.2 是 2026 年的最后一个主要版本，《7.2 路线图》详细列出了预计将推出的内容。文章明确指出，其中所有项目都“正在积极推进，但这并不一定意味着每一项都会进入最终发布版本”。

部分亮点包括：

• 安全：应用程序密码方面的改进，包括新增应用程序密码时发送邮件通知、检测非 HTTPS 环境、更安全的 default_role 值，以及支持 SameSite Cookie。Secrets API 目前仍属暂定性质，在 7.2 中将仅支持 CLI，之后计划推出 UI。sudo 模式提案也将于日后推出。
• 区块与 API：目录区块、目录区块转向服务端渲染、图标区块的关键词搜索，以及 Interactivity API 的一次迭代——该迭代将首先仅渲染受信任的值。
• 设计工具：自定义区块状态、全局样式中的表单元素、扩展并整合区块支持功能、进一步推进响应式样式状态，以及查看继承的样式。
• 后台管理：可扩展的站点编辑器、进一步迭代 DataViews 和 DataForms（包括基于 DataForm 的文章检查器），以及在后台工具栏和菜单中替换 Dashicons。
• 媒体与性能：动态图库、更多客户端媒体工作，以及用预加载取代脚本和样式合并。
• 尚未完全就绪：路线图中列出了 React 19 升级，但表示其“不太可能在 WordPress 7.2 中完全落地”。AI 相关工作，例如 Abilities 和 MCP Adapter，正在 AI 和 MCP Adapter 插件中进行。
• 不会纳入 7.2：协作编辑被明确排除在路线图之外。团队在介绍转向服务端感知协作方案时解释了原因。

Beta 1 将于 10 月 20 日发布，RC1 则于 11 月 17 日推出。如果其中任何变更会影响到你的插件或主题，请在这段时间内进行测试，此时反馈仍有可能影响最终发布。

wp_kses() 正在基于 HTML API 重构

这份 wp_kses() 进度报告介绍了如何在 HTML API 之上重构 WordPress 的 HTML 清理器，目标版本将根据测试进展定为 7.2 或 7.3。

新版本会规范化输出的标记，移除 script 和 style 元素的内容，并拒绝某些格式错误的 SVG、MathML 和注释。如果你的插件或主题会清理 HTML，随后比较、存储或测试结果，请立即针对 trunk 运行相关代码。

还有一个应急出口：wp_kses_force_legacy_parser 过滤器可以恢复旧有行为。请将其视为临时解决方案，而不是修复方案；如果 Trac 工单上出现任何问题，请及时报告。

如果你想了解新解析器是否会影响到你的 HTML，可以使用一个工具进行检查。

区块可以构建响应式自定义控件

响应式样式状态已随 WordPress 7.1 发布，但此前只有核心区块能够为其构建控件，因为它们所依赖的辅助函数是私有的。Gutenberg 24.1 将这些视口状态辅助函数公开，因此你的区块现在也可以像核心区块一样提供按断点划分的设置。

@wordpress/block-editor 现在导出 getStyleForState() 和 setStyleForState()。区块编辑器 store 还新增了 getSelectedBlockStyleState() 和 hasSelectedBlockStyleState() 选择器。下面是仅针对移动端断点设置最小高度的方法：

const state = { viewport: '@mobile' };
const stateStyle = getStyleForState( attributes.style, state ) || {};

setAttributes( {
	style: setStyleForState( attributes.style, state, {
		...stateStyle,
		dimensions: { ...stateStyle.dimensions, minHeight: '50vh' },
	} ),
} );

同一版本还允许位置随视口变化，因此页眉可以仅在移动端保持粘性。

认识 Ipsum，全新的默认主题

WordPress 7.2 将搭载一款全新的默认主题，并且打破了一项长期传统：它的名称并非取自年份。Ipsum 这款全新默认主题解释道，改用基于年份之外的命名方式意味着“默认主题将拥有自己的名称，并在设计需要时更替，而不是随着日历更替。”这个名称来自 lorem ipsum，即“在真实内容到来之前填满页面的占位文本”。

Ipsum 是一款刻意极简的博客主题，相当于一块为创意留出空间的空白画布。页面保持低调，只有点状下划线和少量经过排版的字体。标题、头图和边栏在需要时会出现，在创作时则退居一旁。它的样式变化比大多数主题更胜一筹：它们会为整个页面“重新上墨”，包括图片在内。团队还表示，每一种组合都符合 WCAG AA 标准，而不只是默认设计。

该主题目前已在 Ipsum GitHub 仓库开放测试。

插件发布现已接受自动化安全审查

如果你会向 WordPress.org 目录发布插件，你的发布时间安排正在发生变化。插件团队为插件发布引入了自动化安全审查。在发布冷却期内，多个 AI 模型和 Jetpack Scan 会对每个新版本进行评分。

高风险版本会被自动拦截，提交者也会收到包含审查结果的电子邮件。请确保你的提交者账户所用地址确实是有人会查看的。

几乎所有核心区块都支持区块支持功能

Gutenberg 24.1 主要围绕一件事展开：统一设计工具。约 140 个拉取请求为此前缺少现有区块支持功能的核心区块启用了相关支持。这包括背景图片、渐变、阴影、链接和按钮颜色、边框、分栏以及文本对齐。《Gutenberg 24.1 新功能》一文介绍了重点内容，24.1 变更日志则列出了所有区块。

对主题作者而言，这意味着你为 Code 区块添加阴影或为 Latest Posts 区块设置背景而编写的大量自定义 CSS，都可以移至 theme.json 中的 styles.blocks 下。

请注意，Accordion、Tabs、Tab Panel 和 Post Template 区块现在会输出 has-link-color及相关类。如果你的主题会为其中任何区块内部的链接设置样式，请在 7.2 之前检查是否存在特异性冲突。

Core 图标现在使用描边，而非填充

Core 图标集的重绘工作已在 Gutenberg 24.1 完成，始于 24.0。现在约有 330 个图标改为基于描边，并且每个图标都会在其 <svg> 上内联设置 fill：none。

fill 属性或 CSS fill 规则不再能为它们重新着色。请改用 CSS color。如果你的管理后台样式中有针对 Core 图标的 svg { fill: … } 规则，请检查一下。同时还要一并更新 @wordpress/icons 和 @wordpress/components，因为将新图标与旧版 Icon 组件混用可能会导致合并后的样式丢失。

图标集合现在可以设为私有

7.1 引入的 Icon Registration API 在 Gutenberg 24.1 中新增了一个用于图标集合的 public 参数：

wp_register_icon_collection( 'themeslug-admin', [
	'label'  => __( 'Theme Admin Icons', 'themeslug' ),
	'public' => false,
] );

非公开集合中的图标仍可与 wp_get_icon() 配合使用，但它们不会出现在 REST API 中，Icon 区块也不会在前端渲染它们。Core 使用这一机制建立了一个新的 core-admin 集合，用于存放管理工具栏和菜单图标。如果你的插件需要在自己的界面中使用某些图标，但不希望用户将其添加到帖子中，这非常适合。

文字阴影成为支持预设的区块功能

从 7.1 开始，全局样式就可以设置文字阴影。Gutenberg 24.1 将文字阴影变成了完整的区块支持功能，提供主题定义的预设以及“排版”面板中的选择器。Paragraph 和 Heading 区块默认启用。

对于你自己的区块，请在 block.json 中的 supports.typography 下添加 "textShadow": true。主题可以在 theme.json 中定义预设：

{
	"settings": {
		"typography": {
			"defaultTextShadowPresets": false,
			"textShadowPresets": [
				{
					"name": "Soft",
					"slug": "soft",
					"textShadow": "0.05em 0.05em 0.1em rgba(0, 0, 0, 0.25)"
				}
			]
		}
	}
}

每个预设都会生成一个 --wp--preset--text-shadow--{slug} 自定义属性和一个 .has-{slug}-text-shadow 类。

7.2 默认关闭 NO_BACKSLASH_ESCAPES SQL 模式

7.2 的第一则开发者说明涉及一项数据库更改：wpdb 现在会从 WordPress 自身的数据库会话中移除 NO_BACKSLASH_ESCAPES。

这不太可能影响大多数网站。如果你维护的某个网站确实依赖该模式，可以通过 incompatible_sql_modes 过滤器保留它，但只能通过 db.php 放置文件进行设置。插件和 mu-plugins 的加载时间太晚，无法更改它。

add_filter( 'incompatible_sql_modes', function ( $modes ) {
	return array_diff( $modes, [ 'NO_BACKSLASH_ESCAPES' ] );
} );

五个组件将被移除

Gutenberg 24.1 在 @wordpress/components 中弃用了 Divider、ResponsiveWrapper、Scrollable、ZStack 和 Elevation。它们从 7.2 起被标记为已弃用，并计划在 7.4 中移除。建议的替代方案是纯 CSS（用 aspect-ratio 替代 ResponsiveWrapper），或使用 Separator 组件替代 Divider。

同一版本还稳定了 MediaUpload 的特色图片流程：unstableFeaturedImageFlow 现在是 featuredImageFlow，旧名称也将按同样的路径在 7.4 中移除。

Gallery 的网格变体和按视口设置的选项

Gallery 区块在 Gutenberg 24.0 中获得了 Grid 变体。Flex 仍是默认选项，现有图库会保持原有行为，直到你进行切换。

Gallery 的 CSS 规则现在限定在 :where(.is-layout-flex) 范围内。特异性没有变化，但如果主题 CSS 假定这些规则始终适用，应使用 Grid 图库进行测试。

图库现在也可以按断点进行变化。在 Flex 布局中，列数和裁剪方式会随视口状态变化；宽高比在所有布局中也都如此。

Playground 新增终端和邮箱收件箱

两个新的 Playground 工具让它成为更真实的调试环境。Dev Tools Dock 新增了一个终端，可针对实时站点运行 PHP 和 WP-CLI 命令。它不支持 TTY，交互式或长时间运行的命令会被拒绝，因此无法使用 wp shell。Blueprint 中的 wp-cli 步骤也遵循相同规则。

新的 Email 工具会捕获通过 wp_mail() 发送的所有内容，并显示在浏览器中。这对于测试通知电子邮件很方便，无需配置邮件接收服务。不过请记住，它只能看到通过 sendmail 路径发送的邮件，而看不到基于 SMTP 或 API 的提供商发送的邮件。

想了解更多吗？

以上亮点是我不想让你错过的一些内容。以下是过去一个月的所有其他内容，按主题分组。

版本发布与日程安排

• WordPress 7.1.1 于 9 月 17 日发布，包含 11 项安全修复，随后发布了包含一项严重修复的 WordPress 7.1.2，以及包含另外七项修复的 WordPress 7.1.3。
• WordPress 7.2 发布小组已经确定，完整的 7.2 发布日程安排位于 Make/Core。
• 贡献者可以参与 7.2 缺陷排查和 7.2 测试排查。
• 要全面了解每个 Gutenberg 版本，请阅读 Gutenberg 24.0 有哪些新内容和 Gutenberg 24.1 有哪些新内容。

编辑器与管理后台

• 文章侧边栏正在基于 DataForm 重构，目前正在公开招募测试 DataForm 编辑器检查器。PluginPostExcerpt 可能无法在此次迁移后保留。
• Real Time Collaboration 正转向服务器感知方案，Presence API 功能插件也新增了函数和专用表格。
• Feature Notifications 插件发布了 0.3.0 的计划。
• 现在可以就工具栏中的 W 和站点名称提供反馈，截止日期为 10 月 16 日。

API 与数据

• 仅使用 PHP 的区块如果带有枚举数组属性，其生成的控件中现在会获得一个令牌字段。

组件与界面

• ToolsPanelItem 新增了 defaultShown 和 onShownChange 属性。
• @wordpress/ui 添加了 CheckboxControl、RadioGroupControl 和 SwitchControl，弹出窗口现在默认采用锚点的宽度。
• DataForm 组合字段现在仅用于布局，面板布局新增了 showPlaceholderIfEmpty 选项。
• DataViews 过滤器可以在数字字段上处理 isAny 和 isNone，选择器可以自行组合页脚。
• 新的 Escape 和 Enter 画布停止功能可让键盘用户离开编辑器画布。

主题与区块

• 主题可以使用自定义属性覆盖背景颜色添加的内边距。
• Site Title 区块新增了适配文本支持，这也会为前端的每个适配文本区块添加 has-fit-text 类。
• Navigation Link 区块现在被命名为“Navigation Link”，“Custom Link”被移至变体中。
• 可以从 URL 设置背景图片。
• Group 区块新增了文本列，Cover 区块的检查器中也新增了媒体部分。
• 脚注 ID 现在带有 fn- 前缀。
• 缺失的 blockGap 设置现在会被视为不受支持，不可用的对齐方式会显示为禁用，而不是隐藏。
• 主题目录的无障碍就绪标签将改为条件性标签。
• 更新 Core CSS 编码标准的提案正在公开征求意见。

感谢 @psykro 和 @welcher 对本文提供反馈和审阅。