Skip to content

Commit 654ac26

Browse files
committed
[css-pseudo] Minor wording clarifications
1 parent 2311c7c commit 654ac26

2 files changed

Lines changed: 17 additions & 10 deletions

File tree

css-pseudo/Overview.bs

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -475,7 +475,7 @@ Styling Highlights</h3>
475475
only 'color' and 'background-color' have been interoperably supported.
476476

477477
If 'color' is not specified, the text (and text decoration)'s
478-
unselected color must be used for the highlight.
478+
unselected color must be used for the highlighted text.
479479
(As usual, the initial 'background-color' is ''transparent''.)
480480
Issue: Can we reuse ''currentColor'' for this, now that it computes to itself?
481481

@@ -497,11 +497,11 @@ Styling Highlights</h3>
497497
<h3 id=highlight-bounds>
498498
Area of a Highlight</h3>
499499

500-
<p>For each type of highlighting
501-
there exists a <dfn>highlight overlay</dfn>,
500+
<p>For each type of highlighting (see [[#highlight-selectors]])
501+
there exists a single <dfn>highlight overlay</dfn> for the entire document,
502502
the active portions of which are represented
503503
by the corresponding <a>highlight pseudo-element</a>.
504-
Each box owns a piece of the overlay corresponding to any text or replaced content
504+
Each box owns the piece of the overlay corresponding to any text or replaced content
505505
directly contained by the box.
506506

507507
<ul>
@@ -534,7 +534,7 @@ Cascading and Per-Element Highlight Styles</h3>
534534

535535
Each element draws its own portion of the <a>highlight overlay</a>,
536536
which receives the styles specified by the <a>highlight pseudo-element</a> styles
537-
for which it or one of its ancestors is the <i>originating element</i>.
537+
for which that element or one of its ancestors is the <a>originating element</a>.
538538
When multiple styles conflict,
539539
the winning style is the one belonging to the innermost element
540540
after cascading.

css-pseudo/Overview.html

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -505,7 +505,7 @@ <h3 class="heading settled" data-level="3.2" id="highlight-styling"><span class=
505505
<p class="note" role="note">Note: Historically (and at the time of writing)
506506
only <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-color-3/#color0">color</a> and <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-backgrounds-3/#background-color">background-color</a> have been interoperably supported.</p>
507507
<p>If <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-color-3/#color0">color</a> is not specified, the text (and text decoration)'s
508-
unselected color must be used for the highlight.
508+
unselected color must be used for the highlighted text.
509509
(As usual, the initial <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-backgrounds-3/#background-color">background-color</a> is <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-color-4/#valdef-color-transparent">transparent</a>.)
510510
Issue: Can we reuse <span class="css">currentColor</span> for this, now that it computes to itself?</p>
511511
<p>The UA should use the OS-default highlight colors
@@ -520,11 +520,11 @@ <h3 class="heading settled" data-level="3.2" id="highlight-styling"><span class=
520520
Note: Because <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-text-decor-3/#propdef-text-emphasis-color">text-emphasis-color</a> defaults to <span class="css">currrentColor</span>,
521521
it will by default also set the color of the the emphasis marks.</p>
522522
<h3 class="heading settled" data-level="3.3" id="highlight-bounds"><span class="secno">3.3. </span><span class="content"> Area of a Highlight</span><a class="self-link" href="#highlight-bounds"></a></h3>
523-
<p>For each type of highlighting
524-
there exists a <dfn data-dfn-type="dfn" data-noexport="" id="highlight-overlay">highlight overlay<a class="self-link" href="#highlight-overlay"></a></dfn>,
523+
<p>For each type of highlighting (see <a href="#highlight-selectors">§3.1 Selecting Highlighted Content: the ::selection, ::spelling-error, and ::grammar-error pseudo-elements</a>)
524+
there exists a single <dfn data-dfn-type="dfn" data-noexport="" id="highlight-overlay">highlight overlay<a class="self-link" href="#highlight-overlay"></a></dfn> for the entire document,
525525
the active portions of which are represented
526526
by the corresponding <a data-link-type="dfn" href="#highlight-pseudo-elements">highlight pseudo-element</a>.
527-
Each box owns a piece of the overlay corresponding to any text or replaced content
527+
Each box owns the piece of the overlay corresponding to any text or replaced content
528528
directly contained by the box. </p>
529529
<ul>
530530
<li> For text, the corresponding overlay must cover at least the entire em box
@@ -542,7 +542,7 @@ <h3 class="heading settled" data-level="3.3" id="highlight-bounds"><span class="
542542
<h3 class="heading settled" data-level="3.4" id="highlight-cascade"><span class="secno">3.4. </span><span class="content"> Cascading and Per-Element Highlight Styles</span><a class="self-link" href="#highlight-cascade"></a></h3>
543543
<p>Each element draws its own portion of the <a data-link-type="dfn" href="#highlight-overlay">highlight overlay</a>,
544544
which receives the styles specified by the <a data-link-type="dfn" href="#highlight-pseudo-elements">highlight pseudo-element</a> styles
545-
for which it or one of its ancestors is the <i>originating element</i>.
545+
for which that element or one of its ancestors is the <a data-link-type="dfn" href="https://drafts.csswg.org/selectors-4/#originating-element">originating element</a>.
546546
When multiple styles conflict,
547547
the winning style is the one belonging to the innermost element
548548
after cascading.</p>
@@ -1023,6 +1023,11 @@ <h3 class="no-num heading settled" id="index-defined-elsewhere"><span class="con
10231023
<ul>
10241024
<li><a href="https://html.spec.whatwg.org/multipage/browsers.html#window">Window</a>
10251025
</ul>
1026+
<li>
1027+
<a data-link-type="biblio" href="#biblio-selectors-4">[selectors-4]</a> defines the following terms:
1028+
<ul>
1029+
<li><a href="https://drafts.csswg.org/selectors-4/#originating-element">originating element</a>
1030+
</ul>
10261031
</ul>
10271032
<h2 class="no-num heading settled" id="references"><span class="content">References</span><a class="self-link" href="#references"></a></h2>
10281033
<h3 class="no-num heading settled" id="normative"><span class="content">Normative References</span><a class="self-link" href="#normative"></a></h3>
@@ -1067,6 +1072,8 @@ <h3 class="no-num heading settled" id="normative"><span class="content">Normativ
10671072
<dd>Document Object Model URL: <a href="https://dom.spec.whatwg.org/">https://dom.spec.whatwg.org/</a>
10681073
<dt id="biblio-rfc2119"><a class="self-link" href="#biblio-rfc2119"></a>[RFC2119]
10691074
<dd>S. Bradner. <a href="https://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>. March 1997. Best Current Practice. URL: <a href="https://tools.ietf.org/html/rfc2119">https://tools.ietf.org/html/rfc2119</a>
1075+
<dt id="biblio-selectors-4"><a class="self-link" href="#biblio-selectors-4"></a>[SELECTORS-4]
1076+
<dd>Selectors Level 4 URL: <a href="http://www.w3.org/TR/selectors4/">http://www.w3.org/TR/selectors4/</a>
10701077
<dt id="biblio-selectors4"><a class="self-link" href="#biblio-selectors4"></a>[SELECTORS4]
10711078
<dd>Elika Etemad; Tab Atkins Jr.. <a href="http://www.w3.org/TR/selectors4/">Selectors Level 4</a>. 2 May 2013. WD. URL: <a href="http://www.w3.org/TR/selectors4/">http://www.w3.org/TR/selectors4/</a>
10721079
</dl>

0 commit comments

Comments
 (0)