Blazor数字文本框概述
的Blazor数值文本框组件允许用户输入十进制值而不输入文本。开发人员可以控制最小值、最大值、步骤和UX的其他元素。
的NumericTextBox组件Blazor的Telerik UI,一个专业级的UI库,包含100个本地组件,用于构建现代和功能丰富的应用程序。想要试用它,可以注册一个30天的免费试用期。
创建Blazor数值文本框
- 添加
TelerikNumericTextBox
标签到你的剃须刀页。 - 将数值数据类型绑定到组件
- 可选地,设置custom
格式
,最小值
,马克斯
而且一步
值
新的值是:@theValue @code {private decimal theValue {get;设置;} = 1.234米;}
Numeric TextBox组件是泛型的,这意味着它接受其value形参的类型作为参数。它可以int
,长
,浮动
,双
而且小数
值。的值最小值
,马克斯
而且一步
属性的类型必须与价值
,以及ValueChanged
处理程序还必须容纳相应的值类型。
事件
Blazor数值文本框生成事件,您可以处理并进一步自定义其行为。阅读更多关于Blazor数字文本框事件….
验证
通过使用内置验证,可以确保组件值是可接受的。阅读更多关于输入验证的信息….
自定义格式字符串
Blazor数字文本框允许您定义所需的自定义格式格式
参数。下面是一些使用自定义格式字符串的示例。
@Weight
@code{decimal Weight {get;设置;} = 3.456789m;} @Rent
@code{decimal Rent {get;设置;} = 4567.89m;字符串RentFormat{获取;设置;} = System.Globalization.NumberFormatInfo.CurrentInfo.CurrencySymbol + "#。00年”; } @Units
@code{ int Units { get; set; } = 12; string UnitsFormat { get; set; } = "# unit(s)"; }
数值文本框参数
属性 | 类型及默认值 | 描述 |
---|---|---|
箭头 |
保龄球 ( 真正的 ) |
控制向上/向下旋转箭头(按钮)的显示。 |
自动完成 |
字符串 |
的自动完成 属性在<输入/ > 元素。 |
DebounceDelay |
int ( 150 ) |
从最后输入符号到值更新之间的时间(以毫秒为单位)。使用它来平衡客户端性能和数据库查询数量。 |
小数 |
int |
输入过程中允许的小数点后位数。仅当输入被聚焦时生效。默认值取决于区域性。 |
格式 |
字符串 |
输入未聚焦时的数字格式。欲知详情,请浏览.NET中的标准数字格式字符串 |
Id |
字符串 |
的id 属性上的<输入/ > 元素。 |
InputMode |
字符串 |
的inputmode 属性在<输入/ > 元素。 |
马克斯 |
数值类型 | 输入可以接受的最大值。必须匹配价值 类型。 |
最小值 |
数值类型 | 输入可以接受的最小值。必须匹配价值 类型。 |
占位符 |
字符串 |
的占位符 HTML元素的属性。如果组件绑定到可以为空值类型,没有值集。 |
一步 |
数值类型 | 使用箭头时,该值更改的十进制值。必须匹配价值 类型。 |
价值 |
数值类型 | 组件值。 |
TabIndex |
int ? |
的tabindex 属性。<输入/ > 元素。使用它来自定义页面上的标签顺序。 |
ValidateOn |
ValidationEvent 枚举( 输入 ) |
触发验证的事件(如果启用了验证)。欲知详情,请浏览简单输入的验证模式. |
造型和外观
以下参数使您能够自定义Blazor数值文本框的外观:
属性 | 类型及默认值 | 描述 |
---|---|---|
类 |
字符串 |
对象上呈现的CSS类< span class = " k-numerictextbox”> 元素。 |
宽度 |
字符串 |
组件的宽度任何支持的CSS单元. |
控件中有关自定义数字文本框样式的更多选项外观的文章.
组件引用
数字文本框有一个FocusAsync
启用编程焦点的方法。要使用它,请获取组件实例的引用。
焦点TextBox @code{//确定组件的私有十进制DecimalValue {get;设置;} // Value类型决定了引用私有TelerikNumericTextBox的类型 NumericTextBoxRef {get;设置;} async任务FocusTextBox(){等待NumericTextBoxRef.FocusAsync();}}
笔记
如果你想使用货币格式,你必须为你的应用程序线程指定区域性,这样。net就知道要呈现什么符号。如果不这样做,您可能会看到一个意外/不正确的符号或格式。Telerik Numeric文本框将线程区域性用于货币符号和小数分隔符(详细信息Telerik组件中的全球化).
中可用的小数点位置可能要匹配
格式
在小数
参数。这将统一输入集中和不集中时的数字舍入。例如,如果从一个值开始12.3米
而且一步= 0.1米
它会呈现为12.3
由于Math.Round ()
. net中的行为。用旋转器图标向上和向下更改值将导致12.30
因为该值在某一时刻有第二个十进制数字,并且该精度已经添加到该数字上。下面是一个匹配小数点后数位的例子:
剃须刀
@DecimalStepValue. tostring ("N2")