css-fonts/Fonts.html

changeset 8968
1c284112685e
parent 8957
b3ad55a4d7fc
child 8969
ad86f2dbd235
     1.1 --- a/css-fonts/Fonts.html	Wed Aug 28 18:57:13 2013 -0700
     1.2 +++ b/css-fonts/Fonts.html	Thu Aug 29 13:06:29 2013 +0900
     1.3 @@ -115,15 +115,15 @@
     1.4  
     1.5     <h1>CSS Fonts Module Level 3</h1>
     1.6  
     1.7 -   <h2 class="no-num no-toc" id=editors-draft-28-august-2013>Editor's Draft
     1.8 -    28 August 2013</h2>
     1.9 +   <h2 class="no-num no-toc" id=editors-draft-29-august-2013>Editor's Draft
    1.10 +    29 August 2013</h2>
    1.11  
    1.12     <dl id=authors>
    1.13      <dt>This version:
    1.14  
    1.15      <dd><a
    1.16       href="http://dev.w3.org/csswg/css-fonts/">http://dev.w3.org/csswg/css-fonts/</a>
    1.17 -     <!-- <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>  -->
    1.18 +     <!-- <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>  -->
    1.19       
    1.20  
    1.21      <dt>Latest version:
    1.22 @@ -1583,7 +1583,7 @@
    1.23    <h3 id=font-size-adjust-prop><span class=secno>3.6 </span>Relative sizing:
    1.24     the <a href="#propdef-font-size-adjust">font-size-adjust</a> property</h3>
    1.25  
    1.26 -  <table class=propdef id=namefont-size-adjustvaluenone-auto-ltnum>
    1.27 +  <table class=propdef id=namefont-size-adjustvaluenone-ltnumbergt>
    1.28     <tbody>
    1.29      <tr>
    1.30       <td>Name:
    1.31 @@ -1595,8 +1595,6 @@
    1.32  
    1.33       <td><a href="#font-size-adjust-none-value"
    1.34        title="none!!font-size-adjust">none</a> | <a
    1.35 -      href="#font-size-adjust-auto-value"
    1.36 -      title="auto!!font-size-adjust">auto</a> | <a
    1.37        href="#aspect-ratio-value"><var>&lt;number&gt;</var></a>
    1.38  
    1.39      <tr>
    1.40 @@ -1647,10 +1645,11 @@
    1.41  
    1.42    <p>In situations where font fallback occurs, fallback fonts may not share
    1.43     the same aspect ratio as the desired font family and will thus appear less
    1.44 -   readable. The font-size-adjust property is a way to preserve the
    1.45 -   readability of text when font fallback occurs. It does this by adjusting
    1.46 -   the font-size so that the x-height is the same regardless of the font
    1.47 -   used.
    1.48 +   readable. The ‘<a href="#propdef-font-size-adjust"><code
    1.49 +   class=property>font-size-adjust</code></a>’ property is a way to
    1.50 +   preserve the readability of text when font fallback occurs. It does this
    1.51 +   by adjusting the font-size so that the x-height is the same regardless of
    1.52 +   the font used.
    1.53  
    1.54    <div class=example>
    1.55     <p>The style defined below defines Verdana as the desired font family, but
    1.56 @@ -1674,14 +1673,17 @@
    1.57     font-size value is used across cells within each row and red lines are
    1.58     included to show the differences in x-height. In the upper half each row
    1.59     is rendered in the same font-size value. The same is true for the lower
    1.60 -   half but in this half the font-size-adjust property is also set so that
    1.61 +   half but in this half the ‘<a href="#propdef-font-size-adjust"><code
    1.62 +   class=property>font-size-adjust</code></a>’ property is also set so that
    1.63     the actual font size is adjusted to preserve the x-height across each row.
    1.64     Note how small text remains relatively legible across each row in the
    1.65     lower half.
    1.66  
    1.67 -  <div class=figure><img alt="text with and without font-size-adjust"
    1.68 +  <div class=figure><img alt="text with and without 'font-size-adjust'"
    1.69     src=fontsizeadjust.png>
    1.70 -   <p class=caption>Text with and without the use of font-size-adjust
    1.71 +   <p class=caption>Text with and without the use of ‘<a
    1.72 +    href="#propdef-font-size-adjust"><code
    1.73 +    class=property>font-size-adjust</code></a>’
    1.74    </div>
    1.75  
    1.76    <p>This property allows authors to specify an <a
    1.77 @@ -1695,25 +1697,6 @@
    1.78  
    1.79     <dd>Do not preserve the font's x-height.
    1.80  
    1.81 -   <dt><dfn id=font-size-adjust-auto-value
    1.82 -    title="auto!!font-size-adjust">auto</dfn>
    1.83 -
    1.84 -   <dd>Behaves just like &lt;number>, except the number used is the <a
    1.85 -    href="#aspect-value"><i>aspect value</i></a> calculated by user agents
    1.86 -    for the first font in the list of fonts defined for the initial value of
    1.87 -    the <a href="#propdef-font-family" title="font-family!!property">‘<code
    1.88 -    class=property>font-family</code>’</a> property. Effectively this is
    1.89 -    the default font used for basic Latin text when <a
    1.90 -    href="#propdef-font-family" title="font-family!!property">‘<code
    1.91 -    class=property>font-family</code>’</a> is not otherwise specified. It
    1.92 -    does not vary based on document content and it is not calculated based on
    1.93 -    the computed value of <a href="#propdef-font-family"
    1.94 -    title="font-family!!property">‘<code
    1.95 -    class=property>font-family</code>’</a> for a given element.
    1.96 -    <p class=note>Authors can use this value to specify that font size should
    1.97 -     be normalized across fonts based on the x-height without the need to
    1.98 -     specify the aspect value explicitly.</p>
    1.99 -
   1.100     <dt><dfn id=aspect-ratio-value><var>&lt;number&gt;</var></dfn>
   1.101  
   1.102     <dd>Specifies the <a href="#aspect-value"><i>aspect value</i></a> used in
   1.103 @@ -1724,7 +1707,7 @@
   1.104      <p>where:</p>
   1.105  
   1.106      <pre>s  =  font-size value
   1.107 -a  =  <a href="#aspect-value"><i>aspect value</i></a> as specified by the font-size-adjust property
   1.108 +a  =  <a href="#aspect-value"><i>aspect value</i></a> as specified by the 'font-size-adjust' property
   1.109  a' =  <a href="#aspect-value"><i>aspect value</i></a> of actual font
   1.110  c  =  adjusted font-size to use
   1.111  </pre>
   1.112 @@ -1736,44 +1719,59 @@
   1.113       effectively 1 for the first font and no adjustment occurs. If the value
   1.114       is specified inaccurately, text rendered using the first font in the
   1.115       family list will display differently in older user agents that don't
   1.116 -     support font-size-adjust.</p>
   1.117 +     support ‘<a href="#propdef-font-size-adjust"><code
   1.118 +     class=property>font-size-adjust</code></a>’.</p>
   1.119    </dl>
   1.120  
   1.121    <p>The value of ‘<a href="#propdef-font-size-adjust"><code
   1.122 -   class=property>font-size-adjust</code></a>’ affects the size of relative
   1.123 -   units that are based on font metrics of the <a
   1.124 -   href="#first-available-font"><i>first available font</i></a> such as
   1.125 -   <code>ex</code> and <code>ch</code> but does not affect the size of
   1.126 -   <code>em</code> units.
   1.127 -
   1.128 -  <p class=note>In CSS, authors typically specify <a
   1.129 +   class=property>font-size-adjust</code></a>’ affects the used value of
   1.130 +   ‘<a href="#propdef-font-size"><code
   1.131 +   class=property>font-size</code></a>’ but does not affect the computed
   1.132 +   value. It affects the size of relative units that are based on font
   1.133 +   metrics of the <a href="#first-available-font"><i>first available
   1.134 +   font</i></a> such as <code>ex</code> and <code>ch</code> but does not
   1.135 +   affect the size of <code>em</code> units. Since numeric values of <a
   1.136     href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height">‘<code
   1.137 -   class=property>line-height</code>’</a> using <a
   1.138 -   href="http://dev.w3.org/csswg/css-values/#em-unit">‘<code
   1.139 -   class=property>em</code>’</a> units so that the <a
   1.140 +   class=property>line-height</code>’</a> refer to the computed size of
   1.141 +   ‘<a href="#propdef-font-size"><code
   1.142 +   class=property>font-size</code></a>’, ‘<a
   1.143 +   href="#propdef-font-size-adjust"><code
   1.144 +   class=property>font-size-adjust</code></a>’ does not affect the used
   1.145 +   value of <a
   1.146     href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height">‘<code
   1.147 -   class=property>line-height</code>’</a> is linked to the font size. Since
   1.148 -   the ‘<a href="#propdef-font-size-adjust"><code
   1.149 -   class=property>font-size-adjust</code></a>’ property affects the font
   1.150 -   size used but does not affect the size of font relative units, authors
   1.151 -   should take care setting the line height when ‘<a
   1.152 -   href="#propdef-font-size-adjust"><code
   1.153 +   class=property>line-height</code>’</a>.
   1.154 +
   1.155 +  <p class=note>In CSS, authors often specify <a
   1.156 +   href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height">‘<code
   1.157 +   class=property>line-height</code>’</a> as a multiple of the ‘<a
   1.158 +   href="#propdef-font-size"><code class=property>font-size</code></a>’.
   1.159 +   Since the ‘<a href="#propdef-font-size-adjust"><code
   1.160 +   class=property>font-size-adjust</code></a>’ property affects the used
   1.161 +   value of ‘<a href="#propdef-font-size"><code
   1.162 +   class=property>font-size</code></a>’, authors should take care setting
   1.163 +   the line height when ‘<a href="#propdef-font-size-adjust"><code
   1.164     class=property>font-size-adjust</code></a>’ is used. Setting the line
   1.165 -   height too tightly could result in overlapping lines of text in this
   1.166 +   height too tightly can result in overlapping lines of text in this
   1.167     situation.
   1.168  
   1.169    <p>Authors can calculate the <a href="#aspect-value"><i>aspect
   1.170     value</i></a> for a given font by comparing spans with the same content
   1.171 -   but different font-size-adjust properties. If the same font-size is used,
   1.172 -   the spans will match when the font-size-adjust value is accurate for the
   1.173 +   but different ‘<a href="#propdef-font-size-adjust"><code
   1.174 +   class=property>font-size-adjust</code></a>’ properties. If the same
   1.175 +   font-size is used, the spans will match when the ‘<a
   1.176 +   href="#propdef-font-size-adjust"><code
   1.177 +   class=property>font-size-adjust</code></a>’ value is accurate for the
   1.178     given font.
   1.179  
   1.180    <div class=example>
   1.181     <p>Two spans with borders are used to determine the <a
   1.182 -    href="#aspect-value"><i>aspect value</i></a> of a font. The font-size is
   1.183 -    the same for both spans but the font-size-adjust property is specified
   1.184 -    only for the right span. Starting with a value of 0.5, the aspect value
   1.185 -    can be adjusted until the borders around the two letters line up.</p>
   1.186 +    href="#aspect-value"><i>aspect value</i></a> of a font. The ‘<a
   1.187 +    href="#propdef-font-size"><code class=property>font-size</code></a>’ is
   1.188 +    the same for both spans but the ‘<a
   1.189 +    href="#propdef-font-size-adjust"><code
   1.190 +    class=property>font-size-adjust</code></a>’ property is specified only
   1.191 +    for the right span. Starting with a value of 0.5, the aspect value can be
   1.192 +    adjusted until the borders around the two letters line up.</p>
   1.193  
   1.194     <pre>p {
   1.195      font-family: Futura;
   1.196 @@ -5930,11 +5928,15 @@
   1.197  
   1.198     <li>revised wording of font fetching algorithm
   1.199  
   1.200 -   <li>clarify meaning of <a href="#font-size-adjust-auto-value"
   1.201 -    title="auto!!font-size-adjust">‘<code class=property>auto</code>’</a>
   1.202 -    value for ‘<a href="#propdef-font-size-adjust"><code
   1.203 +   <li>drop ‘<code class=property>auto</code>’ value for ‘<a
   1.204 +    href="#propdef-font-size-adjust"><code
   1.205      class=property>font-size-adjust</code></a>’
   1.206  
   1.207 +   <li>clarify effect of ‘<a href="#propdef-font-size-adjust"><code
   1.208 +    class=property>font-size-adjust</code></a>’ on <a class=property
   1.209 +    href="http://www.w3.org/TR/CSS2/visudet.html#propdef-line-height">‘<code
   1.210 +    class=property>line-height</code>’</a>
   1.211 +
   1.212     <li>allow user agents to synthesize OpenType <span class=tag>kern</span>
   1.213      feature
   1.214  
   1.215 @@ -6453,9 +6455,6 @@
   1.216      <ul>
   1.217       <li>font-kerning, <a href="#font-kerning-auto-value" title="auto,
   1.218        font-kerning"><strong>6.3</strong></a>
   1.219 -
   1.220 -     <li>font-size-adjust, <a href="#font-size-adjust-auto-value"
   1.221 -      title="auto, font-size-adjust"><strong>3.6</strong></a>
   1.222      </ul>
   1.223  
   1.224     <li>bold, <a href="#bold" title=bold><strong>3.2</strong></a>
   1.225 @@ -6955,7 +6954,7 @@
   1.226       <th><a class=property
   1.227        href="#propdef-font-size-adjust">font-size-adjust</a>
   1.228  
   1.229 -     <td>none | auto | &lt;number&gt;
   1.230 +     <td>none | &lt;number&gt;
   1.231  
   1.232       <td>none
   1.233  

mercurial