Skip to content

Commit 4c40333

Browse files
author
John Daggett
committed
[css3-fonts] remove auto value for font-size-adjust
1 parent f90de9f commit 4c40333

1 file changed

Lines changed: 63 additions & 64 deletions

File tree

css-fonts/Fonts.html

Lines changed: 63 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -115,15 +115,15 @@
115115

116116
<h1>CSS Fonts Module Level 3</h1>
117117

118-
<h2 class="no-num no-toc" id=editors-draft-28-august-2013>Editor's Draft
119-
28 August 2013</h2>
118+
<h2 class="no-num no-toc" id=editors-draft-29-august-2013>Editor's Draft
119+
29 August 2013</h2>
120120

121121
<dl id=authors>
122122
<dt>This version:
123123

124124
<dd><a
125125
href="http://dev.w3.org/csswg/css-fonts/">http://dev.w3.org/csswg/css-fonts/</a>
126-
<!-- <dd><a href="http://www.w3.org/TR/2013/ED-css-fonts-3-20130828/">http://www.w3.org/TR/2013/ED-css-fonts-3-20130828/</a> -->
126+
<!-- <dd><a href="http://www.w3.org/TR/2013/ED-css-fonts-3-20130829/">http://www.w3.org/TR/2013/ED-css-fonts-3-20130829/</a> -->
127127

128128

129129
<dt>Latest version:
@@ -1583,7 +1583,7 @@ <h3 id=font-size-prop><span class=secno>3.5 </span>Font size: the <a
15831583
<h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
15841584
the <a href="#propdef-font-size-adjust">font-size-adjust</a> property</h3>
15851585

1586-
<table class=propdef id=namefont-size-adjustvaluenone-auto-ltnum>
1586+
<table class=propdef id=namefont-size-adjustvaluenone-ltnumbergt>
15871587
<tbody>
15881588
<tr>
15891589
<td>Name:
@@ -1595,8 +1595,6 @@ <h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
15951595

15961596
<td><a href="#font-size-adjust-none-value"
15971597
title="none!!font-size-adjust">none</a> | <a
1598-
href="#font-size-adjust-auto-value"
1599-
title="auto!!font-size-adjust">auto</a> | <a
16001598
href="#aspect-ratio-value"><var>&lt;number&gt;</var></a>
16011599

16021600
<tr>
@@ -1647,10 +1645,11 @@ <h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
16471645

16481646
<p>In situations where font fallback occurs, fallback fonts may not share
16491647
the same aspect ratio as the desired font family and will thus appear less
1650-
readable. The font-size-adjust property is a way to preserve the
1651-
readability of text when font fallback occurs. It does this by adjusting
1652-
the font-size so that the x-height is the same regardless of the font
1653-
used.
1648+
readable. The ‘<a href="#propdef-font-size-adjust"><code
1649+
class=property>font-size-adjust</code></a>’ property is a way to
1650+
preserve the readability of text when font fallback occurs. It does this
1651+
by adjusting the font-size so that the x-height is the same regardless of
1652+
the font used.
16541653

16551654
<div class=example>
16561655
<p>The style defined below defines Verdana as the desired font family, but
@@ -1674,14 +1673,17 @@ <h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
16741673
font-size value is used across cells within each row and red lines are
16751674
included to show the differences in x-height. In the upper half each row
16761675
is rendered in the same font-size value. The same is true for the lower
1677-
half but in this half the font-size-adjust property is also set so that
1676+
half but in this half the ‘<a href="#propdef-font-size-adjust"><code
1677+
class=property>font-size-adjust</code></a>’ property is also set so that
16781678
the actual font size is adjusted to preserve the x-height across each row.
16791679
Note how small text remains relatively legible across each row in the
16801680
lower half.
16811681

1682-
<div class=figure><img alt="text with and without font-size-adjust"
1682+
<div class=figure><img alt="text with and without 'font-size-adjust'"
16831683
src=fontsizeadjust.png>
1684-
<p class=caption>Text with and without the use of font-size-adjust
1684+
<p class=caption>Text with and without the use of ‘<a
1685+
href="#propdef-font-size-adjust"><code
1686+
class=property>font-size-adjust</code></a>
16851687
</div>
16861688

16871689
<p>This property allows authors to specify an <a
@@ -1695,25 +1697,6 @@ <h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
16951697

16961698
<dd>Do not preserve the font's x-height.
16971699

1698-
<dt><dfn id=font-size-adjust-auto-value
1699-
title="auto!!font-size-adjust">auto</dfn>
1700-
1701-
<dd>Behaves just like &lt;number>, except the number used is the <a
1702-
href="#aspect-value"><i>aspect value</i></a> calculated by user agents
1703-
for the first font in the list of fonts defined for the initial value of
1704-
the <a href="#propdef-font-family" title="font-family!!property"><code
1705-
class=property>font-family</code></a> property. Effectively this is
1706-
the default font used for basic Latin text when <a
1707-
href="#propdef-font-family" title="font-family!!property"><code
1708-
class=property>font-family</code></a> is not otherwise specified. It
1709-
does not vary based on document content and it is not calculated based on
1710-
the computed value of <a href="#propdef-font-family"
1711-
title="font-family!!property"><code
1712-
class=property>font-family</code></a> for a given element.
1713-
<p class=note>Authors can use this value to specify that font size should
1714-
be normalized across fonts based on the x-height without the need to
1715-
specify the aspect value explicitly.</p>
1716-
17171700
<dt><dfn id=aspect-ratio-value><var>&lt;number&gt;</var></dfn>
17181701

17191702
<dd>Specifies the <a href="#aspect-value"><i>aspect value</i></a> used in
@@ -1724,7 +1707,7 @@ <h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
17241707
<p>where:</p>
17251708

17261709
<pre>s = font-size value
1727-
a = <a href="#aspect-value"><i>aspect value</i></a> as specified by the font-size-adjust property
1710+
a = <a href="#aspect-value"><i>aspect value</i></a> as specified by the 'font-size-adjust' property
17281711
a' = <a href="#aspect-value"><i>aspect value</i></a> of actual font
17291712
c = adjusted font-size to use
17301713
</pre>
@@ -1736,44 +1719,59 @@ <h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
17361719
effectively 1 for the first font and no adjustment occurs. If the value
17371720
is specified inaccurately, text rendered using the first font in the
17381721
family list will display differently in older user agents that don't
1739-
support font-size-adjust.</p>
1722+
support ‘<a href="#propdef-font-size-adjust"><code
1723+
class=property>font-size-adjust</code></a>’.</p>
17401724
</dl>
17411725

17421726
<p>The value of ‘<a href="#propdef-font-size-adjust"><code
1743-
class=property>font-size-adjust</code></a>’ affects the size of relative
1744-
units that are based on font metrics of the <a
1745-
href="#first-available-font"><i>first available font</i></a> such as
1746-
<code>ex</code> and <code>ch</code> but does not affect the size of
1747-
<code>em</code> units.
1748-
1749-
<p class=note>In CSS, authors typically specify <a
1750-
href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height"><code
1751-
class=property>line-height</code></a> using <a
1752-
href="http://dev.w3.org/csswg/css-values/#em-unit"><code
1753-
class=property>em</code></a> units so that the <a
1727+
class=property>font-size-adjust</code></a>’ affects the used value of
1728+
<a href="#propdef-font-size"><code
1729+
class=property>font-size</code></a>’ but does not affect the computed
1730+
value. It affects the size of relative units that are based on font
1731+
metrics of the <a href="#first-available-font"><i>first available
1732+
font</i></a> such as <code>ex</code> and <code>ch</code> but does not
1733+
affect the size of <code>em</code> units. Since numeric values of <a
17541734
href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height"><code
1755-
class=property>line-height</code></a> is linked to the font size. Since
1756-
the ‘<a href="#propdef-font-size-adjust"><code
1757-
class=property>font-size-adjust</code></a>’ property affects the font
1758-
size used but does not affect the size of font relative units, authors
1759-
should take care setting the line height when ‘<a
1735+
class=property>line-height</code></a> refer to the computed size of
1736+
<a href="#propdef-font-size"><code
1737+
class=property>font-size</code></a>’, ‘<a
17601738
href="#propdef-font-size-adjust"><code
1739+
class=property>font-size-adjust</code></a>’ does not affect the used
1740+
value of <a
1741+
href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height"><code
1742+
class=property>line-height</code></a>.
1743+
1744+
<p class=note>In CSS, authors often specify <a
1745+
href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height"><code
1746+
class=property>line-height</code></a> as a multiple of the ‘<a
1747+
href="#propdef-font-size"><code class=property>font-size</code></a>’.
1748+
Since the ‘<a href="#propdef-font-size-adjust"><code
1749+
class=property>font-size-adjust</code></a>’ property affects the used
1750+
value of ‘<a href="#propdef-font-size"><code
1751+
class=property>font-size</code></a>’, authors should take care setting
1752+
the line height when ‘<a href="#propdef-font-size-adjust"><code
17611753
class=property>font-size-adjust</code></a>’ is used. Setting the line
1762-
height too tightly could result in overlapping lines of text in this
1754+
height too tightly can result in overlapping lines of text in this
17631755
situation.
17641756

17651757
<p>Authors can calculate the <a href="#aspect-value"><i>aspect
17661758
value</i></a> for a given font by comparing spans with the same content
1767-
but different font-size-adjust properties. If the same font-size is used,
1768-
the spans will match when the font-size-adjust value is accurate for the
1759+
but different ‘<a href="#propdef-font-size-adjust"><code
1760+
class=property>font-size-adjust</code></a>’ properties. If the same
1761+
font-size is used, the spans will match when the ‘<a
1762+
href="#propdef-font-size-adjust"><code
1763+
class=property>font-size-adjust</code></a>’ value is accurate for the
17691764
given font.
17701765

17711766
<div class=example>
17721767
<p>Two spans with borders are used to determine the <a
1773-
href="#aspect-value"><i>aspect value</i></a> of a font. The font-size is
1774-
the same for both spans but the font-size-adjust property is specified
1775-
only for the right span. Starting with a value of 0.5, the aspect value
1776-
can be adjusted until the borders around the two letters line up.</p>
1768+
href="#aspect-value"><i>aspect value</i></a> of a font. The ‘<a
1769+
href="#propdef-font-size"><code class=property>font-size</code></a>’ is
1770+
the same for both spans but the ‘<a
1771+
href="#propdef-font-size-adjust"><code
1772+
class=property>font-size-adjust</code></a>’ property is specified only
1773+
for the right span. Starting with a value of 0.5, the aspect value can be
1774+
adjusted until the borders around the two letters line up.</p>
17771775

17781776
<pre>p {
17791777
font-family: Futura;
@@ -5930,11 +5928,15 @@ <h3 class=no-num id=recent-changes> Changes from the <a
59305928

59315929
<li>revised wording of font fetching algorithm
59325930

5933-
<li>clarify meaning of <a href="#font-size-adjust-auto-value"
5934-
title="auto!!font-size-adjust"><code class=property>auto</code></a>
5935-
value for ‘<a href="#propdef-font-size-adjust"><code
5931+
<li>drop ‘<code class=property>auto</code>’ value for ‘<a
5932+
href="#propdef-font-size-adjust"><code
59365933
class=property>font-size-adjust</code></a>
59375934

5935+
<li>clarify effect of ‘<a href="#propdef-font-size-adjust"><code
5936+
class=property>font-size-adjust</code></a>’ on <a class=property
5937+
href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height"><code
5938+
class=property>line-height</code></a>
5939+
59385940
<li>allow user agents to synthesize OpenType <span class=tag>kern</span>
59395941
feature
59405942

@@ -6453,9 +6455,6 @@ <h2 class=no-num id=index>Index</h2>
64536455
<ul>
64546456
<li>font-kerning, <a href="#font-kerning-auto-value" title="auto,
64556457
font-kerning"><strong>6.3</strong></a>
6456-
6457-
<li>font-size-adjust, <a href="#font-size-adjust-auto-value"
6458-
title="auto, font-size-adjust"><strong>3.6</strong></a>
64596458
</ul>
64606459

64616460
<li>bold, <a href="#bold" title=bold><strong>3.2</strong></a>
@@ -6955,7 +6954,7 @@ <h2 class=no-num id=property-index>Property index</h2>
69556954
<th><a class=property
69566955
href="#propdef-font-size-adjust">font-size-adjust</a>
69576956

6958-
<td>none | auto | &lt;number&gt;
6957+
<td>none | &lt;number&gt;
69596958

69606959
<td>none
69616960

0 commit comments

Comments
 (0)