@wordpress/components
Version:
UI components for WordPress.
104 lines (88 loc) • 3.05 kB
JavaScript
;
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