2551654928/gutenbergdocs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2080fa3878
gutenbergdocs/contributors/code/deprecations.md

309 lines
21 KiB
Markdown
Raw Normal View History

first commit
2025-10-21 17:33:45 +00:00
## 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 Copy Permalink