8000 Use dfn elements for <alphavalue>, <color>, transparent, and currentC… · w3c/csswg-drafts@a244d0b · GitHub
Skip to content

Commit a244d0b

Browse files
dbarondbaron
committed
Use dfn elements for <alphavalue>, <color>, transparent, and currentColor, and get a bunch of free hyperlinks as a result.
1 parent e4176fc commit a244d0b

2 files changed

Lines changed: 69 additions & 50 deletions

File tree

‎css3-color/Overview.html‎

Lines changed: 65 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -480,9 +480,10 @@ <h3 id=foreground><span class=secno>3.1. </span>Foreground color: the
480480
e.g. <span class=example>six digit hex value or rgb(...) functional
481481
value</span>, with an alpha value of 1.
482482

483-
<li>The computed value of the keyword &lsquo;<code class=css><span
484-
class=index-inst id=transparent0>transparent</span></code>&rsquo; is
485-
the quadruplet of all zero numerical RGBA values, e.g. <span
483+
<li>The computed value of the keyword &lsquo;<code class=css><a
484+
href="#transparent-def"><span class=index-inst
485+
id=transparent0>transparent</span></a></code>&rsquo; is the
486+
quadruplet of all zero numerical RGBA values, e.g. <span
486487
class=example>rgba(0,0,0,0)</span>.
487488

488489
<li>See the definition of the &lsquo;<code class=css><a
@@ -498,9 +499,9 @@ <h3 id=foreground><span class=secno>3.1. </span>Foreground color: the
498499
content. In addition it is used to provide a potential indirect value (<a
499500
class=index-inst href="#currentcolor" id=currentcolor1>currentColor</a>)
500501
for any <em>other</em> properties that accept color values. If the
501-
&lsquo;<code class=css><span class=index-inst
502-
id=currentcolor2>currentColor</span></code>&rsquo; keyword is set on the
503-
&lsquo;<code class=property><a href="#color0">color</a></code>&rsquo;
502+
&lsquo;<code class=css><a href="#currentColor-def"><span class=index-inst
503+
id=currentcolor2>currentColor</span></a></code>&rsquo; keyword is set on
504+
the &lsquo;<code class=property><a href="#color0">color</a></code>&rsquo;
504505
property itself, it is treated as &lsquo;<code class=css>color:
505506
inherit</code>&rsquo;.
506507

@@ -516,7 +517,8 @@ <h3 id=foreground><span class=secno>3.1. </span>Foreground color: the
516517
</div>
517518

518519
<dl>
519-
<dt><span class="prop-value index-inst" id=ltcolorgt>&lt;color&gt;</span>
520+
<dt><a class="prop-value index-inst" href="#valuea-def-color"
521+
id=ltcolorgt>&lt;color&gt;</a>
520522

521523
<dd>Color units are defined in a <a href="#colorunits">following</a>
522524
section.
@@ -577,8 +579,8 @@ <h3 id=transparency><span class=secno>3.2. </span>Transparency: the
577579
</table>
578580

579581
<dl>
580-
<dt id=alphavaluedt><span class="prop-value index-def"
581-
id=alphavalue-def>&lt;alphavalue&gt;</span>
582+
<dt id=alphavaluedt><dfn class=prop-value
583+
id=alphavalue-def>&lt;alphavalue&gt;</dfn>
582584

583585
<dd>Syntactically a &lt;number&gt;. The uniform opacity setting to be
584586
applied across an entire object. Any values outside the range 0.0 (fully
@@ -612,9 +614,8 @@ <h3 id=transparency><span class=secno>3.2. </span>Transparency: the
612614

613615
<h2 id=colorunits><span class=secno>4. </span>Color units</h2>
614616

615-
<p>A <span class="index-def value-def-color"
616-
id=valuea-def-color>&lt;color&gt;</span> is either a keyword or a
617-
numerical specification.
617+
<p>A <dfn class=value-def-color id=valuea-def-color>&lt;color&gt;</dfn> is
618+
either a keyword or a numerical specification.
618619

619620
<h3 id=html4><span class=secno>4.1. </span>HTML4 color keywords</h3>
620621

@@ -949,22 +950,26 @@ <h4 id=rgba-color><span class=secno>4.2.2. </span>RGBA color values</h4>
949950
<em>not</em> be treated as simply an RGB value with the opacity ignored.
950951

951952
<h4 id=transparent><span class=secno>4.2.3. </span>&lsquo;<code
952-
class=css>transparent</code>&rsquo; color keyword</h4>
953-
954-
<p>CSS1 introduced the &lsquo;<code class=css>'transparent</code>&rsquo;'
955-
value for the background-color property. CSS2 allowed border-color to also
956-
accept the &lsquo;<code class=css>transparent</code>&rsquo; value. The
957-
Open eBook(tm) Publication Structure 1.0.1 <a href="#OEB101"
953+
class=css><a href="#transparent-def">transparent</a></code>&rsquo; color
954+
keyword</h4>
< 235B /td>955+
956+
<p>CSS1 introduced the &lsquo;<code class=css><a
957+
href="#transparent-def">'transparent</a></code>&rsquo;' value for the
958+
background-color property. CSS2 allowed border-color to also accept the
959+
&lsquo;<code class=css><a
960+
href="#transparent-def">transparent</a 5D33 ></code>&rsquo; value. The Open
961+
eBook(tm) Publication Structure 1.0.1 <a href="#OEB101"
958962
rel=biblioentry>[OEB101]<!--{{OEB101}}--></a> extended the &lsquo;<code
959963
class=property><a href="#color0">color</a></code>&rsquo; property to also
960-
accept the &lsquo;<code class=css>transparent</code>&rsquo; keyword. CSS3
961-
extends the color value to include the &lsquo;<code
962-
class=css>transparent</code>&rsquo; keyword to allow its use with all
963-
properties that accept a &lt;color&gt; value. This simplifies the
964-
definition of those properties in CSS3.
964+
accept the &lsquo;<code class=css><a
965+
href="#transparent-def">transparent</a></code>&rsquo; keyword. CSS3
966+
extends the color value to include the &lsquo;<code class=css><a
967+
href="#transparent-def">transparent</a></code>&rsquo; keyword to allow its
968+
use with all properties that accept a &lt;color&gt; value. This simplifies
969+
the definition of those properties in CSS3.
965970

966971
<dl>
967-
<dt class=index-def id=transparent-def>transparent
972+
<dt><dfn id=transparent-def>transparent</dfn>
968973

969974
<dd>Fully transparent. This keyword can be considered a shorthand for
970975
rgba(0,0,0,0), which is its computed value.
@@ -4466,8 +4471,8 @@ <h3 id=svg-color><span class=secno>4.3. </span>SVG color keywords</h3>
44664471
<td class=c style="background:silver">154,205,50
44674472
</table>
44684473

4469-
<h3 id=currentcolor><span class=secno>4.4. </span>&lsquo;<code
4470-
class=css>currentColor</code>&rsquo; color keyword</h3>
4474+
<h3 id=currentcolor><span class=secno>4.4. </span>&lsquo;<code class=css><a
4475+
href="#currentColor-def">currentColor</a></code>&rsquo; color keyword</h3>
44714476

44724477
<p>CSS1 and CSS2 defined the initial value of <a
44734478
href="http://www.w3.org/TR/REC-CSS1#border-color">the &lsquo;<code
@@ -4483,22 +4488,24 @@ <h3 id=currentcolor><span class=secno>4.4. </span>&lsquo;<code
44834488
class=property>stop-color</code>&rsquo;, &lsquo;<code
44844489
class=property>flood-color</code>&rsquo;, and &lsquo;<code
44854490
class=property>lighting-color</code>&rsquo; properties. CSS3 extends the
4486-
color value to include the &lsquo;<code
4487-
class=css>currentColor</code>&rsquo; keyword to allow its use with all
4488-
properties that accept a &lt;color&gt; value. This simplifies the
4489-
definition of those properties in CSS3.
4491+
color value to include the &lsquo;<code class=css><a
4492+
href="#currentColor-def">currentColor</a></code>&rsquo; keyword to allow
4493+
its use with all properties that accept a &lt;color&gt; value. This
4494+
simplifies the definition of those properties in CSS3.
44904495

44914496
<dl>
4492-
<dt class=index-def id=currentColor-def>currentColor
4497+
<dt><dfn id=currentColor-def>currentColor</dfn>
44934498

44944499
<dd>The value of the &lsquo;<code class=property><a
44954500
href="#color0">color</a></code>&rsquo; property. The computed value of
4496-
the &lsquo;<code class=css>currentColor</code>&rsquo; keyword is the
4501+
the &lsquo;<code class=css><a
4502+
href="#currentColor-def">currentColor</a></code>&rsquo; keyword is the
44974503
computed value of the &lsquo;<code class=property><a
44984504
href="#color0">color</a></code>&rsquo; property. If the &lsquo;<code
4499-
class=css>currentColor</code>&rsquo; keyword is set on the &lsquo;<code
4500-
class=property><a href="#color0">color</a></code>&rsquo; property itself,
4501-
it is treated as &lsquo;<code class=css>color: inherit</code>&rsquo;.
4505+
class=css><a href="#currentColor-def">currentColor</a></code>&rsquo;
4506+
keyword is set on the &lsquo;<code class=property><a
4507+
href="#color0">color</a></code>&rsquo; property itself, it is treated as
4508+
&lsquo;<code class=css>color: inherit</code>&rsquo;.
45024509
</dl>
45034510

45044511
<h3 id=css-system><span class=secno>4.5. </span>CSS system colors</h3>
@@ -4773,9 +4780,12 @@ <h2 id=profiles><span class=secno>7. </span>Profiles</h2>
47734780
RGBA color values<br>
47744781
HSL and HSLA color values<br>
47754782
SVG color keywords<br>
4776-
&lsquo;<code class=css>currentColor</code>&rsquo; color value<br>
4783+
&lsquo;<code class=css><a
4784+
href="#currentColor-def">currentColor</a></code>&rsquo; color
4785+
value<br>
47774786
CSS2 UI Colors<br>
4778-
&lsquo;<code class=css>transparent</code>&rsquo; color value
4787+
&lsquo;<code class=css><a
4788+
href="#transparent-def">transparent</a></code>&rsquo; color value
47794789

47804790
<tr>
47814791
<th>Extra constraints
@@ -4810,9 +4820,12 @@ <h2 id=profiles><span class=secno>7. </span>Profiles</h2>
48104820
RGBA color values<br>
48114821
HSL and HSLA color values<br>
48124822
SVG color keywords<br>
4813-
&lsquo;<code class=css>currentColor</code>&rsquo; color value<br>
4823+
&lsquo;<code class=css><a
4824+
href="#currentColor-def">currentColor</a></code>&rsquo; color
4825+
value<br>
48144826
CSS2 UI Colors<br>
4815-
&lsquo;<code class=css>transparent</code>&rsquo; color value
4827+
&lsquo;<code class=css><a
4828+
href="#transparent-def">transparent</a></code>&rsquo; color value
48164829

48174830
<tr>
48184831
<th>Extra constraints
@@ -4839,7 +4852,8 @@ <h2 id=profiles><span class=secno>7. </span>Profiles</h2>
48394852
HTML4 color keywords<br>
48404853
RGB color values<br>
48414854
CSS2 UI Colors<br>
4842-
&lsquo;<code class=css>transparent</code>&rsquo; color value
4855+
&lsquo;<code class=css><a
4856+
href="#transparent-def">transparent</a></code>&rsquo; color value
48434857

48444858
<tr>
48454859
<th>Excludes
@@ -4849,12 +4863,14 @@ <h2 id=profiles><span class=secno>7. </span>Profiles</h2>
48494863
RGBA color values<br>
48504864
HSL and HSLA color values<br>
48514865
SVG color keywords<br>
4852-
&lsquo;<code class=css>currentColor</code>&rsquo; color value
4866+
&lsquo;<code class=css><a
4867+
href="#currentColor-def">currentColor</a></code>&rsquo; color value
48534868

48544869
<tr>
48554870
<th>Extra constraints
48564871

4857-
<td>&lsquo;<code class=css>transparent</code>&rsquo; color value not
4872+
<td>&lsquo;<code class=css><a
4873+
href="#transparent-def">transparent</a></code>&rsquo; color value not
48584874
valid for &lsquo;<code class=property><a
48594875
href="#color0">color</a></code>&rsquo; property.<br>
48604876
&lsquo;<code class=css><a href="#orange">orange</a></code>&rsquo;
@@ -4884,20 +4900,23 @@ <h2 id=profiles><span class=secno>7. </span>Profiles</h2>
48844900
RGB color values<br>
48854901
CSS2 UI Colors<br>
48864902
SVG color keywords<br>
4887-
&lsquo;<code class=css>currentColor</code>&rsquo; color value
4903+
&lsquo;<code class=css><a
4904+
href="#currentColor-def">currentColor</a></code>&rsquo; color value
48884905

48894906
<tr>
48904907
<th>Excludes
48914908

48924909
<td> RGBA color values<br>
48934910
HSL and HSLA color values<br>
4894-
&lsquo;<code class=css>transparent</code>&rsquo; color value
4911+
&lsquo;<code class=css><a
4912+
href="#transparent-def">transparent</a></code>&rsquo; color value
48954913

48964914
<tr>
48974915
<th>Extra constraints
48984916

4899-
<td>&lsquo;<code class=css>currentColor</code>&rsquo; color value not
4900-
valid for &lsquo;<code class=property><a
4917+
<td>&lsquo;<code class=css><a
4918+
href="#currentColor-def">currentColor</a></code>&rsquo; color value
4919+
not valid for &lsquo;<code class=property><a
49014920
href="#color0">color</a></code>&rsquo; property.
49024921
</table>
49034922
</div>

‎css3-color/Overview.src.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,7 @@ <h3 id="transparency">Transparency: the 'opacity' property</h3>
381381
</table>
382382

383383
<dl>
384-
<dt id="alphavaluedt"><span class="prop-value index-def" id="alphavalue-def">&lt;alphavalue&gt;</span></dt>
384+
<dt id="alphavaluedt"><dfn class="prop-value" id="alphavalue-def">&lt;alphavalue&gt;</dfn></dt>
385385

386386
<dd>Syntactically a &lt;number&gt;. The uniform opacity setting to be applied across an entire object.
387387
Any values outside the range 0.0 (fully transparent) to 1.0 (fully
@@ -418,7 +418,7 @@ <h3 id="transparency">Transparency: the 'opacity' property</h3>
418418
<h2 id="colorunits">Color units</h2>
419419

420420
<p>A
421-
<span class="index-def value-def-color" id="valuea-def-color">&lt;color&gt;</span>
421+
<dfn class="value-def-color" id="valuea-def-color">&lt;color&gt;</dfn>
422422
is either a keyword or a numerical specification.
423423
</p>
424424

@@ -566,7 +566,7 @@ <h4 id="transparent">''transparent'' color keyword</h4>
566566
Open eBook(tm) Publication Structure 1.0.1 [[OEB101]] extended the 'color' property to also accept the ''transparent'' keyword. CSS3 extends the color value to include the ''transparent'' keyword to allow its use with all properties that accept a &lt;color&gt; value. This simplifies the definition of those properties in CSS3.
567567
</p>
568568

569-
<dl><dt class="index-def" id="transparent-def">transparent</dt>
569+
<dl><dt><dfn id="transparent-def">transparent</dfn></dt>
570570
<dd>Fully transparent. This keyword can be considered a shorthand for rgba(0,0,0,0), which is its computed value.
571571
</dd>
572572
</dl>
@@ -1582,7 +1582,7 @@ <h3 id="currentcolor">''currentColor'' color keyword</h3>
15821582
<a href="http://www.w3.org/TR/SVG/color.html#ColorProperty">SVG 1.0 introduced the ''currentColor'' value</a>
15831583
for the 'fill', 'stroke', 'stop-color', 'flood-color', and 'lighting-color' properties. CSS3 extends the color value to include the ''currentColor'' keyword to allow its use with all properties that accept a &lt;color&gt; value. This simplifies the definition of those properties in CSS3.
15841584
</p>
1585-
<dl><dt class="index-def" id="currentColor-def">currentColor</dt>
1585+
<dl><dt><dfn id="currentColor-def">currentColor</dfn></dt>
15861586
<dd>The value of the 'color' property. The computed value of the ''currentColor'' keyword is the computed value of the 'color' property. If the ''currentColor'' keyword is set on the 'color' property itself, it is treated as ''color: inherit''.
15871587
</dd>
15881588
</dl>

0 commit comments

Comments
 (0)