Skip to content

[css-highlight-api-1] Add i18n warning about placement of range endpoints in text #8647

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sanketj merged 4 commits into from
Mar 28, 2023
Merged

[css-highlight-api-1] Add i18n warning about placement of range endpoints in text #8647

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7e81e00
[css-highlight-api-1] Add i18n warning about placement of range endpo…
sanketj Mar 27, 2023
8177cde
Update css-highlight-api-1/Overview.bs
sanketj Mar 27, 2023
ac167c7
Formatting and grammar fixup.
sanketj Mar 27, 2023
99d9a6c
Grammar and bikeshed fixup.
sanketj Mar 27, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions css-highlight-api-1/Overview.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,13 @@ Creating Custom Highlights</h3>
authors can chose between using {{Range}} objects and {{StaticRange}} objects.
See [[#range-invalidation]] for more details about this choice and its implications.

Note: When creating {{Range}} objects for use in [=custom highlights=], it is
suggested that authors avoid placing [=range=] endpoints in the middle of a [=grapheme=],
such as when a visible unit of text is comprised of multiple [=Unicode code points=].
Doing so can create undesirable highlighting effects, such as highlighting only part of
an Indic syllable. In addition, care needs to be taken to avoid placing an endpoint
in the middle of a [=supplementary character=].

<xmp class="idl">
enum HighlightType {
"highlight",
Expand Down