Dateiliste Formularfeldtyp
From Joomla! Documentation
Dieses Feld bietet eine Dropdown Liste von Dateien eines spezifischen Verzeichnisses. Wenn das Feld einen gespeicherten Wert hat, wird dieser Wert beim ersten Laden der Seite angezeigt. Wenn nicht, wird der Standardwerd (falls definiert) gewählt.
Standardmäßig, der erste Listenpunkt ist "nicht benutzen" (übersetzbar) und hat den zugewiesenen Wert "-1". Dieses wird gefolgt von "Standard nutzen" (übersetzbar) dem der Wert "0" zugeordnet ist.
type (notwendig) muss "Dateiliste" sein.
- name (obligatorisch) ist der eindeutige Name des Feldes.
- label (obligatorisch) (übersetzbar) ist der beschreibende Titel des Feldes.
directory (optional) ist der Dateisystempfad zu dem Verzeichnis, das die gelisteten Dateien enthält. Wenn weggelassen wird das Verzeichnis von JPATH_ROOT vorgeschlagen.
- default (optional) ist der Standard-Dateiname
- Beschreibung (optional) (übersetzbar) ist der Text, der als Tooltip als Mouse-over Effekt über die Dropdown-Box angezeigt wird.
- filter (
) or fileFilter (
and later) (optional) is a regular expression string which is used to filter the list of files selected for inclusion in the drop-down list. If omitted, all files in the directory are included. The filter argument expression is applied before the exclude argument expression. For information on constructing regular expressions see Regular expressions in parameter arguments. - exclude (optional) is a regular expression string which is used to exclude files from the list. The exclude argument expression is applied after the filter argument expression. For information on constructing regular expressions see Regular expressions in parameter arguments.
- stripext (optional) is a Boolean argument. If true then file name extensions will be stripped from the file names listed. Also note that the file name will be saved without the extension too.
hide_none (optional) ist ein Boolsches Argument. Wenn "true", wird der nicht ausgewählte Artikel von der Drop-down-Liste gestrichen.
- hide_default (optional) is a Boolean argument. If true, the '- Use default -' item is omitted from the drop-down list.
Beispiel XML-Felddefinitionen:
<field name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" />