diff --git a/packages/block-editor/README.md b/packages/block-editor/README.md index 6ac825da4925e6..de914a553c0bca 100644 --- a/packages/block-editor/README.md +++ b/packages/block-editor/README.md @@ -207,6 +207,12 @@ _Related_ Undocumented declaration. +### BlockPopover + +_Related_ + +- + ### BlockPreview BlockPreview renders a preview of a block or array of blocks. diff --git a/packages/block-editor/src/components/block-popover/README.md b/packages/block-editor/src/components/block-popover/README.md index c60da7a982ae87..c50e8c90647f69 100644 --- a/packages/block-editor/src/components/block-popover/README.md +++ b/packages/block-editor/src/components/block-popover/README.md @@ -30,7 +30,7 @@ This determines whether the block popover always shifts into the viewport or rem - Required: No - Default: `true` -## BlockPopoverInbetween +## BlockPopoverInbetween - Private Component ### Props diff --git a/packages/block-editor/src/components/block-popover/cover.js b/packages/block-editor/src/components/block-popover/cover.js index 02c31ca1f2dfec..caad2ddbb7ec56 100644 --- a/packages/block-editor/src/components/block-popover/cover.js +++ b/packages/block-editor/src/components/block-popover/cover.js @@ -7,7 +7,7 @@ import { useEffect, useState, useMemo, forwardRef } from '@wordpress/element'; * Internal dependencies */ import { __unstableUseBlockElement as useBlockElement } from '../block-list/use-block-props/use-block-refs'; -import BlockPopover from '.'; +import { PrivateBlockPopover } from '.'; function BlockPopoverCover( { @@ -25,7 +25,7 @@ function BlockPopoverCover( const selectedElement = useBlockElement( clientId ); return ( - + ); } diff --git a/packages/block-editor/src/components/block-popover/index.js b/packages/block-editor/src/components/block-popover/index.js index 9dd700b1e06e6d..cc8d832c31bc70 100644 --- a/packages/block-editor/src/components/block-popover/index.js +++ b/packages/block-editor/src/components/block-popover/index.js @@ -152,4 +152,25 @@ function BlockPopover( ); } -export default forwardRef( BlockPopover ); +export const PrivateBlockPopover = forwardRef( BlockPopover ); + +const PublicBlockPopover = ( + { clientId, bottomClientId, children, ...props }, + ref +) => ( + + { children } + +); + +/** + * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/block-popover/README.md + */ +export default forwardRef( PublicBlockPopover ); diff --git a/packages/block-editor/src/components/block-tools/block-toolbar-breadcrumb.js b/packages/block-editor/src/components/block-tools/block-toolbar-breadcrumb.js index 7a1ffabe629567..0ae67e1be0001e 100644 --- a/packages/block-editor/src/components/block-tools/block-toolbar-breadcrumb.js +++ b/packages/block-editor/src/components/block-tools/block-toolbar-breadcrumb.js @@ -7,7 +7,7 @@ import clsx from 'clsx'; * Internal dependencies */ import BlockSelectionButton from './block-selection-button'; -import BlockPopover from '../block-popover'; +import { PrivateBlockPopover } from '../block-popover'; import useBlockToolbarPopoverProps from './use-block-toolbar-popover-props'; import useSelectedBlockToolProps from './use-selected-block-tool-props'; @@ -28,7 +28,7 @@ export default function BlockToolbarBreadcrumb( { } ); return ( - - + ); } diff --git a/packages/block-editor/src/components/index.js b/packages/block-editor/src/components/index.js index 5263ca3332b250..2a127feb3df1cc 100644 --- a/packages/block-editor/src/components/index.js +++ b/packages/block-editor/src/components/index.js @@ -160,6 +160,7 @@ export { export { default as __experimentalBlockPatternsList } from './block-patterns-list'; export { default as __experimentalPublishDateTimePicker } from './publish-date-time-picker'; export { default as __experimentalInspectorPopoverHeader } from './inspector-popover-header'; +export { default as BlockPopover } from './block-popover'; export { useBlockEditingMode } from './block-editing-mode'; /* diff --git a/packages/block-editor/src/private-apis.js b/packages/block-editor/src/private-apis.js index 29cc5eecc37531..a064d7a389ecf8 100644 --- a/packages/block-editor/src/private-apis.js +++ b/packages/block-editor/src/private-apis.js @@ -39,6 +39,7 @@ import { } from './store/private-keys'; import { requiresWrapperOnCopy } from './components/writing-flow/utils'; import { PrivateRichText } from './components/rich-text/'; +import { PrivateBlockPopover } from './components/block-popover'; /** * Private @wordpress/block-editor APIs. @@ -78,4 +79,5 @@ lock( privateApis, { requiresWrapperOnCopy, PrivateRichText, reusableBlocksSelectKey, + PrivateBlockPopover, } );