Main content

gridcell

Characteristics

Superclass Role:

  • section
  • widget

Subclass Roles:

  • columnheader
  • rowheader

Base Concept:

  • HTML td

Required Context Role:

  • row

Supported States and Properties:

  • aria-readonly
  • aria-required
  • aria-selected (state)

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:

  • contents
  • author

Accessible Name Required:

  • True

A cell in a grid or treegrid.

Gridcell (role) is an element within the table or tree structure. As explained in the grid (role), gridcells will form a relation with their nearest possible parent element. In the table example, gridcells are owned by <tr> or row (role) to form a parent/child relation.

Use aria-selected (state) to inform the user about the selected or non-selected state of the gridcell. If the gridcell is non-editable, also use aria-readonly (property) to intimate the same to a screen reader user. In a tree structure, if the gridcell has the expand/collapse functionality, use aria-expanded (state) to intimate the same to the screen reader user.

Cells may be active, editable, and selectable. Cells may have relationships such as aria-controls to address the application of functional relationships.

If relevant headers cannot be determined from the DOM structure, authors should explicitly indicate which header cells are relevant to the cell by referencing elements with rolerowheader or columnheader using the aria-describedby attribute.

In a treegrid, authors may define cells as expandable by using the aria-expanded attribute. If the aria-expanded attribute is provided, it applies only to the individual cell. It is not a proxy for the container row, which also can be expanded. The main use case for providing this attribute on a cell is pivot table behavior.

Authors must ensure elements with role gridcell are contained in, or owned by, an element with the role row.

Microsoft Active Accessibility accRole Property: 

  • ROLE_SYSTEM_CELL

UI Automation ControlType Property: 

  • DataItem

UI Automation AriaRole Property: 

  • gridcell
More in this category: « group grid »