Groupedlist formulierveld type

From Joomla! Documentation

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

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

Het groupedlist formulierveld type biedt een drop-down lijst of een listbox met zelf gedefinieerde items welke de mogelijkheid heeft om gegroepeerde gegevens te tonen. Indien het veld opgeslagen waarden bevat worden die getoond als de pagina voor het eerst geladen wordt. Indien niet dan wordt de standaard waarde (indien aanwezig) geselecteerd.

  • type (verplicht) moet groupedlist 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).

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.

Tip: Vergeet niet de velddefinitie af te sluiten met de </field>.

Plaats, om de gegevens eenvoudig te groeperen <group> voor de <option> elementen die u wilt groeperen an </group> er na. De <group> tag heeft het volgende argument:

  • label (vertaalbaar) is de tekst die in de lijst wordt getoond.

Voorbeeld XML-velddefinitie:

<field name="mylistvalue" type="groupedlist" default="" label="Select an option" description="">
  <group label="Group 1">
    <option value="0">Option 1</option>
    <option value="1">Option 2</option>
  </group>
  <group label="Group 2">
    <option value="3">Option 3</option>
    <option value="4">Option 4</option>
  </group>
  <option value="5">Option 5</option>
  <option value="6">Option 6</option>
</field>

Zie ook