Skip to content

Commit d541f4a

Browse files
committed
[css-images] bikeshed fixes
1 parent ebdeb61 commit d541f4a

File tree

1 file changed

+43
-49
lines changed

1 file changed

+43
-49
lines changed

css-images/Overview.bs

Lines changed: 43 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
1111
Editor: Elika J. Etemad / fantasai, Invited Expert, http://fantasai.inkedblade.net/contact, w3cid 35400
1212
Abstract: This module contains the features of CSS level 3 relating to the <<image>> type and replaced elements. It includes and extends the functionality of CSS level 2 [[CSS21]]. The main extensions compared to CSS2.1 are the generalization of the <<url>> type to the <<image>> type, several additions to the <<image>> type, a generic sizing algorithm for images and other replaced content in CSS, definitions for interpolating several <<image>> types, and several properties controlling the interaction of replaced elements and CSS's layout models.
1313
At Risk: 'image-orientation'
14-
At Risk: <a section href="#interpolating-gradients">Interpolating <<gradient>></a>
14+
At Risk: [[#interpolating-gradients]]
1515
Issue Tracking: Tracker http://www.w3.org/Style/CSS/Tracker/products/27
1616
Previous Version: https://www.w3.org/TR/2012/CR-css3-images-20120417/
1717
Previous Version: https://www.w3.org/TR/2012/WD-css3-images-20120112/
@@ -51,10 +51,7 @@ Introduction {#intro}
5151
Image Values: the <<image>> type {#image-values}
5252
================================================
5353

54-
The <<image>> value type denotes a 2D image. It can be a
55-
<a section href="#url-notation">url reference</a>,
56-
<a section href="#image-notation">image notation</a>,
57-
or <a section href="#gradients">gradient notation</a>.
54+
The <<image>> value type denotes a 2D image.
5855
Its syntax is:
5956

6057
<pre class="prod"><dfn>&lt;image></dfn> = <<url>> | <<image-set()>> | <<cross-fade()>> | <<gradient>></pre>
@@ -157,7 +154,7 @@ Resolution Negotiation: the ''image-set()'' notation {#image-set-notation}
157154
connection speed,
158155
etc).
159156
The ''image-set()'' then represents the image associated with the URL of that choice.
160-
The image's <a>intrinsic resolution</a> is the resolution associated with that choice.
157+
The image's <a spec=css-images-4>intrinsic resolution</a> is the resolution associated with that choice.
161158
UAs <strong>may</strong> change which <<image-set-option>> they wish to use for a given ''image-set()''
162159
over the lifetime of the page,
163160
if the criteria used to determine which option to choose change significantly enough to make it worthwhile in the UA's estimation.
@@ -1240,7 +1237,7 @@ Examples of CSS Object Sizing {#object-sizing-examples}
12401237
In CSS3, 'background-size' property can give a sizing constraint,
12411238
invoking either the <a>default sizing algorithm</a>
12421239
or one of the <a lt="contain constraint">contain</a> or <a lt="cover constraint">cover</a> constraints.
1243-
The concrete object size is further adjusted in later steps if 'background-repeat' has a ''round'' value. [[CSS3BG]]
1240+
The concrete object size is further adjusted in later steps if 'background-repeat' has a ''background-repeat/round'' value. [[CSS3BG]]
12441241

12451242
<dt>'list-style-image'
12461243
<dd>
@@ -1352,10 +1349,10 @@ Sizing Objects: the 'object-fit' property {#the-object-fit}
13521349

13531350
<dt><dfn>scale-down</dfn>
13541351
<dd>
1355-
Size the content as if ''none'' or ''contain'' were specified,
1352+
Size the content as if ''object-fit/none'' or ''object-fit/contain'' were specified,
13561353
whichever would result in a smaller <a>concrete object size</a>.
13571354

1358-
Note: Both ''none'' and ''contain'' respect the content's intrinsic aspect ratio,
1355+
Note: Both ''object-fit/none'' and ''object-fit/contain'' respect the content's intrinsic aspect ratio,
13591356
so the concept of "smaller" is well-defined.
13601357
</dl>
13611358

@@ -1373,7 +1370,7 @@ Sizing Objects: the 'object-fit' property {#the-object-fit}
13731370
to be scaled to fit its height/width box (shown with a green background),
13741371
using the initial value for 'object-position'.
13751372
The fifth value, ''scale-down'',
1376-
in this case looks identical to ''contain''.
1373+
in this case looks identical to ''object-fit/contain''.
13771374
</figcaption>
13781375
</figure>
13791376

@@ -1456,7 +1453,7 @@ Orienting an Image on the Page: the 'image-orientation' property {#the-image-ori
14561453

14571454
Note: This property is not intended to specify layout transformations
14581455
such as arbitrary rotation or flipping the image in the horizontal or vertical direction.
1459-
(See [[CSS3-2D-TRANSFORMS]] for a feature designed to do that.)
1456+
(See [[CSS-TRANSFORMS-1]] for a feature designed to do that.)
14601457
It is also not needed to correctly orient an image when printing in landscape versus portrait orientation,
14611458
as that rotation is done as part of layout. (See [[CSS3PAGE]].)
14621459
It should only be used to correct incorrectly-oriented images.
@@ -1829,13 +1826,15 @@ Serialization {#serialization}
18291826
<pre>linear-gradient(red, yellow, black 100px)</pre>
18301827
</div>
18311828

1832-
<h2 class="no-num" id="privsec">Privacy and Security Considerations</h2>
1829+
<h2 class="no-num" id="privsec">
1830+
Privacy and Security Considerations</h2>
18331831

18341832
This specification allows rendering of cross-origin images by default,
18351833
which exposes some information of those images programmatically--
18361834
specifically, the intrinsic sizes and resolution of those images.
18371835

1838-
<h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
1836+
<h2 class="no-num" id="acknowledgments">
1837+
Acknowledgments</h2>
18391838

18401839
Thanks to the Webkit team, Brad Kemper, Brian Manthos, and Alan Gresley
18411840
for their contributions to the definition of gradients; to Melinda Grant
@@ -1845,60 +1844,55 @@ Thanks to the Webkit team, Brad Kemper, Brian Manthos, and Alan Gresley
18451844
Kang-Hao Lu, Leif Arne Storset, Erik Dahlstrom, and Øyvind Stenhaug for
18461845
their careful review, comments, and corrections.
18471846

1848-
<h2 class="no-num" id="changes">Changes</h2>
1847+
<h2 class="no-num" id="changes">
1848+
Changes</h2>
18491849

1850-
<h3 class="no-num">Changes Since the <a href="https://www.w3.org/TR/2012/CR-css3-images-20120417/">17 April 2012 Candidate Recommendation</a></h3>
1850+
<h3 class="no-num" id="changes-20120407">
1851+
Changes Since the <a href="https://www.w3.org/TR/2012/CR-css3-images-20120417/">17 April 2012 Candidate Recommendation</a></h3>
18511852

18521853
Major changes include:
18531854

1854-
- The ''image()'' notation has been deferred to Level 4.
1855-
- The 'image-resolution' property has been deferred to Level 4
1855+
- The <css>image()</css> notation has been deferred to Level 4.
1856+
- The <css>image-resolution</css> property has been deferred to Level 4
18561857
- The 'image-orientation' property has been marked as At-Risk.
18571858
- Added the 'image-rendering' property
18581859
- Added the ''cross-fade()'' notation
18591860
- Added the ''image-set()'' notation
18601861
- Defined <a href="#interpolation">Interpolation</a>
18611862
- Defined <a href="#serialization">Serialization</a>
18621863

1863-
<h3 class=no-num id=changes-last-call>Changes Since Last Call</h3>
1864+
<h3 class=no-num id=changes-last-call>
1865+
Changes Since Last Call</h3>
18641866

18651867
Major changes include:
18661868

18671869

1868-
- The ''element()'' feature has been
1869-
deferred to Level 4.
1870-
- The directional images feature (''ltr''/''rtl''
1871-
annotations in ''image()'') has been
1872-
deferred to Level 4 to address some design-level feedback.
1873-
- Images referenced with unsupported URL fragment syntax are now
1874-
considered invalid (and trigger fallback) within ''image()''.
1875-
- The 'object-fit' property no longer resizes
1876-
the element's content box in any cases.
1877-
- The 'image-orientation' property is now
1878-
inherited.
1870+
- The <css>element()</css> feature has been deferred to Level 4.
1871+
- The directional images feature
1872+
(''ltr''/''rtl''annotations in ''image()'')
1873+
has been deferred to Level 4 to address some design-level feedback.
1874+
- Images referenced with unsupported URL fragment syntax
1875+
are now considered invalid (and trigger fallback) within ''image()''.
1876+
- The 'object-fit' property no longer resizes the element's content box in any cases.
1877+
- The 'image-orientation' property is now inherited.
18791878

18801879

1881-
Significant details updated:
1880+
Significant details updated:
18821881

18831882

1884-
- There is now a definition for <a href="#invalid-image"><i>invalid
1885-
images</i></a>, which trigger fallback in the ''image()'' notation.
1886-
- Clarified that media fragments are only required to be supported
1887-
within ''image()'' in order to satisfy
1888-
the prerequisite for supporting ''image()''.
1889-
- Defined how to determine the closeness of two aspect ratios (used in
1890-
the definition of <a href="#intrinsic-dimensions"><i>intrinsic
1891-
dimensions</i></a>).
1892-
- Corrected error in which 'image-orientation' was applied after CSS
1893-
transforms.
1894-
- The 'object-fit' and 'object-position' properties may no longer
1895-
be aliased to 'image-fit' and 'image-position'. A future
1896-
edition of the <a href="http://www.w3.org/TR/css-print/">CSS Print
1897-
Profile</a> may allow this for printer implementations, however.
1883+
- There is now a definition for <a>invalid images</a>,
1884+
which trigger fallback in the ''image()'' notation.
1885+
- Clarified that media fragments are only required to be supported within ''image()''
1886+
in order to satisfy the prerequisite for supporting ''image()''.
1887+
- Defined how to determine the closeness of two aspect ratios
1888+
(used in the definition of <a href="#intrinsic-dimensions"><i>intrinsic dimensions</i></a>).
1889+
- Corrected error in which 'image-orientation' was applied after CSS transforms.
1890+
- The 'object-fit' and 'object-position' properties
1891+
can no longer be aliased to <css>image-fit</css> and <css>image-position</css>.
1892+
A future edition of the <a href="http://www.w3.org/TR/css-print/">CSS Print Profile</a>
1893+
may allow this for printer implementations, however.
18981894

1895+
There were also many clarifications
1896+
and several sections were rearranged to make them easier to read.
18991897

1900-
There were also many clarifications and several sections were rearranged
1901-
to make them easier to read.
1902-
1903-
The <a href="http://dev.w3.org/csswg/css3-images/issues-lc-2012">Disposition of
1904-
Last Call Comments</a> is available.
1898+
The <a href="http://dev.w3.org/csswg/css3-images/issues-lc-2012">Disposition of Last Call Comments</a> is available.

0 commit comments

Comments
 (0)