2551654928/gutenbergdocs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2080fa3878
gutenbergdocs/contributors/code/deprecations.md
unknown 2080fa3878 first commit
2025-10-22 01:33:45 +08:00

309 lines
21 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 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` 已被移除。
Reference in New Issue View Git Blame Copy Permalink