StaticNextTimePicker API
API documentation for the React StaticNextTimePicker component. Learn about the available props and the CSS API.
Import
import { Unstable_StaticNextTimePicker } from '@mui/x-date-pickers-pro/StaticNextTimePicker';
// or
import { Unstable_StaticNextTimePicker } from '@mui/x-date-pickers/StaticNextTimePicker';
// or
import { Unstable_StaticNextTimePicker } from '@mui/x-date-pickers-pro';
// or
import { Unstable_StaticNextTimePicker } from '@mui/x-date-pickers';Component name
The nameMuiStaticNextTimePicker can be used when providing default props or style overrides in the theme.Props
| Name | Type | Default | Description |
|---|---|---|---|
| ampm | bool | `utils.is12HourCycleInCurrentLocale()` | 12h/24h view for hour selection clock. |
| ampmInClock | bool | false | Display ampm controls under the clock (instead of in the toolbar). |
| className | string | Class name applied to the root element. | |
| components | object | {} | Overrideable components. |
| componentsProps | object | {} | The props used for each component slot. |
| defaultValue | any | The default value. Used when the component is not controlled. | |
| disabled | bool | false | If true, the picker and text field are disabled. |
| disableFuture | bool | false | If true disable values before the current date for date components, time for time components and both for date time components. |
| disableIgnoringDatePartForTimeValidation | bool | false | Do not ignore date part when validating min/max time. |
| disablePast | bool | false | If true disable values after the current date for date components, time for time components and both for date time components. |
| displayStaticWrapperAs | 'desktop' | 'mobile' | "mobile" | Force static wrapper inner components to be rendered in mobile or desktop mode. |
| localeText | object | Locale for components texts. Allows overriding texts coming from LocalizationProvider and theme. | |
| maxTime | any | Maximal selectable time. The date part of the object will be ignored unless props.disableIgnoringDatePartForTimeValidation === true. | |
| minTime | any | Minimal selectable time. The date part of the object will be ignored unless props.disableIgnoringDatePartForTimeValidation === true. | |
| minutesStep | number | 1 | Step over minutes. |
| onAccept | func | Callback fired when the value is accepted. Signature: function(value: TValue) => voidvalue: The value that was just accepted. | |
| onChange | func | Callback fired when the value changes. Signature: function(value: TValue, The: FieldChangeHandlerContext<TError>) => voidvalue: The new value. The: context containing the validation result of the current value. | |
| onError | func | Callback fired when the error associated to the current value changes. If the error has a non-null value, then the TextField will be rendered in error state.Signature: function(error: TError, value: TValue) => voiderror: The new error describing why the current value is not valid. value: The value associated to the error. | |
| onViewChange | func | Callback fired on view change. Signature: function(view: View) => voidview: The new view. | |
| openTo | 'hours' | 'minutes' | 'seconds' | First view to show. | |
| orientation | 'landscape' | 'portrait' | Force rendering in particular orientation. | |
| shouldDisableTime | func | Disable specific time. Signature: function(timeValue: number, view: TimeView) => booleantimeValue: The value to check. view: The clock type of the timeValue. returns (boolean): If true the time will be disabled. | |
| showToolbar | bool | `true` for mobile, `false` for desktop | If true, the toolbar will be visible. |
| sx | Array<func | object | bool> | func | object | The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details. | |
| value | any | The selected value. Used when the component is controlled. | |
| views | Array<'hours' | 'minutes' | 'seconds'> | Array of views to show. |
Slots
| Name | Type | Default | Description |
|---|---|---|---|
| ActionBar | elementType | PickersActionBar | Custom component for the action bar, it is placed bellow the picker views. |
| LeftArrowIcon | elementType | ArrowLeft | Icon displayed in the left view switch button. |
| NextIconButton | elementType | IconButton | Button allowing to switch to the right view. |
| PaperContent | elementType | React.Fragment | Custom component wrapping the views of the desktop and static pickers (it is the direct child of the Paper component). |
| PreviousIconButton | elementType | IconButton | Button allowing to switch to the left view. |
| RightArrowIcon | elementType | ArrowRight | Icon displayed in the right view switch button. |
| Toolbar | elementType | TimePickerToolbar | Custom component for the toolbar rendered above the views. |
ref is forwarded to the root element.