InputDate
输入日期并通过日历选择。
实时预览
参数配置
全部字段 52
InputDateOptions
InputDateOptions2
Styles · 0
CalendarOptions
Styles · 0
Go 代码
// Inside a view; c is *ui.Context, t is nui.Theme.
// Keep s (example state) outside the view. See the complete example.
nui.InputDate(c.Key("date"), t, &s.Value, &s.Date, nui.InputDateOptions{InputOptions: nui.InputOptions{Label: "Project name", Placeholder: "Type something…", Color: nui.ColorDefault, Size: nui.SizeDefault, Variant: nui.VariantDefault, Disabled: false, ReadOnly: false, Loading: false}, HideCalendar: false})
nui.InputDateRange(c.Key("range"), t, &s.Range, &s.RangeInput, nui.InputDateOptions{InputOptions: nui.InputOptions{Label: "Date range", Placeholder: "Type something…", Color: nui.ColorDefault, Size: nui.SizeDefault, Variant: nui.VariantDefault, Disabled: false, ReadOnly: false, Loading: false}, HideCalendar: false})使用说明
上方编辑单个日期,下方 InputDateRange 编辑日期区间。可以输入日期或展开日历;两个示例共用外观、禁用、只读和 hideCalendar 快捷参数,值和编辑状态分别持久保存。
API 参考
InputDate
源码func InputDate(c *ui.Context, t Theme, value *Optional[Date], s *DateInputState, o InputDateOptions) ui.ElementInputDateRange
源码func InputDateRange(c *ui.Context, t Theme, value *DateSelection, s *DateRangeInputState, o InputDateOptions) ui.ElementInputDateOptions
源码type InputDateOptions struct {
HideCalendar bool
InputOptions
Calendar CalendarOptions
OnValueChange func(Optional[Date])
}| 字段 | 类型 | 说明 |
|---|---|---|
HideCalendar | boolGo 零值: | 隐藏日期输入的日历入口。 |
Label | stringGo 零值: | 控件标签或可访问名称。 |
Placeholder | stringGo 零值: | 没有输入或选择时的占位文字。 |
ErrorMessage | stringGo 零值: | 显式提供的错误说明。 |
Disabled | boolGo 零值: | 禁用组件及其交互。 |
ReadOnly | boolGo 零值: | 允许读取和选择内容,但禁止编辑。 |
Invalid | boolGo 零值: | 使用无效输入的视觉状态。 |
Password | boolGo 零值: | 遮蔽输入内容。 |
Clearable | boolGo 零值: | 显示清空操作或允许清除当前值。 |
ClearLabel | stringGo 零值: | 清空操作的可访问名称。 |
Color | ColorGo 零值: | 语义颜色;默认值继承主题或组件配色。 |
Variant | VariantGo 零值: | 组件外观样式,支持范围取决于组件。 |
Size | SizeGo 零值: | 组件尺寸;默认值继承主题或组件尺寸。 |
Leading | *ui.SVGGo 零值: | 内容前方的 SVG 图标。 |
Trailing | *ui.SVGGo 零值: | 内容后方的 SVG 图标。 |
Loading | boolGo 零值: | 显示加载状态;是否阻止操作由组件决定。 |
LoadingIcon | *ui.SVGGo 零值: | 覆盖默认加载图标。 |
Highlight | boolGo 零值: | 突出显示控件或选中项目。 |
MaxLength | intGo 零值: | 输入长度上限,原生文本以 UTF-16 单元计数;零表示不限。 |
OnChange | func(string)Go 零值: | 值发生变化时通知应用的回调。 |
OnSubmit | func(string)Go 零值: | 提交表单或输入时通知应用的回调。 |
OnClear | func()Go 零值: | 清空值时通知应用的回调。 |
UI | StylesGo 零值: | 以部件名称为键覆盖外观和间距。 |
Style | func(root, editor, leading, trailing ui.Element)Go 零值: | 同步配置当前构建的部件;不要保留 Element。 |
Calendar | CalendarOptionsGo 零值: | 内嵌日历的配置。 |
OnValueChange | func(Optional[Date])Go 零值: | 解析后的值变化时通知应用的回调。 |