Main content

group

Characteristics

Superclass Role:

  • section

Subclass Roles:

  • row
  • rowgroup
  • select
  • toolbar

Related Concepts:

  • HTML fieldset

Supported States and Properties:

  • aria-activedescendant

Inherited States and Properties:

  • aria-atomic
  • aria-busy (state)
  • aria-controls
  • aria-describedby
  • aria-disabled (state)
  • aria-dropeffect
  • aria-expanded (state)
  • aria-flowto
  • aria-grabbed (state)
  • aria-haspopup
  • aria-hidden (state)
  • aria-invalid (state)
  • aria-label
  • aria-labelledby
  • aria-live
  • aria-owns
  • aria-relevant

Name From:

  • author

A set of user interface objects which are not intended to be included in a page summary or table of contents by assistive technologies.

A group (role) is used to combine a set of logically related elements. The group (role) should be used to group similar elements while the region (role) or landmark (role) is used to group the portions of the page. Group (role) is used to relate the similar items of a tree widget, limit to list items in a HTML list etc. Group (role) relates the child elements which are siblings. Row (role), rowgroup (role) are similar types of aria roles which form a logical relation in a grid or table widgets.

Contrast with region which is a grouping of user interface objects that will be included in a page summary or table of contents.

Authors should use a group to form logical collection of items in a widget such as children in a tree widget forming a collection of siblings in a hierarchy, or a collection of items having the same container in a directory. However, when a group is used in the context of list, authors must limit its children to listitem elements. Therefore, proper handling of group by authors and assistive technologies is determined by the context in which it is provided.

Authors may nest group elements. If a section is significant enough to warrant inclusion in the web page's table of contents, the author should assign the section a role of region or a standard landmark role.

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_GROUPING

UI Automation ControlType Property: 

  • Grouping

UI Automation AriaRole Property: 

  • group
More in this category: « heading gridcell »