@wordpress/components
Version:
UI components for WordPress.
99 lines (98 loc) • 3.6 kB
JavaScript
import clsx from "clsx";
import { useRef, useState } from "@wordpress/element";
import { useMergeRefs } from "@wordpress/compose";
import deprecated from "@wordpress/deprecated";
import { contextConnect, useContextSystem } from "../context/index.mjs";
import { useControlledValue } from "../utils/hooks/index.mjs";
import Popover from "../popover/index.mjs";
import { jsx, jsxs } from "react/jsx-runtime";
// packages/components/src/dropdown/index.tsx
const UnconnectedDropdown = (props, forwardedRef) => {
const { renderContent, renderToggle, className, contentClassName, expandOnMobile, headerTitle, focusOnMount, popoverProps, onClose, onToggle, style, open, defaultOpen, position, variant } = useContextSystem(props, "Dropdown");
if (position !== void 0) deprecated("`position` prop in wp.components.Dropdown", {
since: "6.2",
alternative: "`popoverProps.placement` prop",
hint: "Note that the `position` prop will override any values passed through the `popoverProps.placement` prop."
});
const [fallbackPopoverAnchor, setFallbackPopoverAnchor] = useState(null);
const containerRef = useRef(null);
const [isOpen, setIsOpen] = useControlledValue({
defaultValue: defaultOpen,
value: open,
onChange: onToggle
});
/**
* Closes the popover when focus leaves it unless the toggle was pressed or
* focus has moved to a separate dialog. The former is to let the toggle
* handle closing the popover and the latter is to preserve presence in
* case a dialog has opened, allowing focus to return when it's dismissed.
*/
function closeIfFocusOutside() {
if (!containerRef.current) return;
const { ownerDocument } = containerRef.current;
const dialog = ownerDocument?.activeElement?.closest("[role=\"dialog\"]");
if (!containerRef.current.contains(ownerDocument.activeElement) && (!dialog || dialog.contains(containerRef.current))) close();
}
function close() {
onClose?.();
setIsOpen(false);
}
const args = {
isOpen: !!isOpen,
onToggle: () => setIsOpen(!isOpen),
onClose: close
};
const popoverPropsHaveAnchor = !!popoverProps?.anchor || !!popoverProps?.anchorRef || !!popoverProps?.getAnchorRect || !!popoverProps?.anchorRect;
return /* @__PURE__ */ jsxs("div", {
className,
ref: useMergeRefs([
containerRef,
forwardedRef,
setFallbackPopoverAnchor
]),
tabIndex: -1,
style,
children: [renderToggle(args), isOpen && /* @__PURE__ */ jsx(Popover, {
position,
onClose: close,
onFocusOutside: closeIfFocusOutside,
expandOnMobile,
headerTitle,
focusOnMount,
offset: 13,
anchor: !popoverPropsHaveAnchor ? fallbackPopoverAnchor : void 0,
variant,
...popoverProps,
className: clsx("components-dropdown__content", popoverProps?.className, contentClassName),
children: renderContent(args)
})]
});
};
/**
* Renders a button that opens a floating content modal when clicked.
*
* ```jsx
* import { Button, Dropdown } from '@wordpress/components';
*
* const MyDropdown = () => (
* <Dropdown
* className="my-container-class-name"
* contentClassName="my-dropdown-content-classname"
* popoverProps={ { placement: 'bottom-start' } }
* renderToggle={ ( { isOpen, onToggle } ) => (
* <Button
* variant="primary"
* onClick={ onToggle }
* aria-expanded={ isOpen }
* >
* Toggle Dropdown!
* </Button>
* ) }
* renderContent={ () => <div>This is the content of the dropdown.</div> }
* />
* );
* ```
*/
const Dropdown = contextConnect(UnconnectedDropdown, "Dropdown");
export { Dropdown, Dropdown as default };
//# sourceMappingURL=index.mjs.map