autoFocusbool-如果 true,则在首次挂载期间主元素获得焦点。此主元素是: - 如果有任何可见视图选择的元素(即:`day` 视图上选定的日期)。 - 如果渲染了字段,则为 `input` 元素。
closeOnSelectbool`true` 用于桌面,`false` 用于移动设备(基于所选的 wrapper 和 `desktopModeMediaQuery` prop)。如果 true,则在提交完整日期后,弹出框或模态框将关闭。
dayOfWeekFormatterfunc(date: TDate) => adapter.format(date, 'weekdayShort').charAt(0).toUpperCase()格式化日历标题中显示的星期几。
签名:function(date: TDate) => stringdate 适配器提供的星期几的日期。返回值: 要显示的名称。
defaultValueobject-默认值。当组件不受控制时使用。
desktopModeMediaQuerystring'@media (pointer: fine)'CSS 媒体查询,当 `Mobile` 模式将更改为 `Desktop` 时。
disabledboolfalse如果 true,则禁用选择器和文本字段。
disableFutureboolfalse如果 true,则禁用日期组件的当前日期之后的值,时间组件的时间以及日期时间组件的两者。
disableHighlightTodayboolfalse如果 true,则今天的日期在渲染时不会以圆圈突出显示。
disableOpenPickerboolfalse如果 true,则不会渲染打开选择器的按钮(仅渲染字段)。
disablePastboolfalse如果 true,则禁用日期组件的当前日期之前的值,时间组件的时间以及日期时间组件的两者。
displayWeekNumberbool-如果 true,则将在日历中显示周数。
fixedWeekNumbernumber-日期视图将显示当前月份结束后所需的周数,以匹配此值。设置为 6 以在公历中具有固定周数
formatstring-在 input(s) 中渲染时的日期格式。默认为基于所用 `views` 的本地化格式。
formatDensity'dense'| 'spacious'"dense"输入中渲染的格式密度。将 `formatDensity` 设置为 `\"spacious\"` 将在每个 `/`、`-` 和 `.` 字符前后添加一个空格。
inputRefref-传递 `input` 元素的 ref。
labelnode-标签内容。
loadingboolfalse如果 true,则调用 `renderLoading` 而不是渲染日期日历。可用于预加载信息并在日历中显示。
localeTextobject-组件文本的语言环境。允许覆盖来自 `LocalizationProvider` 和 `theme` 的文本。
maxDateobject2099-12-31最大可选择日期。
minDateobject1900-01-01最小可选择日期。
monthsPerRow3| 43每行渲染的月份数。
namestring-Name 属性,由 Field 中的 `input` 元素使用。
onAcceptfunc-当值被接受时触发的回调。
签名:function(value: TValue, context: FieldChangeHandlerContext) => voidvalue 刚刚被接受的值。context 包含当前值的验证结果的上下文。onChangefunc-当值更改时触发的回调。
签名:function(value: TValue, context: FieldChangeHandlerContext) => voidvalue 新值。context 包含当前值的验证结果的上下文。onClosefunc-当弹出窗口请求关闭时触发的回调。在受控模式下使用(请参阅 `open`)。
onErrorfunc-当与当前值关联的错误更改时触发的回调。当检测到验证错误时,`error` 参数包含非空值。这可用于渲染适当的表单错误。
签名:function(error: TError, value: TValue) => voiderror 当前值无效的原因。value 与错误关联的值。onMonthChangefunc-在月份更改时触发的回调。
签名:function(month: TDate) => voidmonth 新月份。onOpenfunc-当弹出窗口请求打开时触发的回调。在受控模式下使用(请参阅 `open`)。
onSelectedSectionsChangefunc-当选定部分更改时触发的回调。
签名:function(newValue: FieldSelectedSections) => voidnewValue 新的选定部分。onViewChangefunc-在视图更改时触发的回调。
签名:function(view: TView) => voidview 新视图。onYearChangefunc-在年份更改时触发的回调。
签名:function(year: TDate) => voidyear 新年份。openboolfalse控制弹出框或对话框的打开状态。
openTo'day'| 'month'| 'year'-默认可见视图。当组件视图不受控制时使用。必须是 `views` 列表中有效的选项。
orientation'landscape'| 'portrait'-强制以特定方向渲染。
reduceAnimationsbool`@media(prefers-reduced-motion: reduce)` || `navigator.userAgent` 匹配 Android <10 或 iOS <13如果 true,则禁用繁重的动画。
referenceDateobject使用验证 props 的最接近的有效日期时间,除了像 `shouldDisable<...>` 这样的回调。当 `value` 和 `defaultValue` 都为空时,用于生成新值的日期。
renderLoadingfunc() => ...当传递 loading true 时显示的组件。
签名:function() => React.ReactNode返回值: 加载时要渲染的节点。
selectedSections'all'| 'day'| 'empty'| 'hours'| 'meridiem'| 'minutes'| 'month'| 'seconds'| 'weekDay'| 'year'| number-当前选定的部分。此 prop 接受四种格式:1. 如果提供数字,则将选择此索引处的部分。2. 如果提供 `FieldSectionType` 类型的字符串,则将选择第一个具有该名称的部分。3. 如果提供 `\"all\"`,则将选择所有部分。4. 如果提供 `null`,则不会选择任何部分。如果未提供,则选定的部分将在内部处理。
shouldDisableDatefunc-禁用特定日期。警告:此函数可以被多次调用(例如,在渲染日期日历、检查焦点是否可以移动到某个日期等时)。昂贵的计算会影响性能。
签名:function(day: TDate) => booleanday 要测试的日期。返回值: 如果 true,则将禁用该日期。
shouldDisableMonthfunc-禁用特定月份。
签名:function(month: TDate) => booleanmonth 要测试的月份。返回值: 如果 true,则将禁用该月份。
shouldDisableYearfunc-禁用特定年份。
签名:function(year: TDate) => booleanyear 要测试的年份。返回值: 如果 true,则将禁用该年份。
showDaysOutsideCurrentMonthboolfalse如果 true,则渲染当前月份之外的日期- 如果定义了 fixedWeekNumber,则渲染日期以具有请求的周数。- 如果未定义 fixedWeekNumber,则渲染日期以填充当前月份的第一周和最后一周。- 如果 `calendars` 在范围选择器上等于多个 `1`,则忽略。
slotPropsobject{}用于每个组件 slot 的 props。
slotsobject{}可覆盖的组件 slots。
有关更多详细信息,请参阅下面的 Slots API。
sxArray
有关更多详细信息,请参阅 `sx` 页面。
timezonestring`value` 或 `defaultValue` prop 的时区已定义,否则为 'default'。选择用于值的时区。示例:“default”、“system”、“UTC”、“America/New_York”。如果您将来自其他时区的值传递给某些 props,它们将在使用前转换为此时区。
有关更多详细信息,请参阅 时区文档。
valueobject-选定的值。当组件受控时使用。
view'day'| 'month'| 'year'-可见视图。当组件视图受控时使用。必须是 `views` 列表中有效的选项。
viewRenderers{ day?: func, month?: func, year?: func }-为每个部分定义自定义视图渲染器。如果 `null`,则该部分将仅具有字段编辑。如果 `undefined`,将使用内部定义的视图。
viewsArray<'day'| 'month'| 'year'>-可用视图。
yearsOrder'asc'| 'desc''asc'默认情况下,年份按升序(时间顺序)显示。如果为 `desc`,则年份按降序显示。
yearsPerRow3| 4桌面端为 4,移动端为 3每行渲染的年份数。