Gets the event that is fired when the component's hover-state is changing.
Gets the event that is fired when an item is added to the list of items.
Gets the event that is fired when an item is removed from the list of items.
Gets the event that is fired when an item is selected from the list of items.
Adds an item to this selector by doing a sorted insert or by appending the element to the end of the list of items. If an item with the specified key already exists, it is replaced.
the key of the item to add
the (human-readable) label of the item to add
whether the item should be added respecting the order of keys
custom aria label for the listItem
ReadonlycloseConfigures the component for the supplied Player and UIInstanceManager. This is the place where all the magic happens, where components typically subscribe and react to events (on their DOM element, the Player, or the UIInstanceManager), and basically everything that makes them interactive. This method is called only once, when the UIManager initializes the UI.
Subclasses usually overwrite this method to add their own functionality.
the player which this component controls
the UIInstanceManager that manages this component
Returns the configuration object of the component.
Initializes the component, e.g. by applying config settings. This method must not be called from outside the UI framework.
This method is automatically called by the UIInstanceManager. If the component is an inner component of some component, and thus encapsulated abd managed internally and never directly exposed to the UIManager, this method must be called from the managing component's #initialize method.
Releases all resources and dependencies that the component holds. Player, DOM, and UIManager events are automatically removed during release and do not explicitly need to be removed here. This method is called by the UIManager when it releases the UI.
Subclasses that need to release resources should override this method and call super.release().
Synchronize the current items of this selector with the given ones. This will remove and add items selectively. For each removed item the ItemRemovedEvent and for each added item the ItemAddedEvent will be triggered. Favour this method over using clearItems and adding all items again afterwards.
A simple select box providing the possibility to select a single item out of a list of available items.
DOM example: