@@ -472,11 +472,11 @@ Highlight types</h4>
472
472
A custom highlight will have a default type of {{HighlightType/highlight}}
473
473
if its {{Highlight/type}} attribute has not been explicitly set.
474
474
475
- Note: Authors should set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/spelling-error}}
475
+ Note: Authors are advised to set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/spelling-error}}
476
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}}
477
+ Authors are advised to set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/grammar-error}}
478
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}} .
479
+ For all other use cases {{Highlight/type}} is best left as {{HighlightType/highlight}} .
480
480
481
481
UAs should make [=custom highlight=] s available to assistive technologies.
482
482
When exposing a highlight using a given platform accessibility API,
@@ -486,20 +486,20 @@ Highlight types</h4>
486
486
487
487
Note: For example,
488
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
489
+ then UAs is expected to use these capabilities to convey the semantics for highlights
490
490
with {{HighlightType/spelling-error}} and {{HighlightType/spelling-error}} .
491
491
If an accessibility API only has the capability to express spelling errors,
492
- then UAs should convey both highlights with {{HighlightType/spelling-error}}
492
+ then UAs would be expected to convey both highlights with {{HighlightType/spelling-error}}
493
493
and with {{HighlightType/grammar-error}} using spelling error semantics.
494
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}} .
495
+ then UAs would expose all highlights as generic {{HighlightType/highlight}} regardless of their actual {{Highlight/type}} .
496
496
497
497
Note: This initial set of types was chosen
498
498
because they are expected to be popular use cases for Highlight API
499
499
and there is some existing support for expressing their semantics in platform accessibility APIs today.
500
500
Accessibility APIs currently don't have any way to express the specific semantics
501
501
of other expected Highlight API use cases.
502
- More types may be added to {{HighlightType}}
502
+ More types could later be added to {{HighlightType}}
503
503
as accessibility APIs gain support for expressing additional popular use cases of Highlight API.
504
504
505
505
<h2 id=responding-to-changes>
0 commit comments