559 lines
9.6 KiB
Markdown
559 lines
9.6 KiB
Markdown
|
|
### openPublishSidebar
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于通知用户已打开发布侧边栏的动作对象。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`:动作对象
|
|||
|
|
|
|||
|
|
### removeEditorPanel
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于从编辑器中移除面板的动作对象。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _panelName_ `string`:标识要移除的面板的字符串。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`:动作对象。
|
|||
|
|
|
|||
|
|
### requestMetaBoxUpdates
|
|||
|
|
|
|||
|
|
更新元数据框。
|
|||
|
|
|
|||
|
|
### setAvailableMetaBoxesPerLocation
|
|||
|
|
|
|||
|
|
存储关于哪些元数据框在哪些位置可用的信息。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _metaBoxesPerLocation_ `Object`:每个位置的元数据框。
|
|||
|
|
|
|||
|
|
### setIsEditingTemplate
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于切换到模板编辑的动作对象。
|
|||
|
|
|
|||
|
|
### setIsInserterOpened
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于打开/关闭插入器的动作对象。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _value_ `boolean|Object`:插入器应打开(true)还是关闭(false)。
|
|||
|
|
|
|||
|
|
### setIsListViewOpened
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于打开/关闭列表视图的动作对象。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _isOpen_ `boolean`:表示列表视图应打开还是关闭的布尔值。
|
|||
|
|
|
|||
|
|
### showBlockTypes
|
|||
|
|
|
|||
|
|
将提供的区块类型更新为可见。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _blockNames_ `string[]`:要显示的区块类型的名称。
|
|||
|
|
|
|||
|
|
### switchEditorMode
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
触发用于切换编辑器模式的动作。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _mode_ `string`:编辑器模式。
|
|||
|
|
|
|||
|
|
### toggleDistractionFree
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
切换无干扰模式的动作。无干扰模式下预期没有侧边栏,因为设置的 z-index 值会导致无法关闭侧边栏。
|
|||
|
|
|
|||
|
|
### toggleEditorPanelEnabled
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于启用或禁用编辑器中面板的动作对象。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _panelName_ `string`:标识要启用或禁用的面板的字符串。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`:动作对象。
|
|||
|
|
|
|||
|
|
### toggleEditorPanelOpened
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
打开已关闭的面板并关闭已打开的面板。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _panelName_ `string`:标识要打开或关闭的面板的字符串。
|
|||
|
|
|
|||
|
|
### toggleFeature
|
|||
|
|
|
|||
|
|
触发用于切换功能标志的动作。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _feature_ `string`:功能名称。
|
|||
|
|
|
|||
|
|
### toggleFullscreenMode
|
|||
|
|
|
|||
|
|
切换全屏模式视图选项的动作。
|
|||
|
|
|
|||
|
|
### togglePinnedPluginItem
|
|||
|
|
|
|||
|
|
触发用于切换插件名称标志的动作对象。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _pluginName_ `string`:插件名称。
|
|||
|
|
|
|||
|
|
### togglePublishSidebar
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于通知用户切换发布侧边栏的动作对象。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`:动作对象
|
|||
|
|
|
|||
|
|
### updatePreferredStyleVariations
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回用于通知在创建区块时应自动应用样式的动作对象。
|
|||
|
|
|
|||
|
|
<!-- END TOKEN(Autogenerated actions|../../../packages/edit-post/src/store/actions.js) -->
|
|||
|
|
|
|||
|
|
# 编辑器界面数据
|
|||
|
|
|
|||
|
|
命名空间:`core/edit-post`
|
|||
|
|
|
|||
|
|
## 选择器
|
|||
|
|
|
|||
|
|
<!-- START TOKEN(Autogenerated selectors|../../../packages/edit-post/src/store/selectors.js) -->
|
|||
|
|
|
|||
|
|
### areMetaBoxesInitialized
|
|||
|
|
|
|||
|
|
判断元框是否已完成初始化。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 元框是否已初始化
|
|||
|
|
|
|||
|
|
### getActiveGeneralSidebarName
|
|||
|
|
|
|||
|
|
返回当前活动的通用侧边栏名称,若无活动侧边栏则返回null。活动通用侧边栏是用于识别编辑器或插件侧边栏的唯一名称。
|
|||
|
|
|
|||
|
|
示例:
|
|||
|
|
|
|||
|
|
- `edit-post/document`
|
|||
|
|
- `my-plugin/insert-image-sidebar`
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `?string`: 活动通用侧边栏名称
|
|||
|
|
|
|||
|
|
### getActiveMetaBoxLocations
|
|||
|
|
|
|||
|
|
返回活动元框位置的数组。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 文章编辑器状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `string[]`: 活动元框位置
|
|||
|
|
|
|||
|
|
### getAllMetaBoxes
|
|||
|
|
|
|||
|
|
返回所有可用元框的列表。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Array`: 元框列表
|
|||
|
|
|
|||
|
|
### getEditedPostTemplate
|
|||
|
|
|
|||
|
|
获取当前编辑文章的模板。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `?Object`: 文章模板
|
|||
|
|
|
|||
|
|
### getEditorMode
|
|||
|
|
|
|||
|
|
返回当前编辑模式。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `string`: 编辑模式
|
|||
|
|
|
|||
|
|
### getHiddenBlockTypes
|
|||
|
|
|
|||
|
|
返回被隐藏的区块数组。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Array`: 隐藏区块类型列表
|
|||
|
|
|
|||
|
|
### getMetaBoxesPerLocation
|
|||
|
|
|
|||
|
|
返回指定位置的所有可用元框列表。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
- _location_ `string`: 要检测的元框位置
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `?Array`: 元框列表
|
|||
|
|
|
|||
|
|
### getPreference
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
- _preferenceKey_ `string`: 偏好设置键名
|
|||
|
|
- _defaultValue_ `*`: 默认值
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `*`: 偏好设置值
|
|||
|
|
|
|||
|
|
### getPreferences
|
|||
|
|
|
|||
|
|
返回偏好设置(这些设置会在本地持久化保存)。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`: 偏好设置对象
|
|||
|
|
|
|||
|
|
### hasMetaBoxes
|
|||
|
|
|
|||
|
|
判断文章是否正在使用元框。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 是否存在元框
|
|||
|
|
|
|||
|
|
### isEditingTemplate
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
判断是否启用了模板编辑模式。
|
|||
|
|
|
|||
|
|
### isEditorPanelEnabled
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
判断指定面板是否启用,面板默认处于启用状态。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
- _panelName_ `string`: 面板标识字符串
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 面板是否启用
|
|||
|
|
|
|||
|
|
### isEditorPanelOpened
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
判断指定面板是否打开,面板默认处于关闭状态。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
- _panelName_ `string`: 面板标识字符串
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 面板是否打开
|
|||
|
|
|
|||
|
|
### isEditorPanelRemoved
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
判断指定面板是否已被程序化移除,所有面板默认不会被移除。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
- _panelName_ `string`: 面板标识字符串
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 面板是否已被移除
|
|||
|
|
|
|||
|
|
### isEditorSidebarOpened
|
|||
|
|
|
|||
|
|
判断编辑器侧边栏是否打开。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 编辑器侧边栏是否打开
|
|||
|
|
|
|||
|
|
### isFeatureActive
|
|||
|
|
|
|||
|
|
判断指定功能是否启用。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态
|
|||
|
|
- _feature_ `string`: 功能标识符
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 是否处于活动状态
|
|||
|
|
|
|||
|
|
### isInserterOpened
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回插入器是否处于打开状态。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 插入器是否已打开。
|
|||
|
|
|
|||
|
|
### isListViewOpened
|
|||
|
|
|
|||
|
|
返回列表视图是否处于打开状态。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 列表视图是否已打开。
|
|||
|
|
|
|||
|
|
### isMetaBoxLocationActive
|
|||
|
|
|
|||
|
|
如果给定位置存在活动的元框则返回 true,否则返回 false。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 文章编辑器状态。
|
|||
|
|
- _location_ `string`: 要测试的元框位置。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 元框位置是否处于活动状态。
|
|||
|
|
|
|||
|
|
### isMetaBoxLocationVisible
|
|||
|
|
|
|||
|
|
如果元框位置处于活动状态且可见则返回 true。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 文章编辑器状态。
|
|||
|
|
- _location_ `string`: 要测试的元框位置。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 元框位置是否处于活动且可见状态。
|
|||
|
|
|
|||
|
|
### isModalActive
|
|||
|
|
|
|||
|
|
> **已弃用**(自 WP 6.3 起,请改用 `core/interface` 存储中间名选择器)
|
|||
|
|
|
|||
|
|
如果模态框处于活动状态则返回 true,否则返回 false。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态。
|
|||
|
|
- _modalName_ `string`: 唯一标识模态框的字符串。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 模态框是否处于活动状态。
|
|||
|
|
|
|||
|
|
### isPluginItemPinned
|
|||
|
|
|
|||
|
|
如果插件项已固定到标题区域则返回 true。未设置值时默认返回 true。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态。
|
|||
|
|
- _pluginName_ `string`: 插件项名称。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 插件项是否已固定。
|
|||
|
|
|
|||
|
|
### isPluginSidebarOpened
|
|||
|
|
|
|||
|
|
返回插件侧边栏是否处于打开状态。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 插件侧边栏是否已打开。
|
|||
|
|
|
|||
|
|
### isPublishSidebarOpened
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回发布侧边栏是否处于打开状态。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 发布侧边栏是否已打开。
|
|||
|
|
|
|||
|
|
### isSavingMetaBoxes
|
|||
|
|
|
|||
|
|
如果元框正在保存则返回 true。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _state_ `Object`: 全局应用状态。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `boolean`: 元框是否正在保存。
|
|||
|
|
|
|||
|
|
<!-- END TOKEN(Autogenerated selectors|../../../packages/edit-post/src/store/selectors.js) -->
|
|||
|
|
|
|||
|
|
## 操作
|
|||
|
|
|
|||
|
|
<!-- START TOKEN(Autogenerated actions|../../../packages/edit-post/src/store/actions.js) -->
|
|||
|
|
|
|||
|
|
### closeGeneralSidebar
|
|||
|
|
|
|||
|
|
返回表示用户关闭侧边栏的操作对象。
|
|||
|
|
|
|||
|
|
### closeModal
|
|||
|
|
|
|||
|
|
> **已弃用**(自 WP 6.3 起,请改用 `core/interface` 存储中间名操作)
|
|||
|
|
|
|||
|
|
返回表示用户关闭模态框的操作对象。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`: 操作对象。
|
|||
|
|
|
|||
|
|
### closePublishSidebar
|
|||
|
|
|
|||
|
|
> **已弃用**
|
|||
|
|
|
|||
|
|
返回表示用户关闭发布侧边栏的操作对象。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`: 操作对象。
|
|||
|
|
|
|||
|
|
### hideBlockTypes
|
|||
|
|
|
|||
|
|
将指定区块类型设置为隐藏状态。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _blockNames_ `string[]`: 需要隐藏的区块类型名称。
|
|||
|
|
|
|||
|
|
### initializeMetaBoxes
|
|||
|
|
|
|||
|
|
初始化 WordPress `postboxes` 脚本及元框保存逻辑。
|
|||
|
|
|
|||
|
|
### metaBoxUpdatesFailure
|
|||
|
|
|
|||
|
|
返回表示元框更新失败的操作对象。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`: 操作对象。
|
|||
|
|
|
|||
|
|
### metaBoxUpdatesSuccess
|
|||
|
|
|
|||
|
|
返回表示元框更新成功的操作对象。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`: 操作对象。
|
|||
|
|
|
|||
|
|
### openGeneralSidebar
|
|||
|
|
|
|||
|
|
返回表示用户打开编辑器侧边栏的操作对象。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _name_ `?string`: 要打开的侧边栏名称。
|
|||
|
|
|
|||
|
|
### openModal
|
|||
|
|
|
|||
|
|
> **已弃用**(自 WP 6.3 起,请改用 `core/interface` 存储中间名操作)
|
|||
|
|
|
|||
|
|
返回表示用户打开模态框的操作对象。
|
|||
|
|
|
|||
|
|
_参数_
|
|||
|
|
|
|||
|
|
- _name_ `string`: 唯一标识模态框的字符串。
|
|||
|
|
|
|||
|
|
_返回值_
|
|||
|
|
|
|||
|
|
- `Object`: 操作对象。
|