跳至主要内容
版本:5.1

范围表单字段

**范围**表单字段类型提供了一个用于数字输入的水平滑块。虽然可以设置默认值,但没有指示所选的实际值,只有滑块滑块的位置。

  • **type**(必填)必须为range
  • **name**(必填)是字段的唯一名称。
  • **label**(可选)(可翻译)是字段的HTML标签。
  • **description**(可选)(可翻译)是字段描述
  • **default**(可选)初始值。
  • **class**(可选)是HTML表单字段的CSS类名。
  • **min**(可选)可以选择的最小的值。
  • **max**(可选)可以选择的最大值。
  • **step**(可选)如果用户点击向上/向下箭头,当前值将更改此属性(此属性值将加到或减去当前字段值)。
  • **required**(可选)是否要求用户在此字段中输入数据?

由以下实现:libraries/src/Form/Field/RangeField.php

XML参数定义示例

这将创建一个初始值为0的滑块,可以从中选择-0.5到0.5之间的值。当滑块向左或向右移动时,滑块的值将更改0.1。

<field
ame="myrange"
type="range"
default="0"
label="Range from -0.5 to 0.5 step 0.1"
description=""
min="-0.5"
max="0.5"
step="0.1"
/>