Imagelist formulierveld type
From Joomla! Documentation
Het imagelist formulierveld type biedt een drop-down lijst mey afbeeldingsbestanden in een bepaalde map. Alleen bestanden met .png, .gif, .jpg, .bmp, .ico extensies worden getoond. Indien het veld een opgeslagen waarde heeft, wordt dit geselecteerd als de pagina voor het eerst wordt geladen. Indien niet, dan wordt de standaard waarde (als die er is) geselecteerd.
Standaard is het eerste item in de lijst '- Niet gebruiken -' (wat vertaalbaar is) en krijgt de waarde '-1' en dit wordt gevolgd door '- Gebruik standaard -' (ook vertaalbaar) dat de waarde '0' krijgt.
- type (verplicht) moet imagelist zijn.
- name (verplicht) is de unieke naam van het veld.
- label (verplicht) (vertaalbaar) is de beschrijvende titel van het veld.
- directory (optioneel) is het filesysteem-pad naar de map die de afbeeldingsbestanden bevat die getoond moeten worden. Indien weggelaten wordt de map opgegeven door JPATH_ROOT aangenomen.
- default (optioneel) is de standaard afbeeldingsbestandsnaam.
- description (optioneel) (vertaalbaar) is tekst die getoond wordt als tooltip als de gebruiker de muis beweegt over de drop-down box.
- filter (optioneel) is een reguliere expressie string welke gebruikt wordt om de lijst met afbeeldingsbestanden geselecteerd om op te nemen, te filteren. Indien niet opgenomen worden alle afbeeldingsbestanden in de map opgenomen. Het 'filter' argument wordt toegepast voor de 'exclude' expressie. Zie voor informatie over het maken van reguliere expressies Reguliere expressies in parameter argumenten.
- exclude (optioneel) is een reguliere expressie string die gebruikt wordt om afbeeldingsbestanden uit te sluiten van de lijst. De 'exclude' argument expressie wordt toegepast na de 'filter' expressie. Zie, voor informatie over het maken van reguliere expressies Reguliere expressies in parameter argumenten.
- stripext (optioneel) is een Boolean argument. indien waar ('true') wordt de extensie van de bestandsnaam verwijderd van de afbeeldingsbestanden. Merk ook op dat de bestandsnaam ook opgeslagen wordt zonder de extensie.
- hide_none (optioneel) is een boolean argument. Indien waar, wordt het '- Do not use -' item weggelaten uit de drop-down lijst.
- hide_default (optioneel) is een boolean argument. Indien waar wordt het '- Use default -' item weggelaten uit de drop-down lijst.
Voorbeeld XML-velddefinitie:
<field name="myimage" type="imagelist" default="" label="Select an image" description="" directory="" exclude="" stripext="" />