Blazor时间选择器概述
的Blazor时间选择组件允许用户从下拉列表中选择一个时间,或者将其键入日期输入只接受DateTime值。您可以控制输入和响应中显示的格式事件。
Time Picker组件支持DateTime
,DateTime吗?
,DateTimeOffset
和DateTimeOffset吗?
类型。
TimePicker组件是《Blazor》的teleerik UI,一个专业级的UI库,有100个本地组件,用于构建现代和功能丰富的应用程序。要想尝试一下,注册一个30天的免费试用。
创建Blazor时间选择器
- 添加
TelerikTimePicker
标签到你的剃刀页面。 - 绑定一个
DateTime
对象到组件 - 可选地,提供自定义
格式
,最小值
和马克斯
值
基本时间选择与自定义格式,最小和最大
.ToLongTimeString()
@code {private DateTime?selecttime = DateTime.Now;//只使用时间部分public DateTime Min = new DateTime(1900, 1,1,8,15,0);public DateTime Max = new DateTime(1900, 1,1,19,30,45);}
增量的步骤
Time Picker允许最终用户通过单击呈现的箭头来更改所选值。控件设置自增和自减步骤TimePickerSteps
标记及其参数。阅读更多关于Blazor时间选择器增量步骤…
事件
Blazor Time Picker生成事件,您可以处理这些事件并进一步自定义其行为。阅读更多关于Blazor时间选择事件…。
验证
您可以通过使用内置验证来确保组件值是可接受的。阅读更多关于输入验证的信息…。
操作按钮
使用下拉菜单编辑日期时,必须点击“设置”按钮提交日期。点击“取消”,或在下拉框外未点击“设置”,时间将恢复为原始值。您也可以通过点击“NOW”按钮来提交日期,该按钮将选择当前时间。
格式
参数中的时间格式指定符格式
在下拉菜单中控制可用的玻璃杯。例如,HH
指定符将产生一个24小时格式的小时选择器。如果你还加上tt
指定,你也会得到上午/下午的不倒翁,但24小时格式仍将被使用。这意味着如果格式字符串重复它们,您还可以为相同的时间部分添加多个tumbler。
最小和最大
的最小值
和马克斯
属性需要DateTime
对象,但只使用它的时间部分。因此,日期本身并不重要。小时,分钟,秒和AM/PM部分控制的范围在时间选择器下拉。它们不会对输入编辑施加验证/限制。
自适应呈现
该组件根据屏幕大小支持不同的弹出窗口呈现。阅读更多关于自适应渲染功能以及如何启用它…
时间选择器参数
Blazor Time Picker组件提供了各种参数,允许您配置该组件。也可以查看TimePicker的公共API。
属性 | 类型和默认值 | 描述 |
---|---|---|
AdaptiveMode |
AdaptiveMode ( 没有一个 ) |
的自适应模式分量的。 |
自动完成 |
字符串 ( “关闭” ) |
的自动完成 的HTML属性。输入 。 |
DebounceDelay |
int ( 150 ) |
最后键入的符号与值更新之间的时间(以毫秒为单位)。使用它来平衡客户端性能和数据库查询的数量。 |
启用 |
保龄球 |
指定是否允许输入并打开下拉菜单。 |
格式 |
字符串 |
指定时间选择器的DateInput格式。阅读更多支持的格式篇文章。请注意,非时间部分的格式说明符只能在输入中编辑,而不会在时间选择器下拉菜单中显示。 |
Id |
字符串 |
呈现为id 属性上的<输入/ > 元素,所以你可以附加a<标签= " " > 到输入。 |
马克斯 |
DateTime |
用户可选择的最晚时间。 |
最小值 |
DateTime |
用户可选择的最早时间。 |
占位符 |
字符串 |
映射到占位符 属性。如果组件绑定到,则会显示占位符可以为空DateTime对象DateTime吗? ,但如果组件绑定到不可空的DateTime对象的默认值,则不会呈现。当输入没有聚焦时,将显示占位符值。一旦用户聚焦它开始键入,格式占位符(默认或定制一个)将覆盖占位符,以指示输入日期的格式。 |
TabIndex |
int ? |
映射到tabindex 属性。您可以使用它来自定义表单中的输入聚焦的顺序选项卡 关键。 |
ValidateOn |
ValidationEvent 枚举( 输入 ) |
配置将触发验证的事件(如果启用了验证)。阅读更多简单输入的验证模式。 |
价值 |
DateTime 或DateTime吗? |
组件的当前值。支持双向绑定。 |
造型与外观
以下参数使您能够自定义Blazor时间选择器的外观:
属性 | 类型和默认值 | 描述 |
---|---|---|
类 |
字符串 |
呈现在包装元素上的自定义CSS类。 |
PopupClass |
字符串 |
额外的CSS类来自定义时间选择器下拉菜单的外观。 |
宽度 |
字符串 |
定义时间选择器的宽度。 |
控件中可以找到自定义时间选择器样式的更多选项外观的文章。
格式占位符
的FormatPlaceholder
参数允许您将自定义字符串设置为每个DateTime段的占位符,并可用于以下Blazor组件的Telerik UI:
- DateInput
- DatePicker
- DateTimePicker
- DateRangePicker
- TimePicker
要设置FormatPlaceholder
,使用< *组件* FormatPlaceholder >
嵌套的标签。它允许您使用以下参数设置格式占位符:
一天
月
一年
小时
一分钟
第二个
工作日
缺省情况下,所有参数的取值为零
,它应用完整的格式说明符。
时间选择器引用和方法
添加对组件实例的引用以使用时间选择器的方法。
方法 | 描述 |
---|---|
关闭 |
关闭日历弹出窗口。 |
FocusAsync |
聚焦时间选择器文本框。总是等待 这呼唤,正如它所依赖的JSInterop 。 |
开放 |
打开日历弹出窗口。 |
打开Popup @code{//日期时间选择器是一个通用组件,它的类型来自于值字段类型私有TelerikTimePicker< datetime > TimePickerRef {get;设置;} private DateTime TimePickerValue = DateTime. now;private void OpenPopup() {TimePickerRef.Open();}}