UNPKG

@wordpress/components

Version:
104 lines (88 loc) 3.05 kB
"use strict"; var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault"); Object.defineProperty(exports, "__esModule", { value: true }); exports.Placeholder = Placeholder; exports.default = void 0; var _element = require("@wordpress/element"); var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")); var _classnames = _interopRequireDefault(require("classnames")); var _compose = require("@wordpress/compose"); var _primitives = require("@wordpress/primitives"); var _icon = _interopRequireDefault(require("../icon")); /** * External dependencies */ /** * WordPress dependencies */ /** * Internal dependencies */ const PlaceholderIllustration = (0, _element.createElement)(_primitives.SVG, { className: "components-placeholder__illustration", fill: "none", xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 60 60", preserveAspectRatio: "none" }, (0, _element.createElement)(_primitives.Path, { vectorEffect: "non-scaling-stroke", d: "M60 60 0 0" })); /** * Renders a placeholder. Normally used by blocks to render their empty state. * * ```jsx * import { Placeholder } from '@wordpress/components'; * import { more } from '@wordpress/icons'; * * const MyPlaceholder = () => <Placeholder icon={ more } label="Placeholder" />; * ``` */ function Placeholder(props) { const { icon, children, label, instructions, className, notices, preview, isColumnLayout, withIllustration, ...additionalProps } = props; const [resizeListener, { width }] = (0, _compose.useResizeObserver)(); // Since `useResizeObserver` will report a width of `null` until after the // first render, avoid applying any modifier classes until width is known. let modifierClassNames; if (typeof width === 'number') { modifierClassNames = { 'is-large': width >= 480, 'is-medium': width >= 160 && width < 480, 'is-small': width < 160 }; } const classes = (0, _classnames.default)('components-placeholder', className, modifierClassNames, withIllustration ? 'has-illustration' : null); const fieldsetClasses = (0, _classnames.default)('components-placeholder__fieldset', { 'is-column-layout': isColumnLayout }); return (0, _element.createElement)("div", (0, _extends2.default)({}, additionalProps, { className: classes }), withIllustration ? PlaceholderIllustration : null, resizeListener, notices, preview && (0, _element.createElement)("div", { className: "components-placeholder__preview" }, preview), (0, _element.createElement)("div", { className: "components-placeholder__label" }, (0, _element.createElement)(_icon.default, { icon: icon }), label), (0, _element.createElement)("fieldset", { className: fieldsetClasses }, !!instructions && (0, _element.createElement)("legend", { className: "components-placeholder__instructions" }, instructions), children)); } var _default = Placeholder; exports.default = _default; //# sourceMappingURL=index.js.map