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/document
my-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
Stores info about which 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
Opens a closed panel and closes an open panel.
Parameters
- panelName
string
: A string that identifies the panel to open or close.
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.