API Referenceclass

class UIButton

A view class that represents a button control.

class UIButton extends UIElement;

Notes

• Buttons emit events when clicked, including a Navigate event if navigateTo is set.
• Use the UI.Button() function to create buttons using a builder.

Constructor

• new UIButton()
  Creates a new button view object with the specified text.

Type members

• class ButtonBuilder static
  A builder class for creating UIButton instances.

Static members

• function buttonBuilder() static
  Creates a view builder for a button element.
• function iconButtonBuilder() static
  Creates a view builder for an icon-only button element.
• function linkButtonBuilder() static
  Creates a view builder for a link-styled button.

Instance members

• text
  The button text to be displayed.
• icon
  The button icon to be displayed.
• iconStyle
  The style options for displaying the button icon.
• chevron
  The direction of a chevron icon placed at the far end of the button.
• chevronStyle
  The style options for displaying the chevron icon.
• navigateTo
  The navigation target to navigate to when this button is clicked.
• pressed
  The current visual pressed state.
• value
  An arbitrary value associated with this button.
• disableKeyboardFocus
  True if keyboard focus (e.g. Tab key) should be disabled for this button.
• disabled
  True if user input should be disabled on this control.
• buttonVariant
  A set of flags that determine the button’s (internal) visual style.
• getNavigationTarget()
  Returns the navigation target for this button.

Inherited members

• name
  The identifier for this UI element.
• hidden
  True if the element should be hidden from view.
• style
  The style overrides to apply to this element.
• setStyle()
  Applies additional style overrides to this element.
• position
  The position options for this element.
• accessibleRole
  The WAI-ARIA role for this element, if applicable.
• accessibleLabel
  The WAI-ARIA label text for this element, if applicable.
• requestFocus()
  Requests input focus on this element.
• requestFocusNext()
  Requests input focus for the next sibling element.
• requestFocusPrevious()
  Requests input focus for the previous sibling element.
• getRenderer() protected
  Returns the renderer observer for this element, if any.
• isFocused()
  Returns true if this element currently has input focus.
• render()
  Triggers asynchronous rendering for this element and all contained elements, if any.
• findViewContent()
  Implementation of View.findViewContent(); returns an empty array unless overridden.
• lastRenderOutput
  The last rendered output, if any; set by the UI element renderer.
• emit()
  Emits an event, immediately calling all event handlers.
• emitChange()
  Emits a change event.
• listen()
  Adds a handler for all events emitted by this object.
• listenOnce()
  Returns a promise for a single event with the provided name.
• listenAsync()
  Adds a handler for all events emitted by this object, and returns an async iterable.
• observe()
  Observes a property, a bound property from an attached parent, or an observable object.
• observeAsync()
  Observes one or more targets asynchronously, batching or debouncing/throttling updates.
• attach() protected
  Attaches the specified observable object to this object.
• isUnlinked()
  Returns true if the object has been unlinked.
• unlink()
  Unlinks this observable object.
• beforeUnlink() protected
  A method that’s called immediately before unlinking an object, can be overridden.