Slider 滑动输入条

在线示例

Slider - 滑动输入条 是一个竖直或水平的条。通过鼠标拖拽条上的小控件可以为其设定某个范围内的一个数值。拖拽小控件同时也会显示值的大小。

slider

组件的 XML 名称：slider。

基本用法

滑动条的默认 数据类型 是 double。可以用组件的 datatype 属性设置下列数据类型：

  • int

  • long

  • double

  • decimal

用 dataContainer 和 property 属性可以将 Slider 与 数据容器 绑定。此时，数据类型由 property 指定的实体属性决定。

示例：

<data>
    <instance id="productDc"
              class="ui.ex1.entity.Product"
              fetchPlan="_base"/>
</data>
<layout>
    <slider id="slider"
            dataContainer="productDc"
            property="price"/>
</layout>

属性

Slider 组件有下列特殊属性：

  • max - 数值范围的最大值，默认 100。

  • min - 数值范围的最小值，默认 0。

  • orientation - 竖直还是水平。默认值 horizontal（水平）。

  • resolution - 小数点后数字的位数。默认值 0。

  • updateValueOnClick - 定义是否可以通过点击滑动条设置值。默认值 false。

<slider max="20"
        min="10"
        resolution="2"
        updateValueOnClick="true"
        orientation="vertical"/>

事件和处理器

如需使用 Jmix Studio 生成处理器的桩代码，需要在界面 XML 描述或者 Jmix UI 层级结构面板选中该组件，然后用 Jmix UI 组件面板的 Handlers 标签页生成。

或者可以使用界面控制器顶部面板的 Generate Handler 按钮。

ContextHelpIconClickEvent

参阅 ContextHelpIconClickEvent。

Validator

为组件添加 validator 实例。如果值验证失败，validator 必须抛出 ValidationException 异常。

ValueChangeEvent

参阅 ValueChangeEvent。

XML 属性

可以使用 Studio 界面设计器的 Jmix UI 组件面板查看和编辑组件的属性。

align - box.expandRatio - caption - captionAsHtml - contextHelpText - contextHelpTextHtmlEnabled - css - dataContainer - datatype - description - descriptionAsHtml - editable - enable - expand - height - htmlSanitizerEnabled - icon - id - max - min - orientation - property - required - requiredMessage - resolution - responsive - stylename - updupdateValueOnClick - visible - width