List formulierveld type

From Joomla! Documentation

This page is a translated version of the page List form field type and the translation is 78% complete.

Other languages:
English • ‎español • ‎français • ‎Nederlands

Het list formulierveld type biedt een drop-down lijst met zelf gedefinieerde items. Indien het veld een opgeslagen waarde heeft, wordt deze geselecteerd als de pagina voor het eerst geladen wordt. Indien niet, wordt de standaard waarde (als die er is) geselecteerd.

Params.list.jpg
  • type (verplicht) moet list zijn.
  • name (verplicht) is de unieke naam van het veld.
  • label (verplicht) (vertaalbaar) is de beschrijvende titel van het veld.
  • default (optioneel) is de standaard item-lijst waarde.
  • description (optioneel) (vertaalbaar) is tekst die getoond wordt als tooltip als de gebruiker de muis beweegt over de drop-down box.
  • class (optioneel) is een CSS class naam voor het HTML formulierveld. Indien weggelaten wordt de standaard 'inputbox'.
  • multiple (optioneel) is of meerdere items kunnen worden geselecteerd op hetzelfde moment (true of false).
  • required (optioneel) Als deze op "true" staat ingesteld zal de eerste field optie leeg zijn, zie laatste voorbeeld.
  • useglobal (optioneel)Als deze op "true" staat ingesteld zal het de waarde die bij de algemene instellingen staat tonen, indien in de database gevonden.

Het XML <field> element moet een of meer <option> elementen bevatten die de items in de lijst definiëren. De tekst tussen de <option> en </option> tags is wat getoond wordt in de drop-down lijst en is een te vertalen string. De <option> tag heeft het volgende argument:

  • value (verplicht) is de waarde die opgeslagen worden voor het veld als dit item geselecteerd is.
  • requires (optioneel) Waarden: multilanguage, associations en adminlanguage kan gebruikt worden.

Tip: Vergeet niet de velddefinitie af te sluiten met de </field>.
Tip: Voeg eerst een optie zonder waarde toe, met een tekst zoals "Selecteer een optie". Anders wordt, in het geval van een verplicht veld, de eerste optie met een waarde stilletjes geselecteerd (dus zonder dat de gebruiker die gekozen heeft). Deze tekst wordt wordt meestal gelezen door de gebruikers voordat ze op de drop-down lijst klikken.

Tip: Sommige waarden voor het "name" veld zijn gereserveerd, gebruik ze dan ook niet om problemen te voorkomen. Eén daarvan is: "style".

Voorbeeld XML-velddefinitie:

<field name="mylistvalue" type="list" default="" label="Select an option" description="">
  <option value="0">Option 1</option>
  <option value="1">Option 2</option>
</field>

Voorbeeld XML field definitie met verplichte veldwaarde:

<field name="mylistvalue" type="list" default="" required="true" label="Select an option" description="">
  <option value="">Please Select</option>
  <option value="0">Option 1</option>
  <option value="1">Option 2</option>
</field>

Showon attribute for list options

Since Joomla 3.9.0 one can use the showon attribute for option tags in a list field.

Example XML for two list fields fielda and fieldb where the displayed options of fieldb are controlled by selections in fielda

<field
    name="fielda"
    type="list"
    label="FIELDA_LABEL"
    description="FIELDA_DESC"
    >
    <option value="editor">TYPE_EDITOR</option>
    <option value="text">TYPE_TEXT</option>
    <option value="textarea">TYPE_TEXTAREA</option>
</field>

<field
    name="fieldb"
    type="list"
    label="FIELDB_LABEL"
    description="FIELDB_DESC"
    >
    <option value="0">JNO</option>
    <option value="1">Option 1</option>
    <option
	    showon="fielda:text,textarea"
	    value="2">Option 2</option>
    <option
	    showon="fielda:text"
	    value="3">Option 3</option>
</field>
  • "Option 3" of fieldb is only displayed if option "TYPE_TEXT" is selected in fielda.
  • "Option 2" of fieldb is only displayed if option "TYPE_TEXT" OR "TYPE_TEXTAREA" is selected in fielda.
  • "Option 1" and "JNO" of fieldb is always displayed.

Zie ook