data-core-edit-post.md

The Editor’s UI Data

Namespace: core/edit-post.

Selectors

# 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

• Array<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.

# getEditorMode

Returns the current editing mode.

Parameters

• state Object: Global application state.

Returns

• string: Editing mode.

# 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.

# 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.

# 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.

Returns

• Object: Action object.

# 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

Returns an action object used in signalling that block types by the given name(s) should be hidden.

Parameters

• blockNames Array<string>: Names of block types to hide.

Returns

• Object: Action object.

# metaBoxUpdatesSuccess

Returns an action object used 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.

Returns

• Object: Action object.

# 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

Returns an action object used to request meta box update.

Returns

• Object: Action object.

# setAvailableMetaBoxesPerLocation

Returns an action object used in signaling what Meta boxes are available in which location.

Parameters

• metaBoxesPerLocation Object: Meta boxes per location.

Returns

• Object: Action object.

# showBlockTypes

Returns an action object used in signalling that block types by the given name(s) should be shown.

Parameters

• blockNames Array<string>: Names of block types to show.

Returns

• Object: Action object.

# switchEditorMode

Undocumented declaration.

# 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

Returns an action object used to toggle a feature flag.

Parameters

• feature string: Feature name.

Returns

• Object: Action object.

# togglePinnedPluginItem

Returns an action object used to toggle a plugin name flag.

Parameters

• pluginName string: Plugin name.

Returns

• Object: Action object.

# 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.

Returns

• Object: Action object.