Skip to content

Commit dea0c10

Browse files
committed
[css-highlights-api] Rewrap some text
See https://rhodesmill.org/brandon/2012/one-sentence-per-line/
1 parent 6202be2 commit dea0c10

File tree

1 file changed

+37
-34
lines changed

1 file changed

+37
-34
lines changed

css-highlight-api-1/Overview.bs

Lines changed: 37 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -464,40 +464,43 @@ Priority of Overlapping Highlights</h4>
464464
<h4 id=highlight-types>
465465
Highlight 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>
503506
Responding to Changes</h2>

0 commit comments

Comments
 (0)