Skip to content

Commit a0ea0b4

Browse files
committed
Turn the 'default object size' list back to normative, add note about it not meaning to contradict anything.
1 parent 833f898 commit a0ea0b4

2 files changed

Lines changed: 23 additions & 12 deletions

File tree

css3-images/Overview.html

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -702,8 +702,17 @@ <h3 id=element-reference><span class=secno>3.3. </span> Using Elements as
702702
element changes appearance, the image changes as well. This can be used,
703703
for example, to create live previews of the next/previous slide in a
704704
slideshow, or to reference a canvas element for a fancy generated gradient
705-
or even an animated background. The syntax for &lsquo;<code
706-
class=css>element()</code>&rsquo; is:
705+
or even an animated background.
706+
707+
<p class=note>Note that the &lsquo;<code class=css>element()</code>&rsquo;
708+
function only reproduces the <em>appearance</em> of the referenced
709+
element, not the actual content and its structure. Authors should only use
710+
this for decorative purposes, and must not use &lsquo;<code
711+
class=css>element()</code>&rsquo; to reproduce an element with significant
712+
content across the page. Instead, just insert multiple copies of the
713+
element into the document.
714+
715+
<p>The syntax for &lsquo;<code class=css>element()</code>&rsquo; is:
707716

708717
<pre class=prod><dfn
709718
id=element-reference-type>&lt;element-reference></dfn> = element( &lt;id-selector> )</pre>
@@ -1462,7 +1471,7 @@ <h4 class=no-toc id=degenerate-radials><span class=secno>4.2.3. </span>
14621471

14631472
<dl>
14641473
<dt>If the <a href="#ending-shape"><i>ending shape</i></a> is a circle
1465-
with zero width or height:
1474+
with zero radius:
14661475

14671476
<dd>Render as if the <a href="#ending-shape"><i>ending shape</i></a> was a
14681477
circle whose radius was an arbitrary very small number greater than zero.
@@ -1864,14 +1873,16 @@ <h3 id=sizing-terms><span class=secno>5.1. </span> Object-Sizing
18641873
dimensions. It varies based on the context in which that the image is
18651874
being laid out.</p>
18661875

1867-
<p>The following informative list summarizes the <a
1876+
<p>The following list defines the <a
18681877
href="#default-object-size"><i>default object size</i></a> of properties
18691878
and contexts that appear in CSS 2.1, plus &lsquo;<code
18701879
class=property>border-image</code>&rsquo; from CSS 3 Backgrounds &amp;
18711880
Borders. Newer modules that accept an &lsquo;<a href="#image-type"><code
18721881
class=css>&lt;image></code></a>&rsquo; component value in a new context
18731882
must define the <a href="#default-object-size"><i>default object
1874-
size</i></a> in that context.</p>
1883+
size</i></a> in that context. This list is normative, but it is not
1884+
intended to contradict anything stated in CSS2.1 or CSS3 Backgrounds
1885+
&amp; Borders.</p>
18751886

18761887
<dl>
18771888
<dt>&lsquo;<code class=property>background-image</code>&rsquo;

css3-images/Overview.src.html

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -319,7 +319,11 @@ <h4 id='bidi-images'>
319319
<h3 id='element-reference'>
320320
Using Elements as Images: the ''element()'' notation</h3>
321321

322-
<p>The ''element()'' function allows an author to use an element in the document as an image. As the referenced element changes appearance, the image changes as well. This can be used, for example, to create live previews of the next/previous slide in a slideshow, or to reference a canvas element for a fancy generated gradient or even an animated background. The syntax for ''element()'' is:</p>
322+
<p>The ''element()'' function allows an author to use an element in the document as an image. As the referenced element changes appearance, the image changes as well. This can be used, for example, to create live previews of the next/previous slide in a slideshow, or to reference a canvas element for a fancy generated gradient or even an animated background.</p>
323+
324+
<p class='note'>Note that the ''element()'' function only reproduces the <em>appearance</em> of the referenced element, not the actual content and its structure. Authors should only use this for decorative purposes, and must not use ''element()'' to reproduce an element with significant content across the page. Instead, just insert multiple copies of the element into the document.</p>
325+
326+
<p>The syntax for ''element()'' is:</p>
323327

324328
<pre class=prod><dfn id='element-reference-type'>&lt;element-reference></dfn> = element( &lt;id-selector> )</pre>
325329

@@ -818,7 +822,7 @@ <h4 class="no-toc" id="degenerate-radials">
818822
be rendered as follows:</p>
819823

820824
<dl>
821-
<dt>If the <i>ending shape</i> is a circle with zero width or height:</dt>
825+
<dt>If the <i>ending shape</i> is a circle with zero radius:</dt>
822826
<dd>Render as if the <i>ending shape</i> was a circle whose radius was an arbitrary very small number greater than zero. <span class='note'>This will make the gradient continue to look like a circle.</span></dd>
823827

824828
<dt>If the <i>ending shape</i> has zero width (regardless of the height):</dt>
@@ -1099,11 +1103,7 @@ <h3 id="sizing-terms">
10991103
<i>intrinsic dimensions</i> and <i>specified size</i> are missing dimensions.
11001104
It varies based on the context in which that the image is being laid out.</p>
11011105

1102-
<p>The following informative list summarizes the <i>default object size</i> of
1103-
properties and contexts that appear in CSS 2.1, plus 'border-image' from
1104-
CSS 3 Backgrounds &amp; Borders.
1105-
Newer modules that accept an ''&lt;image>'' component value in a new
1106-
context must define the <i>default object size</i> in that context.</p>
1106+
<p>The following list defines the <i>default object size</i> of properties and contexts that appear in CSS 2.1, plus 'border-image' from CSS 3 Backgrounds &amp; Borders. Newer modules that accept an ''&lt;image>'' component value in a new context must define the <i>default object size</i> in that context. This list is normative, but it is not intended to contradict anything stated in CSS2.1 or CSS3 Backgrounds &amp; Borders.</p>
11071107

11081108
<dl>
11091109
<dt>'background-image'</dt>

0 commit comments

Comments
 (0)