Joomla! Documentation™

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.

• 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 field definitie:

<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 attribuut voor list opties

Sinds Joomla 3.9.0 kan men het showon attribuut gebruiken voor option tags in een list field.

• Zie Showon documentatie.
• Deze functie is geïntroduceerd via het Pull Request #18998.

Voorbeeld XML voor twee list velden fielda en fieldb waarbij de getoonde opties van fieldb worden bepaald via selecties 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>

• "Optie 3" van fieldb wordt alleen getoond als optie "TYPE_TEXT" geselecteerd is in fielda.
• "Optie 2" van fieldb wordt alleen getoond als optie "TYPE_TEXT" OF "TYPE_TEXTAREA" geselecteerd is in fielda.
• "Optie 1" en "JNO" van fieldb wordt altijd getoond.

Zie ook

• Filelist formulierveld type
• Folderlist formulierveld type
• Imagelist formulierveld type
• Lijst met standaard formulierveld types