@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.
233 lines (232 loc) • 9.19 kB
JavaScript
;
'use client';
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.SelectPositioner = void 0;
var React = _interopRequireWildcard(require("react"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _useForkRef = require("../../utils/useForkRef");
var _SelectRootContext = require("../root/SelectRootContext");
var _CompositeList = require("../../composite/list/CompositeList");
var _useComponentRenderer = require("../../utils/useComponentRenderer");
var _popupStateMapping = require("../../utils/popupStateMapping");
var _useSelectPositioner = require("./useSelectPositioner");
var _SelectPositionerContext = require("./SelectPositionerContext");
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 select menu popup against the trigger.
* Renders a `<div>` element.
*
* Documentation: [Base UI Select](https://base-ui.com/react/components/select)
*/const SelectPositioner = exports.SelectPositioner = /*#__PURE__*/React.forwardRef(function SelectPositioner(props, ref) {
const {
anchor,
positionMethod = 'absolute',
className,
render,
side = 'bottom',
align = 'start',
sideOffset = 0,
alignOffset = 0,
collisionBoundary = 'clipping-ancestors',
collisionPadding,
arrowPadding = 5,
sticky = false,
trackAnchor = true,
...otherProps
} = props;
const {
open,
mounted,
setPositionerElement,
listRef,
labelsRef,
floatingRootContext
} = (0, _SelectRootContext.useSelectRootContext)();
const {
getPositionerProps,
positioner
} = (0, _useSelectPositioner.useSelectPositioner)({
anchor,
floatingRootContext,
positionMethod,
mounted,
side,
sideOffset,
align,
alignOffset,
arrowPadding,
collisionBoundary,
collisionPadding,
sticky,
trackAnchor,
allowAxisFlip: false
});
const mergedRef = (0, _useForkRef.useForkRef)(ref, setPositionerElement);
const state = React.useMemo(() => ({
open,
side: positioner.side,
align: positioner.align,
anchorHidden: positioner.anchorHidden
}), [open, positioner.side, positioner.align, positioner.anchorHidden]);
const {
renderElement
} = (0, _useComponentRenderer.useComponentRenderer)({
propGetter: getPositionerProps,
render: render ?? 'div',
ref: mergedRef,
className,
state,
customStyleHookMapping: _popupStateMapping.popupStateMapping,
extraProps: otherProps
});
return /*#__PURE__*/(0, _jsxRuntime.jsx)(_CompositeList.CompositeList, {
elementsRef: listRef,
labelsRef: labelsRef,
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_SelectPositionerContext.SelectPositionerContext.Provider, {
value: positioner,
children: renderElement()
})
});
});
process.env.NODE_ENV !== "production" ? SelectPositioner.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.
* @default 'start'
*/
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.oneOfType([(props, propName) => {
if (props[propName] == null) {
return new Error(`Prop '${propName}' is required but wasn't specified`);
}
if (typeof props[propName] !== 'object' || props[propName].nodeType !== 1) {
return new Error(`Expected prop '${propName}' to be of type Element`);
}
return null;
}, _propTypes.default.func, _propTypes.default.shape({
contextElement: (props, propName) => {
if (props[propName] == null) {
return null;
}
if (typeof props[propName] !== 'object' || props[propName].nodeType !== 1) {
return new Error(`Expected prop '${propName}' to be of type Element`);
}
return null;
},
getBoundingClientRect: _propTypes.default.func.isRequired,
getClientRects: _propTypes.default.func
}), _propTypes.default.shape({
current: (props, propName) => {
if (props[propName] == null) {
return null;
}
if (typeof props[propName] !== 'object' || props[propName].nodeType !== 1) {
return new Error(`Expected prop '${propName}' to be of type Element`);
}
return null;
}
})]),
/**
* 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.oneOfType([_propTypes.default.oneOf(['clipping-ancestors']), _propTypes.default.arrayOf((props, propName) => {
if (props[propName] == null) {
return new Error(`Prop '${propName}' is required but wasn't specified`);
}
if (typeof props[propName] !== 'object' || props[propName].nodeType !== 1) {
return new Error(`Expected prop '${propName}' to be of type Element`);
}
return null;
}), (props, propName) => {
if (props[propName] == null) {
return new Error(`Prop '${propName}' is required but wasn't specified`);
}
if (typeof props[propName] !== 'object' || props[propName].nodeType !== 1) {
return new Error(`Expected prop '${propName}' to be of type Element`);
}
return null;
}, _propTypes.default.shape({
height: _propTypes.default.number.isRequired,
width: _propTypes.default.number.isRequired,
x: _propTypes.default.number.isRequired,
y: _propTypes.default.number.isRequired
})]),
/**
* 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
})]),
/**
* The CSS position method for positioning the Select popup element.
* @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.
* @default 'bottom'
*/
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 select menu in the viewport after
* the anchor element is scrolled out of view.
* @default false
*/
sticky: _propTypes.default.bool,
/**
* Whether the select popup continuously tracks its anchor after the initial positioning upon mount.
* @default true
*/
trackAnchor: _propTypes.default.bool
} : void 0;