SxTimeRangePicker (时间范围选择)

  • Implemented

用于选择时间范围的输入组件。对齐 NextUI 扩展 规范,并说明当前实现状态。

使用场景

  • 营业时间配置
  • 排班时间段
  • 表单时间区间

约束说明

  • StartTime / EndTime 使用 DateTime? 表示时间点。
  • Disabledtrue 时不响应输入。

行为说明

  • 起止时间变化分别触发 StartTimeChanged / EndTimeChanged
  • Label 为可选顶部标签。

API

Parameters

状态 参数名 类型 默认值 描述
Implemented StartTime DateTime? null 起始时间。
Implemented EndTime DateTime? null 结束时间。
Implemented Label string? null 顶部标签文本。
Implemented Disabled bool false 禁用状态。
Implemented Id (继承) string? null 组件的物理 Id。
Implemented Class (继承) string? null 自定义 CSS 类名。
Implemented Style (继承) string? null 自定义样式。
Implemented Title (继承) string? null HTML title 属性。
Implemented AdditionalAttributes (继承) IEnumerable<KeyValuePair<string, object>>? null 捕获不匹配的 HTML 属性。

Events

状态 事件名 类型 描述
Implemented StartTimeChanged EventCallback<DateTime?> 起始时间改变时触发。
Implemented EndTimeChanged EventCallback<DateTime?> 结束时间改变时触发。

示例

<SxTimeRangePicker Label="工作时段"
                   @bind-StartTime="_start"
                   @bind-EndTime="_end" />

参考设计 (References)