Skip to content

Commit 7862cb2

Browse files
committed
[css-images-3] Deprecate image-orientation and make it optional per <https://lists.w3.org/Archives/Public/www-style/2019Aug/0005.html>. Related to discussion in w3c#4164
1 parent 24ce0f6 commit 7862cb2

File tree

1 file changed

+16
-14
lines changed

1 file changed

+16
-14
lines changed

css-images-3/Overview.bs

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1495,8 +1495,6 @@ Image Processing {#image-processing}
14951495

14961496
<h3 id="the-image-orientation" caniuse="css-image-orientation">Orienting an Image on the Page: the 'image-orientation' property </h3>
14971497

1498-
Issue: This property is likely going to be deprecated and its functionality moved to HTML.
1499-
At minimum, it will likely lose all but its initial value and ''image-orientation/from-image''.
15001498

15011499
If a picture is taken with a camera turned on its side,
15021500
or a document isn't positioned correctly within a scanner,
@@ -1520,6 +1518,17 @@ Image Processing {#image-processing}
15201518
Animation type: discrete
15211519
</pre>
15221520

1521+
<strong>This property is deprecated,
1522+
and is <em>optional</em> for implementations.</strong>
1523+
1524+
Note: This property previously used ''image-orientation/none'' as its initial value.
1525+
It is believed that using ''from-image'' as the initial value
1526+
will produce a generally better user experience,
1527+
and minimal breakage,
1528+
but future compat data as UAs attempt to make the change will confirm that.
1529+
If that is confirmed, then it is likely that this property will be removed from CSS
1530+
unless use cases other than “correct for incorrect orientation” are raised for its other values.
1531+
15231532
This property specifies an orthogonal rotation to be applied to an image before it is laid out.
15241533
It applies only to content images
15251534
(e.g. replaced elements and generated content),
@@ -1548,19 +1557,7 @@ Image Processing {#image-processing}
15481557
If necessary, this angle is then rounded and normalized as described above for an <<angle>> value.
15491558
If there is no orientation specified in its metadata,
15501559
this value computes to ''image-orientation/none''.
1551-
</dl>
15521560

1553-
Note: This property previously used ''image-orientation/none'' as its initial value.
1554-
It is believed that using ''from-image'' as the initial value
1555-
will produce a generally better user experience,
1556-
and minimal breakage,
1557-
but future compat data as UAs attempt to make the change will confirm that.
1558-
1559-
Values other than ''image-orientation/none'' and ''from-image'' are
1560-
<em>optional</em> to implement and <em>deprecated</em> in CSS.
1561-
They have the following meanings:
1562-
1563-
<dl dfn-type=value dfn-for=image-orientation>
15641561
<dt><dfn><<angle>></dfn>
15651562
<dd>
15661563
Positive values cause the image to be rotated to the right
@@ -1583,6 +1580,11 @@ Image Processing {#image-processing}
15831580
Note: This value is only necessary to represent all 8 possible EXIF orientations that <a value for=image-orientation>from-image</a> can produce.
15841581
</dl>
15851582

1583+
<!--
1584+
Values other than ''image-orientation/none'' and ''from-image'' are
1585+
<em>optional</em> to implement and <em>deprecated</em> in CSS.
1586+
-->
1587+
15861588
The 'image-orientation' property must be applied before any other transformations,
15871589
such as using CSS Transforms.
15881590

0 commit comments

Comments
 (0)