跳至主要内容
版本:5.1

数字表单字段

**数字**表单字段类型提供了一个带有箭头的HTML5文本框。如果字段保存了值,则在页面首次加载时将显示此值。如果没有,则使用默认值(如果有)。

  • **type**(必填)必须为number
  • **name**(必填)是字段的唯一名称。
  • **label**(必填)(可翻译)是字段的HTML标签。
  • **description**(可选)(可翻译)是字段描述
  • **default**(可选)(可翻译)是默认值。
  • **class**(可选)是HTML表单字段的CSS类名。如果省略,则默认为'text_area'。
  • **min**(可选)此值是可以选择的最低值。
  • **max**(可选)此值是可以选择的最高值。
  • **step**(可选)如果用户点击向上/向下箭头,当前值将按此属性更改(此属性值将加到或减去当前字段值)。
  • **filter**(可选)提交后要在此字段值上使用的过滤器。
  • **hint**(可选)要在此字段上设置的占位符。
  • **disabled**(可选)此字段是否应禁用?
  • **readonly**(可选)此字段是否应为只读?
  • **required**(可选)此字段是否必填?
  • **autocomplete**(可选)此字段是否应使用自动完成功能?
  • **autofocus**(可选)页面首次加载时此字段是否应获得焦点?
  • **size**(可选)字符的最大字段宽度。

由以下文件实现:libraries/src/Form/Field/NumberField.php

XML参数定义示例

这将创建一个数字框,允许用户在0到10之间选择值,并带有向上/向下字段按钮,允许值以1为步长更改。

<field
name="mynumbervalue"
type="number"
default="0"
label="Choose an number"
description=""
min="0"
max="10"
step="1"
/>

另请参阅