---
title: Events
description: event reference
---

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

| 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 added (i.e., when an option is selected)                                             |
| **item_remove**     | value, $item | Invoked when an item is deselected.                                                                          |
| **item_select**     | item         | Invoked when an item is selected.                                                                            |
| **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 list of available options.                                         |
| **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 list of available options.                                         |
| **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.                                                               |
