UNPKG

@material-ui/core

Version:

React components that implement Google's Material Design.

546 lines (449 loc) 16.4 kB
"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 _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray")); var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties")); var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof")); var _react = _interopRequireDefault(require("react")); var _propTypes = _interopRequireDefault(require("prop-types")); var _clsx = _interopRequireDefault(require("clsx")); var _capitalize = _interopRequireDefault(require("../utils/capitalize")); var _utils = require("@material-ui/utils"); var _Menu = _interopRequireDefault(require("../Menu/Menu")); var _utils2 = require("../InputBase/utils"); var _useForkRef = _interopRequireDefault(require("../utils/useForkRef")); function areEqualValues(a, b) { if ((0, _typeof2.default)(b) === 'object' && b !== null) { return a === b; } return String(a) === String(b); } function isEmpty(display) { return display == null || typeof display === 'string' && !display.trim(); } /** * @ignore - internal component. */ var SelectInput = _react.default.forwardRef(function SelectInput(props, ref) { var autoFocus = props.autoFocus, autoWidth = props.autoWidth, children = props.children, classes = props.classes, className = props.className, defaultValue = props.defaultValue, disabled = props.disabled, displayEmpty = props.displayEmpty, labelId = props.labelId, IconComponent = props.IconComponent, inputRefProp = props.inputRef, _props$MenuProps = props.MenuProps, MenuProps = _props$MenuProps === void 0 ? {} : _props$MenuProps, multiple = props.multiple, name = props.name, onBlur = props.onBlur, onChange = props.onChange, onClose = props.onClose, onFocus = props.onFocus, onOpen = props.onOpen, openProp = props.open, readOnly = props.readOnly, renderValue = props.renderValue, required = props.required, _props$SelectDisplayP = props.SelectDisplayProps, SelectDisplayProps = _props$SelectDisplayP === void 0 ? {} : _props$SelectDisplayP, tabIndexProp = props.tabIndex, type = props.type, valueProp = props.value, _props$variant = props.variant, variant = _props$variant === void 0 ? 'standard' : _props$variant, other = (0, _objectWithoutProperties2.default)(props, ["autoFocus", "autoWidth", "children", "classes", "className", "defaultValue", "disabled", "displayEmpty", "labelId", "IconComponent", "inputRef", "MenuProps", "multiple", "name", "onBlur", "onChange", "onClose", "onFocus", "onOpen", "open", "readOnly", "renderValue", "required", "SelectDisplayProps", "tabIndex", "type", "value", "variant"]); var _React$useRef = _react.default.useRef(valueProp != null), isControlled = _React$useRef.current; var _React$useState = _react.default.useState(defaultValue), valueState = _React$useState[0], setValueState = _React$useState[1]; var value = isControlled ? valueProp : valueState; if (process.env.NODE_ENV !== 'production') { // eslint-disable-next-line react-hooks/rules-of-hooks _react.default.useEffect(function () { if (isControlled !== (valueProp != null)) { console.error(["Material-UI: A component is changing ".concat(isControlled ? 'a ' : 'an un', "controlled Select to be ").concat(isControlled ? 'un' : '', "controlled."), 'Elements should not switch from uncontrolled to controlled (or vice versa).', 'Decide between using a controlled or uncontrolled Select ' + 'element for the lifetime of the component.', 'More info: https://fb.me/react-controlled-components'].join('\n')); } }, [valueProp, isControlled]); } var inputRef = _react.default.useRef(null); var _React$useState2 = _react.default.useState(null), displayNode = _React$useState2[0], setDisplayNode = _React$useState2[1]; var _React$useRef2 = _react.default.useRef(openProp != null), isOpenControlled = _React$useRef2.current; var _React$useState3 = _react.default.useState(), menuMinWidthState = _React$useState3[0], setMenuMinWidthState = _React$useState3[1]; var _React$useState4 = _react.default.useState(false), openState = _React$useState4[0], setOpenState = _React$useState4[1]; var handleRef = (0, _useForkRef.default)(ref, inputRefProp); _react.default.useImperativeHandle(handleRef, function () { return { focus: function focus() { displayNode.focus(); }, node: inputRef.current, value: value }; }, [displayNode, value]); _react.default.useEffect(function () { if (autoFocus && displayNode) { displayNode.focus(); } }, [autoFocus, displayNode]); var update = function update(open, event) { if (open) { if (onOpen) { onOpen(event); } } else { displayNode.focus(); if (onClose) { onClose(event); } } if (!isOpenControlled) { setMenuMinWidthState(autoWidth ? null : displayNode.clientWidth); setOpenState(open); } }; var handleClick = function handleClick(event) { update(true, event); }; var handleClose = function handleClose(event) { update(false, event); }; var handleItemClick = function handleItemClick(child) { return function (event) { if (!multiple) { update(false, event); } var newValue; if (multiple) { newValue = Array.isArray(value) ? (0, _toConsumableArray2.default)(value) : []; var itemIndex = value.indexOf(child.props.value); if (itemIndex === -1) { newValue.push(child.props.value); } else { newValue.splice(itemIndex, 1); } } else { newValue = child.props.value; } if (!isControlled) { setValueState(newValue); } if (onChange) { event.persist(); // Preact support, target is read only property on a native event. Object.defineProperty(event, 'target', { writable: true, value: { value: newValue, name: name } }); onChange(event, child); } }; }; var handleKeyDown = function handleKeyDown(event) { if (!readOnly) { var validKeys = [' ', 'ArrowUp', 'ArrowDown', // The native select doesn't respond to enter on MacOS, but it's recommended by // https://www.w3.org/TR/wai-aria-practices/examples/listbox/listbox-collapsible.html 'Enter']; if (validKeys.indexOf(event.key) !== -1) { event.preventDefault(); update(true, event); } } }; var open = displayNode !== null && (isOpenControlled ? openProp : openState); var handleBlur = function handleBlur(event) { // if open event.stopImmediatePropagation if (!open && onBlur) { event.persist(); // Preact support, target is read only property on a native event. Object.defineProperty(event, 'target', { writable: true, value: { value: value, name: name } }); onBlur(event); } }; delete other['aria-invalid']; var display; var displaySingle; var displayMultiple = []; var computeDisplay = false; var foundMatch = false; // No need to display any value if the field is empty. if ((0, _utils2.isFilled)({ value: value }) || displayEmpty) { if (renderValue) { display = renderValue(value); } else { computeDisplay = true; } } var items = _react.default.Children.map(children, function (child) { if (!_react.default.isValidElement(child)) { return null; } if (process.env.NODE_ENV !== 'production') { if (child.type === _react.default.Fragment) { console.error(["Material-UI: the Select component doesn't accept a Fragment as a child.", 'Consider providing an array instead.'].join('\n')); } } var selected; if (multiple) { if (!Array.isArray(value)) { throw new Error('Material-UI: the `value` prop must be an array ' + 'when using the `Select` component with `multiple`.'); } selected = value.some(function (v) { return areEqualValues(v, child.props.value); }); if (selected && computeDisplay) { displayMultiple.push(child.props.children); } } else { selected = areEqualValues(value, child.props.value); if (selected && computeDisplay) { displaySingle = child.props.children; } } if (selected) { foundMatch = true; } return _react.default.cloneElement(child, { 'aria-selected': selected ? 'true' : undefined, onClick: handleItemClick(child), role: 'option', selected: selected, value: undefined, // The value is most likely not a valid HTML attribute. 'data-value': child.props.value // Instead, we provide it as a data attribute. }); }); if (process.env.NODE_ENV !== 'production') { // eslint-disable-next-line react-hooks/rules-of-hooks _react.default.useEffect(function () { if (!foundMatch && !multiple && value !== '') { var values = _react.default.Children.toArray(children).map(function (child) { return child.props.value; }); console.warn(["Material-UI: you have provided an out-of-range value `".concat(value, "` for the select ").concat(name ? "(name=\"".concat(name, "\") ") : '', "component."), "Consider providing a value that matches one of the available options or ''.", "The available values are ".concat(values.filter(function (x) { return x != null; }).map(function (x) { return "`".concat(x, "`"); }).join(', ') || '""', ".")].join('\n')); } }, [foundMatch, children, multiple, name, value]); } if (computeDisplay) { display = multiple ? displayMultiple.join(', ') : displaySingle; } // Avoid performing a layout computation in the render method. var menuMinWidth = menuMinWidthState; if (!autoWidth && isOpenControlled && displayNode) { menuMinWidth = displayNode.clientWidth; } var tabIndex; if (typeof tabIndexProp !== 'undefined') { tabIndex = tabIndexProp; } else { tabIndex = disabled ? null : 0; } var buttonId = SelectDisplayProps.id || (name ? "mui-component-select-".concat(name) : undefined); return _react.default.createElement(_react.default.Fragment, null, _react.default.createElement("div", (0, _extends2.default)({ className: (0, _clsx.default)(classes.root, // TODO v5: merge root and select classes.select, classes.selectMenu, classes[variant], className, disabled && classes.disabled), ref: setDisplayNode, tabIndex: tabIndex, role: "button", "aria-expanded": open ? 'true' : undefined, "aria-labelledby": "".concat(labelId || '', " ").concat(buttonId || ''), "aria-haspopup": "listbox", onKeyDown: handleKeyDown, onClick: disabled || readOnly ? null : handleClick, onBlur: handleBlur, onFocus: onFocus }, SelectDisplayProps, { // The id is required for proper a11y id: buttonId }), isEmpty(display) ? // eslint-disable-next-line react/no-danger _react.default.createElement("span", { dangerouslySetInnerHTML: { __html: '&#8203;' } }) : display), _react.default.createElement("input", (0, _extends2.default)({ value: Array.isArray(value) ? value.join(',') : value, name: name, ref: inputRef, type: "hidden", autoFocus: autoFocus }, other)), _react.default.createElement(IconComponent, { className: (0, _clsx.default)(classes.icon, classes["icon".concat((0, _capitalize.default)(variant))], open && classes.iconOpen) }), _react.default.createElement(_Menu.default, (0, _extends2.default)({ id: "menu-".concat(name || ''), anchorEl: displayNode, open: open, onClose: handleClose }, MenuProps, { MenuListProps: (0, _extends2.default)({ 'aria-labelledby': labelId, role: 'listbox', disableListWrap: true }, MenuProps.MenuListProps), PaperProps: (0, _extends2.default)({}, MenuProps.PaperProps, { style: (0, _extends2.default)({ minWidth: menuMinWidth }, MenuProps.PaperProps != null ? MenuProps.PaperProps.style : null) }) }), items)); }); process.env.NODE_ENV !== "production" ? SelectInput.propTypes = { /** * @ignore */ autoFocus: _propTypes.default.bool, /** * If true, the width of the popover will automatically be set according to the items inside the * menu, otherwise it will be at least the width of the select input. */ autoWidth: _propTypes.default.bool, /** * The option elements to populate the select with. * Can be some `<MenuItem>` elements. */ children: _propTypes.default.node, /** * Override or extend the styles applied to the component. * See [CSS API](#css) below for more details. */ classes: _propTypes.default.object.isRequired, /** * The CSS class name of the select element. */ className: _propTypes.default.string, /** * The default element value. Use when the component is not controlled. */ defaultValue: _propTypes.default.any, /** * If `true`, the select will be disabled. */ disabled: _propTypes.default.bool, /** * If `true`, the selected item is displayed even if its value is empty. */ displayEmpty: _propTypes.default.bool, /** * The icon that displays the arrow. */ IconComponent: _propTypes.default.elementType.isRequired, /** * Imperative handle implementing `{ value: T, node: HTMLElement, focus(): void }` * Equivalent to `ref` */ inputRef: _utils.refType, /** * The idea of an element that acts as an additional label. The Select will * be labelled by the additional label and the selected value. */ labelId: _propTypes.default.string, /** * Props applied to the [`Menu`](/api/menu/) element. */ MenuProps: _propTypes.default.object, /** * If true, `value` must be an array and the menu will support multiple selections. */ multiple: _propTypes.default.bool, /** * Name attribute of the `select` or hidden `input` element. */ name: _propTypes.default.string, /** * @ignore */ onBlur: _propTypes.default.func, /** * Callback function fired when a menu item is selected. * * @param {object} event The event source of the callback. * You can pull out the new value by accessing `event.target.value` (any). * @param {object} [child] The react element that was selected. */ onChange: _propTypes.default.func, /** * Callback fired when the component requests to be closed. * Use in controlled mode (see open). * * @param {object} event The event source of the callback. */ onClose: _propTypes.default.func, /** * @ignore */ onFocus: _propTypes.default.func, /** * Callback fired when the component requests to be opened. * Use in controlled mode (see open). * * @param {object} event The event source of the callback. */ onOpen: _propTypes.default.func, /** * Control `select` open state. */ open: _propTypes.default.bool, /** * @ignore */ readOnly: _propTypes.default.bool, /** * Render the selected value. * * @param {any} value The `value` provided to the component. * @returns {ReactNode} */ renderValue: _propTypes.default.func, /** * @ignore */ required: _propTypes.default.bool, /** * Props applied to the clickable div element. */ SelectDisplayProps: _propTypes.default.object, /** * @ignore */ tabIndex: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]), /** * @ignore */ type: _propTypes.default.any, /** * The input value. */ value: _propTypes.default.any, /** * The variant to use. */ variant: _propTypes.default.oneOf(['standard', 'outlined', 'filled']) } : void 0; var _default = SelectInput; exports.default = _default;