/** * @license *------------------------------------------------------------------------------------------- * Copyright © 2026 Progress Software Corporation. All rights reserved. * Licensed under commercial license. See LICENSE.md in the package root for more information *------------------------------------------------------------------------------------------- */ import { DateInputFormatPlaceholder } from './format-placeholder'; import { DateInputIncrementalSteps } from './incremental-steps'; import { DateFormatOptions } from '@progress/kendo-react-intl'; import * as React from 'react'; /** * @hidden */ export interface DateInputSettings { /** * Specifies the `date` format which is used for formatting the value ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/formats)). If not set, the default format will be used. */ format?: string | DateFormatOptions; /** * Specifies the descriptions of the format sections in the input field ([more information and example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/placeholders)). */ formatPlaceholder?: DateInputFormatPlaceholder; /** * Specifies the width of the DateInput. */ width?: number | string; /** * Sets the `tabIndex` property of the DateInput. * * @remarks * This property is related to accessibility. */ tabIndex?: number; /** * Sets the title of the `input` element of the DateInput. */ title?: string; /** * Specifies the incremental steps of the DateInput ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/incremental-steps)). * * The available options are: * - `year: Number`—Controls the incremental step of the year value. * - `month: Number`—Controls the incremental step of the month value. * - `day: Number`—Controls the incremental step of the day value. * - `hour: Number`—Controls the incremental step of the hour value. * - `minute: Number`—Controls the incremental step of the minute value. * - `second: Number`—Controls the incremental step of the second value. */ steps?: DateInputIncrementalSteps; /** * Specifies the smallest date that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges)). */ min?: Date; /** * Specifies the greatest date that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges)). */ max?: Date; /** * Specifies the smallest time that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges#toc-limiting-the-time-range)). */ minTime?: Date; /** * Specifies the greatest time that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges#toc-limiting-the-time-range)). */ maxTime?: Date; /** * Determines whether the DateInput is disabled ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/disabled-state)). */ disabled?: boolean; /** * Specifies whether the **Up** and **Down** spin buttons will be rendered ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/spin-buttons)). */ spinners?: boolean; /** * Specifies the name property of the input DOM element. */ name?: string; /** * Represents the `dir` HTML attribute. */ dir?: string; /** * Renders a floating label for the DateInput. */ label?: React.ReactNode; /** * Sets the `id` of the `input` DOM element. */ id?: string; /** * Identifies the element(s) which will describe the component, similar to [HTML aria-describedby attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute). * For example these elements could contain error or hint message. * * @remarks * This property is related to accessibility. */ ariaDescribedBy?: string; /** * Identifies the element(s) which will label the component. * * @remarks * This property is related to accessibility. */ ariaLabelledBy?: string; /** * The accessible label of the component. * * @remarks * This property is related to accessibility. */ ariaLabel?: string; /** * Specifies the hint the DateInput displays when its value is `null` or there is no partial selection. * For more information, refer to the article on * [placeholders](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/placeholders). */ placeholder?: string | null; }