From cbe5c02eec0238767ded4cc18fb27ec0615c93c7 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Wed, 11 Dec 2019 12:29:55 -0500 Subject: [PATCH 01/10] Add mark role Closes issue #508 --- index.html | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) diff --git a/index.html b/index.html index 8b1b896d4..9e0f49a01 100644 --- a/index.html +++ b/index.html @@ -4832,6 +4832,88 @@

Definition of Roles

+
+ mark +
+

A mark contains a run of content, marked or highlighted to indicate that other content refers to it, or to indicate special relevance to the user's current activity.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Characteristics:
CharacteristicValue
Is Abstract: 
Superclass Role:section
Base Concept: 
Related Concepts:<mark> in [[HTML]]
Required Context Role: 
Required Owned Elements: 
Required States and Properties: 
Supported States and Properties:
Inherited States and Properties:Placeholder
Prohibited States and Properties: +
    +
  • aria-label
    • +
  • aria-labelledby
    • +
+
Name From:prohibited
Accessible Name Required: 
Inherits Name Required: 
Children Presentational: 
Inherits Presentational: 
+
marquee
From 0dbe15e3970a358ecee4a58e33b7429b297db9d5 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Wed, 11 Dec 2019 13:17:57 -0500 Subject: [PATCH 02/10] Fix tabs --- index.html | 164 ++++++++++++++++++++++++++--------------------------- 1 file changed, 82 insertions(+), 82 deletions(-) diff --git a/index.html b/index.html index 9e0f49a01..3455cd1ee 100644 --- a/index.html +++ b/index.html @@ -4832,88 +4832,88 @@

Definition of Roles

-
- mark -
-

A mark contains a run of content, marked or highlighted to indicate that other content refers to it, or to indicate special relevance to the user's current activity.

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Characteristics:
CharacteristicValue
Is Abstract: 
Superclass Role:section
Base Concept: 
Related Concepts:<mark> in [[HTML]]
Required Context Role: 
Required Owned Elements: 
Required States and Properties: 
Supported States and Properties:
Inherited States and Properties:Placeholder
Prohibited States and Properties: -
    -
  • aria-label
    • -
  • aria-labelledby
    • -
-
Name From:prohibited
Accessible Name Required: 
Inherits Name Required: 
Children Presentational: 
Inherits Presentational: 
-
+
+ mark +
+

A mark contains a run of content, marked or highlighted to indicate that other content refers to it, or to indicate special relevance to the user's current activity.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Characteristics:
CharacteristicValue
Is Abstract: 
Superclass Role:section
Base Concept: 
Related Concepts:<mark> in [[HTML]]
Required Context Role: 
Required Owned Elements: 
Required States and Properties: 
Supported States and Properties:
Inherited States and Properties:Placeholder
Prohibited States and Properties: +
    +
  • aria-label
    • +
  • aria-labelledby
    • +
+
Name From:prohibited
Accessible Name Required: 
Inherits Name Required: 
Children Presentational: 
Inherits Presentational: 
+
marquee
From 7d2691455e0cd55d3c758dceb1aa502c7ee8c18a Mon Sep 17 00:00:00 2001 From: James Nurthen Date: Fri, 3 Jan 2020 14:57:39 -0800 Subject: [PATCH 03/10] Fix tabs --- index.html | 150 ++++++++++++++++++++++++++--------------------------- 1 file changed, 75 insertions(+), 75 deletions(-) diff --git a/index.html b/index.html index 3455cd1ee..dd7129929 100644 --- a/index.html +++ b/index.html @@ -4835,83 +4835,83 @@

Definition of Roles

mark
-

A mark contains a run of content, marked or highlighted to indicate that other content refers to it, or to indicate special relevance to the user's current activity.

+

A mark contains a run of content, marked or highlighted to indicate that other content refers to it, or to indicate special relevance to the user's current activity.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Characteristics:
CharacteristicValue
Is Abstract: 
Superclass Role:section
Base Concept: 
Related Concepts:<mark> in [[HTML]]
Required Context Role: 
Required Owned Elements: 
Required States and Properties: 
Supported States and Properties:
Inherited States and Properties:Placeholder
Prohibited States and Properties: -
    -
  • aria-label
    • -
  • aria-labelledby
    • -
-
Name From:prohibited
Accessible Name Required: 
Inherits Name Required: 
Children Presentational: 
Inherits Presentational: 
Characteristics:
CharacteristicValue
Is Abstract: 
Superclass Role:section
Base Concept: 
Related Concepts:<mark> in [[HTML]]
Required Context Role: 
Required Owned Elements: 
Required States and Properties: 
Supported States and Properties:
Inherited States and Properties:Placeholder
Prohibited States and Properties: +
    +
  • aria-label
    • +
  • aria-labelledby
    • +
+
Name From:prohibited
Accessible Name Required: 
Inherits Name Required: 
Children Presentational: 
Inherits Presentational: 
From 9f3860c4ee7582b98b1deb55283954cf9a58df71 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Mon, 6 Jan 2020 16:02:01 -0500 Subject: [PATCH 04/10] Match HTML's description of mark element --- index.html | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index 3455cd1ee..699dfae7a 100644 --- a/index.html +++ b/index.html @@ -4835,7 +4835,9 @@

Definition of Roles

mark
-

A mark contains a run of content, marked or highlighted to indicate that other content refers to it, or to indicate special relevance to the user's current activity.

+

+ The mark element represents a run of text in one document marked or highlighted for reference purposes, due to its relevance in another context. When used in a quotation or other block of text referred to from the prose, it indicates a highlight that was not originally present but which has been added to bring the reader's attention to a part of the text that might not have been considered important by the original author when the block was originally written, but which is now under previously unexpected scrutiny. When used in the main prose of a document, it indicates a part of the document that has been highlighted due to its likely relevance to the user's current activity. +

From 52f401267cb0c946655dcfe08e78f70dc03c0e40 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Mon, 6 Jan 2020 16:06:46 -0500 Subject: [PATCH 05/10] Add to role categorization section --- index.html | 1 + 1 file changed, 1 insertion(+) diff --git a/index.html b/index.html index 79375b82c..ece641ff0 100644 --- a/index.html +++ b/index.html @@ -656,6 +656,7 @@

Document Structure Roles

  • legend
  • list
  • listitem
    • +
  • mark
  • math
  • meter
  • none
    • From 0bf22ccb831170a946fe35ef7b41f78c70738aa0 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Tue, 7 Jan 2020 11:57:18 -0500 Subject: [PATCH 06/10] First paragraph should only be 1-2 sentences so that automatic role summary works --- index.html | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index ece641ff0..ff0808ecc 100644 --- a/index.html +++ b/index.html @@ -4836,9 +4836,8 @@

    Definition of Roles

    mark
    -

    - The mark element represents a run of text in one document marked or highlighted for reference purposes, due to its relevance in another context. When used in a quotation or other block of text referred to from the prose, it indicates a highlight that was not originally present but which has been added to bring the reader's attention to a part of the text that might not have been considered important by the original author when the block was originally written, but which is now under previously unexpected scrutiny. When used in the main prose of a document, it indicates a part of the document that has been highlighted due to its likely relevance to the user's current activity. -

    +

    The mark element represents a run of text in one document marked or highlighted for reference purposes, due to its relevance in another context.

    +

    When used in a quotation or other block of text referred to from the prose, it indicates a highlight that was not originally present but which has been added to bring the reader's attention to a part of the text that might not have been considered important by the original author when the block was originally written, but which is now under previously unexpected scrutiny. When used in the main prose of a document, it indicates a part of the document that has been highlighted due to its likely relevance to the user's current activity.

    Characteristics:
    From 3e1f8fa70965ba44f5bcbd9cfe95c4840a0a32c2 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Thu, 9 Jan 2020 14:54:05 -0500 Subject: [PATCH 07/10] Improved wording inspired by MDN --- index.html | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index ff0808ecc..06ae022d3 100644 --- a/index.html +++ b/index.html @@ -4836,8 +4836,13 @@

    Definition of Roles

    mark
    -

    The mark element represents a run of text in one document marked or highlighted for reference purposes, due to its relevance in another context.

    -

    When used in a quotation or other block of text referred to from the prose, it indicates a highlight that was not originally present but which has been added to bring the reader's attention to a part of the text that might not have been considered important by the original author when the block was originally written, but which is now under previously unexpected scrutiny. When used in the main prose of a document, it indicates a part of the document that has been highlighted due to its likely relevance to the user's current activity.

    +

    Content which is marked or highlighted for reference or notation purposes, due to the content's relevance in the enclosing context.

    +

    Example uses for mark include:

    +
      +
    • Highlighting text in a quotation which is of special interest but is not marked in the original source material, comparable using a highlighter pen to mark passages of a print article.
      • +
    • Indicating portions of the content that are relevant to the user's current activity, such as highlighting text matches found by an page-implemented search feature.
      • +
    +

    Don't use mark for purely decorative styling such as syntax highlighting.

    Characteristics:
    From ea122a6681bc6eaed2723491c6b968009c93a54e Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 10 Jan 2020 11:40:26 -0500 Subject: [PATCH 08/10] Update index.html Co-Authored-By: Carolyn MacLeod --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 06ae022d3..41551830c 100644 --- a/index.html +++ b/index.html @@ -4840,7 +4840,7 @@

    Definition of Roles

    Example uses for mark include:

    • Highlighting text in a quotation which is of special interest but is not marked in the original source material, comparable using a highlighter pen to mark passages of a print article.
      • -
    • Indicating portions of the content that are relevant to the user's current activity, such as highlighting text matches found by an page-implemented search feature.
      • +
    • Indicating portions of the content that are relevant to the user's current activity, such as highlighting text matches found by a search feature.

    Don't use mark for purely decorative styling such as syntax highlighting.

    From f7c4e33991e1fef0ac7fa49e5056ecb3797b91b1 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 10 Jan 2020 11:40:43 -0500 Subject: [PATCH 09/10] Update index.html Co-Authored-By: Carolyn MacLeod --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 41551830c..1bc930e6f 100644 --- a/index.html +++ b/index.html @@ -4839,7 +4839,7 @@

    Definition of Roles

    Content which is marked or highlighted for reference or notation purposes, due to the content's relevance in the enclosing context.

    Example uses for mark include:

      -
    • Highlighting text in a quotation which is of special interest but is not marked in the original source material, comparable using a highlighter pen to mark passages of a print article.
      • +
    • Highlighting text in a quotation which is of special interest but is not marked in the original source material, comparable to using a highlighter pen to mark passages of a print article.
    • Indicating portions of the content that are relevant to the user's current activity, such as highlighting text matches found by a search feature.

    Don't use mark for purely decorative styling such as syntax highlighting.

    From 90248abc235d4cf8849c7b3bfc96c94c6db3dc98 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 10 Jan 2020 15:20:19 -0500 Subject: [PATCH 10/10] Address Joanie's comments --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 06ae022d3..da1f9d5b8 100644 --- a/index.html +++ b/index.html @@ -4837,12 +4837,12 @@

    Definition of Roles

    mark

    Content which is marked or highlighted for reference or notation purposes, due to the content's relevance in the enclosing context.

    -

    Example uses for mark include:

    +

    Example uses for mark include:

    • Highlighting text in a quotation which is of special interest but is not marked in the original source material, comparable using a highlighter pen to mark passages of a print article.
    • Indicating portions of the content that are relevant to the user's current activity, such as highlighting text matches found by an page-implemented search feature.
    -

    Don't use mark for purely decorative styling such as syntax highlighting.

    +

    Authors SHOULD NOT use mark for purely decorative styling such as syntax highlighting.

    Characteristics:
    Characteristics: