Events

This section describes events fired by this widget.

See Also

disposing

Raised when the widget is removed from the DOM using the remove(), empty(), or html() jQuery methods only.

Event Handler Argument:
Information about the event.
Object structure:
component: Object
The widget instance.
element: jQuery
The widget's container.
model: Object
The model data. Available only if you use Knockout.

Main article: onDisposing

See Also

initialized

Raised only once, after the widget is initialized.

Event Handler Argument:
Information about the event.
Object structure:
component: Object
The widget instance.
element: jQuery
The widget's container.

Main article: onInitialized

See Also

optionChanged

Raised after an option of the widget is changed.

Event Handler Argument:
Information about the event.
Object structure:
component: Object
The widget instance.
name: String
A short name of the option whose value has been changed.
fullName: String
A full name of the option whose value has been changed; contains a full hierarchy of the option.
value: any
A new value for the option.
element: jQuery
The widget's container.
model: Object
The model data. Available only if you use Knockout.

Main article: onOptionChanged

See Also

progress

Fires when a segment of a file has been uploaded.

Event Handler Argument:
Provides function parameters.
Object structure:
component: Object
Provides access to the widget instance.
element: jQuery
An HTML element of the widget.
model: Object
Provides access to the data that is available for binding against the element. Available only in the Knockout approach.
file: Object
An uploaded file.
segmentSize: Number
The size of an uploaded file segment.
bytesLoaded: Number
The total count of uploaded bytes.
bytesTotal: Number
The total count of bytes in the XMLHttpRequest.
jQueryEvent: ProgressEvent
An XMLHttpRequest progress event that caused the action execution.
An XMLHttpRequest for the file.

Instead, you can use the onProgress option to handle the event.

See Also

uploadAborted

Fires when file uploading has been aborted.

Event Handler Argument:
Provides function parameters.
Object structure:
component: Object
Provides access to the widget instance.
element: jQuery
An HTML element of the widget.
model: Object
Provides access to the data that is available for binding against the element. Available only in the Knockout approach.
file: Object
An uploaded file.
jQueryEvent: jQuery.Event
Specifies the jQuery event that caused action execution.
request: Object
Specifies an XMLHttpRequest for the file.

Instead, you can use the onUploadAborted option to handle the event.

See Also

uploaded

Fires when a file has been uploaded.

Event Handler Argument:
Provides function parameters.
Object structure:
component: Object
Provides access to the widget instance.
element: jQuery
An HTML element of the widget.
model: Object
Provides access to the data that is available for binding against the element. Available only in the Knockout approach.
file: Object
An uploaded file.
jQueryEvent: jQuery.Event
Specifies the jQuery event that caused action execution.
request: Object
Specifies an XMLHttpRequest for the file.

Instead, you can use the onUploaded option to handle the event.

See Also
Show Example:
AngularJS
Knockout
jQuery

uploadError

Fires when an error has occurred during uploading.

Event Handler Argument:
Provides function parameters.
Object structure:
component: Object
Provides access to the widget instance.
element: jQuery
An HTML element of the widget.
model: Object
Provides access to the data that is available for binding against the element. Available only in the Knockout approach.
file: Object
An uploaded file.
jQueryEvent: jQuery.Event
Specifies the jQuery event that caused action execution.
request: Object
Specifies an XMLHttpRequest for the file.

Instead, you can use the onUploadError option to handle the event.

See Also

uploadStarted

Fires when file uploading is started.

Event Handler Argument:
Provides function parameters.
Object structure:
component: Object
Provides access to the widget instance.
element: jQuery
An HTML element of the widget.
model: Object
Provides access to the data that is available for binding against the element. Available only in the Knockout approach.
file: Object
An uploaded file.
jQueryEvent: jQuery.Event
Specifies the jQuery event that caused action execution.
request: Object
Specifies an XMLHttpRequest for the file.

Instead, you can use the onUploadStarted option to handle the event.

See Also
Show Example:
AngularJS
Knockout
jQuery

valueChanged

Fires when a file or several files are added to or removed from selection.

Event Handler Argument:
Provides function parameters.
Object structure:
component: Object
Provides access to the widget instance.
element: jQuery
An HTML element of the widget.
model: Object
Provides access to the data that is available for binding against the element. Available only in the Knockout approach.
value: Array
Newly selected files.
previousValue: Array
Previously selected files.
jQueryEvent: jQuery.Event
Specifies the jQuery event that caused action execution.

Instead, you can use the onValueChanged option to handle the event.

See Also
Show Example:
AngularJS
Knockout
jQuery