The Editor’s UI Data
Edit
Namespace: core/edit-post.
Selectors
areMetaBoxesInitialized
Returns true if meta boxes are initialized.
Parameters
- state
Object: Global application state.
Returns
boolean: Whether meta boxes are initialized.
getActiveGeneralSidebarName
Returns the current active general sidebar name, or null if there is no
general sidebar active. The active general sidebar is a unique name to
identify either an editor or plugin sidebar.
Examples:
edit-post/documentmy-plugin/insert-image-sidebar
Parameters
- state
Object: Global application state.
Returns
?string: Active general sidebar name.
getActiveMetaBoxLocations
Returns an array of active meta box locations.
Parameters
- state
Object: Post editor state.
Returns
string[]: Active meta box locations.
getAllMetaBoxes
Returns the list of all the available meta boxes.
Parameters
- state
Object: Global application state.
Returns
Array: List of meta boxes.
getEditedPostTemplate
Retrieves the template of the currently edited post.
Returns
Object?: Post Template.
getEditorMode
Returns the current editing mode.
Parameters
- state
Object: Global application state.
Returns
string: Editing mode.
getHiddenBlockTypes
Returns an array of blocks that are hidden.
Returns
Array: A list of the hidden block types
getMetaBoxesPerLocation
Returns the list of all the available meta boxes for a given location.
Parameters
- state
Object: Global application state. - location
string: Meta box location to test.
Returns
?Array: List of meta boxes.
getPreference
Parameters
- state
Object: Global application state. - preferenceKey
string: Preference Key. - defaultValue
*: Default Value.
Returns
*: Preference Value.
getPreferences
Returns the preferences (these preferences are persisted locally).
Parameters
- state
Object: Global application state.
Returns
Object: Preferences Object.
hasMetaBoxes
Returns true if the post is using Meta Boxes
Parameters
- state
Object: Global application state
Returns
boolean: Whether there are metaboxes or not.
isEditingTemplate
Returns true if the template editing mode is enabled.
Parameters
- state
Object: Global application state.
Returns
boolean: Whether we’re editing the template.
isEditorPanelEnabled
Returns true if the given panel is enabled, or false otherwise. Panels are
enabled by default.
Parameters
- state
Object: Global application state. - panelName
string: A string that identifies the panel.
Returns
boolean: Whether or not the panel is enabled.
isEditorPanelOpened
Returns true if the given panel is open, or false otherwise. Panels are
closed by default.
Parameters
- state
Object: Global application state. - panelName
string: A string that identifies the panel.
Returns
boolean: Whether or not the panel is open.
isEditorPanelRemoved
Returns true if the given panel was programmatically removed, or false otherwise.
All panels are not removed by default.
Parameters
- state
Object: Global application state. - panelName
string: A string that identifies the panel.
Returns
boolean: Whether or not the panel is removed.
isEditorSidebarOpened
Returns true if the editor sidebar is opened.
Parameters
- state
Object: Global application state
Returns
boolean: Whether the editor sidebar is opened.
isFeatureActive
Returns whether the given feature is enabled or not.
Parameters
- state
Object: Global application state. - feature
string: Feature slug.
Returns
boolean: Is active.
isInserterOpened
Returns true if the inserter is opened.
Parameters
- state
Object: Global application state.
Returns
boolean: Whether the inserter is opened.
isListViewOpened
Returns true if the list view is opened.
Parameters
- state
Object: Global application state.
Returns
boolean: Whether the list view is opened.
isMetaBoxLocationActive
Returns true if there is an active meta box in the given location, or false
otherwise.
Parameters
- state
Object: Post editor state. - location
string: Meta box location to test.
Returns
boolean: Whether the meta box location is active.
isMetaBoxLocationVisible
Returns true if a metabox location is active and visible
Parameters
- state
Object: Post editor state. - location
string: Meta box location to test.
Returns
boolean: Whether the meta box location is active and visible.
isModalActive
Returns true if a modal is active, or false otherwise.
Parameters
- state
Object: Global application state. - modalName
string: A string that uniquely identifies the modal.
Returns
boolean: Whether the modal is active.
isPluginItemPinned
Returns true if the plugin item is pinned to the header.
When the value is not set it defaults to true.
Parameters
- state
Object: Global application state. - pluginName
string: Plugin item name.
Returns
boolean: Whether the plugin item is pinned.
isPluginSidebarOpened
Returns true if the plugin sidebar is opened.
Parameters
- state
Object: Global application state.
Returns
boolean: Whether the plugin sidebar is opened.
isPublishSidebarOpened
Returns true if the publish sidebar is opened.
Parameters
- state
Object: Global application state
Returns
boolean: Whether the publish sidebar is open.
isSavingMetaBoxes
Returns true if the Meta Boxes are being saved.
Parameters
- state
Object: Global application state.
Returns
boolean: Whether the metaboxes are being saved.
Actions
closeGeneralSidebar
Returns an action object signalling that the user closed the sidebar.
closeModal
Returns an action object signalling that the user closed a modal.
Returns
Object: Action object.
closePublishSidebar
Returns an action object used in signalling that the user closed the
publish sidebar.
Returns
Object: Action object.
hideBlockTypes
Update the provided block types to be hidden.
Parameters
- blockNames
string[]: Names of block types to hide.
initializeMetaBoxes
Initializes WordPress postboxes script and the logic for saving meta boxes.
metaBoxUpdatesFailure
Returns an action object used to signal a failed meta box update.
Returns
Object: Action object.
metaBoxUpdatesSuccess
Returns an action object used to signal a successful meta box update.
Returns
Object: Action object.
openGeneralSidebar
Returns an action object used in signalling that the user opened an editor sidebar.
Parameters
- name
?string: Sidebar name to be opened.
openModal
Returns an action object used in signalling that the user opened a modal.
Parameters
- name
string: A string that uniquely identifies the modal.
Returns
Object: Action object.
openPublishSidebar
Returns an action object used in signalling that the user opened the publish
sidebar.
Returns
Object: Action object
removeEditorPanel
Returns an action object used to remove a panel from the editor.
Parameters
- panelName
string: A string that identifies the panel to remove.
Returns
Object: Action object.
requestMetaBoxUpdates
Update a metabox.
setAvailableMetaBoxesPerLocation
Returns an action object used in signaling
what Meta boxes are available in which location.
Parameters
- metaBoxesPerLocation
Object: Meta boxes per location.
setIsEditingTemplate
Returns an action object used to switch to template editing.
Parameters
- value
boolean: Is editing template.
Returns
Object: Action object.
setIsInserterOpened
Returns an action object used to open/close the inserter.
Parameters
- value
boolean|Object: Whether the inserter should be opened (true) or closed (false). To specify an insertion point, use an object. - value.rootClientId
string: The root client ID to insert at. - value.insertionIndex
number: The index to insert at.
Returns
Object: Action object.
setIsListViewOpened
Returns an action object used to open/close the list view.
Parameters
- isOpen
boolean: A boolean representing whether the list view should be opened or closed.
Returns
Object: Action object.
showBlockTypes
Update the provided block types to be visible.
Parameters
- blockNames
string[]: Names of block types to show.
switchEditorMode
Triggers an action used to switch editor mode.
Parameters
- mode
string: The editor mode.
toggleEditorPanelEnabled
Returns an action object used to enable or disable a panel in the editor.
Parameters
- panelName
string: A string that identifies the panel to enable or disable.
Returns
Object: Action object.
toggleEditorPanelOpened
Returns an action object used to open or close a panel in the editor.
Parameters
- panelName
string: A string that identifies the panel to open or close.
Returns
Object: Action object.
toggleFeature
Triggers an action used to toggle a feature flag.
Parameters
- feature
string: Feature name.
togglePinnedPluginItem
Triggers an action object used to toggle a plugin name flag.
Parameters
- pluginName
string: Plugin name.
togglePublishSidebar
Returns an action object used in signalling that the user toggles the publish sidebar.
Returns
Object: Action object
updatePreferredStyleVariations
Returns an action object used in signaling that a style should be auto-applied when a block is created.
Parameters
- blockName
string: Name of the block. - blockStyle
?string: Name of the style that should be auto applied. If undefined, the “auto apply” setting of the block is removed.