UNPKG

@material-ui/core

Version:

React components that implement Google's Material Design.

584 lines (496 loc) 16.6 kB
import _extends from "@babel/runtime/helpers/esm/extends"; import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray"; import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties"; import _typeof from "@babel/runtime/helpers/esm/typeof"; import { formatMuiErrorMessage as _formatMuiErrorMessage } from "@material-ui/utils"; import * as React from 'react'; import { isFragment } from 'react-is'; import PropTypes from 'prop-types'; import clsx from 'clsx'; import ownerDocument from '../utils/ownerDocument'; import capitalize from '../utils/capitalize'; import { refType } from '@material-ui/utils'; import Menu from '../Menu/Menu'; import { isFilled } from '../InputBase/utils'; import useForkRef from '../utils/useForkRef'; import useControlled from '../utils/useControlled'; function areEqualValues(a, b) { if (_typeof(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 = /*#__PURE__*/React.forwardRef(function SelectInput(props, ref) { var ariaLabel = props['aria-label'], autoFocus = props.autoFocus, autoWidth = props.autoWidth, children = props.children, classes = props.classes, className = props.className, defaultValue = props.defaultValue, disabled = props.disabled, displayEmpty = props.displayEmpty, IconComponent = props.IconComponent, inputRefProp = props.inputRef, labelId = props.labelId, _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, _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 = _objectWithoutProperties(props, ["aria-label", "autoFocus", "autoWidth", "children", "classes", "className", "defaultValue", "disabled", "displayEmpty", "IconComponent", "inputRef", "labelId", "MenuProps", "multiple", "name", "onBlur", "onChange", "onClose", "onFocus", "onOpen", "open", "readOnly", "renderValue", "SelectDisplayProps", "tabIndex", "type", "value", "variant"]); var _useControlled = useControlled({ controlled: valueProp, default: defaultValue, name: 'Select' }), _useControlled2 = _slicedToArray(_useControlled, 2), value = _useControlled2[0], setValue = _useControlled2[1]; var inputRef = React.useRef(null); var _React$useState = React.useState(null), displayNode = _React$useState[0], setDisplayNode = _React$useState[1]; var _React$useRef = React.useRef(openProp != null), isOpenControlled = _React$useRef.current; var _React$useState2 = React.useState(), menuMinWidthState = _React$useState2[0], setMenuMinWidthState = _React$useState2[1]; var _React$useState3 = React.useState(false), openState = _React$useState3[0], setOpenState = _React$useState3[1]; var handleRef = useForkRef(ref, inputRefProp); React.useImperativeHandle(handleRef, function () { return { focus: function focus() { displayNode.focus(); }, node: inputRef.current, value: value }; }, [displayNode, value]); React.useEffect(function () { if (autoFocus && displayNode) { displayNode.focus(); } }, [autoFocus, displayNode]); React.useEffect(function () { if (displayNode) { var label = ownerDocument(displayNode).getElementById(labelId); if (label) { var handler = function handler() { if (getSelection().isCollapsed) { displayNode.focus(); } }; label.addEventListener('click', handler); return function () { label.removeEventListener('click', handler); }; } } return undefined; }, [labelId, displayNode]); var update = function update(open, event) { if (open) { if (onOpen) { onOpen(event); } } else if (onClose) { onClose(event); } if (!isOpenControlled) { setMenuMinWidthState(autoWidth ? null : displayNode.clientWidth); setOpenState(open); } }; var handleMouseDown = function handleMouseDown(event) { // Ignore everything but left-click if (event.button !== 0) { return; } // Hijack the default focus behavior. event.preventDefault(); displayNode.focus(); update(true, event); }; var handleClose = function handleClose(event) { update(false, event); }; var childrenArray = React.Children.toArray(children); // Support autofill. var handleChange = function handleChange(event) { var index = childrenArray.map(function (child) { return child.props.value; }).indexOf(event.target.value); if (index === -1) { return; } var child = childrenArray[index]; setValue(child.props.value); if (onChange) { onChange(event, child); } }; var handleItemClick = function handleItemClick(child) { return function (event) { if (!multiple) { update(false, event); } var newValue; if (multiple) { newValue = Array.isArray(value) ? value.slice() : []; 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 (child.props.onClick) { child.props.onClick(event); } if (value === newValue) { return; } setValue(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 (isFilled({ value: value }) || displayEmpty) { if (renderValue) { display = renderValue(value); } else { computeDisplay = true; } } var items = childrenArray.map(function (child) { if (! /*#__PURE__*/React.isValidElement(child)) { return null; } if (process.env.NODE_ENV !== 'production') { if (isFragment(child)) { 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(process.env.NODE_ENV !== "production" ? "Material-UI: The `value` prop must be an array when using the `Select` component with `multiple`." : _formatMuiErrorMessage(2)); } 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 /*#__PURE__*/React.cloneElement(child, { 'aria-selected': selected ? 'true' : undefined, onClick: handleItemClick(child), onKeyUp: function onKeyUp(event) { if (event.key === ' ') { // otherwise our MenuItems dispatches a click event // it's not behavior of the native <option> and causes // the select to close immediately since we open on space keydown event.preventDefault(); } if (child.props.onKeyUp) { child.props.onKeyUp(event); } }, 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.useEffect(function () { if (!foundMatch && !multiple && value !== '') { var values = childrenArray.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, childrenArray, 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 /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", _extends({ className: clsx(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-disabled": disabled ? 'true' : undefined, "aria-expanded": open ? 'true' : undefined, "aria-haspopup": "listbox", "aria-label": ariaLabel, "aria-labelledby": [labelId, buttonId].filter(Boolean).join(' ') || undefined, onKeyDown: handleKeyDown, onMouseDown: disabled || readOnly ? null : handleMouseDown, onBlur: handleBlur, onFocus: onFocus }, SelectDisplayProps, { // The id is required for proper a11y id: buttonId }), isEmpty(display) ? /*#__PURE__*/ // eslint-disable-next-line react/no-danger React.createElement("span", { dangerouslySetInnerHTML: { __html: '&#8203;' } }) : display), /*#__PURE__*/React.createElement("input", _extends({ value: Array.isArray(value) ? value.join(',') : value, name: name, ref: inputRef, "aria-hidden": true, onChange: handleChange, tabIndex: -1, className: classes.nativeInput, autoFocus: autoFocus }, other)), /*#__PURE__*/React.createElement(IconComponent, { className: clsx(classes.icon, classes["icon".concat(capitalize(variant))], open && classes.iconOpen, disabled && classes.disabled) }), /*#__PURE__*/React.createElement(Menu, _extends({ id: "menu-".concat(name || ''), anchorEl: displayNode, open: open, onClose: handleClose }, MenuProps, { MenuListProps: _extends({ 'aria-labelledby': labelId, role: 'listbox', disableListWrap: true }, MenuProps.MenuListProps), PaperProps: _extends({}, MenuProps.PaperProps, { style: _extends({ minWidth: menuMinWidth }, MenuProps.PaperProps != null ? MenuProps.PaperProps.style : null) }) }), items)); }); process.env.NODE_ENV !== "production" ? SelectInput.propTypes = { /** * @ignore */ 'aria-label': PropTypes.string, /** * @ignore */ autoFocus: PropTypes.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.bool, /** * The option elements to populate the select with. * Can be some `<MenuItem>` elements. */ children: PropTypes.node, /** * Override or extend the styles applied to the component. * See [CSS API](#css) below for more details. */ classes: PropTypes.object.isRequired, /** * The CSS class name of the select element. */ className: PropTypes.string, /** * The default element value. Use when the component is not controlled. */ defaultValue: PropTypes.any, /** * If `true`, the select will be disabled. */ disabled: PropTypes.bool, /** * If `true`, the selected item is displayed even if its value is empty. */ displayEmpty: PropTypes.bool, /** * The icon that displays the arrow. */ IconComponent: PropTypes.elementType.isRequired, /** * Imperative handle implementing `{ value: T, node: HTMLElement, focus(): void }` * Equivalent to `ref` */ inputRef: refType, /** * The ID of an element that acts as an additional label. The Select will * be labelled by the additional label and the selected value. */ labelId: PropTypes.string, /** * Props applied to the [`Menu`](/api/menu/) element. */ MenuProps: PropTypes.object, /** * If `true`, `value` must be an array and the menu will support multiple selections. */ multiple: PropTypes.bool, /** * Name attribute of the `select` or hidden `input` element. */ name: PropTypes.string, /** * @ignore */ onBlur: PropTypes.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.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.func, /** * @ignore */ onFocus: PropTypes.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.func, /** * Control `select` open state. */ open: PropTypes.bool, /** * @ignore */ readOnly: PropTypes.bool, /** * Render the selected value. * * @param {any} value The `value` provided to the component. * @returns {ReactNode} */ renderValue: PropTypes.func, /** * Props applied to the clickable div element. */ SelectDisplayProps: PropTypes.object, /** * @ignore */ tabIndex: PropTypes.oneOfType([PropTypes.number, PropTypes.string]), /** * @ignore */ type: PropTypes.any, /** * The input value. */ value: PropTypes.any, /** * The variant to use. */ variant: PropTypes.oneOf(['standard', 'outlined', 'filled']) } : void 0; export default SelectInput;