UNPKG

@material-ui/core

Version:

React components that implement Google's Material Design.

467 lines (398 loc) 13.2 kB
import _extends from "@babel/runtime/helpers/esm/extends"; import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray"; 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 React from 'react'; import PropTypes from 'prop-types'; import clsx from 'clsx'; import warning from 'warning'; import Menu from '../Menu/Menu'; import { isFilled } from '../InputBase/utils'; import { useForkRef } from '../utils/reactHelpers'; 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 = React.forwardRef(function SelectInput(props, ref) { var autoFocus = props.autoFocus, autoWidth = props.autoWidth, children = props.children, classes = props.classes, className = props.className, disabled = props.disabled, displayEmpty = props.displayEmpty, 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, SelectDisplayProps = props.SelectDisplayProps, tabIndexProp = props.tabIndex, _props$type = props.type, type = _props$type === void 0 ? 'hidden' : _props$type, value = props.value, variant = props.variant, other = _objectWithoutProperties(props, ["autoFocus", "autoWidth", "children", "classes", "className", "disabled", "displayEmpty", "IconComponent", "inputRef", "MenuProps", "multiple", "name", "onBlur", "onChange", "onClose", "onFocus", "onOpen", "open", "readOnly", "renderValue", "required", "SelectDisplayProps", "tabIndex", "type", "value", "variant"]); var inputRef = React.useRef(null); var displayRef = React.useRef(null); var ignoreNextBlur = React.useRef(false); var _React$useRef = React.useRef(openProp != null), isOpenControlled = _React$useRef.current; var _React$useState = React.useState(), _React$useState2 = _slicedToArray(_React$useState, 2), menuMinWidthState = _React$useState2[0], setMenuMinWidthState = _React$useState2[1]; var _React$useState3 = React.useState(false), _React$useState4 = _slicedToArray(_React$useState3, 2), openState = _React$useState4[0], setOpenState = _React$useState4[1]; var _React$useState5 = React.useState(0), _React$useState6 = _slicedToArray(_React$useState5, 2), forceUpdate = _React$useState6[1]; var handleRef = useForkRef(ref, inputRefProp); React.useImperativeHandle(handleRef, function () { return { focus: function focus() { displayRef.current.focus(); }, node: inputRef.current, value: value }; }, [value]); React.useEffect(function () { if (isOpenControlled && openProp) { // Focus the display node so the focus is restored on this element once // the menu is closed. displayRef.current.focus(); // Rerender with the resolve `displayRef` reference. forceUpdate(function (n) { return !n; }); } if (autoFocus) { displayRef.current.focus(); } }, [autoFocus, isOpenControlled, openProp]); var update = function update(open, event) { if (open) { if (onOpen) { onOpen(event); } } else if (onClose) { onClose(event); } if (!isOpenControlled) { setMenuMinWidthState(autoWidth ? null : displayRef.current.clientWidth); setOpenState(open); } }; var handleClick = function handleClick(event) { // Opening the menu is going to blur the. It will be focused back when closed. ignoreNextBlur.current = true; update(true, event); }; var handleClose = function handleClose(event) { update(false, event); }; var handleItemClick = function handleItemClick(child) { return function (event) { if (!multiple) { update(false, event); } if (onChange) { var newValue; if (multiple) { newValue = Array.isArray(value) ? _toConsumableArray(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; } event.persist(); event.target = { value: newValue, name: name }; onChange(event, child); } }; }; var handleBlur = function handleBlur(event) { if (ignoreNextBlur.current === true) { // The parent components are relying on the bubbling of the event. event.stopPropagation(); ignoreNextBlur.current = false; return; } if (onBlur) { event.persist(); event.target = { value: value, name: name }; onBlur(event); } }; 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(); // Opening the menu is going to blur the. It will be focused back when closed. ignoreNextBlur.current = true; update(true, event); } } }; var open = isOpenControlled && displayRef.current ? openProp : openState; delete other['aria-invalid']; var display; var displaySingle; var displayMultiple = []; var computeDisplay = false; // No need to display any value if the field is empty. if (isFilled(props) || displayEmpty) { if (renderValue) { display = renderValue(value); } else { computeDisplay = true; } } var items = React.Children.map(children, function (child) { if (!React.isValidElement(child)) { return null; } process.env.NODE_ENV !== "production" ? warning(child.type !== React.Fragment, ["Material-UI: the Select component doesn't accept a Fragment as a child.", 'Consider providing an array instead.'].join('\n')) : void 0; 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; } } return React.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 (computeDisplay) { display = multiple ? displayMultiple.join(', ') : displaySingle; } // Avoid performing a layout computation in the render method. var menuMinWidth = menuMinWidthState; if (!autoWidth && isOpenControlled && displayRef.current) { menuMinWidth = displayRef.current.clientWidth; } var tabIndex; if (typeof tabIndexProp !== 'undefined') { tabIndex = tabIndexProp; } else { tabIndex = disabled ? null : 0; } return React.createElement(React.Fragment, null, React.createElement("div", _extends({ className: clsx(classes.root, // TODO v5: merge root and select classes.select, classes.selectMenu, className, disabled && classes.disabled, { filled: classes.filled, outlined: classes.outlined }[variant]), ref: displayRef, tabIndex: tabIndex, role: "button", "aria-expanded": open ? 'true' : undefined, "aria-haspopup": "listbox", "aria-owns": open ? "menu-".concat(name || '') : undefined, onKeyDown: handleKeyDown, onBlur: handleBlur, onClick: disabled || readOnly ? null : handleClick, onFocus: onFocus // The id can help with end-to-end testing automation. , id: name ? "select-".concat(name) : undefined }, SelectDisplayProps), isEmpty(display) ? // eslint-disable-next-line react/no-danger React.createElement("span", { dangerouslySetInnerHTML: { __html: '&#8203;' } }) : display), React.createElement("input", _extends({ value: Array.isArray(value) ? value.join(',') : value, name: name, ref: inputRef, type: type, autoFocus: autoFocus }, other)), React.createElement(IconComponent, { className: classes.icon }), React.createElement(Menu, _extends({ id: "menu-".concat(name || ''), anchorEl: displayRef.current, open: open, onClose: handleClose }, MenuProps, { MenuListProps: _extends({ 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 */ 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, /** * 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, /** * Use that prop to pass a ref callback to the native select element. */ inputRef: PropTypes.oneOfType([PropTypes.func, PropTypes.object]), /** * 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`. * @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 {*} value The `value` provided to the component. * @returns {ReactElement} */ renderValue: PropTypes.func, /** * @ignore */ required: PropTypes.bool, /** * Props applied to the clickable div element. */ SelectDisplayProps: PropTypes.object, /** * @ignore */ tabIndex: PropTypes.oneOfType([PropTypes.number, PropTypes.string]), /** * @ignore */ type: PropTypes.string, /** * The input value. */ value: PropTypes.any.isRequired, /** * The variant to use. */ variant: PropTypes.oneOf(['standard', 'outlined', 'filled']) } : void 0; export default SelectInput;