Skip to content

Commit 6326b4c

Browse files
committed
[cssom] Linkify some stuff in the serialization section.
And add an issue about <url> serialization, which is not right.
1 parent 5539796 commit 6326b4c

File tree

1 file changed

+21
-19
lines changed

1 file changed

+21
-19
lines changed

cssom-1/Overview.bs

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2578,13 +2578,13 @@ depends on the component, as follows:
25782578
<dd>The keyword
25792579
<a lt="ASCII lowercase">converted to ASCII lowercase</a>.
25802580

2581-
<dt>&lt;angle>
2581+
<dt><<angle>>
25822582
<dd>
25832583
The &lt;number> component serialized as per &lt;number> followed by the unit in canonical form as defined in its respective specification.
25842584

25852585
Issue: Probably should distinguish between specified and computed / resolved values.
25862586

2587-
<dt>&lt;color>
2587+
<dt><<color>>
25882588
<dd>
25892589
If &lt;color&gt; is a component of a resolved or computed value, then
25902590
return the color using the <code>rgb()</code> or <code>rgba()</code> functional
@@ -2620,7 +2620,7 @@ depends on the component, as follows:
26202620

26212621
In the above rules, the string "<code>, </code>" denotes a COMMA (U+002C) followed by a single SPACE (U+0020).
26222622

2623-
If &lt;color&gt; is a component of a specified value, then
2623+
If <<color>> is a component of a specified value, then
26242624
return the color as follows:
26252625
<ol>
26262626
<li>If the color was explicitly specified by the author, then return the original, author specified color value.
@@ -2629,7 +2629,7 @@ depends on the component, as follows:
26292629

26302630
Issue: Should author specified values be normalized for case? Or should original case be preserved?
26312631

2632-
<dt>&lt;alphavalue>
2632+
<dt><<alphavalue>>
26332633
<dd>
26342634
If the value is internally represented as an integer between 0 and 255 inclusive (i.e. 8-bit unsigned integer),
26352635
follow these steps:
@@ -2646,7 +2646,7 @@ depends on the component, as follows:
26462646

26472647
Otherwise, return the result of serializing the given value as a &lt;number>.
26482648

2649-
<dt>&lt;counter>
2649+
<dt><<counter>>
26502650
<dd>
26512651
The return value of the following algorithm:
26522652
<ol>
@@ -2663,28 +2663,28 @@ depends on the component, as follows:
26632663
</ol>
26642664

26652665

2666-
<dt>&lt;frequency>
2666+
<dt><<frequency>>
26672667
<dd>
26682668
The &lt;number> component serialized as per &lt;number> followed by the unit in its canonical form as defined in its respective specification.
26692669

26702670
Issue: Probably should distinguish between specified and computed / resolved values.
26712671

2672-
<dt>&lt;identifier>
2672+
<dt><<identifier>>
26732673
<dd>The identifier
26742674
<a lt="serialize an identifier">serialized as an identifier</a>.
26752675

2676-
<dt>&lt;integer>
2676+
<dt><<integer>>
26772677
<dd>A base-ten integer using digits 0-9 (U+0030 to U+0039) in the
26782678
shortest form possible, preceded by "<code>-</code>" (U+002D) if it is
26792679
negative.
26802680

2681-
<dt>&lt;length>
2681+
<dt><<length>>
26822682
<dd>
26832683
The &lt;number> component serialized as per &lt;number> followed by the unit in its canonical form as defined in its respective specification.
26842684

26852685
Issue: Probably should distinguish between specified and computed / resolved values.
26862686

2687-
<dt>&lt;number>
2687+
<dt><<number>>
26882688
<dd>
26892689
A base-ten number using digits 0-9 (U+0030 to U+0039) in the shortest form possible,
26902690
using "<code>.</code>" to separate decimals (if any),
@@ -2693,20 +2693,20 @@ depends on the component, as follows:
26932693

26942694
Note: scientific notation is not used.
26952695

2696-
<dt>&lt;percentage>
2696+
<dt><<percentage>>
26972697
<dd>The &lt;number> component serialized as per &lt;number> followed
26982698
by the literal string "<code>%</code>" (U+0025).
26992699

2700-
<dt>&lt;resolution>
2700+
<dt><<resolution>>
27012701
<dd>The resolution in dots per <a lt=px value>CSS pixel</a> serialized as per
27022702
&lt;number> followed by the literal string "<code>dppx</code>".
27032703

2704-
<dt>&lt;ratio>
2704+
<dt><<ratio>>
27052705
<dd>The numerator serialized as per &lt;number>
27062706
followed by the literal string "<code> / </code>",
27072707
followed by the denominator serialized as per &lt;number>.
27082708

2709-
<dt>&lt;shape>
2709+
<dt><<shape>>
27102710
<dd>
27112711
The return value of the following algorithm:
27122712
<ol>
@@ -2719,19 +2719,21 @@ depends on the component, as follows:
27192719
</ol>
27202720

27212721

2722-
<dt>&lt;string>
2723-
<dt>&lt;family-name>
2724-
<dt>&lt;specific-voice>
2722+
<dt><<string>>
2723+
<dt><<family-name>>
2724+
<dt><<specific-voice>>
27252725
<dd>The string
27262726
<a lt="serialize a string">serialized as a string</a>.
27272727

2728-
<dt>&lt;time>
2728+
<dt><<time>>
27292729
<dd>The time in seconds serialized as per &lt;number> followed by
27302730
the literal string "<code>s</code>".
27312731

2732-
<dt>&lt;uri>
2732+
<dt><<url>>
27332733
<dd>The <a>absolute-URL string</a>
27342734
<a lt="serialize a URL">serialized as URL</a>.
2735+
2736+
Issue: This should differentiate specified and computed <<url>> values, see <a href="https://github.com/w3c/csswg-drafts/issues/3195">#3195</a>.
27352737
</dl>
27362738

27372739

0 commit comments

Comments
 (0)