MujicaUI

Calendar · #429

CurrentTimeIndicator 浅色主题渲染快照
浅色 · 渲染快照
CurrentTimeIndicator 深色主题渲染快照
深色 · 渲染快照

429 CurrentTimeIndicator · 当前时间线

用途

填满父元素,按当前时间在当天中的比例画一条横线,用于时间网格。

最小示例

view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	ui.Box(c).Size(200, 240).Children(func() {
		datetime.CurrentTimeIndicator(c, datetime.CurrentTimeIndicatorOptions{Location: time.Local})
	})
}
ui.Render(view, 400, 300, 1)

参数

func CurrentTimeIndicator(c *ui.Context, opts CurrentTimeIndicatorOptions) *ui.Element

字段类型默认值含义
Location*time.Location必填切分日期与显示时间所用的时区;为 nil 时 panic,不做隐式 UTC 转换。
DayDate零值(今天)父元素自上而下代表的日期;不是今天时不显示。
Nowtime.Time零值(系统时钟)当前时间;固定后不再定时刷新,便于测试。
Hour12boolfalse12 小时制显示时间。

状态

显示(Danger 色线与菱形)、不在当天时隐藏。

事件

无事件;读屏通过标签读出当前时间。

键盘操作

  • 不可聚焦。

限制

  • 仅在被构建(可见)时用 c.After 预约下一分钟的重绘;隐藏后不再预约,自动停止。