UNPKG

@material-ui/lab

Version:

Material-UI Lab - Incubator for Material-UI React components.

344 lines (297 loc) 10.2 kB
import _extends from "@babel/runtime/helpers/esm/extends"; import * as React from 'react'; import PropTypes from 'prop-types'; import { createStyles, withStyles } from '@material-ui/core/styles'; import Clock from './Clock'; import { pipe } from '../internal/pickers/utils'; import { useUtils, useNow } from '../internal/pickers/hooks/useUtils'; import { getHourNumbers, getMinutesNumbers } from './ClockNumbers'; import ArrowSwitcher from '../internal/pickers/PickersArrowSwitcher'; import { convertValueToMeridiem, createIsAfterIgnoreDatePart } from '../internal/pickers/time-utils'; import { useMeridiemMode } from '../internal/pickers/hooks/date-helpers-hooks'; export const styles = createStyles({ arrowSwitcher: { position: 'absolute', right: 12, top: 15 } }); const getDefaultClockLabelText = (view, time, adapter) => `Select ${view}. Selected time is ${adapter.format(time, 'fullTime')}`; const getMinutesAriaText = minute => `${minute} minutes`; const getHoursAriaText = hour => `${hour} hours`; const getSecondsAriaText = seconds => `${seconds} seconds`; /** * @ignore - do not document. */ function ClockPicker(props) { const { allowKeyboardControl, ampm, ampmInClock, classes, date, disableIgnoringDatePartForTimeValidation, getClockLabelText = getDefaultClockLabelText, getHoursClockNumberText = getHoursAriaText, getMinutesClockNumberText = getMinutesAriaText, getSecondsClockNumberText = getSecondsAriaText, leftArrowButtonProps, leftArrowButtonText = 'open previous view', leftArrowIcon, maxTime, minTime, minutesStep = 1, nextViewAvailable, onChange, openNextView, openPreviousView, previousViewAvailable, rightArrowButtonProps, rightArrowButtonText = 'open next view', rightArrowIcon, shouldDisableTime, showViewSwitcher, view } = props; const now = useNow(); const utils = useUtils(); const dateOrNow = date || now; const { meridiemMode, handleMeridiemChange } = useMeridiemMode(dateOrNow, ampm, onChange); const isTimeDisabled = React.useCallback((rawValue, viewType) => { if (date === null) { return false; } const validateTimeValue = getRequestedTimePoint => { const isAfterComparingFn = createIsAfterIgnoreDatePart(Boolean(disableIgnoringDatePartForTimeValidation), utils); return Boolean(minTime && isAfterComparingFn(minTime, getRequestedTimePoint('end')) || maxTime && isAfterComparingFn(getRequestedTimePoint('start'), maxTime) || shouldDisableTime && shouldDisableTime(rawValue, viewType)); }; switch (viewType) { case 'hours': { const hoursWithMeridiem = convertValueToMeridiem(rawValue, meridiemMode, Boolean(ampm)); return validateTimeValue(when => pipe(currentDate => utils.setHours(currentDate, hoursWithMeridiem), dateWithHours => utils.setMinutes(dateWithHours, when === 'start' ? 0 : 59), dateWithMinutes => utils.setSeconds(dateWithMinutes, when === 'start' ? 0 : 59))(date)); } case 'minutes': return validateTimeValue(when => pipe(currentDate => utils.setMinutes(currentDate, rawValue), dateWithMinutes => utils.setSeconds(dateWithMinutes, when === 'start' ? 0 : 59))(date)); case 'seconds': return validateTimeValue(() => utils.setSeconds(date, rawValue)); default: throw new Error('not supported'); } }, [ampm, date, disableIgnoringDatePartForTimeValidation, maxTime, meridiemMode, minTime, shouldDisableTime, utils]); const viewProps = React.useMemo(() => { switch (view) { case 'hours': { const handleHoursChange = (value, isFinish) => { const valueWithMeridiem = convertValueToMeridiem(value, meridiemMode, Boolean(ampm)); onChange(utils.setHours(dateOrNow, valueWithMeridiem), isFinish); }; return { onChange: handleHoursChange, value: utils.getHours(dateOrNow), children: getHourNumbers({ date, utils, ampm: Boolean(ampm), onChange: handleHoursChange, getClockNumberText: getHoursClockNumberText, isDisabled: value => isTimeDisabled(value, 'hours') }) }; } case 'minutes': { const minutesValue = utils.getMinutes(dateOrNow); const handleMinutesChange = (value, isFinish) => { onChange(utils.setMinutes(dateOrNow, value), isFinish); }; return { value: minutesValue, onChange: handleMinutesChange, children: getMinutesNumbers({ utils, value: minutesValue, onChange: handleMinutesChange, getClockNumberText: getMinutesClockNumberText, isDisabled: value => isTimeDisabled(value, 'minutes') }) }; } case 'seconds': { const secondsValue = utils.getSeconds(dateOrNow); const handleSecondsChange = (value, isFinish) => { onChange(utils.setSeconds(dateOrNow, value), isFinish); }; return { value: secondsValue, onChange: handleSecondsChange, children: getMinutesNumbers({ utils, value: secondsValue, onChange: handleSecondsChange, getClockNumberText: getSecondsClockNumberText, isDisabled: value => isTimeDisabled(value, 'seconds') }) }; } default: throw new Error('You must provide the type for ClockView'); } }, [view, utils, date, ampm, getHoursClockNumberText, getMinutesClockNumberText, getSecondsClockNumberText, meridiemMode, onChange, dateOrNow, isTimeDisabled]); return /*#__PURE__*/React.createElement(React.Fragment, null, showViewSwitcher && /*#__PURE__*/React.createElement(ArrowSwitcher, { className: classes.arrowSwitcher, leftArrowButtonProps: leftArrowButtonProps, rightArrowButtonProps: rightArrowButtonProps, leftArrowButtonText: leftArrowButtonText, rightArrowButtonText: rightArrowButtonText, leftArrowIcon: leftArrowIcon, rightArrowIcon: rightArrowIcon, onLeftClick: openPreviousView, onRightClick: openNextView, isLeftDisabled: previousViewAvailable, isRightDisabled: nextViewAvailable }), /*#__PURE__*/React.createElement(Clock, _extends({ date: date, ampmInClock: ampmInClock, type: view, ampm: ampm // @ts-expect-error TODO figure out this weird error , getClockLabelText: getClockLabelText, minutesStep: minutesStep, allowKeyboardControl: allowKeyboardControl, isTimeDisabled: isTimeDisabled, meridiemMode: meridiemMode, handleMeridiemChange: handleMeridiemChange }, viewProps))); } ClockPicker.propTypes = { // ----------------------------- Warning -------------------------------- // | These PropTypes are generated from the TypeScript type definitions | // | To update them edit TypeScript types and run "yarn proptypes" | // ---------------------------------------------------------------------- /** * Enables keyboard listener for moving between days in calendar. * @default currentWrapper !== 'static' */ allowKeyboardControl: PropTypes.bool, /** * 12h/24h view for hour selection clock. * @default true */ ampm: PropTypes.bool, /** * Display ampm controls under the clock (instead of in the toolbar). * @default false */ ampmInClock: PropTypes.bool, /** * @ignore */ classes: PropTypes.object.isRequired, /** * Selected date @DateIOType. */ date: PropTypes.any, /** * Do not ignore date part when validating min/max time. * @default false */ disableIgnoringDatePartForTimeValidation: PropTypes.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.func, /** * Get clock number aria-text for hours. */ getHoursClockNumberText: PropTypes.func, /** * Get clock number aria-text for minutes. */ getMinutesClockNumberText: PropTypes.func, /** * Get clock number aria-text for seconds. */ getSecondsClockNumberText: PropTypes.func, /** * Props to pass to left arrow button. */ leftArrowButtonProps: PropTypes.object, /** * Left arrow icon aria-label text. */ leftArrowButtonText: PropTypes.string, /** * Left arrow icon. */ leftArrowIcon: PropTypes.node, /** * Max time acceptable time. * For input validation date part of passed object will be ignored if `disableIgnoringDatePartForTimeValidation` not specified. */ maxTime: PropTypes.any, /** * Min time acceptable time. * For input validation date part of passed object will be ignored if `disableIgnoringDatePartForTimeValidation` not specified. */ minTime: PropTypes.any, /** * Step over minutes. * @default 1 */ minutesStep: PropTypes.number, /** * @ignore */ nextViewAvailable: PropTypes.bool.isRequired, /** * On change callback @DateIOType. */ onChange: PropTypes.func.isRequired, /** * @ignore */ openNextView: PropTypes.func.isRequired, /** * @ignore */ openPreviousView: PropTypes.func.isRequired, /** * @ignore */ previousViewAvailable: PropTypes.bool.isRequired, /** * Props to pass to right arrow button. */ rightArrowButtonProps: PropTypes.object, /** * Right arrow icon aria-label text. */ rightArrowButtonText: PropTypes.string, /** * Right arrow icon. */ rightArrowIcon: PropTypes.node, /** * Dynamically check if time is disabled or not. * If returns `false` appropriate time point will ot be acceptable. */ shouldDisableTime: PropTypes.func, /** * @ignore */ showViewSwitcher: PropTypes.bool, /** * @ignore */ view: PropTypes.oneOf(['hours', 'minutes', 'seconds']).isRequired }; export default withStyles(styles, { name: 'MuiPickersClockView' })(ClockPicker);