Commit 1fb7a2a8 authored by Carsten  Rose's avatar Carsten Rose
Browse files

Iindex.rst: update 'file-upload' doc.

parent 2be7d97c
......@@ -1187,21 +1187,22 @@ Type: upload
* See: https://www.w3.org/TR/html5/forms.html#file-upload-state-(type=file)
* parameter:accept: *image/*,video/*,audio/*,.doc,.docx,.pdf,<mime type>*
An upload element is based on a file browse button and a delete button. Only one of them is shown at a time.
The file browse button is displayed, if there is no file uploaded already.
The trash button is displayed, if there is file uploaded already.
An upload element is based on a 'file browse'-button and a 'trash'-button (=delete). Only one of them is shown at a time.
The 'file browse'-button is displayed, if there is no file uploaded already.
The 'trash'-button is displayed, if there is a file uploaded already.
The user can than select a file from the local filesystem.
After choosing the file, the upload starts immediately, shown by a turning wheel. When the server received the whole file
and accepts the file, the browse button dissappears and the filename is shown, followed by a delete button.
and accepts the file, the 'file browse'-button dissappears and the filename is shown, followed by a 'trash'-button.
Either the user is satisfied now or the user can delete the uploaded file (and maybe upload another one).
Until this point, the file is cached on the server but not copied to the final destination. The user have to save the
current record, either to finalize the upload or to delete a previous uploaded file.
* *FormElement*. *parameter*:
* *fileDestination*: Destination where to copy the file. A good practice is to specify a relative `fileDestination` - such an
installation (filesystem and database) are moveable.
* *fileDestination*: Destination where to copy the file. A good practice is to specify a relative `fileDestination` -
such an installation (filesystem and database) are moveable.
* If `fileDestination` should contain the original filename, the variable *{{_filename}}* can be used. Example ::
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment