@mui/material
Version:
Material UI is an open-source React component library that implements Google's Material Design. It's comprehensive and can be used in production out of the box.
464 lines (462 loc) • 17.1 kB
JavaScript
"use strict";
'use client';
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = void 0;
var React = _interopRequireWildcard(require("react"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _clsx = _interopRequireDefault(require("clsx"));
var _composeClasses = _interopRequireDefault(require("@mui/utils/composeClasses"));
var _useId = _interopRequireDefault(require("@mui/utils/useId"));
var _refType = _interopRequireDefault(require("@mui/utils/refType"));
var _zeroStyled = require("../zero-styled");
var _DefaultPropsProvider = require("../DefaultPropsProvider");
var _Input = _interopRequireDefault(require("../Input"));
var _FilledInput = _interopRequireDefault(require("../FilledInput"));
var _OutlinedInput = _interopRequireDefault(require("../OutlinedInput"));
var _InputLabel = _interopRequireDefault(require("../InputLabel"));
var _FormControl = _interopRequireDefault(require("../FormControl"));
var _FormHelperText = _interopRequireDefault(require("../FormHelperText"));
var _Select = _interopRequireDefault(require("../Select"));
var _textFieldClasses = require("./textFieldClasses");
var _useSlot = _interopRequireDefault(require("../utils/useSlot"));
var _jsxRuntime = require("react/jsx-runtime");
const variantComponent = {
standard: _Input.default,
filled: _FilledInput.default,
outlined: _OutlinedInput.default
};
const useUtilityClasses = ownerState => {
const {
classes
} = ownerState;
const slots = {
root: ['root']
};
return (0, _composeClasses.default)(slots, _textFieldClasses.getTextFieldUtilityClass, classes);
};
const TextFieldRoot = (0, _zeroStyled.styled)(_FormControl.default, {
name: 'MuiTextField',
slot: 'Root',
overridesResolver: (props, styles) => styles.root
})({});
/**
* The `TextField` is a convenience wrapper for the most common cases (80%).
* It cannot be all things to all people, otherwise the API would grow out of control.
*
* ## Advanced Configuration
*
* It's important to understand that the text field is a simple abstraction
* on top of the following components:
*
* - [FormControl](/material-ui/api/form-control/)
* - [InputLabel](/material-ui/api/input-label/)
* - [FilledInput](/material-ui/api/filled-input/)
* - [OutlinedInput](/material-ui/api/outlined-input/)
* - [Input](/material-ui/api/input/)
* - [FormHelperText](/material-ui/api/form-helper-text/)
*
* If you wish to alter the props applied to the `input` element, you can do so as follows:
*
* ```jsx
* const inputProps = {
* step: 300,
* };
*
* return <TextField id="time" type="time" inputProps={inputProps} />;
* ```
*
* For advanced cases, please look at the source of TextField by clicking on the
* "Edit this page" button above. Consider either:
*
* - using the upper case props for passing values directly to the components
* - using the underlying components directly as shown in the demos
*/
const TextField = /*#__PURE__*/React.forwardRef(function TextField(inProps, ref) {
const props = (0, _DefaultPropsProvider.useDefaultProps)({
props: inProps,
name: 'MuiTextField'
});
const {
autoComplete,
autoFocus = false,
children,
className,
color = 'primary',
defaultValue,
disabled = false,
error = false,
FormHelperTextProps: FormHelperTextPropsProp,
fullWidth = false,
helperText,
id: idOverride,
InputLabelProps: InputLabelPropsProp,
inputProps: inputPropsProp,
InputProps: InputPropsProp,
inputRef,
label,
maxRows,
minRows,
multiline = false,
name,
onBlur,
onChange,
onFocus,
placeholder,
required = false,
rows,
select = false,
SelectProps: SelectPropsProp,
slots = {},
slotProps = {},
type,
value,
variant = 'outlined',
...other
} = props;
const ownerState = {
...props,
autoFocus,
color,
disabled,
error,
fullWidth,
multiline,
required,
select,
variant
};
const classes = useUtilityClasses(ownerState);
if (process.env.NODE_ENV !== 'production') {
if (select && !children) {
console.error('MUI: `children` must be passed when using the `TextField` component with `select`.');
}
}
const id = (0, _useId.default)(idOverride);
const helperTextId = helperText && id ? `${id}-helper-text` : undefined;
const inputLabelId = label && id ? `${id}-label` : undefined;
const InputComponent = variantComponent[variant];
const externalForwardedProps = {
slots,
slotProps: {
input: InputPropsProp,
inputLabel: InputLabelPropsProp,
htmlInput: inputPropsProp,
formHelperText: FormHelperTextPropsProp,
select: SelectPropsProp,
...slotProps
}
};
const inputAdditionalProps = {};
const inputLabelSlotProps = externalForwardedProps.slotProps.inputLabel;
if (variant === 'outlined') {
if (inputLabelSlotProps && typeof inputLabelSlotProps.shrink !== 'undefined') {
inputAdditionalProps.notched = inputLabelSlotProps.shrink;
}
inputAdditionalProps.label = label;
}
if (select) {
// unset defaults from textbox inputs
if (!SelectPropsProp || !SelectPropsProp.native) {
inputAdditionalProps.id = undefined;
}
inputAdditionalProps['aria-describedby'] = undefined;
}
const [RootSlot, rootProps] = (0, _useSlot.default)('root', {
elementType: TextFieldRoot,
shouldForwardComponentProp: true,
externalForwardedProps: {
...externalForwardedProps,
...other
},
ownerState,
className: (0, _clsx.default)(classes.root, className),
ref,
additionalProps: {
disabled,
error,
fullWidth,
required,
color,
variant
}
});
const [InputSlot, inputProps] = (0, _useSlot.default)('input', {
elementType: InputComponent,
externalForwardedProps,
additionalProps: inputAdditionalProps,
ownerState
});
const [InputLabelSlot, inputLabelProps] = (0, _useSlot.default)('inputLabel', {
elementType: _InputLabel.default,
externalForwardedProps,
ownerState
});
const [HtmlInputSlot, htmlInputProps] = (0, _useSlot.default)('htmlInput', {
elementType: 'input',
externalForwardedProps,
ownerState
});
const [FormHelperTextSlot, formHelperTextProps] = (0, _useSlot.default)('formHelperText', {
elementType: _FormHelperText.default,
externalForwardedProps,
ownerState
});
const [SelectSlot, selectProps] = (0, _useSlot.default)('select', {
elementType: _Select.default,
externalForwardedProps,
ownerState
});
const InputElement = /*#__PURE__*/(0, _jsxRuntime.jsx)(InputSlot, {
"aria-describedby": helperTextId,
autoComplete: autoComplete,
autoFocus: autoFocus,
defaultValue: defaultValue,
fullWidth: fullWidth,
multiline: multiline,
name: name,
rows: rows,
maxRows: maxRows,
minRows: minRows,
type: type,
value: value,
id: id,
inputRef: inputRef,
onBlur: onBlur,
onChange: onChange,
onFocus: onFocus,
placeholder: placeholder,
inputProps: htmlInputProps,
slots: {
input: slots.htmlInput ? HtmlInputSlot : undefined
},
...inputProps
});
return /*#__PURE__*/(0, _jsxRuntime.jsxs)(RootSlot, {
...rootProps,
children: [label != null && label !== '' && /*#__PURE__*/(0, _jsxRuntime.jsx)(InputLabelSlot, {
htmlFor: id,
id: inputLabelId,
...inputLabelProps,
children: label
}), select ? /*#__PURE__*/(0, _jsxRuntime.jsx)(SelectSlot, {
"aria-describedby": helperTextId,
id: id,
labelId: inputLabelId,
value: value,
input: InputElement,
...selectProps,
children: children
}) : InputElement, helperText && /*#__PURE__*/(0, _jsxRuntime.jsx)(FormHelperTextSlot, {
id: helperTextId,
...formHelperTextProps,
children: helperText
})]
});
});
process.env.NODE_ENV !== "production" ? TextField.propTypes /* remove-proptypes */ = {
// ┌────────────────────────────── Warning ──────────────────────────────┐
// │ These PropTypes are generated from the TypeScript type definitions. │
// │ To update them, edit the d.ts file and run `pnpm proptypes`. │
// └─────────────────────────────────────────────────────────────────────┘
/**
* This prop helps users to fill forms faster, especially on mobile devices.
* The name can be confusing, as it's more like an autofill.
* You can learn more about it [following the specification](https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill).
*/
autoComplete: _propTypes.default.string,
/**
* If `true`, the `input` element is focused during the first mount.
* @default false
*/
autoFocus: _propTypes.default.bool,
/**
* @ignore
*/
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/#custom-colors).
* @default 'primary'
*/
color: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_propTypes.default.oneOf(['primary', 'secondary', 'error', 'info', 'success', 'warning']), _propTypes.default.string]),
/**
* The default value. Use when the component is not controlled.
*/
defaultValue: _propTypes.default.any,
/**
* If `true`, the component is disabled.
* @default false
*/
disabled: _propTypes.default.bool,
/**
* If `true`, the label is displayed in an error state.
* @default false
*/
error: _propTypes.default.bool,
/**
* Props applied to the [`FormHelperText`](https://mui.com/material-ui/api/form-helper-text/) element.
* @deprecated Use `slotProps.formHelperText` instead. This prop will be removed in a future major release. See [Migrating from deprecated APIs](https://mui.com/material-ui/migration/migrating-from-deprecated-apis/) for more details.
*/
FormHelperTextProps: _propTypes.default.object,
/**
* If `true`, the input will take up the full width of its container.
* @default false
*/
fullWidth: _propTypes.default.bool,
/**
* The helper text content.
*/
helperText: _propTypes.default.node,
/**
* The id of the `input` element.
* Use this prop to make `label` and `helperText` accessible for screen readers.
*/
id: _propTypes.default.string,
/**
* Props applied to the [`InputLabel`](https://mui.com/material-ui/api/input-label/) element.
* Pointer events like `onClick` are enabled if and only if `shrink` is `true`.
* @deprecated Use `slotProps.inputLabel` instead. This prop will be removed in a future major release. See [Migrating from deprecated APIs](https://mui.com/material-ui/migration/migrating-from-deprecated-apis/) for more details.
*/
InputLabelProps: _propTypes.default.object,
/**
* [Attributes](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Attributes) applied to the `input` element.
* @deprecated Use `slotProps.htmlInput` instead. This prop will be removed in a future major release. See [Migrating from deprecated APIs](https://mui.com/material-ui/migration/migrating-from-deprecated-apis/) for more details.
*/
inputProps: _propTypes.default.object,
/**
* Props applied to the Input element.
* It will be a [`FilledInput`](https://mui.com/material-ui/api/filled-input/),
* [`OutlinedInput`](https://mui.com/material-ui/api/outlined-input/) or [`Input`](https://mui.com/material-ui/api/input/)
* component depending on the `variant` prop value.
* @deprecated Use `slotProps.input` instead. This prop will be removed in a future major release. See [Migrating from deprecated APIs](https://mui.com/material-ui/migration/migrating-from-deprecated-apis/) for more details.
*/
InputProps: _propTypes.default.object,
/**
* Pass a ref to the `input` element.
*/
inputRef: _refType.default,
/**
* The label content.
*/
label: _propTypes.default.node,
/**
* If `dense` or `normal`, will adjust vertical spacing of this and contained components.
* @default 'none'
*/
margin: _propTypes.default.oneOf(['dense', 'none', 'normal']),
/**
* Maximum number of rows to display when multiline option is set to true.
*/
maxRows: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
/**
* Minimum number of rows to display when multiline option is set to true.
*/
minRows: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
/**
* If `true`, a `textarea` element is rendered instead of an input.
* @default false
*/
multiline: _propTypes.default.bool,
/**
* Name attribute of the `input` element.
*/
name: _propTypes.default.string,
/**
* @ignore
*/
onBlur: _propTypes.default.func,
/**
* Callback fired when the value is changed.
*
* @param {object} event The event source of the callback.
* You can pull out the new value by accessing `event.target.value` (string).
*/
onChange: _propTypes.default.func,
/**
* @ignore
*/
onFocus: _propTypes.default.func,
/**
* The short hint displayed in the `input` before the user enters a value.
*/
placeholder: _propTypes.default.string,
/**
* If `true`, the label is displayed as required and the `input` element is required.
* @default false
*/
required: _propTypes.default.bool,
/**
* Number of rows to display when multiline option is set to true.
*/
rows: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
/**
* Render a [`Select`](https://mui.com/material-ui/api/select/) element while passing the Input element to `Select` as `input` parameter.
* If this option is set you must pass the options of the select as children.
* @default false
*/
select: _propTypes.default.bool,
/**
* Props applied to the [`Select`](https://mui.com/material-ui/api/select/) element.
* @deprecated Use `slotProps.select` instead. This prop will be removed in a future major release. See [Migrating from deprecated APIs](https://mui.com/material-ui/migration/migrating-from-deprecated-apis/) for more details.
*/
SelectProps: _propTypes.default.object,
/**
* The size of the component.
* @default 'medium'
*/
size: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_propTypes.default.oneOf(['medium', 'small']), _propTypes.default.string]),
/**
* The props used for each slot inside.
* @default {}
*/
slotProps: _propTypes.default /* @typescript-to-proptypes-ignore */.shape({
formHelperText: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
htmlInput: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
input: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
inputLabel: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object]),
select: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object])
}),
/**
* The components used for each slot inside.
* @default {}
*/
slots: _propTypes.default.shape({
formHelperText: _propTypes.default.elementType,
htmlInput: _propTypes.default.elementType,
input: _propTypes.default.elementType,
inputLabel: _propTypes.default.elementType,
root: _propTypes.default.elementType,
select: _propTypes.default.elementType
}),
/**
* 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]),
/**
* Type of the `input` element. It should be [a valid HTML5 input type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#Form_%3Cinput%3E_types).
*/
type: _propTypes.default /* @typescript-to-proptypes-ignore */.string,
/**
* The value of the `input` element, required for a controlled component.
*/
value: _propTypes.default.any,
/**
* The variant to use.
* @default 'outlined'
*/
variant: _propTypes.default.oneOf(['filled', 'outlined', 'standard'])
} : void 0;
var _default = exports.default = TextField;