跳至主要内容
版本:5.1

Spacer表单字段

**间隔**表单字段类型在参数字段元素之间提供视觉分隔符。它纯粹是一个视觉辅助工具,不会存储任何字段值。

  • **type**(必填)必须为spacer
  • **name**(必填)是字段的唯一名称。
  • **label**(必填)是要用作间隔符的文本。
  • **description**(可选)(可翻译)是字段描述
  • **hr**(可选)是否显示水平线('true'或'false')。如果此属性为'true',则将忽略label属性。
  • **class**(可选)是HTML表单字段的CSS类名。

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

XML参数定义示例

<field
type="spacer"
name="myspacer"
hr="true"
/>

您可以用标题替换基本水平线,该标题可用于对参数进行分组。例如

<field
type="spacer"
name="myspacer"
label="Advanced parameters"
/>

您还可以将可翻译文本放入label属性中

<field 
type="spacer"
name="myspacer"
class="text"
label="PLG_TINY_FIELD_NAME_EXTENDED_LABEL"
/>

请注意,您还可以包含HTML标记,但必须对其进行编码。例如,要将文本加粗,您可以使用

<field 
type="spacer"
name="myspacer"
label="&lt;b&gt;Advanced parameters&lt;/b&gt;"
/>

**不能同时使用hr和label属性。**要定义同时具有水平线和标签的间隔符,请在label属性中使用编码的<hr/>

<field 
type="spacer"
name="myspacer"
label="&lt;hr/&gt;More parameters"
/>