053 DateRangePicker · 日期范围选择器

用途

在弹层中先选开始日期、再选结束日期，悬停时预览范围，确认后写入。

最小示例

var stay datetime.DateRange
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	r := datetime.DateRangePicker(c, &stay, datetime.DateRangePickerOptions{Label: "Stay"})
	if r.Changed() {
		fmt.Println("stay", stay.Start, stay.End, stay.Days())
	}
}
ui.Render(view, 400, 300, 1)

参数

func DateRangePicker(c *ui.Context, value *DateRange, opts DateRangePickerOptions) DateTimeResult，返回值的 Element 字段是组件元素。

字段	类型	默认值	含义
`Layout`	`string`	`2006-01-02`	触发器与摘要中的日期格式。
`Min`	`Date`	零值	两端最早日期。
`Max`	`Date`	零值	两端最晚日期。
`DisableDate`	`func(Date) bool`	nil	不可选日期；范围内包含此类日期时拒绝并提示。
`WeekStart`	`WeekStart`	`WeekStartLocale`	周起始日。
`Today`	`Date`	零值（系统时钟）	今日标记与空值时的起始月份。
`ReadOnly`	`bool`	false	只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。
`Disabled`	`bool`	false	禁用。
`Label`	`string`	内置“日期范围”	辅助技术名称。

状态

触发器：默认、悬停、聚焦、禁用。弹层：起止日期酒红填充，中间日期浅色带；选择结束前随指针或焦点预览范围；错误说明；“确定”在两端选齐前禁用。

事件

Changed()：点击“确定”或“清空”使值改变时为 true。Canceled()：按 Escape、点击“取消”或点击弹层外关闭、草稿被丢弃时为 true。

键盘操作

Enter/Space/↓：打开弹层。
日历内方向键移动，Enter 依次选择开始与结束。
早于开始日期的选择会重新开始范围。
Tab 到“清空”“取消”“确定”。
Escape：放弃草稿。

限制

弹层一次显示一个月；跨月范围通过翻页完成。
DateRange 为闭区间，Days() 计入两端。
日期与时间值不带时区：Date、YearMonth、TimeOfDay 只保存日历字段，组件内部计算不做 UTC 转换。
Today 为零值时读取 c.Now()（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（expanded）、数值范围（hasRange/accRange）与值（accValue）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 RolePopUpButton 而无法报告展开状态；时间段以 Description 读出当前值与范围，错误通过 Error() 关联。