DateInput

自定义下拉日历,支持日期、日期时间、时间、月份、周;也可直接在框内键入。

最后更新

说明

Mode 取 date / datetime / time / month / week,绑定值为 DateTime?,弹出面板非浏览器原生控件。Editable 打开键入:datetime 模式写 2026-11-04 14:30(可带秒),回车或移开焦点生效,解析失败或越界时保留原值。

常见能力:

  • 自定义日历面板
  • 五种选择模式
  • 可直接键入日期时间
  • 最小/最大限制
  • 清除/今天快捷项

用法

<DateInput @bind-Value="@day" />
<DateInput Mode="datetime" @bind-Value="@day" />
<DateInput Mode="datetime" Editable="true" @bind-Value="@day" />

API 参数

参数 类型 默认值 说明
Editable bool false 是否允许直接在框内键入值(date / datetime / time / month):键入后回车或移开焦点生效, 解析失败或超出 Min/Max 时保留原值并把文字退回。week 无直观键入格式,仍只读。
Icon string "calendar" 左侧图标。
Max DateTime? null 最大值。
Min DateTime? null 最小值。
Mode string "date" 选择模式:date / datetime / time / month / week(不区分大小写与首尾空白)。
Placeholder string "请选择" 占位文字。
Value DateTime? null 绑定值(DateTime?)。
ValueChanged EventCallback<DateTime?> — 事件
Visible bool true 取得或设置组件是否可见,默认为false。
VisibleChanged EventCallback<bool> — 事件 取得或设置组件可见性变化时的回调事件。
Class string null 取得或设置组件的CSS类名,用于自定义样式。
Disabled bool false 取得或设置组件是否禁用,默认为false。
Style string null 取得或设置组件的内联样式,用于自定义样式。

所有组件均继承 BaseComponent,除上表参数外还支持 Class、Style、Disabled、Visible。

微信公众号二维码 扫码关注公众号
QQ 交流群二维码 扫码加入 QQ 群