diff --git a/html-aam/index.html b/html-aam/index.html index 6ba045f20..8bcf4b0c1 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -6964,7 +6964,520 @@

`table`

Computed Role -
Use WAI-ARIA mapping
+
+

To compute the role given table element `element`:

+
    +
  1. +

    If element is in not being rendered, return `table`.

    +
    +

    Tables which are not rendered are unlikely to be used for layout, but could be present to supplement otherwise inaccessible graphics.

    +
    +
    + +
    +
    2. +
  2. +

    If element is editable, return `table`.

    +
    +

    Tables which are in an editable state need to act as data tables to allow for rich text editors to create and edit tables which otherwise might have insufficient rows or columns to be considered a table.

    +
    +
    + +
    +
    3. +
  3. +

    If element has a `datatable` attribute whose value is `"0"`, return `table`

    +
    +

    This is a nonstandard attribute used to force tables to be as such. It should be avoided, as `role=table` should be sufficient.

    +
    +
    + +
    +
    4. +
  4. +

    If element has a `summary` attribute whose value is not the empty string, return `table`.

    +
    +

    The `summary` attribute is deprecated, this is here for completeness & web compatibility.

    +
    +
    + +
    +
    5. +
  5. +

    If element has a `rules` attribute whose value is not the empty string, return `table`.

    +
    +

    The `rules` attribute is deprecated, this is here for completeness & web compatibility.

    +
    +
    +
      +
    • Firefox does not include this heuristic.
      • +
    • Chrome
      • +
    • WebKit
      • +
    +
    +
    6. +
  6. +

    If element has a `aria-rowcount` attribute whose value a positive integer greater than 0, return `table`.

    +
    + +
    +
    7. +
  7. +

    If element has a `aria-colcount` attribute whose value a positive integer greater than 0, return `table`.

    +
    + +
    +
    8. +
  8. Let row_count be 0.
    9. +
  9. Let column_count be 0.
    10. +
  10. Let cell_count be 0.
    11. +
  11. Let cells_with_borders be 0.
    12. +
  12. Let cells_with_top_border be 0.
    13. +
  13. Let cells_with_right_border be 0.
    14. +
  14. Let cells_with_bottom_border be 0.
    15. +
  15. Let cells_with_left_border be 0.
    16. +
  16. Let cells_with_alternate_background be 0.
    17. +
  17. Let alternating_row_colors be a new list.
    18. +
  18. Let alternating_row_color_count be 0.
    19. +
  19. Let alternating_cell_color_count be 0.
    20. +
  20. Let prev_row_background be null.
    21. +
  21. Let table_background be the result of getting the computed value of the background-color property on element.
    22. +
  22. +

    For each child node table_child of element:

    +
      +
    1. +

      If table_child is a `thead` element, return `table`.

      +
      + +
      +
      2. +
    2. +

      If table_child is a `tfoot` element, return `table`.

      +
      + +
      +
      3. +
    3. +

      If table_child is a `caption` element, return `table`.

      +
      + +
      +
      4. +
    4. +

      If table_child is a `col` element, return `table`.

      +
      + +
      +
      5. +
    5. +

      If table_child is a `colgroup` element, return `table`.

      +
      + +
      +
      6. +
    6. +

      If table_child is a `tbody` element:

      +
        +
      1. +

        For each child node body_child of table_child:

        +
          +
        1. +

          If body_child is a `tr` element:

          +
            +
          1. +

            If row_count is equal to alternating_row_color_count:.

            +
              +

            1. Let row_background be the result of getting the computed value of the background-color property on element.

              2. +
            2. +

              If row_background is not null:

              +
                +
              1. +

                If prev_row_background is not null, and prev_row_background is not equal to row_background, return `table`.

                +
                + +
                +
                2. +

              2. Append row_background to the list alternating_row_colors.

                3. +

              3. Increment alternating_row_color_count.

                4. +

              4. Set prev_row_color to row_color

                5. +
              +
              3. +
            +
            2. +

          2. Increment row_count.

            3. +
          3. +

            If body_child has a role attribute whose value does not include "row", return `html-layout-table`

            +
            + +
            +
            4. +
          4. +

            If row_count is greater than or equal to 20, and column_count is greater than or equal to 2, return `table`.

            +
            +

            This and the following condition are exclusive, while the condition after the following condition is mutually exclusive with these two. The standard should pick one or the other.

            +
            +
            + +
            +
            5. +
          5. +

            If column_count is greater than or equal to 20, and row_count is greater than or equal to 2, return `table`.

            +
            +

            This and the prior condition are exclusive, while the following condition is mutually exclusive with these two. The standard should pick one or the other.

            +
            +
            + +
            +
            6. +
          6. +

            If row_count is greater than or equal to 20, return `table`.

            +
            +

            This and the prior two condition are mutually exclusive. The standard should pick one or the other.

            +
            +
            + +
            +
            7. +
          7. +

            For each child node row_child of body_child:

            +
              +
            1. +

              If row_child is a `th` element, return `table`.

              +
              + +
              +
              2. +
            2. +

              If row_child is a `td` element:

              +
                +
              1. +

                If cell_count is 0 and row_child is in not being rendered, return `table`.

                +
                +

                Tables whose first cell is not being rendered are likely to be data tables, as layout tables will typically use available cells.

                +
                +
                + +
                +
                2. +
              2. +

                If row_child has a `headers` attribute whose value is not empty, return `table`.

                +
                + +
                +
                3. +
              3. +

                If row_child has a `scope` attribute whose value is not empty, return `table`.

                +
                + +
                +
                4. +
              4. +

                If row_child has a `abbr` attribute whose value is not empty, return `table`.

                +
                + +
                +
                5. +
              5. +

                If row_child has a `axis` attribute whose value is not empty, return `table`.

                +
                +
                  +
                • Firefox does not include this heuristic.
                  • +
                • WebKit
                  • +
                • Chrome
                  • +
                +
                +
                6. +
              6. +

                If row_child has a `role` attribute whose value is "gridcell", "cell", "columnheader" or "rowheader", return `table`.

                +
                + +
                +
                7. +
              7. +

                If row_child has a `role` attribute whose value is NOT one of "gridcell", "cell", "columnheader" or "rowheader", return `html-layout-table`.

                +
                + +
                +
                8. +
              8. +

                If the result of getting the computed value of the empty-cells property is equal to `hide`, return `table`.

                +
                +
                  +
                • Firefox does not include this heuristic.
                  • +
                • Chrome
                  • +
                • WebKit
                  • +
                +
                +
                9. +

              9. If row_count is 1, increment column_count.

                10. +
              10. +

                If column_count is greater than 4, return `table`.

                +
                +
                  +
                • Firefox does not include this heuristic.
                  • +
                • Chrome
                  • +
                • WebKit
                  • +
                +
                +
                11. +

              11. Increment cell_count.

                12. +

              12. Let border_top be the result of getting the computed value of the border-top property on row_child.

                13. +

              13. Let border_right be the result of getting the computed value of the border-right property on row_child.

                14. +

              14. Let border_bottom be the result of getting the computed value of the border-bottom property on row_child.

                15. +

              15. Let border_left be the result of getting the computed value of the border-left property on row_child.

                16. + +
              16. +

                If border_top is not null return `table`.

                +
                + +
                +
                17. +
              17. +

                If border_right is not null return `table`.

                +
                + +
                +
                18. +
              18. +

                If border_bottom is not null return `table`.

                +
                + +
                +
                19. +
              19. +

                If border_left is not null return `table`.

                +
                + +
                +
                20. + +

              20. Let has_block_borders be true if border_top and border_bottom are both not null, otherwise false.

                21. +

              21. Let has_inline_borders be true if border_left and border_right are both not null, otherwise false.

                22. +
              22. +

                If either has_inline_borders or has_block_borders are true, increment cells_with_borders.

                +
                +
                  +
                • Firefox does not include this heuristic.
                  • +
                • Chrome
                  • +
                • WebKit
                  • +
                +
                +
                23. + +
              23. +

                If cells_with_borders is greater than 10, return `table`.

                +
                +
                  +
                • Firefox does not include this heuristic.
                  • +
                • Chrome
                  • +
                • WebKit
                  • +
                +
                +
                24. + +

              24. If border_top is not null increment cells_with_top_border.

                25. +

              25. If border_right is not null increment cells_with_right_border.

                26. +

              26. If border_bottom is not null increment cells_with_bottom_border.

                27. +

              27. If border_left is not null increment cells_with_left_border.

                28. + +

              28. Let cell_background be the result of getting the computed value of the background-color property on row_child.

                29. +

              29. If cell_background is not null, and is not equal to table_background, increment alternating_cell_color_count.

                30. +
              30. +

                If alternating_cell_color_count is greater than 10, return `table`.

                +
                +
                  +
                • Firefox does not include this heuristic.
                  • +
                • Chrome
                  • +
                • WebKit
                  • +
                +
                +
                31. +
              +
              3. +
            +
            8. +
          +
          2. +
        +
        2. +
      +
      7. +
    +
    23. +
  23. +

    If row_count is less than 2, return `html-layout-table`.

    +
    + +
    +
    24. +
  24. +

    If column_count is less than 2, return `html-layout-table`.

    +
    + +
    +
    25. +
  25. +

    If cell_count is less than 2, return `html-layout-table`.

    +
    +
      +
    • Firefox does not include this heuristic.
      • +
    • Chrome
      • +
    • WebKit
      • +
    +
    +
    26. +
  26. +

    Let minimum_styled_borders by the result of dividing cell_count by 2.

    +
    27. +
  27. +

    If the cells_with_borders is greater than or equal to minimum_styled_borders, return `table`.

    +
    +
      +
    • Firefox does not include this heuristic.
      • +
    • Chrome
      • +
    • WebKit
      • +
    +
    +
    28. +
  28. +

    If the cells_with_top_border is greater than or equal to minimum_styled_borders, return `table`.

    +
    +
      +
    • Firefox does not include this heuristic.
      • +
    • Chrome
      • +
    • WebKit
      • +
    +
    +
    29. +
  29. +

    If the cells_with_right_border is greater than or equal to minimum_styled_borders, return `table`.

    +
    +
      +
    • Firefox does not include this heuristic.
      • +
    • Chrome
      • +
    • WebKit
      • +
    +
    +
    30. +
  30. +

    If the cells_with_bottom_border is greater than or equal to minimum_styled_borders, return `table`.

    +
    +
      +
    • Firefox does not include this heuristic.
      • +
    • Chrome
      • +
    • WebKit
      • +
    +
    +
    31. +
  31. +

    If the cells_with_left_border is greater than or equal to minimum_styled_borders, return `table`.

    +
    +
      +
    • Firefox does not include this heuristic.
      • +
    • Chrome
      • +
    • WebKit
      • +
    +
    +
    32. +
  32. +

    If the result of getting the first element that is a descendants of element, whose local name is one of `embed`, `object`, `iframe`, is not null, return `html-layout-table`.

    +
    + +
    +
    33. +

  33. Return `html-layout-table`.

    34. +
+
@@ -16688,7 +17201,7 @@

Accessible Description Computation

-