@mui/core
Version:
Unstyled React components with which to implement custom design systems.
241 lines (203 loc) • 8.01 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 _clsx = _interopRequireDefault(require("clsx"));
var _utils = require("@mui/utils");
var _FormControlContext = _interopRequireDefault(require("./FormControlContext"));
var _appendOwnerState = _interopRequireDefault(require("../utils/appendOwnerState"));
var _formControlUnstyledClasses = _interopRequireDefault(require("./formControlUnstyledClasses"));
var _jsxRuntime = require("react/jsx-runtime");
const _excluded = ["defaultValue", "children", "className", "component", "components", "componentsProps", "disabled", "error", "focused", "onChange", "required", "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 hasValue(value) {
return value != null && !(Array.isArray(value) && value.length === 0) && value !== '';
}
/**
* 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](https://mui.com/components/text-fields/#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 `Input` can be used within a FormControl because it create visual inconsistencies.
* For instance, only one input can be focused at the same time, the state shouldn't be shared.
*
* Demos:
*
* - [Text Fields](https://mui.com/components/text-fields/)
*
* API:
*
* - [FormControlUnstyled API](https://mui.com/api/form-control-unstyled/)
*/
const FormControlUnstyled = /*#__PURE__*/React.forwardRef(function FormControlUnstyled(props, ref) {
var _ref;
const {
defaultValue,
children,
className,
component,
components = {},
componentsProps = {},
disabled = false,
error = false,
focused: visuallyFocused = false,
onChange,
required = false,
value: incomingValue
} = props,
other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
const [value, setValue] = (0, _utils.unstable_useControlled)({
controlled: incomingValue,
default: defaultValue,
name: 'FormControl',
state: 'value'
});
const filled = hasValue(value);
const [focusedState, setFocused] = React.useState(false);
if (disabled && focusedState) {
setFocused(false);
}
const focused = visuallyFocused !== undefined && !disabled ? visuallyFocused : focusedState;
const ownerState = (0, _extends2.default)({}, props, {
disabled,
error,
filled,
focused,
required
});
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 `Input` components inside a FormControl.', 'This creates visual inconsistencies, only use one `Input`.'].join('\n'));
}
registeredInput.current = true;
return () => {
registeredInput.current = false;
};
};
}
const handleChange = event => {
setValue(event.target.value);
onChange == null ? void 0 : onChange(event);
};
const childContext = {
disabled,
error,
filled,
focused,
onBlur: () => {
setFocused(false);
},
onChange: handleChange,
onFocus: () => {
setFocused(true);
},
registerEffect,
required,
value: value != null ? value : ''
};
const Root = (_ref = component != null ? component : components.Root) != null ? _ref : 'div';
const rootProps = (0, _appendOwnerState.default)(Root, (0, _extends2.default)({}, other, componentsProps.root), ownerState);
return /*#__PURE__*/(0, _jsxRuntime.jsx)(_FormControlContext.default.Provider, {
value: childContext,
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(Root, (0, _extends2.default)({
ref: ref
}, rootProps, {
className: (0, _clsx.default)(_formControlUnstyledClasses.default.root, className, rootProps == null ? void 0 : rootProps.className, disabled && _formControlUnstyledClasses.default.disabled),
children: children
}))
});
});
process.env.NODE_ENV !== "production" ? FormControlUnstyled.propTypes
/* remove-proptypes */
= {
// ----------------------------- Warning --------------------------------
// | These PropTypes are generated from the TypeScript type definitions |
// | To update them edit TypeScript types and run "yarn proptypes" |
// ----------------------------------------------------------------------
/**
* The content of the component.
*/
children: _propTypes.default.node,
/**
* Class name applied to the root element.
*/
className: _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,
/**
* The components used for each slot inside the FormControl.
* Either a string to use a HTML element or a component.
* @default {}
*/
components: _propTypes.default.shape({
Root: _propTypes.default.elementType
}),
/**
* @ignore
*/
componentsProps: _propTypes.default.object,
/**
* @ignore
*/
defaultValue: _propTypes.default.any,
/**
* 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.
* @default false
*/
focused: _propTypes.default.bool,
/**
* @ignore
*/
onChange: _propTypes.default.func,
/**
* If `true`, the label will indicate that the `input` is required.
* @default false
*/
required: _propTypes.default.bool,
/**
* @ignore
*/
value: _propTypes.default.any
} : void 0;
var _default = FormControlUnstyled;
exports.default = _default;