UNPKG

@mui/material

Version:

React components that implement Google's Material Design.

298 lines (296 loc) 11.4 kB
"use strict"; var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault"); Object.defineProperty(exports, "__esModule", { value: true }); exports.default = void 0; var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose")); var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")); var React = _interopRequireWildcard(require("react")); var _propTypes = _interopRequireDefault(require("prop-types")); var _clsx = _interopRequireDefault(require("clsx")); var _base = require("@mui/base"); var _useThemeProps = _interopRequireDefault(require("../styles/useThemeProps")); var _styled = _interopRequireDefault(require("../styles/styled")); var _utils = require("../InputBase/utils"); var _capitalize = _interopRequireDefault(require("../utils/capitalize")); var _isMuiElement = _interopRequireDefault(require("../utils/isMuiElement")); var _FormControlContext = _interopRequireDefault(require("./FormControlContext")); var _formControlClasses = require("./formControlClasses"); var _jsxRuntime = require("react/jsx-runtime"); const _excluded = ["children", "className", "color", "component", "disabled", "error", "focused", "fullWidth", "hiddenLabel", "margin", "required", "size", "variant"]; 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; } const useUtilityClasses = ownerState => { const { classes, margin, fullWidth } = ownerState; const slots = { root: ['root', margin !== 'none' && `margin${(0, _capitalize.default)(margin)}`, fullWidth && 'fullWidth'] }; return (0, _base.unstable_composeClasses)(slots, _formControlClasses.getFormControlUtilityClasses, classes); }; const FormControlRoot = (0, _styled.default)('div', { name: 'MuiFormControl', slot: 'Root', overridesResolver: ({ ownerState }, styles) => { return (0, _extends2.default)({}, styles.root, styles[`margin${(0, _capitalize.default)(ownerState.margin)}`], ownerState.fullWidth && styles.fullWidth); } })(({ ownerState }) => (0, _extends2.default)({ display: 'inline-flex', flexDirection: 'column', position: 'relative', // Reset fieldset default style. minWidth: 0, padding: 0, margin: 0, border: 0, verticalAlign: 'top' }, ownerState.margin === 'normal' && { marginTop: 16, marginBottom: 8 }, ownerState.margin === 'dense' && { marginTop: 8, marginBottom: 4 }, ownerState.fullWidth && { width: '100%' })); /** * Provides context such as filled/focused/error/required for form inputs. * Relying on the context provides high flexibility and ensures that the state always stays * consistent across the children of the `FormControl`. * This context is used by the following components: * * - FormLabel * - FormHelperText * - Input * - InputLabel * * You can find one composition example below and more going to [the demos](/material-ui/react-text-field/#components). * * ```jsx * <FormControl> * <InputLabel htmlFor="my-input">Email address</InputLabel> * <Input id="my-input" aria-describedby="my-helper-text" /> * <FormHelperText id="my-helper-text">We'll never share your email.</FormHelperText> * </FormControl> * ``` * * ⚠️ Only one `InputBase` can be used within a FormControl because it creates visual inconsistencies. * For instance, only one input can be focused at the same time, the state shouldn't be shared. */ const FormControl = /*#__PURE__*/React.forwardRef(function FormControl(inProps, ref) { const props = (0, _useThemeProps.default)({ props: inProps, name: 'MuiFormControl' }); const { children, className, color = 'primary', component = 'div', disabled = false, error = false, focused: visuallyFocused, fullWidth = false, hiddenLabel = false, margin = 'none', required = false, size = 'medium', variant = 'outlined' } = props, other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded); const ownerState = (0, _extends2.default)({}, props, { color, component, disabled, error, fullWidth, hiddenLabel, margin, required, size, variant }); const classes = useUtilityClasses(ownerState); const [adornedStart, setAdornedStart] = React.useState(() => { // We need to iterate through the children and find the Input in order // to fully support server-side rendering. let initialAdornedStart = false; if (children) { React.Children.forEach(children, child => { if (!(0, _isMuiElement.default)(child, ['Input', 'Select'])) { return; } const input = (0, _isMuiElement.default)(child, ['Select']) ? child.props.input : child; if (input && (0, _utils.isAdornedStart)(input.props)) { initialAdornedStart = true; } }); } return initialAdornedStart; }); const [filled, setFilled] = React.useState(() => { // We need to iterate through the children and find the Input in order // to fully support server-side rendering. let initialFilled = false; if (children) { React.Children.forEach(children, child => { if (!(0, _isMuiElement.default)(child, ['Input', 'Select'])) { return; } if ((0, _utils.isFilled)(child.props, true)) { initialFilled = true; } }); } return initialFilled; }); const [focusedState, setFocused] = React.useState(false); if (disabled && focusedState) { setFocused(false); } const focused = visuallyFocused !== undefined && !disabled ? visuallyFocused : focusedState; let registerEffect; if (process.env.NODE_ENV !== 'production') { // eslint-disable-next-line react-hooks/rules-of-hooks const registeredInput = React.useRef(false); registerEffect = () => { if (registeredInput.current) { console.error(['MUI: There are multiple `InputBase` components inside a FormControl.', 'This creates visual inconsistencies, only use one `InputBase`.'].join('\n')); } registeredInput.current = true; return () => { registeredInput.current = false; }; }; } const childContext = React.useMemo(() => { return { adornedStart, setAdornedStart, color, disabled, error, filled, focused, fullWidth, hiddenLabel, size, onBlur: () => { setFocused(false); }, onEmpty: () => { setFilled(false); }, onFilled: () => { setFilled(true); }, onFocus: () => { setFocused(true); }, registerEffect, required, variant }; }, [adornedStart, color, disabled, error, filled, focused, fullWidth, hiddenLabel, registerEffect, required, size, variant]); return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FormControlContext.default.Provider, { value: childContext, children: /*#__PURE__*/(0, _jsxRuntime.jsx)(FormControlRoot, (0, _extends2.default)({ as: component, ownerState: ownerState, className: (0, _clsx.default)(classes.root, className), ref: ref }, other, { children: children })) }); }); process.env.NODE_ENV !== "production" ? FormControl.propTypes /* remove-proptypes */ = { // ----------------------------- Warning -------------------------------- // | These PropTypes are generated from the TypeScript type definitions | // | To update them edit the d.ts file and run "yarn proptypes" | // ---------------------------------------------------------------------- /** * The content of the component. */ children: _propTypes.default.node, /** * Override or extend the styles applied to the component. */ classes: _propTypes.default.object, /** * @ignore */ className: _propTypes.default.string, /** * The color of the component. * It supports both default and custom theme colors, which can be added as shown in the * [palette customization guide](https://mui.com/material-ui/customization/palette/#adding-new-colors). * @default 'primary' */ color: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_propTypes.default.oneOf(['primary', 'secondary', 'error', 'info', 'success', 'warning']), _propTypes.default.string]), /** * The component used for the root node. * Either a string to use a HTML element or a component. */ component: _propTypes.default.elementType, /** * If `true`, the label, input and helper text should be displayed in a disabled state. * @default false */ disabled: _propTypes.default.bool, /** * If `true`, the label is displayed in an error state. * @default false */ error: _propTypes.default.bool, /** * If `true`, the component is displayed in focused state. */ focused: _propTypes.default.bool, /** * If `true`, the component will take up the full width of its container. * @default false */ fullWidth: _propTypes.default.bool, /** * If `true`, the label is hidden. * This is used to increase density for a `FilledInput`. * Be sure to add `aria-label` to the `input` element. * @default false */ hiddenLabel: _propTypes.default.bool, /** * If `dense` or `normal`, will adjust vertical spacing of this and contained components. * @default 'none' */ margin: _propTypes.default.oneOf(['dense', 'none', 'normal']), /** * If `true`, the label will indicate that the `input` is required. * @default false */ required: _propTypes.default.bool, /** * The size of the component. * @default 'medium' */ size: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_propTypes.default.oneOf(['medium', 'small']), _propTypes.default.string]), /** * The system prop that allows defining system overrides as well as additional CSS styles. */ sx: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object, _propTypes.default.bool])), _propTypes.default.func, _propTypes.default.object]), /** * The variant to use. * @default 'outlined' */ variant: _propTypes.default.oneOf(['filled', 'outlined', 'standard']) } : void 0; var _default = FormControl; exports.default = _default;