Skip to content

Latest commit

 

History

History
114 lines (109 loc) · 3.92 KB

events.md

File metadata and controls

114 lines (109 loc) · 3.92 KB

Selectize API – Events

In the usage documentation, a few callbacks are listed that allow you to listen for certain events. Callbacks aren't always ideal though; specifically when you wish to have multiple handlers.

Selectize instances have a basic event emitter interface that mimics jQuery, Backbone.js, et al:

var handler = function() { /* ... */ };
selectize.on('event_name', handler);
selectize.off('event_name');
selectize.off('event_name', handler);

List of Events

Event Params Description
"initialize" Invoked once the control is completely initialized.
"change" value Invoked when the value of the control changes.
"focus" Invoked when the control gains focus.
"blur" Invoked when the control loses focus.
"item_add" value, $item Invoked when an item is selected.
"item_remove" value, $item Invoked when an item is deselected.
"clear" Invoked when the control is manually cleared via the clear() method.
"option_add" value, data Invoked when a new option is added to the available options list.
"option_remove" value Invoked when an option is removed from the available options.
"option_clear" Invoked when all options are removed from the control.
"optgroup_add" id, data Invoked when a new option is added to the available options list.
"optgroup_remove" id Invoked when an option group is removed.
"optgroup_clear" Invoked when all option groups are removed.
"dropdown_open" $dropdown Invoked when the dropdown opens.
"dropdown_close" $dropdown Invoked when the dropdown closes.
"type" str Invoked when the user types while filtering options.
"load" data Invoked when new options have been loaded and added to the control (via the "load" option or "load" API method).
"destroy" Invoked right before the control is destroyed.