Joomla text Form Field Type

The text form field type provides a text box for data entry. If the field has a value saved, this value is displayed when the page is first loaded. If not, the default value (if any) is selected.

XML Field Definitions

<field name="mytextvalue"
type="text"
default="Some text"
label="Enter some text"
description=""
size="10" />

Use the integer filter to ensure that letters types get stripped when the form is processed.

<field name="myintvalue"
type="text"
default=""
label="Enter some text"
description="Enter some description"
filter="integer" />

Use the raw filter to ensure that html code is preserved when the form is processed.

<field name="myhtmlvalue"
type="text"
default=""
label="Enter some text"
description="Enter some description"
filter="raw" />

Mandatory Parameters

  • type must be text.
  • name is the unique name of the field.
  • label (translatable) is the descriptive title of the field.

Optional Parameters

  • size is the width of the text box in characters.
  • maxlength limits the number of characters that may be entered.
  • default (not translatable) is the default value.
  • description (translatable) is text that will be shown as a tooltip when the user moves the mouse over the drop-down box.
  • class - CSS class name for the HTML form field.
  • readonly - The field cannot be changed and will automatically inherit the default value
  • disabled - The field cannot be changed and will automatically inherit the default value - it will also not submit
  • required - The field must be filled before submitting the form.
  • filter - Allow the system to save certain html tags or raw data.
  • message - The error message that will be displayed instead of the default message.
  • hint - The text displayed in the html placeholder element, usually a lighter coloured hint displayed inside an blank field.

Examples

1. Title Field (com_content)

<field
name="title"
type="text"
label="JGLOBAL_TITLE"
description="JFIELD_TITLE_DESC"
class="input-xxlarge input-large-text"
size="40"
required="true"
/>

2, Alias Field (com_content)

<field
name="alias"
type="text"
label="JFIELD_ALIAS_LABEL"
description="JFIELD_ALIAS_DESC"
hint="JFIELD_ALIAS_PLACEHOLDER"
size="40"
/>

3. Note Field (com_content)

<field
name="note"
type="text"
label="COM_CONTENT_FIELD_NOTE_LABEL"
description="COM_CONTENT_FIELD_NOTE_DESC"
class="span12"
size="40"
maxlength="255"
/>

4. Author (com_content)

<field
name="author"
type="text"
label="JAUTHOR"
description="JFIELD_METADATA_AUTHOR_DESC"
size="20"
/>

 

Star InactiveStar InactiveStar InactiveStar InactiveStar Inactive