WordPress Gutenberg 编辑器自定义实体保存提示问题解析

问题背景

在 WordPress Gutenberg 编辑器开发过程中，开发者创建自定义实体时遇到一个用户体验问题：当保存包含自定义实体的文章时，编辑器总会弹出提示询问是否要保存"Untitled"实体记录。这个问题在开发动态表格等自定义功能时尤为明显。

技术原理分析

Gutenberg 编辑器核心数据模块(core-data)在处理非文章类型实体时有一套特殊的保存机制：

1. 编辑器会通过 hasNonPostEntityChanges 方法检查是否有非文章类型的实体变更
2. 该方法会筛选出 kind 不为 postType 且 name 不为 wp_template 的脏实体记录
3. 对于这些实体，编辑器会强制显示保存确认提示

问题复现条件

这个问题会在以下情况下出现：

1. 开发者创建了自定义实体（非文章类型）
2. 该实体被集成到自定义区块中
3. 用户在编辑器中修改包含该区块的文章并尝试保存

解决方案

目前官方推荐的解决方案是在实体定义中添加 getTitle 属性：

dispatch('core').addEntities([
    {
        name: 'table',
        kind: 'dynamic-tables',
        baseURL: '/dynamic-tables/v1/tables',
        baseURLParams: { context: 'edit' },
        plural: 'tables',
        label: __('Table'),
        getTitle: ( record ) => record?.title || __( 'Table name' ),
    }
]);

getTitle 是一个回调函数，接收实体记录作为参数，开发者可以在此返回适当的标题文本，替代默认的"Untitled"提示。

深入讨论

虽然上述方案解决了标题显示问题，但从架构角度看，这种强制提示机制可能并不适合所有自定义实体场景。例如：

1. 当自定义实体实质上是区块的附属数据时（类似段落区块的内容）
2. 当实体变更与文章保存应视为原子操作时
3. 当提示会破坏用户体验流程时

核心开发团队已意识到这个问题，并在考虑更灵活的提示控制机制，可能的改进方向包括：

1. 为实体添加提示显示/隐藏的配置选项
2. 根据实体类型自动判断是否需要提示
3. 提供更细粒度的提示控制API

最佳实践建议

在当前版本下，开发者可以采取以下策略：

1. 为所有自定义实体明确定义 getTitle 属性
2. 在实体记录中维护有效的标题字段
3. 对于确实不需要提示的场景，可以考虑将数据存储在区块属性而非独立实体中
4. 关注核心代码库的相关讨论，及时了解API变更

总结

Gutenberg 编辑器对自定义实体的处理机制仍在不断完善中。开发者在使用自定义实体功能时，应当充分理解现有机制的工作原理，合理设计数据结构，并通过官方推荐的方式优化用户体验。随着编辑器功能的演进，相信会提供更灵活的控制选项来满足各种开发场景的需求。