Skip to content

Commit 8bed684

Browse files
committed
[css-values-4] Add lv* units explicitly for large viewport size. w3c#4329
1 parent 3edb9dc commit 8bed684

1 file changed

Lines changed: 37 additions & 15 deletions

File tree

css-values-4/Overview.bs

Lines changed: 37 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1737,11 +1737,6 @@ Font-relative Lengths: the ''em'', ''ex'', ''cap'', ''ch'', ''ic'', ''rem'', ''l
17371737
<h4 id="viewport-relative-lengths">
17381738
Viewport-percentage Lengths: the ''*vw'', ''*vh'', ''*vi'', ''*vb'', ''*vmin'', ''*vmax'' units</h4>
17391739

1740-
ISSUE: <img src="../construction.gif" alt="" style="float: right">
1741-
This section is <strong>UNDER CONSTRUCTION</strong>.
1742-
Please use <a href="https://www.w3.org/TR/css-values-3/">CSS Values and Units Level 3</a>
1743-
as an implementation reference for now.
1744-
17451740
The <dfn export>viewport-percentage lengths</dfn> are relative to the size of the
17461741
<a href="https://www.w3.org/TR/CSS21/visudet.html#containing-block-details">initial containing block</a>--
17471742
which is itself based on the size of either
@@ -1753,13 +1748,32 @@ Viewport-percentage Lengths: the ''*vw'', ''*vh'', ''*vi'', ''*vb'', ''*vmin'',
17531748
<h5 id="viewport-variants" class="no-toc">
17541749
The Large, Small, and Dynamic Viewport Sizes</h5>
17551750

1756-
There are three variants of the [=viewport-percentage length=] units,
1757-
corresponding to three (possibly identical) notions of the viewport size.
1751+
There are four variants of the [=viewport-percentage length=] units,
1752+
corresponding to four (possibly identical) notions of the viewport size.
17581753

17591754
<dl export>
1755+
<dt>UA-default viewport
1756+
<dd>
1757+
The <dfn export>UA-default viewport-percentage units</dfn>
1758+
(''v*'')
1759+
are defined with respect to a UA-defined <dfn export>UA-default viewport size</dfn>,
1760+
which for any given document
1761+
should be equivalent to the [=large viewport size=],
1762+
[=small viewport size=],
1763+
or some intermediary size.
1764+
1765+
ISSUE: Should the [=UA-default viewport size=] be required
1766+
to correspond to the size of the [=initial containing block=]?
1767+
1768+
Note: Implementations that choose a size other than
1769+
the [=large viewport size=] or [=small viewport size=]
1770+
are encouraged to explain their choice to the CSSWG
1771+
for consideration in future specification updates.
1772+
17601773
<dt>large viewport
17611774
<dd>
17621775
The <dfn export>large viewport-percentage units</dfn>
1776+
(''lv*'')
17631777
are defined with respect to the <dfn export>large viewport size</dfn>:
17641778
the viewport sized assuming
17651779
any UA interfaces that are dynamically expanded and retracted
@@ -1789,6 +1803,7 @@ The Large, Small, and Dynamic Viewport Sizes</h5>
17891803
<dt>small viewport
17901804
<dd>
17911805
The <dfn export>small viewport-percentage units</dfn>
1806+
(''sv*'')
17921807
are defined with respect to the <dfn export>small viewport size</dfn>:
17931808
the viewport sized assuming
17941809
any UA interfaces that are dynamically expanded and retracted
@@ -1818,6 +1833,7 @@ The Large, Small, and Dynamic Viewport Sizes</h5>
18181833
<dt>dynamic viewport
18191834
<dd>
18201835
The <dfn export>dynamic viewport-percentage units</dfn>
1836+
(''dv*'')
18211837
are defined with respect to the <dfn export>dynamic viewport size</dfn>:
18221838
the viewport sized
18231839
with dynamic consideration of any UA interfaces
@@ -1879,11 +1895,13 @@ The Various Viewport-relative Units</h5>
18791895
<dl export dfn-type=value dfn-for="<length>">
18801896
<dt><dfn lt="vw">vw unit</dfn>
18811897
<dt><dfn lt="svw">svw unit</dfn>
1898+
<dt><dfn lt="lvw">lvw unit</dfn>
18821899
<dt><dfn lt="dvw">dvw unit</dfn>
18831900
<dd>
18841901
Equal to 1% of the width of the
1885-
[=large viewport size=],
1902+
[=UA-default viewport size=],
18861903
[=small viewport size=],
1904+
[=large viewport size=],
18871905
and [=dynamic viewport size=],
18881906
respectively.
18891907

@@ -1897,16 +1915,19 @@ The Various Viewport-relative Units</h5>
18971915

18981916
<dt><dfn lt="vh">vh unit</dfn>
18991917
<dt><dfn lt="svh">svh unit</dfn>
1918+
<dt><dfn lt="lvh">lvh unit</dfn>
19001919
<dt><dfn lt="dvh">dvh unit</dfn>
19011920
<dd>
19021921
Equal to 1% of the height of the
1903-
[=large viewport size=],
1922+
[=UA-default viewport size=],
19041923
[=small viewport size=],
1924+
[=large viewport size=],
19051925
and [=dynamic viewport size=],
19061926
respectively.
19071927

19081928
<dt><dfn lt=vi>vi unit</dfn>
19091929
<dt><dfn lt=svi>svi unit</dfn>
1930+
<dt><dfn lt=lvi>lvi unit</dfn>
19101931
<dt><dfn lt=dvi>dvi unit</dfn>
19111932
<dd>
19121933
Equal to 1% of the size of the
@@ -1918,23 +1939,27 @@ The Various Viewport-relative Units</h5>
19181939

19191940
<dt><dfn lt=vb>vb unit</dfn>
19201941
<dt><dfn lt=svb>svb unit</dfn>
1942+
<dt><dfn lt=lvb>lvb unit</dfn>
19211943
<dt><dfn lt=dvb>dvb unit</dfn>
19221944
<dd>
19231945
Equal to 1% of the size of the initial containing block
1924-
[=large viewport size=],
1946+
[=UA-default viewport size=],
19251947
[=small viewport size=],
1948+
[=large viewport size=],
19261949
and [=dynamic viewport size=]
19271950
(respectively)
19281951
in the direction of the root element's block axis.
19291952

19301953
<dt><dfn lt="vmin">vmin unit</dfn>
19311954
<dt><dfn lt="svmin">svmin unit</dfn>
1955+
<dt><dfn lt="lvmin">lvmin unit</dfn>
19321956
<dt><dfn lt="dvmin">dvmin unit</dfn>
19331957
<dd>
19341958
Equal to the smaller of ''*vw'' or ''*vh''.
19351959

19361960
<dt><dfn lt="vmax">vmax unit</dfn>
19371961
<dt><dfn lt="svmax">svmax unit</dfn>
1962+
<dt><dfn lt="lvmax">lvmax unit</dfn>
19381963
<dt><dfn lt="dvmax">dvmax unit</dfn>
19391964
<dd>
19401965
Equal to the larger of ''*vw'' or ''*vh''.
@@ -1967,10 +1992,6 @@ The Various Viewport-relative Units</h5>
19671992
but can also block critical content (such as toolbars, headers, and footers) in others.
19681993
It's therefore not entirely clear whether this is the best mapping.
19691994

1970-
ISSUE: Should we have dedicated ''lv*'' units for the [=large viewport size=]?
1971-
That would give authors an explicit version, and allow the unprefixed units
1972-
to maybe do smarter things to avoid obscuring critical content.
1973-
19741995
In situations where there is no root element
19751996
or it hasn't yet been styled
19761997
(such as when evaluating <a>media queries</a>),
@@ -4921,7 +4942,8 @@ Recent Changes</h3>
49214942

49224943
<ul>
49234944
<li>Updated interpolation of colors to reference [[CSS-COLOR-4]] instead of [[CSS-COLOR-3]].
4924-
<li>Added the ''svh'', ''svw'', ''svi'', ''svb'', ''svmin'', and ''svmax'' [=small viewport-percentage units=]
4945+
<li>Added the ''svh'', ''svw'', ''svi'', ''svb'', ''svmin'', and ''svmax'' [=small viewport-percentage units=];
4946+
''lvh'', ''lvw'', ''lvi'', ''lvb'', ''lvmin'', and ''lvmax'' [=large viewport-percentage units=];
49254947
and ''dvh'', ''dvw'', ''dvi'', ''dvb'', ''dvmin'', and ''dvmax'' [=dynamic viewport-percentage units=].
49264948
(<a href="https://github.com/w3c/csswg-drafts/issues/4329">Issue 4329</a> and
49274949
<a href="https://github.com/w3c/csswg-drafts/issues/6113">Issue 6113</a>)

0 commit comments

Comments
 (0)