Skip to content

Commit 73ee458

Browse files
authored
[selectors-4] Fix bikeshed warnings (#10750)
1 parent dff3cfb commit 73ee458

File tree

1 file changed

+15
-14
lines changed

1 file changed

+15
-14
lines changed

selectors-4/Overview.bs

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -37,11 +37,12 @@ spec:css-pseudo-4; type:selector;
3737
text: ::after
3838
text: ::first-line
3939
text: ::first-letter
40+
spec:dom; type:dfn; text:descendant
41+
spec:html; type:dfn; text:muted
4042
spec:html; type:element-attr; for:a; text:href
4143
spec:html; type:element;
4244
text:meta
4345
text:audio
44-
4546
</pre>
4647

4748
<style>
@@ -528,7 +529,7 @@ Structure and Terminology</h3>
528529

529530
A <dfn id="compound" export>compound selector</dfn>
530531
is a sequence of <a>simple selectors</a>
531-
that are not separated by a <a>combinator</a>,
532+
that are not separated by a <a for=selector>combinator</a>,
532533
and represents a set of simultaneous conditions on a single element.
533534
If it contains a <a>type selector</a> or <a>universal selector</a>,
534535
that selector must come first in the sequence.
@@ -547,7 +548,7 @@ Structure and Terminology</h3>
547548
optionally followed by additional [=pseudo-class=] selectors,
548549
and optionally preceded by a [=compound selector=]
549550
or another [=pseudo-compound selector=],
550-
without any [=combinators=].
551+
without any [=selector/combinators=].
551552
(A <a>pseudo-compound selector</a> is represented by <<pseudo-compound-selector>>
552553
in the selectors <a href="#grammar">grammar</a>.)
553554
A [=pseudo-element=] [=matches=] a [=pseudo-compound selector=]
@@ -572,7 +573,7 @@ Structure and Terminology</h3>
572573
Note: A [=pseudo-compound selector=] <strong>is not</strong>
573574
a [=compound selector=],
574575
and can't be used in places that expect a [=compound selector=] only.
575-
[=Pseudo-compound selectors=] act as if they carry a [=combinator=] with themselves,
576+
[=Pseudo-compound selectors=] act as if they carry a [=selector/combinator=] with themselves,
576577
expressing their relationship with their [=originating element=],
577578
just as the ''>'' combinator
578579
expresses a relationship with a parent element.
@@ -585,16 +586,16 @@ Structure and Terminology</h3>
585586
the <a>child combinator</a> (U+003E, <code>></code>),
586587
the <a>next-sibling combinator</a> (U+002B, <code>+</code>),
587588
and the <a>subsequent-sibling combinator</a> (U+007E, <code>~</code>).
588-
Two given elements are said to <a>match</a> a <a>combinator</a>
589+
Two given elements are said to <a>match</a> a <a for=selector>combinator</a>
589590
when the condition of relationship between these elements is true.
590591

591592
A <dfn id="complex" export>complex selector</dfn> is
592593
a sequence of one or more <a>compound selectors</a>
593594
and/or [=pseudo-compound selectors=],
594-
with [=compound selectors=] separated by <a>combinators</a>.
595+
with [=compound selectors=] separated by <a for=selector>combinators</a>.
595596
It represents a set of simultaneous conditions
596597
on a set of elements in the particular relationships
597-
described by its <a>combinators</a>.
598+
described by its <a for=selector>combinators</a>.
598599
(Complex selectors are represented by <<complex-selector>>
599600
in the selectors <a href="#grammar">grammar</a>.)
600601
A given element or pseudo-element
@@ -712,7 +713,7 @@ Relative Selectors</h3>
712713
Certain contexts may accept <dfn lt="relative selector" local-lt="relative" export>relative selectors</dfn>,
713714
which are a shorthand for selectors that represent elements relative to one or more
714715
<dfn export local-lt="anchor element">relative selector anchor elements</dfn>.
715-
Relative selectors begin with a <a>combinator</a>,
716+
Relative selectors begin with a <a for=selector>combinator</a>,
716717
with a selector representing the [=anchor element=]
717718
implied at the start of the selector.
718719
(If no combinator is present,
@@ -916,7 +917,7 @@ Internal Structure</h4>
916917
Some <a>pseudo-elements</a> are defined to have internal structure.
917918
These <a>pseudo-elements</a> may be followed by child/descendant combinators
918919
to express those relationships.
919-
Selectors containing <a>combinators</a> after the pseudo-element
920+
Selectors containing <a for=selector>combinators</a> after the pseudo-element
920921
are otherwise invalid.
921922

922923
<div class="example">
@@ -1133,7 +1134,7 @@ The Matches-Any Pseudo-class: '':is()''</h3>
11331134
they are not valid within '':is()''.
11341135

11351136
Default namespace declarations do not affect the <a>compound selector</a>
1136-
representing the <a>subject</a> of any selector
1137+
representing the <a for=selector>subject</a> of any selector
11371138
within a '':is()'' pseudo-class,
11381139
unless that compound selector contains
11391140
an explicit <a>universal selector</a> or <a>type selector</a>.
@@ -1171,7 +1172,7 @@ The Negation (Matches-None) Pseudo-class: '':not()''</h3>
11711172

11721173
Note: The specificity of the '':not()'' pseudo-class
11731174
is replaced by the specificity of the most specific selector in its argument;
1174-
thus it has the exact behavior of '':not(:is(<var>argument</var>))''.
1175+
thus it has the exact behavior of '':not(:is(<var ignore>argument</var>))''.
11751176
See [[#specificity-rules]].
11761177

11771178
Pseudo-elements cannot be represented by the negation pseudo-class;
@@ -1195,7 +1196,7 @@ The Negation (Matches-None) Pseudo-class: '':not()''</h3>
11951196

11961197
As with '':is()'',
11971198
default namespace declarations do not affect the <a>compound selector</a>
1198-
representing the <a>subject</a> of any selector
1199+
representing the <a for=selector>subject</a> of any selector
11991200
within a '':not()'' pseudo-class,
12001201
unless that compound selector contains
12011202
an explicit <a>universal selector</a> or <a>type selector</a>.
@@ -1978,7 +1979,7 @@ The Language Pseudo-class: '':lang()''</h3>
19781979

19791980
Note: The <a>content language</a> of an element is defined by the document language.
19801981

1981-
For example, in HTML [[HTML5]], the <a>content language</a> is determined
1982+
For example, in HTML [[HTML5]], the <a>content language</a> is determined
19821983
by a combination of the <code>lang</code> attribute,
19831984
information from <a element>meta</a> elements,
19841985
and possibly also the protocol (e.g. from HTTP headers).
@@ -3839,7 +3840,7 @@ Match a Selector Against an Element</h3>
38393840
complex selector, return success.
38403841

38413842
<li>Otherwise, consider all possible elements
3842-
that could be related to this element by the rightmost <a>combinator</a>.
3843+
that could be related to this element by the rightmost <a for=selector>combinator</a>.
38433844
If the operation of matching the selector consisting of this selector
38443845
with the rightmost compound selector and rightmost combinator removed
38453846
against any one of these elements returns success, then return success.

0 commit comments

Comments
 (0)