UNPKG

@wordpress/block-editor

Version:
148 lines (125 loc) 4.96 kB
"use strict"; var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault"); Object.defineProperty(exports, "__esModule", { value: true }); exports.BlockPreview = BlockPreview; exports.default = void 0; exports.useBlockPreview = useBlockPreview; var _element = require("@wordpress/element"); var _classnames = _interopRequireDefault(require("classnames")); var _compose = require("@wordpress/compose"); var _data = require("@wordpress/data"); var _deprecated = _interopRequireDefault(require("@wordpress/deprecated")); var _provider = require("../provider"); var _auto = _interopRequireDefault(require("./auto")); var _store = require("../../store"); var _blockList = require("../block-list"); /** * External dependencies */ /** * WordPress dependencies */ /** * Internal dependencies */ function BlockPreview({ blocks, viewportWidth = 1200, minHeight, additionalStyles = [], // Deprecated props: __experimentalMinHeight, __experimentalPadding }) { if (__experimentalMinHeight) { minHeight = __experimentalMinHeight; (0, _deprecated.default)('The __experimentalMinHeight prop', { since: '6.2', version: '6.4', alternative: 'minHeight' }); } if (__experimentalPadding) { additionalStyles = [...additionalStyles, { css: `body { padding: ${__experimentalPadding}px; }` }]; (0, _deprecated.default)('The __experimentalPadding prop of BlockPreview', { since: '6.2', version: '6.4', alternative: 'additionalStyles' }); } const originalSettings = (0, _data.useSelect)(select => select(_store.store).getSettings(), []); const settings = (0, _element.useMemo)(() => ({ ...originalSettings, __unstableIsPreviewMode: true }), [originalSettings]); const renderedBlocks = (0, _element.useMemo)(() => Array.isArray(blocks) ? blocks : [blocks], [blocks]); if (!blocks || blocks.length === 0) { return null; } return (0, _element.createElement)(_provider.ExperimentalBlockEditorProvider, { value: renderedBlocks, settings: settings }, (0, _element.createElement)(_auto.default, { viewportWidth: viewportWidth, minHeight: minHeight, additionalStyles: additionalStyles })); } /** * BlockPreview renders a preview of a block or array of blocks. * * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/block-preview/README.md * * @param {Object} preview options for how the preview should be shown * @param {Array|Object} preview.blocks A block instance (object) or an array of blocks to be previewed. * @param {number} preview.viewportWidth Width of the preview container in pixels. Controls at what size the blocks will be rendered inside the preview. Default: 700. * * @return {WPComponent} The component to be rendered. */ var _default = (0, _element.memo)(BlockPreview); /** * This hook is used to lightly mark an element as a block preview wrapper * element. Call this hook and pass the returned props to the element to mark as * a block preview wrapper, automatically rendering inner blocks as children. If * you define a ref for the element, it is important to pass the ref to this * hook, which the hook in turn will pass to the component through the props it * returns. Optionally, you can also pass any other props through this hook, and * they will be merged and returned. * * @param {Object} options Preview options. * @param {WPBlock[]} options.blocks Block objects. * @param {Object} options.props Optional. Props to pass to the element. Must contain * the ref if one is defined. * @param {Object} options.__experimentalLayout Layout settings to be used in the preview. * */ exports.default = _default; function useBlockPreview({ blocks, props = {}, __experimentalLayout }) { const originalSettings = (0, _data.useSelect)(select => select(_store.store).getSettings(), []); const settings = (0, _element.useMemo)(() => ({ ...originalSettings, __unstableIsPreviewMode: true }), [originalSettings]); const disabledRef = (0, _compose.useDisabled)(); const ref = (0, _compose.useMergeRefs)([props.ref, disabledRef]); const renderedBlocks = (0, _element.useMemo)(() => Array.isArray(blocks) ? blocks : [blocks], [blocks]); const children = (0, _element.createElement)(_provider.ExperimentalBlockEditorProvider, { value: renderedBlocks, settings: settings }, (0, _element.createElement)(_blockList.BlockListItems, { renderAppender: false, __experimentalLayout: __experimentalLayout })); return { ...props, ref, className: (0, _classnames.default)(props.className, 'block-editor-block-preview__live-content', 'components-disabled'), children: blocks?.length ? children : null }; } //# sourceMappingURL=index.js.map