This widget renders a file picker allowing to choose one or more files from the file system.
The file tree widget in the contao download element:
The file tree with gallery option enabled (as in the contao gallery element):
This table only shows the options relevant to the core functionality of this widget. See the DCA reference for a full field reference.
Key | Value | Description |
---|---|---|
inputType |
fileTree (string) |
|
eval.extensions |
string |
Limits the file tree to certain file types (comma separated list). |
eval.fieldType |
checkbox /radio (string) |
checkbox allow multiple selections radio allow a single selection only |
eval.files |
bool |
If true files and folders will be shown. If false, only folders will be shown. |
eval.filesOnly |
bool |
Removes the radio buttons or checkboxes next to folders. |
eval.isGallery |
bool |
Displays selected files of a fileTree widget as an image gallery. |
eval.isSortable |
bool |
This feature is available in Contao 4.10 and later. |
eval.multiple |
bool |
Make the input field multiple. |
eval.orderField |
string |
Using “orderField” for the page tree has been deprecated and will no longer work in Contao 5.0. Use “isSortable” instead. |
eval.path |
string |
Custom root directory for file trees. |
A single image file picker.
// ...
'singleSRC' => [
'exclude' => true,
'inputType' => 'fileTree',
'eval' => [
'filesOnly' => true,
'fieldType' => 'radio',
'extensions' => 'jpg,png,gif',
],
'sql' => "binary(16) NULL"
],
// ...
An image gallery picker, allows picking multiple images, display them in the back end as gallery and be able to sort them.
// ...
'multiSRC' => [
'exclude' => true,
'inputType' => 'fileTree',
'eval' => [
'fieldType' => 'checkbox',
'files' => true,
'isGallery' => true,
'multiple' => true,
'orderField' => 'orderSRC',
],
'sql' => "blob NULL",
],
// ...
A folder picker.
// ...
'folders' => [
'inputType' => 'fileTree',
'eval' => [
'files' => false,
'fieldType' => 'checkbox',
'multiple' => true,
],
'sql' => "blob NULL",
],
// ...
The file tree widget is used very often in contao. Examples are the text, download, image and gallery elements.