@material-ui/lab
Version:
Material-UI Lab - Incubator for Material-UI React components.
405 lines (330 loc) • 11.9 kB
JavaScript
"use strict";
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.getTextFieldAriaText = getTextFieldAriaText;
exports.default = exports.timePickerConfig = void 0;
var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
var _react = _interopRequireDefault(require("react"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _Clock = _interopRequireDefault(require("../internal/svg-icons/Clock"));
var _TimePickerToolbar = _interopRequireDefault(require("./TimePickerToolbar"));
var _ResponsiveWrapper = require("../internal/pickers/wrappers/ResponsiveWrapper");
var _textFieldHelper = require("../internal/pickers/text-field-helper");
var _useUtils = require("../internal/pickers/hooks/useUtils");
var _timeUtils = require("../internal/pickers/time-utils");
var _useValidation = require("../internal/pickers/hooks/useValidation");
var _dateHelpersHooks = require("../internal/pickers/hooks/date-helpers-hooks");
var _makePickerWithState = require("../internal/pickers/Picker/makePickerWithState");
function getTextFieldAriaText(value, utils) {
return value && utils.isValid(utils.date(value)) ? `Choose time, selected time is ${utils.format(utils.date(value), 'fullTime')}` : 'Choose time';
}
var _ref2 = /*#__PURE__*/_react.default.createElement(_Clock.default, null);
function useInterceptProps(_ref) {
let {
ampm,
inputFormat,
maxTime: __maxTime,
minTime: __minTime,
openTo = 'hours',
views = ['hours', 'minutes']
} = _ref,
other = (0, _objectWithoutPropertiesLoose2.default)(_ref, ["ampm", "inputFormat", "maxTime", "minTime", "openTo", "views"]);
const utils = (0, _useUtils.useUtils)();
const minTime = (0, _dateHelpersHooks.useParsedDate)(__minTime);
const maxTime = (0, _dateHelpersHooks.useParsedDate)(__maxTime);
const willUseAmPm = ampm !== null && ampm !== void 0 ? ampm : utils.is12HourCycleInCurrentLocale();
return (0, _extends2.default)({
views,
openTo,
minTime,
maxTime,
ampm: willUseAmPm,
acceptRegex: willUseAmPm ? /[\dapAP]/gi : /\d/gi,
mask: '__:__',
disableMaskedInput: willUseAmPm,
getOpenDialogAriaText: getTextFieldAriaText,
openPickerIcon: _ref2,
inputFormat: (0, _textFieldHelper.pick12hOr24hFormat)(inputFormat, willUseAmPm, {
localized: utils.formats.fullTime,
'12h': utils.formats.fullTime12h,
'24h': utils.formats.fullTime24h
})
}, other);
}
const timePickerConfig = {
useInterceptProps,
useValidation: (0, _useValidation.makeValidationHook)(_timeUtils.validateTime),
DefaultToolbarComponent: _TimePickerToolbar.default
};
exports.timePickerConfig = timePickerConfig;
/**
* @ignore - do not document.
*/
/* @GeneratePropTypes */
const TimePicker = (0, _makePickerWithState.makePickerWithStateAndWrapper)(_ResponsiveWrapper.ResponsiveWrapper, (0, _extends2.default)({
name: 'MuiTimePicker'
}, timePickerConfig));
TimePicker.propTypes = {
// ----------------------------- Warning --------------------------------
// | These PropTypes are generated from the TypeScript type definitions |
// | To update them edit TypeScript types and run "yarn proptypes" |
// ----------------------------------------------------------------------
/**
* Regular expression to detect "accepted" symbols.
* @default /\dap/gi
*/
acceptRegex: _propTypes.default.instanceOf(RegExp),
/**
* Enables keyboard listener for moving between days in calendar.
* @default currentWrapper !== 'static'
*/
allowKeyboardControl: _propTypes.default.bool,
/**
* 12h/24h view for hour selection clock.
* @default true
*/
ampm: _propTypes.default.bool,
/**
* Display ampm controls under the clock (instead of in the toolbar).
* @default false
*/
ampmInClock: _propTypes.default.bool,
/**
* "CANCEL" Text message
* @default "CANCEL"
*/
cancelText: _propTypes.default.node,
/**
* className applied to the root component.
*/
className: _propTypes.default.string,
/**
* If `true`, it shows the clear action in the picker dialog.
* @default false
*/
clearable: _propTypes.default.bool,
/**
* "CLEAR" Text message
* @default "CLEAR"
*/
clearText: _propTypes.default.node,
/**
* Allows to pass configured date-io adapter directly. More info [here](https://next.material-ui-pickers.dev/guides/date-adapter-passing)
* ```jsx
* dateAdapter={new DateFnsAdapter({ locale: ruLocale })}
* ```
*/
dateAdapter: _propTypes.default.object,
/**
* CSS media query when `Mobile` mode will be changed to `Desktop`.
* @default "@media (pointer: fine)"
* @example "@media (min-width: 720px)" or theme.breakpoints.up("sm")
*/
desktopModeMediaQuery: _propTypes.default.string,
/**
* Props to be passed directly to material-ui [Dialog](https://material-ui.com/components/dialogs)
*/
DialogProps: _propTypes.default.object,
/**
* If `true` the popup or dialog will immediately close after submitting full date.
* @default `true` for Desktop, `false` for Mobile (based on the chosen wrapper and `desktopModeMediaQuery` prop).
*/
disableCloseOnSelect: _propTypes.default.bool,
/**
* If `true`, the picker and text field are disabled.
*/
disabled: _propTypes.default.bool,
/**
* Do not ignore date part when validating min/max time.
* @default false
*/
disableIgnoringDatePartForTimeValidation: _propTypes.default.bool,
/**
* Disable mask on the keyboard, this should be used rarely. Consider passing proper mask for your format.
* @default false
*/
disableMaskedInput: _propTypes.default.bool,
/**
* Do not render open picker button (renders only text field with validation).
* @default false
*/
disableOpenPicker: _propTypes.default.bool,
/**
* Accessible text that helps user to understand which time and view is selected.
* @default (view, time) => `Select ${view}. Selected time is ${format(time, 'fullTime')}`
*/
getClockLabelText: _propTypes.default.func,
/**
* Get aria-label text for control that opens picker dialog. Aria-label text must include selected date. @DateIOType
* @default (value, utils) => `Choose date, selected date is ${utils.format(utils.date(value), 'fullDate')}`
*/
getOpenDialogAriaText: _propTypes.default.func,
/**
* @ignore
*/
ignoreInvalidInputs: _propTypes.default.bool,
/**
* Props to pass to keyboard input adornment.
*/
InputAdornmentProps: _propTypes.default.object,
/**
* Format string.
*/
inputFormat: _propTypes.default.string,
/**
* @ignore
*/
InputProps: _propTypes.default.object,
/**
* @ignore
*/
key: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
/**
* @ignore
*/
label: _propTypes.default.node,
/**
* Custom mask. Can be used to override generate from format. (e.g. __/__/____ __:__ or __/__/____ __:__ _M)
*/
mask: _propTypes.default.string,
/**
* @ignore
*/
maxTime: _propTypes.default.oneOfType([_propTypes.default.any, _propTypes.default.instanceOf(Date), _propTypes.default.number, _propTypes.default.string]),
/**
* @ignore
*/
minTime: _propTypes.default.oneOfType([_propTypes.default.any, _propTypes.default.instanceOf(Date), _propTypes.default.number, _propTypes.default.string]),
/**
* Step over minutes.
* @default 1
*/
minutesStep: _propTypes.default.number,
/**
* "OK" button text.
* @default "OK"
*/
okText: _propTypes.default.node,
/**
* Callback fired when date is accepted @DateIOType.
*/
onAccept: _propTypes.default.func,
/**
* Callback fired when the value (the selected date) changes. @DateIOType.
*/
onChange: _propTypes.default.func.isRequired,
/**
* Callback fired when the popup requests to be closed.
* Use in controlled mode (see open).
*/
onClose: _propTypes.default.func,
/**
* Callback that fired when input value or new `value` prop validation returns **new** validation error (or value is valid after error).
* In case of validation error detected `reason` prop return non-null value and `TextField` must be displayed in `error` state.
* This can be used to render appropriate form error.
*
* [Read the guide](https://next.material-ui-pickers.dev/guides/forms) about form integration and error displaying.
* @DateIOType
*/
onError: _propTypes.default.func,
/**
* Callback fired when the popup requests to be opened.
* Use in controlled mode (see open).
*/
onOpen: _propTypes.default.func,
/**
* Control the popup or dialog open state.
*/
open: _propTypes.default.bool,
/**
* Props to pass to keyboard adornment button.
*/
OpenPickerButtonProps: _propTypes.default.object,
/**
* Icon displaying for open picker button.
*/
openPickerIcon: _propTypes.default.node,
/**
* First view to show.
*/
openTo: _propTypes.default.oneOf(['date', 'hours', 'minutes', 'month', 'seconds', 'year']),
/**
* Force rendering in particular orientation.
*/
orientation: _propTypes.default.oneOf(['landscape', 'portrait']),
/**
* Popper props passed down to [Popper](https://material-ui.com/api/popper/) component.
*/
PopperProps: _propTypes.default.object,
/**
* Make picker read only.
*/
readOnly: _propTypes.default.bool,
/**
* The `renderInput` prop allows you to customize the rendered input.
* The `props` argument of this render prop contains props of [TextField](https://material-ui.com/api/text-field/#textfield-api) that you need to forward.
* Pay specific attention to the `ref` and `inputProps` keys.
* @example ```jsx
* renderInput={props => <TextField {...props} />}
* ````
*/
renderInput: _propTypes.default.func.isRequired,
/**
* Custom formatter to be passed into Rifm component.
*/
rifmFormatter: _propTypes.default.func,
/**
* Dynamically check if time is disabled or not.
* If returns `false` appropriate time point will ot be acceptable.
*/
shouldDisableTime: _propTypes.default.func,
/**
* If `true`, the today button will be displayed. **Note** that `showClearButton` has a higher priority.
* @default false
*/
showTodayButton: _propTypes.default.bool,
/**
* If `true`, show the toolbar even in desktop mode.
*/
showToolbar: _propTypes.default.bool,
/**
* "TODAY" Text message
* @default "TODAY"
*/
todayText: _propTypes.default.node,
/**
* Component that will replace default toolbar renderer.
*/
ToolbarComponent: _propTypes.default.elementType,
/**
* Date format, that is displaying in toolbar.
*/
toolbarFormat: _propTypes.default.string,
/**
* Mobile picker date value placeholder, displaying if `value` === `null`.
* @default "–"
*/
toolbarPlaceholder: _propTypes.default.node,
/**
* Mobile picker title, displaying in the toolbar.
* @default "SELECT DATE"
*/
toolbarTitle: _propTypes.default.node,
/**
* Custom component for popper [Transition](https://material-ui.com/components/transitions/#transitioncomponent-prop).
*/
TransitionComponent: _propTypes.default.elementType,
/**
* The value of the picker.
*/
value: _propTypes.default.oneOfType([_propTypes.default.any, _propTypes.default.instanceOf(Date), _propTypes.default.number, _propTypes.default.string]),
/**
* Array of views to show.
*/
views: _propTypes.default.arrayOf(_propTypes.default.oneOf(['hours', 'minutes', 'seconds']).isRequired)
};
var _default = TimePicker;
exports.default = _default;