跳至主要内容
版本:5.1

仪表盘表单字段

**仪表盘**表单字段类型绘制进度条。有关更多详细信息,请参阅Bootstrap 进度条

  • **type**(必填)必须为meter
  • **name**(必填)是字段的唯一名称。
  • **label**(必填)(可翻译)是字段的 HTML 标签。
  • **description**(可选)(可翻译)是字段描述
  • **class**(可选)是 HTML 表单字段的 CSS 类名。
  • **size**(可选)设置字段的输入大小。
  • **default**(可选)进度条的初始值。
  • **min**(可选)进度条的最小值。
  • **max**(可选)进度条的最大值。
  • **step**(可选)进度条上进度变化的步长。
  • **animated**(可选)(默认:true) 设置进度条是否为动画。
  • **active**(可选)(默认:false) 设置进度条动画是否处于活动状态。与 animated 结合使用。

请注意,如果不设置 min 和 max 值,则可能无法按预期工作。这不是输入类型。它只是创建一个进度条。

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

XML 参数定义示例

<field
name="meter"
active="true"
type="meter"
label="Meter"
max="1000"
min="1"
step="10"
default="240"
/>

这将创建以下 HTML 代码

<div class="control-group">
<div class="control-label">
<label id="jform_meter-lbl" for="jform_meter" class="">
Meter
</label>
</div>
<div class="controls">
<div class="progress progress-striped active" data-max="1000" data-min="1" data-step="10" data-value="240">
<div class="bar" style="width: 23.923923923924%;"></div>
</div>
</div>
</div>