@base-ui-components/react
Version:
Base UI is a library of headless ('unstyled') React components and low-level hooks. You gain complete control over your app's CSS and accessibility features.
218 lines (217 loc) • 8.61 kB
JavaScript
"use strict";
'use client';
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.MenuPositioner = void 0;
var React = _interopRequireWildcard(require("react"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _react2 = require("@floating-ui/react");
var _MenuPositionerContext = require("./MenuPositionerContext");
var _MenuRootContext = require("../root/MenuRootContext");
var _useComponentRenderer = require("../../utils/useComponentRenderer");
var _useForkRef = require("../../utils/useForkRef");
var _useMenuPositioner = require("./useMenuPositioner");
var _proptypes = require("../../utils/proptypes");
var _popupStateMapping = require("../../utils/popupStateMapping");
var _CompositeList = require("../../composite/list/CompositeList");
var _jsxRuntime = require("react/jsx-runtime");
function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
/**
* Positions the menu popup against the trigger.
* Renders a `<div>` element.
*
* Documentation: [Base UI Menu](https://base-ui.com/react/components/menu)
*/const MenuPositioner = exports.MenuPositioner = /*#__PURE__*/React.forwardRef(function MenuPositioner(props, forwardedRef) {
const {
anchor,
positionMethod = 'absolute',
className,
render,
keepMounted = false,
side,
align,
sideOffset = 0,
alignOffset = 0,
collisionBoundary = 'clipping-ancestors',
collisionPadding = 5,
arrowPadding = 5,
sticky = false,
...otherProps
} = props;
const {
open,
floatingRootContext,
setPositionerElement,
itemDomElements,
itemLabels,
mounted,
nested,
setOpen
} = (0, _MenuRootContext.useMenuRootContext)();
const {
events: menuEvents
} = (0, _react2.useFloatingTree)();
const nodeId = (0, _react2.useFloatingNodeId)();
const parentNodeId = (0, _react2.useFloatingParentNodeId)();
let computedSide = side;
let computedAlign = align;
if (!side) {
computedSide = nested ? 'inline-end' : 'bottom';
}
if (!align) {
computedAlign = nested ? 'start' : 'center';
}
const positioner = (0, _useMenuPositioner.useMenuPositioner)({
anchor,
floatingRootContext,
positionMethod,
open,
mounted,
side: computedSide,
sideOffset,
align: computedAlign,
alignOffset,
arrowPadding,
collisionBoundary,
collisionPadding,
sticky,
nodeId,
parentNodeId,
menuEvents,
setOpen
});
const state = React.useMemo(() => ({
open,
side: positioner.side,
align: positioner.align,
anchorHidden: positioner.anchorHidden,
nested
}), [open, positioner.side, positioner.align, positioner.anchorHidden, nested]);
const contextValue = React.useMemo(() => ({
side: positioner.side,
align: positioner.align,
arrowRef: positioner.arrowRef,
arrowUncentered: positioner.arrowUncentered,
arrowStyles: positioner.arrowStyles,
floatingContext: positioner.floatingContext
}), [positioner.side, positioner.align, positioner.arrowRef, positioner.arrowUncentered, positioner.arrowStyles, positioner.floatingContext]);
const mergedRef = (0, _useForkRef.useForkRef)(forwardedRef, setPositionerElement);
const {
renderElement
} = (0, _useComponentRenderer.useComponentRenderer)({
propGetter: positioner.getPositionerProps,
render: render ?? 'div',
className,
state,
customStyleHookMapping: _popupStateMapping.popupStateMapping,
ref: mergedRef,
extraProps: otherProps
});
const shouldRender = keepMounted || mounted;
if (!shouldRender) {
return null;
}
return /*#__PURE__*/(0, _jsxRuntime.jsx)(_MenuPositionerContext.MenuPositionerContext.Provider, {
value: contextValue,
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_react2.FloatingNode, {
id: nodeId,
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_CompositeList.CompositeList, {
elementsRef: itemDomElements,
labelsRef: itemLabels,
children: renderElement()
})
})
});
});
process.env.NODE_ENV !== "production" ? MenuPositioner.propTypes /* remove-proptypes */ = {
// ┌────────────────────────────── Warning ──────────────────────────────┐
// │ These PropTypes are generated from the TypeScript type definitions. │
// │ To update them, edit the TypeScript types and run `pnpm proptypes`. │
// └─────────────────────────────────────────────────────────────────────┘
/**
* How to align the popup relative to the specified side.
*/
align: _propTypes.default.oneOf(['center', 'end', 'start']),
/**
* Additional offset along the alignment axis of the element.
* @default 0
*/
alignOffset: _propTypes.default.number,
/**
* An element to position the popup against.
* By default, the popup will be positioned against the trigger.
*/
anchor: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_proptypes.HTMLElementType, _propTypes.default.object, _propTypes.default.func]),
/**
* Minimum distance to maintain between the arrow and the edges of the popup.
*
* Use it to prevent the arrow element from hanging out of the rounded corners of a popup.
* @default 5
*/
arrowPadding: _propTypes.default.number,
/**
* @ignore
*/
children: _propTypes.default.node,
/**
* CSS class applied to the element, or a function that
* returns a class based on the component’s state.
*/
className: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.string]),
/**
* An element or a rectangle that delimits the area that the popup is confined to.
* @default 'clipping-ancestors'
*/
collisionBoundary: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_proptypes.HTMLElementType, _propTypes.default.arrayOf(_proptypes.HTMLElementType), _propTypes.default.string, _propTypes.default.shape({
height: _propTypes.default.number,
width: _propTypes.default.number,
x: _propTypes.default.number,
y: _propTypes.default.number
})]),
/**
* Additional space to maintain from the edge of the collision boundary.
* @default 5
*/
collisionPadding: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.shape({
bottom: _propTypes.default.number,
left: _propTypes.default.number,
right: _propTypes.default.number,
top: _propTypes.default.number
})]),
/**
* Whether to keep the HTML element in the DOM while the menu is hidden.
* @default false
*/
keepMounted: _propTypes.default.bool,
/**
* Determines which CSS `position` property to use.
* @default 'absolute'
*/
positionMethod: _propTypes.default.oneOf(['absolute', 'fixed']),
/**
* Allows you to replace the component’s HTML element
* with a different tag, or compose it with another component.
*
* Accepts a `ReactElement` or a function that returns the element to render.
*/
render: _propTypes.default.oneOfType([_propTypes.default.element, _propTypes.default.func]),
/**
* Which side of the anchor element to align the popup against.
* May automatically change to avoid collisions.
*/
side: _propTypes.default.oneOf(['bottom', 'inline-end', 'inline-start', 'left', 'right', 'top']),
/**
* Distance between the anchor and the popup.
* @default 0
*/
sideOffset: _propTypes.default.number,
/**
* Whether to maintain the menu in the viewport after
* the anchor element is scrolled out of view.
* @default false
*/
sticky: _propTypes.default.bool
} : void 0;