Properties

• inherited observable

  ariaLabel : string | undefinedmodule:ui/dropdown/button/dropdownbutton~DropdownButton#ariaLabel

  See source

  (Optional) The ARIA property reflected by the aria-label DOM attribute used by assistive technologies.

• inherited observable

  ariaLabelledBy : string | undefinedmodule:ui/dropdown/button/dropdownbutton~DropdownButton#ariaLabelledBy

  See source

  (Optional) The ARIA property reflected by the aria-ariaLabelledBy DOM attribute used by assistive technologies.

• children : ViewCollection<View<HTMLElement>>module:ui/dropdown/button/dropdownbutton~DropdownButton#children

  See source

• inherited observable

  class : undefined | stringmodule:ui/dropdown/button/dropdownbutton~DropdownButton#class

  See source

  (Optional) The additional CSS class set on the button.

• inherited observable

  icon : undefined | stringmodule:ui/dropdown/button/dropdownbutton~DropdownButton#icon

  See source

  (Optional) An XML content of the icon. When defined, an iconView should be added to the button.

  The user must provide the entire XML string, not just the path. See the UI library guide for details.

• inherited observable

  isEnabled : booleanmodule:ui/dropdown/button/dropdownbutton~DropdownButton#isEnabled

  See source

  Controls whether the button view is enabled, i.e. it can be clicked and execute an action.

  To change the "on" state of the button, use isOn instead.

  Defaults to true

• inherited observable

  isOn : booleanmodule:ui/dropdown/button/dropdownbutton~DropdownButton#isOn

  See source

  Controls whether the button view is "on". It makes sense when a feature it represents is currently active, e.g. a bold button is "on" when the selection is in the bold text.

  To disable the button, use isEnabled instead.

  Defaults to true

• inherited observable

  isToggleable : booleanmodule:ui/dropdown/button/dropdownbutton~DropdownButton#isToggleable

  See source

  Controls whether the button view is a toggle button (two–state) for assistive technologies.

  Defaults to false

• inherited observable

  isVisible : booleanmodule:ui/dropdown/button/dropdownbutton~DropdownButton#isVisible

  See source

  Controls whether the button view is visible. Visible by default, buttons are hidden using a CSS class.

  Defaults to true

• inherited observable

  keystroke : undefined | stringmodule:ui/dropdown/button/dropdownbutton~DropdownButton#keystroke

  See source

  (Optional) The keystroke associated with the button, i.e. CTRL+B, in the string format compatible with keyboard.

  Note: Use withKeystroke if you want to display the keystroke information next to the label.

• inherited observable

  label : undefined | stringmodule:ui/dropdown/button/dropdownbutton~DropdownButton#label

  See source

  The label of the button view visible to the user when withText is true. It can also be used to create a tooltip.

• inherited observable

  labelStyle : undefined | stringmodule:ui/dropdown/button/dropdownbutton~DropdownButton#labelStyle

  See source

  (Optional) The value of the style attribute of the label.

• inherited observable

  role : string | undefinedmodule:ui/dropdown/button/dropdownbutton~DropdownButton#role

  See source

  (Optional) The property reflected by the role DOM attribute to be used by assistive technologies.

• inherited observable

  tabindex : numbermodule:ui/dropdown/button/dropdownbutton~DropdownButton#tabindex

  See source

  (Optional) Controls the tabindex HTML attribute of the button. By default, the button is focusable but does not included in the Tab order.

  Defaults to -1

• inherited observable

  tooltip : string | boolean | ( string, undefined | string ) => stringmodule:ui/dropdown/button/dropdownbutton~DropdownButton#tooltip

  See source

  (Optional) Tooltip of the button, i.e. displayed when hovering the button with the mouse cursor.

  • If defined as a Boolean (e.g. true), then combination of label and keystroke will be set as a tooltip.
  • If defined as a String, tooltip will equal the exact text of that String.
  • If defined as a Function, label and keystroke will be passed to that function, which is to return a string with the tooltip text.

  const view = new ButtonView( locale );
  view.tooltip = ( label, keystroke ) => `A tooltip for ${ label } and ${ keystroke }.`
  

  Defaults to false

• inherited observable

  tooltipPosition : 'e' | 's' | 'n' | 'w' | 'sw' | 'se'module:ui/dropdown/button/dropdownbutton~DropdownButton#tooltipPosition

  See source

  (Optional) The position of the tooltip. See TooltipManager to learn more about the tooltip system.

  Note: It makes sense only when the tooltip attribute is defined.

  Defaults to 's'

• inherited observable

  type : 'button' | 'menu' | 'reset' | 'submit'module:ui/dropdown/button/dropdownbutton~DropdownButton#type

  See source

  The HTML type of the button.

  Defaults to 'button'

• inherited observable

  withKeystroke : booleanmodule:ui/dropdown/button/dropdownbutton~DropdownButton#withKeystroke

  See source

  (Optional) Controls whether the keystroke of the button is displayed next to its label.

  Note: This property requires a keystroke to be defined in the first place.

  Defaults to false

• inherited observable

  withText : booleanmodule:ui/dropdown/button/dropdownbutton~DropdownButton#withText

  See source

  (Optional) Controls whether the label of the button is hidden (e.g. an icon–only button).

  Defaults to false

Events

• inherited

  change:ariaLabel( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:ariaLabel

  See source

  Fired when the ariaLabel property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (ariaLabel).

  value : string

  New value of the ariaLabel property with given key or null, if operation should remove property.

  oldValue : string

  Old value of the ariaLabel property with given key or null, if property was not set before.

• inherited

  change:ariaLabelledBy( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:ariaLabelledBy

  See source

  Fired when the ariaLabelledBy property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (ariaLabelledBy).

  value : string

  New value of the ariaLabelledBy property with given key or null, if operation should remove property.

  oldValue : string

  Old value of the ariaLabelledBy property with given key or null, if property was not set before.

• inherited

  change:class( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:class

  See source

  Fired when the class property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (class).

  value : undefined | string

  New value of the class property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the class property with given key or null, if property was not set before.

• inherited

  change:icon( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:icon

  See source

  Fired when the icon property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (icon).

  value : undefined | string

  New value of the icon property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the icon property with given key or null, if property was not set before.

• inherited

  change:isEnabled( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:isEnabled

  See source

  Fired when the isEnabled property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isEnabled).

  value : boolean

  New value of the isEnabled property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isEnabled property with given key or null, if property was not set before.

• inherited

  change:isOn( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:isOn

  See source

  Fired when the isOn property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isOn).

  value : boolean

  New value of the isOn property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isOn property with given key or null, if property was not set before.

• inherited

  change:isToggleable( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:isToggleable

  See source

  Fired when the isToggleable property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isToggleable).

  value : boolean

  New value of the isToggleable property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isToggleable property with given key or null, if property was not set before.

• inherited

  change:isVisible( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:isVisible

  See source

  Fired when the isVisible property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isVisible).

  value : boolean

  New value of the isVisible property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isVisible property with given key or null, if property was not set before.

• inherited

  change:keystroke( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:keystroke

  See source

  Fired when the keystroke property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (keystroke).

  value : undefined | string

  New value of the keystroke property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the keystroke property with given key or null, if property was not set before.

• inherited

  change:label( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:label

  See source

  Fired when the label property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (label).

  value : undefined | string

  New value of the label property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the label property with given key or null, if property was not set before.

• inherited

  change:labelStyle( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:labelStyle

  See source

  Fired when the labelStyle property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (labelStyle).

  value : undefined | string

  New value of the labelStyle property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the labelStyle property with given key or null, if property was not set before.

• inherited

  change:role( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:role

  See source

  Fired when the role property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (role).

  value : string

  New value of the role property with given key or null, if operation should remove property.

  oldValue : string

  Old value of the role property with given key or null, if property was not set before.

• inherited

  change:tabindex( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:tabindex

  See source

  Fired when the tabindex property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (tabindex).

  value : number

  New value of the tabindex property with given key or null, if operation should remove property.

  oldValue : number

  Old value of the tabindex property with given key or null, if property was not set before.

• inherited

  change:tooltip( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:tooltip

  See source

  Fired when the tooltip property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (tooltip).

  value : string | boolean | ( string, undefined | string ) => string

  New value of the tooltip property with given key or null, if operation should remove property.

  oldValue : string | boolean | ( string, undefined | string ) => string

  Old value of the tooltip property with given key or null, if property was not set before.

• inherited

  change:tooltipPosition( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:tooltipPosition

  See source

  Fired when the tooltipPosition property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (tooltipPosition).

  value : 'e' | 's' | 'n' | 'w' | 'sw' | 'se'

  New value of the tooltipPosition property with given key or null, if operation should remove property.

  oldValue : 'e' | 's' | 'n' | 'w' | 'sw' | 'se'

  Old value of the tooltipPosition property with given key or null, if property was not set before.

• inherited

  change:type( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:type

  See source

  Fired when the type property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (type).

  value : 'button' | 'menu' | 'reset' | 'submit'

  New value of the type property with given key or null, if operation should remove property.

  oldValue : 'button' | 'menu' | 'reset' | 'submit'

  Old value of the type property with given key or null, if property was not set before.

• inherited

  change:withKeystroke( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:withKeystroke

  See source

  Fired when the withKeystroke property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (withKeystroke).

  value : boolean

  New value of the withKeystroke property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the withKeystroke property with given key or null, if property was not set before.

• inherited

  change:withText( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:change:withText

  See source

  Fired when the withText property changed value.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (withText).

  value : boolean

  New value of the withText property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the withText property with given key or null, if property was not set before.

• inherited

  execute( eventInfo )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:execute

  See source

  Fired when the button view is clicked. It won't be fired when the button isEnabled is false.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

• open( eventInfo )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:open

  See source

  Fired when the dropdown should be opened. It will not be fired when the button is disabled.

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

• inherited

  set:ariaLabel( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:ariaLabel

  See source

  Fired when the ariaLabel property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (ariaLabel).

  value : string

  New value of the ariaLabel property with given key or null, if operation should remove property.

  oldValue : string

  Old value of the ariaLabel property with given key or null, if property was not set before.

• inherited

  set:ariaLabelledBy( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:ariaLabelledBy

  See source

  Fired when the ariaLabelledBy property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (ariaLabelledBy).

  value : string

  New value of the ariaLabelledBy property with given key or null, if operation should remove property.

  oldValue : string

  Old value of the ariaLabelledBy property with given key or null, if property was not set before.

• inherited

  set:class( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:class

  See source

  Fired when the class property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (class).

  value : undefined | string

  New value of the class property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the class property with given key or null, if property was not set before.

• inherited

  set:icon( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:icon

  See source

  Fired when the icon property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (icon).

  value : undefined | string

  New value of the icon property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the icon property with given key or null, if property was not set before.

• inherited

  set:isEnabled( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:isEnabled

  See source

  Fired when the isEnabled property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isEnabled).

  value : boolean

  New value of the isEnabled property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isEnabled property with given key or null, if property was not set before.

• inherited

  set:isOn( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:isOn

  See source

  Fired when the isOn property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isOn).

  value : boolean

  New value of the isOn property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isOn property with given key or null, if property was not set before.

• inherited

  set:isToggleable( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:isToggleable

  See source

  Fired when the isToggleable property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isToggleable).

  value : boolean

  New value of the isToggleable property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isToggleable property with given key or null, if property was not set before.

• inherited

  set:isVisible( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:isVisible

  See source

  Fired when the isVisible property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (isVisible).

  value : boolean

  New value of the isVisible property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the isVisible property with given key or null, if property was not set before.

• inherited

  set:keystroke( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:keystroke

  See source

  Fired when the keystroke property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (keystroke).

  value : undefined | string

  New value of the keystroke property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the keystroke property with given key or null, if property was not set before.

• inherited

  set:label( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:label

  See source

  Fired when the label property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (label).

  value : undefined | string

  New value of the label property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the label property with given key or null, if property was not set before.

• inherited

  set:labelStyle( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:labelStyle

  See source

  Fired when the labelStyle property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (labelStyle).

  value : undefined | string

  New value of the labelStyle property with given key or null, if operation should remove property.

  oldValue : undefined | string

  Old value of the labelStyle property with given key or null, if property was not set before.

• inherited

  set:role( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:role

  See source

  Fired when the role property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (role).

  value : string

  New value of the role property with given key or null, if operation should remove property.

  oldValue : string

  Old value of the role property with given key or null, if property was not set before.

• inherited

  set:tabindex( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:tabindex

  See source

  Fired when the tabindex property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (tabindex).

  value : number

  New value of the tabindex property with given key or null, if operation should remove property.

  oldValue : number

  Old value of the tabindex property with given key or null, if property was not set before.

• inherited

  set:tooltip( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:tooltip

  See source

  Fired when the tooltip property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (tooltip).

  value : string | boolean | ( string, undefined | string ) => string

  New value of the tooltip property with given key or null, if operation should remove property.

  oldValue : string | boolean | ( string, undefined | string ) => string

  Old value of the tooltip property with given key or null, if property was not set before.

• inherited

  set:tooltipPosition( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:tooltipPosition

  See source

  Fired when the tooltipPosition property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (tooltipPosition).

  value : 'e' | 's' | 'n' | 'w' | 'sw' | 'se'

  New value of the tooltipPosition property with given key or null, if operation should remove property.

  oldValue : 'e' | 's' | 'n' | 'w' | 'sw' | 'se'

  Old value of the tooltipPosition property with given key or null, if property was not set before.

• inherited

  set:type( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:type

  See source

  Fired when the type property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (type).

  value : 'button' | 'menu' | 'reset' | 'submit'

  New value of the type property with given key or null, if operation should remove property.

  oldValue : 'button' | 'menu' | 'reset' | 'submit'

  Old value of the type property with given key or null, if property was not set before.

• inherited

  set:withKeystroke( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:withKeystroke

  See source

  Fired when the withKeystroke property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (withKeystroke).

  value : boolean

  New value of the withKeystroke property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the withKeystroke property with given key or null, if property was not set before.

• inherited

  set:withText( eventInfo, name, value, oldValue )module:ui/dropdown/button/dropdownbutton~DropdownButton#event:set:withText

  See source

  Fired when the withText property is going to be set but is not set yet (before the change event is fired).

  Parameters

  eventInfo : EventInfo

  An object containing information about the fired event.

  name : string

  Name of the changed property (withText).

  value : boolean

  New value of the withText property with given key or null, if operation should remove property.

  oldValue : boolean

  Old value of the withText property with given key or null, if property was not set before.