@@ -464,40 +464,43 @@ Priority of Overlapping Highlights</h4>
464464<h4 id=highlight-types>
465465Highlight types</h4>
466466
467- A [=custom highlight=] 's {{Highlight/type}} attribute is used by authors to specify the semantic
468- meaning of the highlight. This allows assistive technologies to include this meaning when
469- exposing the highlight to users.
470-
471- A custom highlight will have a default type of {{HighlightType/highlight}} if its
472- {{Highlight/type}} attribute has not been explicitly set.
473-
474- Note: Authors should set a [=custom highlight=] 's {{Highlight/type}} to
475- {{HighlightType/spelling-error}} when that [=custom highlight=] is being used to emphasize
476- misspelled content. Authors should set a [=custom highlight=] 's {{Highlight/type}} to
477- {{HighlightType/grammar-error}} when that [=custom highlight=] is being used to emphasize
478- content that is grammatically incorrect. For all other use cases {{Highlight/type}} should
479- be left as {{HighlightType/highlight}} .
480-
481- UAs should make [=custom highlight=] s available to assistive technologies. When exposing a
482- highlight using a given platform accessibility API, UAs should expose the semantic meaning of
483- the highlight as specified by its {{Highlight/type}} attribute with as much specificity as
484- possible for that accessibility API.
485-
486- Note: For example, if a platform accessibility API has the capability to express spelling errors
487- and grammar errors specifically, then UAs should use these capabilities to convey the semantics
488- for highlights with {{HighlightType/spelling-error}} and {{HighlightType/spelling-error}} .
489- If an accessibility API only has the capability to express spelling errors, then UAs should
490- convey both highlights with {{HighlightType/spelling-error}} and with
491- {{HighlightType/grammar-error}} using spelling error semantics. If an accessibility API has
492- support for expressing neither spelling errors nor grammar errors, then UAs should expose all
493- highlights as generic {{HighlightType/highlight}} regardless of their actual {{Highlight/type}} .
494-
495- Note: This initial set of types was chosen because they are expected to be popular use cases
496- for Highlight API and there is some existing support for expressing their semantics in platform
497- accessibility APIs today. Accessibility APIs currently don't have any way to express the
498- specific semantics of other expected Highlight API use cases. More types may be added to
499- {{HighlightType}} as accessibility APIs gain support for expressing additional popular use
500- cases of Highlight API.
467+ A [=custom highlight=] 's {{Highlight/type}} attribute is used by authors
468+ to specify the semantic meaning of the highlight.
469+ This allows assistive technologies to include this meaning
470+ when exposing the highlight to users.
471+
472+ A custom highlight will have a default type of {{HighlightType/highlight}}
473+ if its {{Highlight/type}} attribute has not been explicitly set.
474+
475+ Note: Authors should set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/spelling-error}}
476+ when that [=custom highlight=] is being used to emphasize misspelled content.
477+ Authors should set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/grammar-error}}
478+ when that [=custom highlight=] is being used to emphasize content that is grammatically incorrect.
479+ For all other use cases {{Highlight/type}} should be left as {{HighlightType/highlight}} .
480+
481+ UAs should make [=custom highlight=] s available to assistive technologies.
482+ When exposing a highlight using a given platform accessibility API,
483+ UAs should expose the semantic meaning of the highlight
484+ as specified by its {{Highlight/type}} attribute
485+ with as much specificity as possible for that accessibility API.
486+
487+ Note: For example,
488+ if a platform accessibility API has the capability to express spelling errors and grammar errors specifically,
489+ then UAs should use these capabilities to convey the semantics for highlights
490+ with {{HighlightType/spelling-error}} and {{HighlightType/spelling-error}} .
491+ If an accessibility API only has the capability to express spelling errors,
492+ then UAs should convey both highlights with {{HighlightType/spelling-error}}
493+ and with {{HighlightType/grammar-error}} using spelling error semantics.
494+ If an accessibility API has support for expressing neither spelling errors nor grammar errors,
495+ then UAs should expose all highlights as generic {{HighlightType/highlight}} regardless of their actual {{Highlight/type}} .
496+
497+ Note: This initial set of types was chosen
498+ because they are expected to be popular use cases for Highlight API
499+ and there is some existing support for expressing their semantics in platform accessibility APIs today.
500+ Accessibility APIs currently don't have any way to express the specific semantics
501+ of other expected Highlight API use cases.
502+ More types may be added to {{HighlightType}}
503+ as accessibility APIs gain support for expressing additional popular use cases of Highlight API.
501504
502505<h2 id=responding-to-changes>
503506Responding to Changes</h2>
0 commit comments