From 55a66bc5be75c4d21109cc6ef0525a46a6d1e787 Mon Sep 17 00:00:00 2001 From: joanmarie Date: Tue, 25 Jun 2019 14:24:02 -0400 Subject: [PATCH] Create aria-rowindextext and aria-colindextext (#994) --- index.html | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 83 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 1e73da249..343781c08 100644 --- a/index.html +++ b/index.html @@ -1472,8 +1472,10 @@

Definition of Roles

@@ -6352,6 +6354,7 @@
Presentational Roles Conflict Resolution
  • aria-level
  • aria-posinset
  • aria-rowindex
    • +
  • aria-rowindextext
  • aria-setsize
  • aria-selected
    • @@ -9446,6 +9449,7 @@

    Relationship Attributes

  • aria-activedescendant
  • aria-colcount
  • aria-colindex
    • +
  • aria-colindextext
  • aria-colspan
  • aria-controls
  • aria-describedby
    • @@ -9457,6 +9461,7 @@

    Relationship Attributes

  • aria-posinset
  • aria-rowcount
  • aria-rowindex
    • +
  • aria-rowindextext
  • aria-rowspan
  • aria-setsize
    • @@ -9826,7 +9831,7 @@

    Definitions of States and Properties (all aria-* attributes)

    aria-colindex
    -

    Defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. See related aria-colcount and aria-colspan.

    +

    Defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. See related aria-colindextext, aria-colcount, and aria-colspan.

    If all of the columns are present in the DOM, it is not necessary to set this attribute as the user agent can automatically calculate the column index of each cell or gridcell. However, if only a portion of the columns is present in the DOM at a given moment, this attribute is needed to provide an explicit indication of the column of each cell or gridcell with respect to the full table.

    Authors MUST set the value for aria-colindex to an integer greater than or equal to 1, greater than the aria-colindex value of any previous elements within the same row, and less than or equal to the number of columns in the full table. For a cell or gridcell which spans multiple columns, authors MUST set the value of aria-colindex to the start of the span.

    If the set of columns which is present in the DOM is contiguous, and if there are no cells which span more than one row or column in that set, then authors MAY place aria-colindex on each row, setting the value to the index of the first column of the set. Otherwise, authors SHOULD place aria-colindex on all of the children or owned elements of each row.

    @@ -9938,6 +9943,42 @@

    Definitions of States and Properties (all aria-* attributes)

    +
    + aria-colindextext +
    +

    Defines a human readable text alternative of aria-colindex. See related aria-rowindextext.

    +

    Authors SHOULD only use aria-colindextext when the provided or calculated value of aria-colindex is not meaningful or does not reflect the displayed index, as is the case with spreadsheets and chess boards.

    +

    Authors SHOULD NOT use aria-colindextext as a replacement for aria-colindex because some assistive technologies rely upon the numeric column index for the purpose of keeping track of the user's position or providing alternative table navigation.

    +

    Unlike aria-colindex, aria-colindextext is not a supported property of row because user agents have no way to reliably calculate aria-colindextext for the purpose of exposing its value on the cell or gridcell.

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Characteristics:
    CharacteristicValue
    Related Concepts: 
    Used in Roles:Placeholder
    Inherits into Roles:Placeholder
    Value:string
    +
    aria-colspan
    @@ -11681,7 +11722,7 @@

    Definitions of States and Properties (all aria-* attributes)

    aria-rowindex
    -

    Defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. See related aria-rowcount and aria-rowspan.

    +

    Defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. See related aria-rowindextext, aria-rowcount, and aria-rowspan.

    If all of the rows are present in the DOM, it is not necessary to set this attribute as the user agent can automatically calculate the index of each row. However, if only a portion of the rows is present in the DOM at a given moment, this attribute is needed to provide an explicit indication of each row's position with respect to the full table.

    Authors MUST set the value for aria-rowindex to an integer greater than or equal to 1, greater than the aria-rowindex value of any previous rows, and less than or equal to the number of rows in the full table. For a cell or gridcell which spans multiple rows, authors MUST set the value of aria-rowindex to the start of the span.

    Authors SHOULD place aria-rowindex on each row. Authors MAY also place aria-rowindex on all of the children or owned elements of each row.

    @@ -11778,6 +11819,42 @@

    Definitions of States and Properties (all aria-* attributes)

    +
    + aria-rowindextext +
    +

    Defines a human readable text alternative of aria-rowindex. See related aria-colindextext.

    +

    Authors SHOULD only use aria-rowindextext when the provided or calculated value of aria-rowindex is not meaningful or does not reflect the displayed index, as can be seen in the game Battleship.

    +

    Authors SHOULD NOT use aria-rowindextext as a replacement for aria-rowindex because some assistive technologies rely upon the numeric row index for the purpose of keeping track of the user's position or providing alternative table navigation.

    +

    Authors SHOULD place aria-rowindextext on each row. Authors MAY also place aria-rowindextext on all of the children or owned elements of each row.

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Characteristics:
    CharacteristicValue
    Related Concepts: 
    Used in Roles:Placeholder
    Inherits into Roles:Placeholder
    Value:string
    +
    aria-rowspan
    @@ -12457,6 +12534,7 @@

    Interface Mixin AriaAttributes

    attribute DOMString? ariaChecked; attribute DOMString? ariaColCount; attribute DOMString? ariaColIndex; + attribute DOMString? ariaColIndexText; attribute DOMString? ariaColSpan; attribute FrozenArray<Element>? ariaControlsElements; attribute DOMString? ariaCurrent; @@ -12488,6 +12566,7 @@

    Interface Mixin AriaAttributes

    attribute DOMString? ariaRoleDescription; attribute DOMString? ariaRowCount; attribute DOMString? ariaRowIndex; + attribute DOMString? ariaRowIndexText; attribute DOMString? ariaRowSpan; attribute DOMString? ariaSelected; attribute DOMString? ariaSetSize; @@ -12511,6 +12590,7 @@

    ARIA Attribute Reflection

    ariaCheckedaria-checked ariaColCountaria-colcount ariaColIndexaria-colindex + ariaColIndexTextaria-colindextext ariaColSpanaria-colspan ariaControlsElementsaria-controls ariaCurrentaria-current @@ -12542,6 +12622,7 @@

    ARIA Attribute Reflection

    ariaRoleDescriptionaria-roledescription ariaRowCountaria-rowcount ariaRowIndexaria-rowindex + ariaRowIndexTextaria-rowindextext ariaRowSpanaria-rowspan ariaSelectedaria-selected ariaSetSizearia-setsize