Role

  • Cmn
    value class Role

The type of user interface element. Accessibility services might use this to describe the element or do customizations. Most roles can be automatically resolved by the semantics properties of this element. But some elements with subtle differences need an exact role. If an exact role is not listed, SemanticsPropertyReceiver.role should not be set and the framework will automatically resolve it.

Summary

Public companion properties

Role

This element is a button control.

Cmn
Role

This element is a Checkbox which is a component that represents two states (checked / unchecked).

Cmn
Role

This element is associated with a drop down menu.

Cmn
Role

This element is an image.

Cmn
Role

This element is a RadioButton which is a component to represent two states, selected and not selected.

Cmn
Role

This element is a Switch which is a two state toggleable component that provides on/off like options.

Cmn
Role

This element is a Tab which represents a single page of content using a text label and/or icon.

Cmn

Public functions

open String
Cmn

Public companion properties

Button

val ButtonRole

This element is a button control. Associated semantics properties for accessibility: SemanticsProperties.Disabled, SemanticsActions.OnClick

Checkbox

val CheckboxRole

This element is a Checkbox which is a component that represents two states (checked / unchecked). Associated semantics properties for accessibility: SemanticsProperties.Disabled, SemanticsProperties.StateDescription, SemanticsActions.OnClick

val DropdownListRole

This element is associated with a drop down menu. Associated semantics properties for accessibility: SemanticsActions.OnClick

Image

val ImageRole

This element is an image. Associated semantics properties for accessibility: SemanticsProperties.ContentDescription

RadioButton

val RadioButtonRole

This element is a RadioButton which is a component to represent two states, selected and not selected. Associated semantics properties for accessibility: SemanticsProperties.Disabled, SemanticsProperties.StateDescription, SemanticsActions.OnClick

Switch

val SwitchRole

This element is a Switch which is a two state toggleable component that provides on/off like options. Associated semantics properties for accessibility: SemanticsProperties.Disabled, SemanticsProperties.StateDescription, SemanticsActions.OnClick

Tab

val TabRole

This element is a Tab which represents a single page of content using a text label and/or icon. A Tab also has two states: selected and not selected. Associated semantics properties for accessibility: SemanticsProperties.Disabled, SemanticsProperties.StateDescription, SemanticsActions.OnClick

Public functions

toString

open fun toString(): String