SxTimeRangePicker (时间范围选择)
用于选择时间范围的输入组件。对齐 NextUI 扩展 规范,并说明当前实现状态。
使用场景
约束说明
StartTime / EndTime 使用 DateTime? 表示时间点。
Disabled 为 true 时不响应输入。
行为说明
- 起止时间变化分别触发
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)