Actions

Spacer form field type

From Joomla! Documentation

Revision as of 08:18, 21 May 2011 by Mvangeest (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Params.spacer.jpg

The spacer form field type provides a visual separator between parameter field elements. It is purely a visual aid and no field value is stored.

  • type (mandatory) must be spacer.
  • name (mandatory?) is the unique name of the field.
  • label (optional) (translatable) is the text to use as a spacer.
  • hr (optional) is whether to display a horizontal rule ('true' or 'false').
  • class (optional) is a CSS class name for the HTML form field.

Example XML field definition:

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

You can replace the basic horizontal line with a title which can be used to group parameters. For example,

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

You can also place translatable text into the label attribute:

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

Note that you can also include HTML markup but it must be encoded. For example, to put the text into bold you can use:

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

See also