- :alert
- An element with important, and usually time-sensitive, information.
- :alert-dialog
- A type of dialog that contains an alert message.
- :banner
- Unused.
- :button
- An input element that allows for user-triggered actions when clicked or pressed.
- :caption, :cell
- Unused.
- :checkbox
- A checkable input element that has three possible values: :false, :true , or :mixed.
- :column-header
- A header in a columned list.
- :combo-box
- An input that controls another element, such as a list
or a grid, that can dynamically pop up to help the user set the value of the input.
- :command, :composite
- Abstract role.
- :dialog
- A dialog is a window that is designed to interrupt the
current processing of an application in order to prompt the user to enter information or require a response.
- :document
- Content that assistive technology users may want to browse in a reading mode.
- :feed, :form
- Unused.
A nameless container that has no semantic meaning of its own. This is the role that GTK uses by default for widgets. - :grid
- A grid of items.
- :grid-cell
- An item in a grid or tree grid.
- :group
- An element that groups multiple widgets. GTK uses this role for various containers, like the gtk:header-bar or gtk:notebook widgets.
- :heading
- Unused.
- :img
- An image.
- :input
- Abstract role.
- :label
- A visible name or caption for a user interface component.
- :landmark
- Abstract role.
- :legend
- Unused.
- :link
- A clickable link.
- :list
- A list of items.
- :list-box
- Unused.
- :list-item
- An item in a list.
- :log, :main, :marquee, :math
- Unused.
- :meter
- An element that represents a value within a known range.
- :menu
- A menu.
- :menu-bar
- A menubar.
- :menu-item
- An item in a menu.
- :menu-item-checkbox
- A check item in a menu.
- :menu-item-radio
- A radio item in a menu.
- :navigation
- Unused.
- :none
- An element that is not represented to accessibility
technologies. This role is synonymous to :presentation.
- :note, :option
- Unused.
- :presentation
- An element that is not represented to accessibility
technologies. This role is synonymous to :none.
- :progress-bar
- An element that displays the progress status for tasks that take a long time.
- :radio
- A checkable input in a group of radio roles, only one of which can be checked at a time.
- :radio-group
- Unused.
- :range
- Abstract role.
- :region
- Unused.
- :row
- A row in a columned list.
- :row-group, :row-header
- Unused.
- :scrollbar
- A graphical object that controls the scrolling of
content within a viewing area, regardless of whether the content is fully displayed within the viewing area.
- :search
- Unused.
- :search-box
- A type of textbox intended for specifying search criteria.
- :section. :section-head
- Abstract role.
- :select
- Abstract role.
- :separator
- A divider that separates and distinguishes sections of content or groups of menuitems.
- :slider
- A user input where the user selects a value from within a given range.
- :spin-button
- A form of range that expects the user to select from among discrete choices.
- :status
- Unused.
- :structure
- Abstract role.
- :switch
- A type of checkbox that represents on/off values, as opposed to checked/unchecked values.
- :tab
- An item in a list of tab used for switching pages.
- :table
- Unused.
- :tab-list
- A list of tabs for switching pages.
- :tab-panel
- A page in a notebook or stack.
- :text-box
- A type of input that allows free-form text as its value.
- :time, :timer, :toolbar, :tooltip, :tree
- Unused.
- :tree-grid
- A treeview-like, columned list.
- :tree-item
- Unused.
- :widget
- Abstract role for interactive components of a graphical user interface.
- :window
- Abstract role for windows.
- :toggle-button
- A type of push button which stays pressed until depressed by a second activation. Since: 4.10
- :application
- A toplevel element of a graphical user interface. This is the role that GTK uses by default for windows. Since 4.12
- :paragraph
- A paragraph of content. Since 4.14
- :block-quote
- A section of content that is quoted from another source. Since 4.14
- :article
- A section of a page that consists of a composition that forms an independent part of a document, page, or site. Since 4.14
- :comment
- A comment contains content expressing reaction to other content. Since 4.14
- :terminal
- A virtual terminal. Since 4.14