integerField 整数字段

基本用法

integerField 组件可用于输入和展示整数值。

integerField 的示例：

<integerField id="integerField"
              clearButtonVisible="true"
              value="27000"/>
integer field basics
integerField 并不会处理数字的格式。如果需要本地化的数值显示格式或使用不同的数据类型，请使用 TypedTextField。

数据绑定

在线示例

数据绑定是指将组件与 数据容器 进行关联。可视化组件或相应数据容器中的更改可以触发彼此的更新。有关详细信息，请参阅 使用数据组件。

下面的示例生成了一个数据感知的 integerField。对应的实体属性类型必须是 Integer。

<data>
    <instance class="com.company.onboarding.entity.Step" id="stepDc"> (1)
        <fetchPlan extends="_base"/> (2)
        <loader id="stepDl"/>
    </instance>
</data>
<layout>
    <integerField dataContainer="stepDc"
                  property="duration"/> (3)
</layout>
1 Step 实体的 InstanceContainer 容器。
2 容器内实体的内联 fetch plan。
3 将组件与数据容器和属性进行关联。dataContainer 属性使用 stepDc 数据容器，property 引用 duration 实体属性。

步长

Vaadin

step（步长）属性用于控制用户使用向上/向下箭头（也称为步长按钮）交互时的增减值。步长决定每次交互时值的变化量。可以用来定义 integerField 的精度级别。

step 属性通常与 min 和 max 属性结合使用，以定义数字的有效范围。

stepButtonsVisible 属性控制是否显示步长按钮。

<integerField step="1"
              stepButtonsVisible="true"
              min="1"
              max="10"
              helperText="Max 10 items"/>
integer field data binding

验证

如需检查 integerField 组件输入的值，可以在内部元素 validators 中添加一个 validator元素。

integerField 可以使用下列预定义的验证器：

XML 元素

validators

预定义验证器

custom - digits - max - min - negativeOrZero - negative - notNull - positiveOrZero - positive

XML 属性

在 Jmix 中，所有组件都有一些作用一致的 通用属性。 下面是 integerField 的特殊属性：

名称

描述

默认值

max

指定允许输入的最大值。大于 max 的值会导致验证失败。

min

指定允许输入的最小值。小于 min 的值会导致验证失败。

step

设置控件的值变化量。设置当点击增加/减少按钮时，数字变化的步长。参阅 步长。

1

stepButtonsVisible

设置步长按钮的可见性。参阅 步长。

false

参考

Vaadin 文档