@wordpress/components
Version:
UI components for WordPress.
365 lines (364 loc) • 15 kB
JavaScript
;
Object.defineProperties(exports, {
__esModule: { value: true },
[Symbol.toStringTag]: { value: "Module" }
});
// \0rolldown/runtime.js
var __create = Object.create;
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __getProtoOf = Object.getPrototypeOf;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
key = keys[i];
if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
get: ((k) => from[k]).bind(null, key),
enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
});
}
return to;
};
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
value: mod,
enumerable: true
}) : target, mod));
let clsx = require("clsx");
clsx = __toESM(clsx);
let _floating_ui_react_dom = require("@floating-ui/react-dom");
let framer_motion = require("framer-motion");
let _wordpress_element = require("@wordpress/element");
let _wordpress_compose = require("@wordpress/compose");
let _wordpress_icons = require("@wordpress/icons");
let _wordpress_deprecated = require("@wordpress/deprecated");
_wordpress_deprecated = __toESM(_wordpress_deprecated);
let _wordpress_primitives = require("@wordpress/primitives");
let _wordpress_i18n = require("@wordpress/i18n");
let ___button_index_tsx = require("../button/index.cjs");
___button_index_tsx = __toESM(___button_index_tsx);
let ___scroll_lock_index_tsx = require("../scroll-lock/index.cjs");
___scroll_lock_index_tsx = __toESM(___scroll_lock_index_tsx);
let ___slot_fill_index_tsx = require("../slot-fill/index.cjs");
let __utils_ts = require("./utils.cjs");
let ___context_index_ts = require("../context/index.cjs");
let __overlay_middlewares_tsx = require("./overlay-middlewares.cjs");
let ___style_provider_index_tsx = require("../style-provider/index.cjs");
let react_jsx_runtime = require("react/jsx-runtime");
let __context_ts = require("./context.cjs");
// packages/components/src/popover/index.tsx
/**
* Name of slot in which popover should fill.
*
* @type {string}
*/
const SLOT_NAME = "Popover";
/**
* Virtual padding to account for overflow boundaries.
*
* @type {number}
*/
const OVERFLOW_PADDING = 8;
/**
* How long to wait after the last position update before dropping the
* `will-change` hint.
*
* @type {number}
*/
const WILL_CHANGE_IDLE_TIMEOUT = 200;
const ArrowTriangle = () => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_wordpress_primitives.SVG, {
xmlns: "http://www.w3.org/2000/svg",
viewBox: "0 0 100 100",
className: "components-popover__triangle",
role: "presentation",
children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_wordpress_primitives.Path, {
className: "components-popover__triangle-bg",
d: "M 0 0 L 50 50 L 100 0"
}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_wordpress_primitives.Path, {
className: "components-popover__triangle-border",
d: "M 0 0 L 50 50 L 100 0",
vectorEffect: "non-scaling-stroke"
})]
});
const fallbackContainerClassname = "components-popover__fallback-container";
const getPopoverFallbackContainer = () => {
let container = document.body.querySelector("." + fallbackContainerClassname);
if (!container) {
container = document.createElement("div");
container.className = fallbackContainerClassname;
document.body.append(container);
}
return container;
};
const UnforwardedPopover = (props, forwardedRef) => {
const { animate = true, headerTitle, constrainTabbing, onClose, children, className, noArrow = true, position, placement: placementProp = "bottom-start", offset: offsetProp = 0, focusOnMount = "firstElement", anchor, expandOnMobile, onFocusOutside, __unstableSlotName = SLOT_NAME, flip = true, resize = true, shift = false, inline = false, variant, style: contentStyle, __unstableForcePosition, anchorRef, anchorRect, getAnchorRect, isAlternate, onKeyDown, ...contentProps } = (0, ___context_index_ts.useContextSystem)(props, "Popover");
let computedFlipProp = flip;
let computedResizeProp = resize;
if (__unstableForcePosition !== void 0) {
(0, _wordpress_deprecated.default)("`__unstableForcePosition` prop in wp.components.Popover", {
since: "6.1",
version: "6.3",
alternative: "`flip={ false }` and `resize={ false }`"
});
computedFlipProp = !__unstableForcePosition;
computedResizeProp = !__unstableForcePosition;
}
if (anchorRef !== void 0) (0, _wordpress_deprecated.default)("`anchorRef` prop in wp.components.Popover", {
since: "6.1",
alternative: "`anchor` prop"
});
if (anchorRect !== void 0) (0, _wordpress_deprecated.default)("`anchorRect` prop in wp.components.Popover", {
since: "6.1",
alternative: "`anchor` prop"
});
if (getAnchorRect !== void 0) (0, _wordpress_deprecated.default)("`getAnchorRect` prop in wp.components.Popover", {
since: "6.1",
alternative: "`anchor` prop"
});
const computedVariant = isAlternate ? "toolbar" : variant;
if (isAlternate !== void 0) (0, _wordpress_deprecated.default)("`isAlternate` prop in wp.components.Popover", {
since: "6.2",
alternative: "`variant` prop with the `'toolbar'` value"
});
const arrowRef = (0, _wordpress_element.useRef)(null);
const [fallbackReferenceElement, setFallbackReferenceElement] = (0, _wordpress_element.useState)(null);
const anchorRefFallback = (0, _wordpress_element.useCallback)((node) => {
setFallbackReferenceElement(node);
}, []);
const isMobileViewport = (0, _wordpress_compose.useViewportMatch)("medium", "<");
const isExpanded = expandOnMobile && isMobileViewport;
const hasArrow = !isExpanded && !noArrow;
const normalizedPlacementFromProps = position ? (0, __utils_ts.positionToPlacement)(position) : placementProp;
const middleware = [
...placementProp === "overlay" ? (0, __overlay_middlewares_tsx.overlayMiddlewares)() : [],
(0, _floating_ui_react_dom.offset)(offsetProp),
computedFlipProp && (0, _floating_ui_react_dom.flip)(),
computedResizeProp && (0, _floating_ui_react_dom.size)({
padding: OVERFLOW_PADDING,
apply(sizeProps) {
const { firstElementChild } = refs.floating.current ?? {};
if (!(firstElementChild instanceof HTMLElement)) return;
Object.assign(firstElementChild.style, {
maxHeight: `${Math.max(0, sizeProps.availableHeight)}px`,
overflow: "auto"
});
}
}),
shift && (0, _floating_ui_react_dom.shift)({
crossAxis: true,
limiter: (0, _floating_ui_react_dom.limitShift)(),
padding: 1
}),
(0, _floating_ui_react_dom.arrow)({ element: arrowRef })
];
const slotName = (0, _wordpress_element.useContext)(__context_ts.slotNameContext) || __unstableSlotName;
const slot = (0, ___slot_fill_index_tsx.useSlot)(slotName);
let onDialogClose;
if (onClose || onFocusOutside) onDialogClose = (type, event) => {
if (type === "focus-outside") {
const blurTarget = event?.target;
const referenceElement = refs.reference.current;
const floatingElement = refs.floating.current;
const isBlurFromThisPopover = referenceElement && "contains" in referenceElement && referenceElement.contains(blurTarget) || floatingElement?.contains(blurTarget);
const ownerDocument = floatingElement?.ownerDocument;
if (!isBlurFromThisPopover && !("relatedTarget" in event && event.relatedTarget) && ownerDocument?.activeElement === ownerDocument?.body) return;
const relatedTarget = "relatedTarget" in event ? event.relatedTarget : null;
if (relatedTarget instanceof Element && relatedTarget.closest("[data-wp-compat-overlay-slot]")) return;
if (floatingElement && ownerDocument?.activeElement instanceof Element && floatingElement.contains(ownerDocument.activeElement)) return;
if (onFocusOutside) onFocusOutside(event);
else if (onClose) onClose();
} else if (onClose) onClose();
};
const [dialogRef, dialogProps] = (0, _wordpress_compose.__experimentalUseDialog)({
constrainTabbing,
focusOnMount,
onKeyDown,
__unstableOnClose: onDialogClose,
onClose: onDialogClose
});
const { x, y, refs, elements, strategy, update, placement: computedPlacement, middlewareData: { arrow: arrowData } } = (0, _floating_ui_react_dom.useFloating)({
placement: normalizedPlacementFromProps === "overlay" ? void 0 : normalizedPlacementFromProps,
middleware,
whileElementsMounted: (referenceParam, floatingParam, updateParam) => (0, _floating_ui_react_dom.autoUpdate)(referenceParam, floatingParam, updateParam, {
layoutShift: false,
animationFrame: true
})
});
const arrowCallbackRef = (0, _wordpress_element.useCallback)((node) => {
arrowRef.current = node;
update();
}, [update]);
const anchorRefTop = anchorRef?.top;
const anchorRefBottom = anchorRef?.bottom;
const anchorRefStartContainer = anchorRef?.startContainer;
const anchorRefCurrent = anchorRef?.current;
(0, _wordpress_element.useLayoutEffect)(() => {
const resultingReferenceElement = (0, __utils_ts.getReferenceElement)({
anchor,
anchorRef,
anchorRect,
getAnchorRect,
fallbackReferenceElement
});
refs.setReference(resultingReferenceElement);
}, [
anchor,
anchorRef,
anchorRefTop,
anchorRefBottom,
anchorRefStartContainer,
anchorRefCurrent,
anchorRect,
getAnchorRect,
fallbackReferenceElement,
refs
]);
const popoverElementRef = (0, _wordpress_element.useRef)(null);
const mergedFloatingRef = (0, _wordpress_compose.useMergeRefs)([
refs.setFloating,
dialogRef,
popoverElementRef,
forwardedRef
]);
(0, _wordpress_element.useLayoutEffect)(() => {
const popoverElement = popoverElementRef.current;
if (!popoverElement) return;
popoverElement.style.willChange = "transform";
const timeoutId = setTimeout(() => {
popoverElement.style.willChange = "auto";
}, WILL_CHANGE_IDLE_TIMEOUT);
return () => clearTimeout(timeoutId);
}, [
x,
y,
elements.floating
]);
const style = isExpanded ? void 0 : {
position: strategy,
top: 0,
left: 0,
x: (0, __utils_ts.computePopoverPosition)(x),
y: (0, __utils_ts.computePopoverPosition)(y)
};
const shouldReduceMotion = (0, _wordpress_compose.useReducedMotion)();
const shouldAnimate = animate && !isExpanded && !shouldReduceMotion;
const [animationFinished, setAnimationFinished] = (0, _wordpress_element.useState)(false);
const { style: motionInlineStyles, ...otherMotionProps } = (0, _wordpress_element.useMemo)(() => (0, __utils_ts.placementToMotionAnimationProps)(computedPlacement), [computedPlacement]);
const animationProps = shouldAnimate ? {
style: {
...contentStyle,
...motionInlineStyles,
...style
},
onAnimationComplete: () => setAnimationFinished(true),
...otherMotionProps
} : {
animate: false,
style: {
...contentStyle,
...style
}
};
const isPositioned = (!shouldAnimate || animationFinished) && x !== null && y !== null;
let content = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(framer_motion.motion.div, {
className: (0, clsx.default)(className, {
"is-expanded": isExpanded,
"is-positioned": isPositioned,
[`is-${computedVariant === "toolbar" ? "alternate" : computedVariant}`]: computedVariant
}),
...animationProps,
...contentProps,
ref: mergedFloatingRef,
...dialogProps,
tabIndex: -1,
children: [
isExpanded && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(___scroll_lock_index_tsx.default, {}),
isExpanded && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
className: "components-popover__header",
children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
className: "components-popover__header-title",
children: headerTitle
}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(___button_index_tsx.default, {
className: "components-popover__close",
size: "small",
icon: _wordpress_icons.close,
onClick: onClose,
label: (0, _wordpress_i18n.__)("Close")
})]
}),
/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
className: "components-popover__content",
children
}),
hasArrow && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
ref: arrowCallbackRef,
className: ["components-popover__arrow", `is-${computedPlacement.split("-")[0]}`].join(" "),
style: {
left: typeof arrowData?.x !== "undefined" && Number.isFinite(arrowData.x) ? `${arrowData.x}px` : "",
top: typeof arrowData?.y !== "undefined" && Number.isFinite(arrowData.y) ? `${arrowData.y}px` : ""
},
children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArrowTriangle, {})
})
]
});
const shouldRenderWithinSlot = slot.ref && !inline;
const hasAnchor = anchorRef || anchorRect || anchor;
if (shouldRenderWithinSlot) content = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(___slot_fill_index_tsx.Fill, {
name: slotName,
children: content
});
else if (!inline) content = (0, _wordpress_element.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(___style_provider_index_tsx.StyleProvider, {
document,
children: content
}), getPopoverFallbackContainer());
if (hasAnchor) return content;
return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { ref: anchorRefFallback }), content] });
};
const PopoverSlot = (0, _wordpress_element.forwardRef)(({ name = SLOT_NAME }, ref) => {
return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(___slot_fill_index_tsx.Slot, {
bubblesVirtually: true,
name,
className: "popover-slot",
ref
});
});
/**
* `Popover` renders its content in a floating modal. If no explicit anchor is passed via props, it anchors to its parent element by default.
*
* ```jsx
* import { Button, Popover } from '@wordpress/components';
* import { useState } from '@wordpress/element';
*
* const MyPopover = () => {
* const [ isVisible, setIsVisible ] = useState( false );
* const toggleVisible = () => {
* setIsVisible( ( state ) => ! state );
* };
*
* return (
* <Button variant="secondary" onClick={ toggleVisible }>
* Toggle Popover!
* { isVisible && <Popover>Popover is toggled!</Popover> }
* </Button>
* );
* };
* ```
*
*/
const Popover = Object.assign((0, ___context_index_ts.contextConnect)(UnforwardedPopover, "Popover"), {
/**
* Renders a slot that is used internally by Popover for rendering content.
*/
Slot: Object.assign(PopoverSlot, { displayName: "Popover.Slot" }),
/**
* Provides a context to manage popover slot names.
*
* This is marked as unstable and should not be used directly.
*/
__unstableSlotNameProvider: Object.assign(__context_ts.slotNameContext.Provider, { displayName: "Popover.__unstableSlotNameProvider" })
});
exports.Popover = Popover;
exports.default = Popover;
exports.PopoverSlot = PopoverSlot;
exports.SLOT_NAME = SLOT_NAME;
//# sourceMappingURL=index.cjs.map