Class: FileUpload

Extends

• LuCI.ui.AbstractElement

Methods

inherited getValue(){string|Array.<string>|null}

ui.js, line 2919

Read the current value of the input widget.

Returns:

Type	Description
string | Array.<string> | null	The current value of the input element. For simple inputs like text fields or selects, the return value type will be a - possibly empty - string. Complex widgets such as DynamicList instances may result in an array of strings or null for unset values.

inherited isValid(){boolean}

ui.js, line 107

Check whether the current input value is valid.

Returns:

Type	Description
boolean	Returns true if the current input value is valid or false if it does not meet the validation constraints.

inherited registerEvents(targetNode, synevent, events)

ui.js, line 156

Dispatch a custom (synthetic) event in response to received events.

Sets up event handlers on the given target DOM node for the given event names that dispatch a custom event of the given type to the widget root DOM node.

The primary purpose of this function is to set up a series of custom uniform standard events such as widget-update, validation-success, validation-failure etc. which are triggered by various different widget specific native DOM events.

Name	Type	Description
targetNode	Node	Specifies the DOM node on which the native event listeners should be registered.
synevent	string	The name of the custom event to dispatch to the widget root DOM node.
events	Array.<string>	The native DOM events for which event handlers should be registered.

inherited render(){Node}

ui.js, line 2548

Render the widget, setup event listeners and return resulting markup.

Returns:

Type	Description
Node	Returns a DOM Node or DocumentFragment containing the rendered widget markup.

inherited setChangeEvents(targetNode, events)

ui.js, line 224

Setup listeners for native DOM events that may change the widget value.

Sets up event handlers on the given target DOM node for the given event names which may cause the input value to change completely, such as change events in a select menu. In contrast to update events, such change events will not trigger input value validation but they may cause field dependencies to get re-evaluated and will mark the input widget as dirty.

Name	Type	Description
targetNode	Node	Specifies the DOM node on which the event listeners should be registered.
events	string	repeatable The DOM events for which event handlers should be registered.

inherited setUpdateEvents(targetNode, events)

ui.js, line 181

Setup listeners for native DOM events that may update the widget value.

Sets up event handlers on the given target DOM node for the given event names which may cause the input value to update, such as keyup or onclick events. In contrast to change events, such update events will trigger input value validation.

Name	Type	Description
targetNode	Node	Specifies the DOM node on which the event listeners should be registered.
events	string	repeatable The DOM events for which event handlers should be registered.

inherited setValue(value)

ui.js, line 2924

Set the current value of the input widget.

Name	Type	Description
value	string | Array.<string> | null	The value to set the input element to. For simple inputs like text fields or selects, the value should be a - possibly empty - string. Complex widgets such as DynamicList instances may accept string array or null values.

inherited triggerValidation()

ui.js, line 121

Force validation of the current input value.

Usually input validation is automatically triggered by various DOM events bound to the input widget. In some cases it is required though to manually trigger validation runs, e.g. when programmatically altering values.

Type Definitions

LuCI.ui.FileUpload.InitOptionsLuCI.ui.AbstractElement.InitOptions

In addition to the AbstractElement.InitOptions the following properties are recognized:

Properties:

Name	Type	Argument	Default	Description
show_hidden	boolean	<optional>	false	Specifies whether hidden files should be displayed when browsing remote files. Note that this is not a security feature, hidden files are always present in the remote file listings received, this option merely controls whether they're displayed or not.
enable_upload	boolean	<optional>	true	Specifies whether the widget allows the user to upload files. If set to false, only existing files may be selected. Note that this is not a security feature. Whether file upload requests are accepted remotely depends on the ACL setup for the current session. This option merely controls whether the upload controls are rendered or not.
enable_remove	boolean	<optional>	true	Specifies whether the widget allows the user to delete remove files. If set to false, existing files may not be removed. Note that this is not a security feature. Whether file delete requests are accepted remotely depends on the ACL setup for the current session. This option merely controls whether the file remove controls are rendered or not.
root_directory	string	<optional>	/etc/luci-uploads	Specifies the remote directory the upload and file browsing actions take place in. Browsing to directories outside of the root directory is prevented by the widget. Note that this is not a security feature. Whether remote directories are browseable or not solely depends on the ACL setup for the current session.