## 3.2.0

-   `wp.data.withRehydratation` 已重命名为 `wp.data.withRehydration`
-   `wp.editor.ImagePlaceholder` 组件已移除，请改用 `wp.editor.MediaPlaceholder`
-   `wp.utils.deprecated` 函数已移除，请改用 `wp.deprecated`
-   `wp.utils.blob` 已移除，请改用 `wp.blob`
-   `getInserterItems`：移除了 `allowedBlockTypes` 参数，新增了 `parentUID` 参数
-   `getFrecentInserterItems` 选择器已移除，请改用 `getInserterItems`
-   `getSupportedBlocks` 选择器已移除，请改用 `canInsertBlockType`

## 3.1.0

-   `wp.blocks.*` 中的所有组件已移除，请改用 `wp.editor.*`
-   `wp.blocks.withEditorSettings` 已移除，请使用数据模块访问编辑器设置 `wp.data.select( "core/editor" ).getEditorSettings()`
-   `wp.utils.*` 中的所有 DOM 工具已移除，请改用 `wp.dom.*`
-   区块 API 中的 `isPrivate: true` 已移除，请改用 `supports.inserter: false`
-   `wp.utils.isExtraSmall` 函数已移除，请改用 `wp.viewport` 模块
-   `getEditedPostExcerpt` 选择器已移除（`core/editor`），请改用 `getEditedPostAttribute( 'excerpt' )`

## 3.0.0

-   `wp.blocks.registerCoreBlocks` 函数已移除，请改用 `wp.coreBlocks.registerCoreBlocks`
-   `RichText` 的原始 TinyMCE 事件处理程序已弃用，请改用[文档化属性](https://github.com/WordPress/gutenberg/blob/v3.0.0/editor/components/rich-text/README.md)、祖先事件处理程序，或通过 onSetup 访问内部编辑器实例事件中心

## 2.8.0

-   `wp.components.Autocomplete` 中的原始自动补全接口已更新，请改用最新自动补全接口。更多信息请参阅[自动补全文档](https://github.com/WordPress/gutenberg/blob/v2.8.0/components/autocomplete/README.md)
-   `getInserterItems`：`allowedBlockTypes` 参数现为必填项
-   `getFrecentInserterItems`：`allowedBlockTypes` 参数现为必填项

## 2.7.0

-   `wp.element.getWrapperDisplayName` 函数已移除，请改用 `wp.element.createHigherOrderComponent`

## 2.6.0

-   `wp.blocks.getBlockDefaultClassname` 函数已移除，请改用 `wp.blocks.getBlockDefaultClassName`
-   `wp.blocks.Editable` 组件已移除，请改用 `wp.blocks.RichText` 组件

## 2.5.0

-   不再支持从区块 `save` 返回原始 HTML，请改用 `wp.element.RawHTML` 组件
-   `wp.data.query` 高阶组件已移除，请改用 `wp.data.withSelect`

## 2.4.0

-   `wp.blocks.BlockDescription` 组件已移除，请改用 `description` 区块属性
-   `wp.blocks.InspectorControls.*` 组件已移除，请改用 `wp.components.*` 组件
-   `wp.blocks.source.*` 匹配器已移除，请改用声明式属性。更多信息请参阅[区块属性文档](/docs/reference-guides/block-api/block-attributes.md)
-   `wp.data.select( 'selector', ...args )` 已移除，请改用 `wp.data.select( reducerKey' ).*`
-   `wp.blocks.MediaUploadButton` 组件已移除，请改用 `wp.blocks.MediaUpload` 组件

```markdown
## 3.6.0

-   已移除 `wp.editor.editorMediaUpload`，请改用 `wp.editor.mediaUpload`
-   已移除 `wp.utils.getMimeTypesArray`
-   已移除 `wp.utils.mediaUpload`，请改用 `wp.editor.mediaUpload`
-   已移除 `wp.utils.preloadImage`
-   区块 API 中的 `supports.wideAlign` 已移除，请改用 `supports.alignWide`
-   已移除 `wp.blocks.isSharedBlock`，请改用 `wp.blocks.isReusableBlock`
-   已移除 fetchSharedBlocks 操作（`core/editor`），请改用 fetchReusableBlocks
-   已移除 receiveSharedBlocks 操作（`core/editor`），请改用 receiveReusableBlocks
-   已移除 saveSharedBlock 操作（`core/editor`），请改用 saveReusableBlock
-   已移除 deleteSharedBlock 操作（`core/editor`），请改用 deleteReusableBlock
-   已移除 updateSharedBlockTitle 操作（`core/editor`），请改用 updateReusableBlockTitle
-   已移除 convertBlockToSaved 操作（`core/editor`），请改用 convertBlockToReusable
-   已移除 getSharedBlock 选择器（`core/editor`），请改用 getReusableBlock
-   已移除 isSavingSharedBlock 选择器（`core/editor`），请改用 isSavingReusableBlock
-   已移除 isFetchingSharedBlock 选择器（`core/editor`），请改用 isFetchingReusableBlock
-   已移除 getSharedBlocks 选择器（`core/editor`），请改用 getReusableBlocks

## 3.5.0

-   已移除 `wp.components.ifCondition`，请改用 `wp.compose.ifCondition`
-   已移除 `wp.components.withGlobalEvents`，请改用 `wp.compose.withGlobalEvents`
-   已移除 `wp.components.withInstanceId`，请改用 `wp.compose.withInstanceId`
-   已移除 `wp.components.withSafeTimeout`，请改用 `wp.compose.withSafeTimeout`
-   已移除 `wp.components.withState`，请改用 `wp.compose.withState`
-   已移除 `wp.element.pure`，请改用 `wp.compose.pure`
-   已移除 `wp.element.compose`，请改用 `wp.compose.compose`
-   已移除 `wp.element.createHigherOrderComponent`，请改用 `wp.compose.createHigherOrderComponent`
-   已移除 `wp.utils.buildTermsTree`
-   已移除 `wp.utils.decodeEntities`，请改用 `wp.htmlEntities.decodeEntities`
-   所有区块 `uid` 的引用已替换为等效的 `clientId` 属性和选择器
-   `wp.editor.MediaPlaceholder` 组件的 `onSelectUrl` 属性已重命名为 `onSelectURL`
-   `wp.editor.UrlInput` 组件已重命名为 `wp.editor.URLInput`
-   已移除文本列区块，请改用列区块
-   已移除 `InnerBlocks` 分组布局，请改用中间嵌套内部区块。参考列/栏目块的实现方案
-   已移除 `RichText` 显式 `element` 格式，请改用兼容的 `children` 格式

## 3.4.0

-   `Popover` 组件中的 `focusOnMount` 属性已从仅布尔值改为枚举式属性，接受 `"firstElement"`、`"container"` 或 `false`。请将 `<Popover focusOnMount />` 用法转换为 `<Popover focusOnMount="firstElement" />`
-   已移除 `wp.utils.keycodes` 工具，请改用 `wp.keycodes`
-   已移除 `edit` 函数中的区块 `id` 属性，请改用区块 `clientId` 属性
-   已移除 `property` 源，请改用等效的 `text`、`html` 或 `attribute` 源，或注释属性

## 3.3.0

-   已从区块 API 中移除 `useOnce: true`，请改用 `supports.multiple: false`
-   使用 `componentWillMount` 生命周期方法序列化组件，请改用构造函数
-   已移除 `blocks.Autocomplete.completers` 过滤器，请改用 `editor.Autocomplete.completers`
-   已移除 `blocks.BlockEdit` 过滤器，请改用 `editor.BlockEdit`
-   已移除 `blocks.BlockListBlock` 过滤器，请改用 `editor.BlockListBlock`
-   已移除 `blocks.MediaUpload` 过滤器，请改用 `editor.MediaUpload`
```

-   PHP 函数 `gutenberg_show_privacy_policy_help_text` 已被移除。
-   PHP 函数 `gutenberg_common_scripts_and_styles` 已被移除。请改用 [`wp_common_block_scripts_and_styles`](https://developer.wordpress.org/reference/functions/wp_common_block_scripts_and_styles/)。
-   PHP 函数 `gutenberg_enqueue_registered_block_scripts_and_styles` 已被移除。请改用 [`wp_enqueue_registered_block_scripts_and_styles`](https://developer.wordpress.org/reference/functions/wp_enqueue_registered_block_scripts_and_styles/)。
-   PHP 函数 `gutenberg_meta_box_save` 已被移除。
-   PHP 函数 `gutenberg_meta_box_save_redirect` 已被移除。
-   PHP 函数 `gutenberg_filter_meta_boxes` 已被移除。
-   PHP 函数 `gutenberg_intercept_meta_box_render` 已被移除。
-   PHP 函数 `gutenberg_override_meta_box_callback` 已被移除。
-   PHP 函数 `gutenberg_show_meta_box_warning` 已被移除。
-   PHP 函数 `the_gutenberg_metaboxes` 已被移除。请改用 [`the_block_editor_meta_boxes`](https://developer.wordpress.org/reference/functions/the_block_editor_meta_boxes/)。
-   PHP 函数 `gutenberg_meta_box_post_form_hidden_fields` 已被移除。请改用 [`the_block_editor_meta_box_post_form_hidden_fields`](https://developer.wordpress.org/reference/functions/the_block_editor_meta_box_post_form_hidden_fields/)。
-   PHP 函数 `gutenberg_toggle_custom_fields` 已被移除。
-   PHP 函数 `gutenberg_collect_meta_box_data` 已被移除。请改用 [`register_and_do_post_meta_boxes`](https://developer.wordpress.org/reference/functions/register_and_do_post_meta_boxes/)。
-   `window._wpLoadGutenbergEditor` 已被移除。请改用 `window._wpLoadBlockEditor`。注意：这是一个私有 API，不供公共使用，未来可能会被移除。
-   PHP 函数 `gutenberg_get_script_polyfill` 已被移除。请改用 [`wp_get_script_polyfill`](https://developer.wordpress.org/reference/functions/wp_get_script_polyfill/)。
-   PHP 函数 `gutenberg_add_admin_body_class` 已被移除。如果需要将样式限定在块编辑器界面，请在样式表中使用 `.block-editor-page` 类选择器。

## 4.5.0

-   `Dropdown.refresh()` 已被弃用，因为其包含的 `Popover` 现在会自动刷新。
-   `wp.editor.PostPublishPanelToggle` 已被弃用，请改用 `wp.editor.PostPublishButton`。

## 4.4.0

-   `wp.date.getSettings` 已被移除。请改用 `wp.date.__experimentalGetSettings`。
-   `wp.compose.remountOnPropChange` 已被移除。
-   以下编辑器存储操作已被移除：`createNotice`、`removeNotice`、`createSuccessNotice`、`createInfoNotice`、`createErrorNotice`、`createWarningNotice`。请使用 `@wordpress/notices` 模块中同名的等效操作。
-   `wp.nux.DotTip` 的 `id` 属性已被移除。请改用 `tipId` 属性。
-   `wp.blocks.isValidBlock` 已被移除。请改用 `wp.blocks.isValidBlockContent`，但请注意参数顺序已更改。
-   `wp.data` 的 `registry.registerReducer` 已被弃用。请改用 `registry.registerStore`。
-   `wp.data` 的 `registry.registerSelectors` 已被弃用。请改用 `registry.registerStore`。
-   `wp.data` 的 `registry.registerActions` 已被弃用。请改用 `registry.registerStore`。
-   `wp.data` 的 `registry.registerResolvers` 已被弃用。请改用 `registry.registerStore`。
-   `moment` 已从日期模块的公共 API 中移除。

## 4.3.0

-   `isEditorSidebarPanelOpened` 选择器（`core/edit-post`）已被移除。请改用 `isEditorPanelEnabled`。
-   `toggleGeneralSidebarEditorPanel` 操作（`core/edit-post`）已被移除。请改用 `toggleEditorPanelOpened`。
-   `wp.components.PanelColor` 组件已被移除。请改用 `wp.editor.PanelColorSettings`。
-   `wp.editor.PanelColor` 组件已被移除。请改用 `wp.editor.PanelColorSettings`。

## 4.2.0

-   已将异步生成器形式的解析器移除，请改用 controls 插件
-   `wp.components.AccessibleSVG` 组件已移除，请改用 `wp.components.SVG`
-   `wp.editor.UnsavedChangesWarning` 组件不再接受 `forceIsDirty` 属性
-   `setActiveMetaBoxLocations` 操作（`core/edit-post`）已移除
-   `initializeMetaBoxState` 操作（`core/edit-post`）已移除
-   `wp.editPost.initializeEditor` 不再返回对象，请使用 `setActiveMetaBoxLocations` 操作（`core/edit-post`）替代原对象的 `initializeMetaBoxes` 函数
-   `setMetaBoxSavedData` 操作（`core/edit-post`）已移除
-   `getMetaBoxes` 选择器（`core/edit-post`）已移除，请改用 `getActiveMetaBoxLocations` 选择器（`core/edit-post`）
-   `getMetaBox` 选择器（`core/edit-post`）已移除，请改用 `isMetaBoxLocationActive` 选择器（`core/edit-post`）
-   属性类型强制转换已移除，需省略源以通过序列化注释标记保留类型
-   `wp.editor.mediaUpload` 的 `onFileChange` 回调所传对象中的 `mediaDetails` 已移除，请改用 `media_details` 属性
-   `wp.components.CodeEditor` 已移除，请直接使用 `wp.codeEditor`
-   `wp.blocks.setUnknownTypeHandlerName` 已移除，请改用 `setFreeformContentHandlerName` 和 `setUnregisteredTypeHandlerName`
-   `wp.blocks.getUnknownTypeHandlerName` 已移除，请改用 `getFreeformContentHandlerName` 和 `getUnregisteredTypeHandlerName`
-   可重用块数据 API 标记为实验性功能，未来可能变更

## 4.1.0

-   `wp.data.dispatch( 'core/editor' ).checkTemplateValidity` 已移除，区块重置时会自动进行有效性验证

## 4.0.0

-   `wp.editor.RichTextProvider` 已移除，请改用 `wp.data.select( 'core/editor' )` 方法
-   `wp.components.Draggable` 作为 DOM 节点拖拽处理器的功能已移除，请将 `wp.components.Draggable` 作为包装组件用于 DOM 节点拖拽处理器
-   `wp.i18n.getI18n` 已移除，请改用 `__`、`_x`、`_n` 或 `_nx`
-   `wp.i18n.dcnpgettext` 已移除，请改用 `__`、`_x`、`_n` 或 `_nx`

## 3.9.0

-   RichText 的 `getSettings` 属性已移除，如需继续使用请改用 `unstableGetSettings` 属性（强烈不建议使用不稳定 API，此类 API 可能随时被移除）
-   RichText 的 `onSetup` 属性已移除，如需继续使用请改用 `unstableOnSetup` 属性（强烈不建议使用不稳定 API，此类 API 可能随时被移除）
-   `wp.editor.getColorName` 已移除，请改用 `wp.editor.getColorObjectByColorValue`
-   `wp.editor.getColorClass` 已重命名，请改用 `wp.editor.getColorClassName`
-   `wp.editor.withColors` 所传颜色对象中的 `value` 属性已移除，请改用 color 属性
-   子标题区块已移除，请改用段落区块
-   `wp.blocks.getDefaultBlockForPostFormat` 已移除

## 3.8.0

-   `wp.components.withContext` 已移除，请改用 `wp.element.createContext`，参见：https://react.dev/reference/react/createContext
-   `wp.coreBlocks.registerCoreBlocks` 已移除，请改用 `wp.blockLibrary.registerCoreBlocks`
-   `wp.editor.DocumentTitle` 组件已移除
-   `getDocumentTitle` 选择器（`core/editor`）已移除

## 3.7.0

-   `wp.components.withAPIData` 已移除，请直接使用核心数据模块或 `wp.apiFetch`
-   `wp.data.dispatch("core").receiveTerms` 已弃用，请改用 `wp.data.dispatch("core").receiveEntityRecords`
-   `getCategories` 解析器已弃用，请改用 `getEntityRecords` 解析器
-   `wp.data.select("core").getTerms` 已弃用，请改用 `wp.data.select("core").getEntityRecords`
-   `wp.data.select("core").getCategories` 已弃用，请改用 `wp.data.select("core").getEntityRecords`
-   `wp.data.select("core").isRequestingCategories` 已弃用，请改用 `wp.data.select("core/data").isResolving`
-   `wp.data.select("core").isRequestingTerms` 已弃用，请改用 `wp.data.select("core").isResolving`
-   `wp.data.restrictPersistence`、`wp.data.setPersistenceStorage` 和 `wp.data.setupPersistence` 已移除，请改用数据持久化插件

# 已弃用功能

对于Gutenberg插件中包含的功能，弃用政策旨在尽可能支持两个次要插件版本的向后兼容性。WordPress稳定版本中包含的功能和代码不在此弃用时间线内，而是遵循[WordPress项目的版本管理政策](https://make.wordpress.org/core/handbook/about/release-cycle/version-numbering/)。当前已弃用的功能如下所示，并按*将完全移除这些功能的版本*进行分组。如果您的插件依赖这些行为，则必须在指定版本之前更新至推荐的替代方案。

## 未发布版本

-   `wp.blocks.isValidBlockContent` 已被移除。请改用 `wp.blocks.validateBlock`。

## 11.0.0

-   `wp.blocks.registerBlockTypeFromMetadata` 方法已被移除。请改用 `wp.blocks.registerBlockType` 方法。

## 10.3.0

-   不再支持向 `ActionItem.Slot` 组件传递带有 `as` 属性的组件元组。请改为传递带有 `as` 属性的组件。示例：
    ```diff
    <ActionItem.Slot
    	名称="my/slot"
    	标签={ __( '我的插槽' ) }
    - 	组件={ [ MenuGroup, MenuItem ] }
    + 	组件={ MenuGroup }
    />
    ```

## 9.7.0

-   `InterfaceSkeleton` 组件中的 `leftSidebar` 属性已被移除。请改用 `secondarySidebar` 属性。

## 8.6.0

-   更新了与[区块上下文](/docs/reference-guides/block-api/block-context.md)的区块API集成。注册区块时，请在JavaScript文件中使用 `usesContext` 和 `providesContext` 对，在PHP文件中使用 `uses_context` 和 `provides_context` 对，而不是之前的 `context` 和 `providesContext` 对。

## 8.3.0

-   PHP函数 `gutenberg_get_post_from_context` 已被移除。请改用[区块上下文](/docs/reference-guides/block-api/block-context.md)。
-   旧的区块模式API `register_pattern`/`unregister_pattern` 已被移除。请改用[新函数](/docs/reference-guides/block-api/block-patterns.md#register_block_pattern)。

## 5.5.0

-   PHP函数 `gutenberg_init` 已被移除。
-   PHP函数 `is_gutenberg_page` 已被移除。请改用 [`WP_Screen::is_block_editor`](https://developer.wordpress.org/reference/classes/wp_screen/is_block_editor/)。
-   PHP函数 `the_gutenberg_project` 已被移除。
-   PHP函数 `gutenberg_default_post_format_template` 已被移除。
-   PHP函数 `gutenberg_get_available_image_sizes` 已被移除。
-   PHP函数 `gutenberg_get_autosave_newer_than_post_save` 已被移除。
-   PHP函数 `gutenberg_editor_scripts_and_styles` 已被移除。

## 5.4.0

-   PHP函数 `gutenberg_load_plugin_textdomain` 已被移除。
-   PHP函数 `gutenberg_get_jed_locale_data` 已被移除。
-   PHP函数 `gutenberg_load_locale_data` 已被移除。

## 5.3.0

-   PHP函数 `gutenberg_redirect_to_classic_editor_when_saving_posts` 已被移除。
-   PHP函数 `gutenberg_revisions_link_to_editor` 已被移除。
-   PHP函数 `gutenberg_remember_classic_editor_when_saving_posts` 已被移除。
-   PHP函数 `gutenberg_can_edit_post_type` 已被移除。请改用 [`use_block_editor_for_post_type`](https://developer.wordpress.org/reference/functions/use_block_editor_for_post_type/)。
-   PHP函数 `gutenberg_can_edit_post` 已被移除。请改用 [`use_block_editor_for_post`](https://developer.wordpress.org/reference/functions/use_block_editor_for_post/)。

## 5.2.0

-   PHP函数 `gutenberg_parse_blocks` 已被移除。请改用 [`parse_blocks`](https://developer.wordpress.org/reference/functions/parse_blocks/)。
-   PHP函数 `get_dynamic_blocks_regex` 已被移除。
-   PHP函数 `gutenberg_render_block` 已被移除。请改用 [`render_block`](https://developer.wordpress.org/reference/functions/render_block/)。
-   PHP函数 `strip_dynamic_blocks` 已被移除。如需用于摘要准备，请考虑改用 [`excerpt_remove_blocks`](https://developer.wordpress.org/reference/functions/excerpt_remove_blocks/)。
-   PHP函数 `strip_dynamic_blocks_add_filter` 已被移除。
-   PHP函数 `strip_dynamic_blocks_remove_filter` 已被移除。
-   PHP函数 `gutenberg_post_has_blocks` 已被移除。请改用 [`has_blocks`](https://developer.wordpress.org/reference/functions/has_blocks/)。
-   PHP函数 `gutenberg_content_has_blocks` 已被移除。请改用 [`has_blocks`](https://developer.wordpress.org/reference/functions/has_blocks/)。
-   PHP函数 `gutenberg_register_rest_routes` 已被移除。
-   PHP函数 `gutenberg_add_taxonomy_visibility_field` 已被移除。
-   PHP函数 `gutenberg_get_taxonomy_visibility_data` 已被移除。
-   PHP函数 `gutenberg_add_permalink_template_to_posts` 已被移除。
-   PHP函数 `gutenberg_add_block_format_to_post_content` 已被移除。
-   PHP函数 `gutenberg_add_target_schema_to_links` 已被移除。
-   PHP函数 `gutenberg_register_post_prepare_functions` 已被移除。
-   PHP函数 `gutenberg_silence_rest_errors` 已被移除。
-   PHP函数 `gutenberg_filter_post_type_labels` 已被移除。
-   PHP函数 `gutenberg_preload_api_request` 已被移除。请改用 [`rest_preload_api_request`](https://developer.wordpress.org/reference/functions/rest_preload_api_request/)。
-   PHP函数 `gutenberg_remove_wpcom_markdown_support` 已被移除。
-   PHP函数 `gutenberg_add_gutenberg_post_state` 已被移除。
-   PHP函数 `gutenberg_bulk_post_updated_messages` 已被移除。
-   PHP函数 `gutenberg_kses_allowedtags` 已被移除。
-   PHP函数 `gutenberg_add_responsive_body_class` 已被移除。
-   PHP函数 `gutenberg_add_edit_link_filters` 已被移除。
-   PHP函数 `gutenberg_add_edit_link` 已被移除。
-   PHP函数 `gutenberg_block_bulk_actions` 已被移除。
-   PHP函数 `gutenberg_replace_default_add_new_button` 已被移除。
-   PHP函数 `gutenberg_content_block_version` 已被移除。请改用 [`block_version`](https://developer.wordpress.org/reference/functions/block_version/)。
-   PHP函数 `gutenberg_get_block_categories` 已被移除。请改用 [`get_block_categories`](https://developer.wordpress.org/reference/functions/get_block_categories/)。
-   PHP函数 `register_tinymce_scripts` 已被移除。请改用 [`wp_register_tinymce_scripts`](https://developer.wordpress.org/reference/functions/wp_register_tinymce_scripts/)。
-   PHP函数 `gutenberg_register_post_types` 已被移除。
-   `gutenberg` 主题支持选项已被移除。请改用 [`align-wide`](https://developer.wordpress.org/block-editor/developers/themes/theme-support/#wide-alignment)。
-   PHP函数 `gutenberg_prepare_blocks_for_js` 已被移除。请改用 [`get_block_editor_server_block_settings`](https://developer.wordpress.org/reference/functions/get_block_editor_server_block_settings/)。
-   PHP函数 `gutenberg_load_list_reusable_blocks` 已被移除。
-   PHP函数 `_gutenberg_utf8_split` 已被移除。请改用 `_mb_substr`。
-   PHP函数 `gutenberg_disable_editor_settings_wpautop` 已被移除。
-   PHP函数 `gutenberg_add_rest_nonce_to_heartbeat_response_headers` 已被移除。
-   PHP函数 `gutenberg_check_if_classic_needs_warning_about_blocks` 已被移除。
-   PHP函数 `gutenberg_warn_classic_about_blocks` 已被移除。