@mui/base
Version:
A library of headless ('unstyled') React UI components and low-level hooks.
307 lines (305 loc) • 12.1 kB
JavaScript
"use strict";
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = void 0;
var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
var React = _interopRequireWildcard(require("react"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _utils = require("@mui/utils");
var _useSelect = _interopRequireDefault(require("../useSelect"));
var _utils2 = require("../utils");
var _Popper = _interopRequireDefault(require("../Popper"));
var _composeClasses = _interopRequireDefault(require("../composeClasses"));
var _selectClasses = require("./selectClasses");
var _defaultOptionStringifier = _interopRequireDefault(require("../useSelect/defaultOptionStringifier"));
var _ClassNameConfigurator = require("../utils/ClassNameConfigurator");
var _SelectProvider = _interopRequireDefault(require("../useSelect/SelectProvider"));
var _jsxRuntime = require("react/jsx-runtime");
const _excluded = ["autoFocus", "children", "defaultValue", "defaultListboxOpen", "disabled", "getSerializedValue", "listboxId", "listboxOpen", "multiple", "name", "onChange", "onListboxOpenChange", "getOptionAsString", "renderValue", "slotProps", "slots", "value"];
function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
function defaultRenderValue(selectedOptions) {
var _selectedOptions$labe;
if (Array.isArray(selectedOptions)) {
return /*#__PURE__*/(0, _jsxRuntime.jsx)(React.Fragment, {
children: selectedOptions.map(o => o.label).join(', ')
});
}
return (_selectedOptions$labe = selectedOptions == null ? void 0 : selectedOptions.label) != null ? _selectedOptions$labe : '';
}
function defaultFormValueProvider(selectedOption) {
if (Array.isArray(selectedOption)) {
if (selectedOption.length === 0) {
return '';
}
if (selectedOption.every(o => typeof o.value === 'string' || typeof o.value === 'number' || typeof o.value === 'boolean')) {
return selectedOption.map(o => String(o.value));
}
return JSON.stringify(selectedOption.map(o => o.value));
}
if ((selectedOption == null ? void 0 : selectedOption.value) == null) {
return '';
}
if (typeof selectedOption.value === 'string' || typeof selectedOption.value === 'number') {
return selectedOption.value;
}
return JSON.stringify(selectedOption.value);
}
function useUtilityClasses(ownerState) {
const {
active,
disabled,
open,
focusVisible
} = ownerState;
const slots = {
root: ['root', disabled && 'disabled', focusVisible && 'focusVisible', active && 'active', open && 'expanded'],
listbox: ['listbox', disabled && 'disabled'],
popper: ['popper']
};
return (0, _composeClasses.default)(slots, (0, _ClassNameConfigurator.useClassNamesOverride)(_selectClasses.getSelectUtilityClass));
}
/**
* The foundation for building custom-styled select components.
*
* Demos:
*
* - [Select](https://mui.com/base/react-select/)
*
* API:
*
* - [Select API](https://mui.com/base/react-select/components-api/#select)
*/
const Select = /*#__PURE__*/React.forwardRef(function Select(props, forwardedRef) {
var _slots$root, _slots$listbox, _slots$popper;
const {
autoFocus,
children,
defaultValue,
defaultListboxOpen = false,
disabled: disabledProp,
getSerializedValue = defaultFormValueProvider,
listboxId,
listboxOpen: listboxOpenProp,
multiple = false,
name,
onChange,
onListboxOpenChange,
getOptionAsString = _defaultOptionStringifier.default,
renderValue: renderValueProp,
slotProps = {},
slots = {},
value: valueProp
} = props,
other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
const renderValue = renderValueProp != null ? renderValueProp : defaultRenderValue;
const [buttonDefined, setButtonDefined] = React.useState(false);
const buttonRef = React.useRef(null);
const listboxRef = React.useRef(null);
const Button = (_slots$root = slots.root) != null ? _slots$root : 'button';
const ListboxRoot = (_slots$listbox = slots.listbox) != null ? _slots$listbox : 'ul';
const PopperComponent = (_slots$popper = slots.popper) != null ? _slots$popper : _Popper.default;
const handleButtonRefChange = React.useCallback(element => {
setButtonDefined(element != null);
}, []);
const handleButtonRef = (0, _utils.unstable_useForkRef)(forwardedRef, buttonRef, handleButtonRefChange);
React.useEffect(() => {
if (autoFocus) {
buttonRef.current.focus();
}
}, [autoFocus]);
const {
buttonActive,
buttonFocusVisible,
contextValue,
disabled,
getButtonProps,
getListboxProps,
getOptionMetadata,
value,
open
} = (0, _useSelect.default)({
buttonRef: handleButtonRef,
defaultOpen: defaultListboxOpen,
defaultValue,
disabled: disabledProp,
listboxId,
multiple,
open: listboxOpenProp,
onChange,
onOpenChange: onListboxOpenChange,
getOptionAsString,
value: valueProp
});
const ownerState = (0, _extends2.default)({}, props, {
active: buttonActive,
defaultListboxOpen,
disabled,
focusVisible: buttonFocusVisible,
open,
multiple,
renderValue,
value
});
const classes = useUtilityClasses(ownerState);
const buttonProps = (0, _utils2.useSlotProps)({
elementType: Button,
getSlotProps: getButtonProps,
externalSlotProps: slotProps.root,
externalForwardedProps: other,
ownerState,
className: classes.root
});
const listboxProps = (0, _utils2.useSlotProps)({
elementType: ListboxRoot,
getSlotProps: getListboxProps,
externalSlotProps: slotProps.listbox,
additionalProps: {
ref: listboxRef
},
ownerState,
className: classes.listbox
});
const popperProps = (0, _utils2.useSlotProps)({
elementType: PopperComponent,
externalSlotProps: slotProps.popper,
additionalProps: {
anchorEl: buttonRef.current,
keepMounted: true,
open,
placement: 'bottom-start',
role: undefined
},
ownerState,
className: classes.popper
});
let selectedOptionsMetadata;
if (multiple) {
selectedOptionsMetadata = value.map(v => getOptionMetadata(v)).filter(o => o !== undefined);
} else {
var _getOptionMetadata;
selectedOptionsMetadata = (_getOptionMetadata = getOptionMetadata(value)) != null ? _getOptionMetadata : null;
}
return /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(Button, (0, _extends2.default)({}, buttonProps, {
children: renderValue(selectedOptionsMetadata)
})), buttonDefined && /*#__PURE__*/(0, _jsxRuntime.jsx)(PopperComponent, (0, _extends2.default)({}, popperProps, {
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ListboxRoot, (0, _extends2.default)({}, listboxProps, {
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_SelectProvider.default, {
value: contextValue,
children: children
})
}))
})), name && /*#__PURE__*/(0, _jsxRuntime.jsx)("input", {
type: "hidden",
name: name,
value: getSerializedValue(selectedOptionsMetadata)
})]
});
});
process.env.NODE_ENV !== "production" ? Select.propTypes /* remove-proptypes */ = {
// ----------------------------- Warning --------------------------------
// | These PropTypes are generated from the TypeScript type definitions |
// | To update them edit TypeScript types and run "yarn proptypes" |
// ----------------------------------------------------------------------
/**
* If `true`, the select element is focused during the first mount
* @default false
*/
autoFocus: _propTypes.default.bool,
/**
* @ignore
*/
children: _propTypes.default.node,
/**
* If `true`, the select will be initially open.
* @default false
*/
defaultListboxOpen: _propTypes.default.bool,
/**
* The default selected value. Use when the component is not controlled.
*/
defaultValue: _propTypes.default.any,
/**
* If `true`, the select is disabled.
* @default false
*/
disabled: _propTypes.default.bool,
/**
* A function used to convert the option label to a string.
* It's useful when labels are elements and need to be converted to plain text
* to enable navigation using character keys on a keyboard.
*
* @default defaultOptionStringifier
*/
getOptionAsString: _propTypes.default.func,
/**
* A function to convert the currently selected value to a string.
* Used to set a value of a hidden input associated with the select,
* so that the selected value can be posted with a form.
*/
getSerializedValue: _propTypes.default.func,
/**
* `id` attribute of the listbox element.
*/
listboxId: _propTypes.default.string,
/**
* Controls the open state of the select's listbox.
* @default undefined
*/
listboxOpen: _propTypes.default.bool,
/**
* If `true`, selecting multiple values is allowed.
* This affects the type of the `value`, `defaultValue`, and `onChange` props.
*
* @default false
*/
multiple: _propTypes.default.bool,
/**
* Name of the element. For example used by the server to identify the fields in form submits.
* If the name is provided, the component will render a hidden input element that can be submitted to a server.
*/
name: _propTypes.default.string,
/**
* Callback fired when an option is selected.
*/
onChange: _propTypes.default.func,
/**
* Callback fired when the component requests to be opened.
* Use in controlled mode (see listboxOpen).
*/
onListboxOpenChange: _propTypes.default.func,
/**
* Function that customizes the rendering of the selected value.
*/
renderValue: _propTypes.default.func,
/**
* The props used for each slot inside the Input.
* @default {}
*/
slotProps: _propTypes.default /* @typescript-to-proptypes-ignore */.shape({
listbox: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
popper: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
root: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object])
}),
/**
* The components used for each slot inside the Select.
* Either a string to use a HTML element or a component.
* @default {}
*/
slots: _propTypes.default /* @typescript-to-proptypes-ignore */.shape({
listbox: _propTypes.default.elementType,
popper: _propTypes.default.elementType,
root: _propTypes.default.elementType
}),
/**
* The selected value.
* Set to `null` to deselect all options.
*/
value: _propTypes.default.any
} : void 0;
var _default = Select;
exports.default = _default;