Skip to content

Commit ff43d57

Browse files
committed
* text-transform accepts multiple values <http://lists.w3.org/Archives/Public/www-style/2010Oct/0062.html>
* Added text-justify:none <http://lists.w3.org/Archives/Public/www-style/2010Oct/0268.html> * Added description to punctuation-trim for when kerning data exists <http://lists.w3.org/Archives/Public/www-style/2010Dec/0130.html> * text-autospace describes behavior for element boundaries * text-autospace describes exception cases <http://lists.w3.org/Archives/Public/www-style/2010Dec/0127.html> * Changed how text-emphasis should be rendered to be more UA dependent * Added Adobe open source font as an example for text-emphasis * Some syntax (the use of '' and ') fixes
1 parent 73cf173 commit ff43d57

2 files changed

Lines changed: 138 additions & 70 deletions

File tree

css3-text/Overview.html

Lines changed: 90 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -83,14 +83,14 @@
8383

8484
<h1>CSS Text Level 3</h1>
8585

86-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 3 November
86+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 14 December
8787
2010</h2>
8888

8989
<dl>
9090
<dt>This version:
9191

9292
<dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
93-
2010/10/07 06:46:06 $ (CVS $Revision$)</a> <!--<dd><a
93+
2010/11/03 13:39:38 $ (CVS $Revision$)</a> <!--<dd><a
9494
href="http://www.w3.org/TR/2010/WD-css3-text-20101005/">http://www.w3.org/TR/2010/WD-css3-text-20101005/</a></dd> -->
9595

9696

@@ -109,11 +109,11 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 3 November
109109
<dd><a href="http://fantasai.inkedblade.net/contact">Elika J. Etemad</a>
110110
(Invited Expert)
111111

112-
<dd><a href="mailto:kojiishi@gluesoft.co.jp">Koji Ishii</a> (Antenna
113-
House)
112+
<dd><a href="mailto:kojiishi@gluesoft.co.jp">Koji Ishii</a> (<a
113+
href="http://www.antenna.co.jp/">Antenna House</a>)
114114

115-
<dd><a href="mailto:murakami@antenna.co.jp">Shinyu Murakami</a> (Antenna
116-
House)
115+
<dd><a href="mailto:murakami@antenna.co.jp">Shinyu Murakami</a> (<a
116+
href="http://www.antenna.co.jp/">Antenna House</a>)
117117
</dl>
118118
<!--begin-copyright-->
119119
<p class=copyright><a
@@ -518,7 +518,8 @@ <h3 id=text-transform><span class=secno>3.1. </span> <a name=caps-prop></a>
518518
<tr>
519519
<th>Value:
520520

521-
<td>none | capitalize | uppercase | lowercase | fullwidth | large-kana
521+
<td>none | [ [ capitalize | uppercase | lowercase ] || fullwidth ||
522+
large-kana ]
522523

523524
<tr>
524525
<th>Initial:
@@ -908,9 +909,9 @@ <h4 id=line-break-transform><span class=secno>4.2.2. </span> Line Break
908909
be considered in this rule?</p>
909910

910911
<li>Otherwise, if &lsquo;<a href="#text-autospace0"><code
911-
class=css>text-autospace</code></a>&rsquo; property is set to add extra
912-
spaces for the combination of the character before the line feed and
913-
after, then the line break is removed.
912+
class=property>text-autospace</code></a>&rsquo; property is set to add
913+
extra spaces for the combination of the character before the line feed
914+
and after, then the line break is removed.
914915
<p class=issue>Any feedback on this behavior is appreciated. Now that we
915916
have text-autospace property, it makes sense to favor it than inserting
916917
spaces. However, we also want to preserve backward compatibility as much
@@ -1161,8 +1162,6 @@ <h3 id=line-break><span class=secno>5.1. </span> Line Breaking Restrictions
11611162
<li>breaks before Japanese small kana
11621163

11631164
<li>breaks before the KATAKANA-HIRAGANA PROLONGED SOUND MARK (U+30FC)
1164-
1165-
<li>
11661165
</ul>
11671166
Additionally, if the language is known to be Chinese or Japanese, breaks
11681167
before hyphens (U+2010, U+2013, U+301C, U+30A0) may be allowed in
@@ -1806,8 +1805,8 @@ <h3 id=text-justify><span class=secno>7.3. </span> Justification Method:
18061805
<tr>
18071806
<th>Value:
18081807

1809-
<td>auto | [ trim || [ inter-word | inter-ideograph | inter-cluster |
1810-
distribute | kashida ] ]
1808+
<td>auto | none | [ trim || [ inter-word | inter-ideograph |
1809+
inter-cluster | distribute | kashida ] ]
18111810

18121811
<tr>
18131812
<th>Initial:
@@ -1861,6 +1860,12 @@ <h3 id=text-justify><span class=secno>7.3. </span> Justification Method:
18611860
scripts, e.g. the &lsquo;<code class=css>distribute</code>&rsquo; method
18621861
with discrete scripts dropped to second priority.</p>
18631862

1863+
<dt><dfn id=none1 title="text-justify:none"><code>none</code></dfn>
1864+
1865+
<dd>Justification is disabled. <span class=note>This value is intended for
1866+
use in user stylesheets to improve readability or for accessibility
1867+
purposes.</span>
1868+
18641869
<dt><dfn id=inter-word
18651870
title="text-justify:inter-word"><code>inter-word</code></dfn>
18661871

@@ -1906,7 +1911,14 @@ <h3 id=text-justify><span class=secno>7.3. </span> Justification Method:
19061911
enables the trimming of blank space in glyphs where allowed by
19071912
typographic tradition (for example, in spaces and fullwidth punctuation
19081913
glyphs). If specified alone, the exact justification algorithm is
1909-
UA-defined (as for &lsquo;<code class=css>auto</code>&rsquo;).
1914+
UA-defined (as for &lsquo;<code class=css>auto</code>&rsquo;). <span
1915+
class=note> An example of compression rules is given for Japanese in 3.8
1916+
Line Adjustment in the <a href="#JLREQ"
1917+
rel=biblioentry>[JLREQ]<!--{{!JLREQ}}--></a>.</span>
1918+
<p class=issue>The rule a. of 3.8.3 in the current JLREQ may produce
1919+
non-optimal results when the rules are applied to English lines, or
1920+
sometimes English words within Japanese lines. There's a discussion
1921+
currently going on for how to manage this.</p>
19101922
</dl>
19111923

19121924
<p>When justifying text, the user agent takes the remaining space between
@@ -2664,7 +2676,7 @@ <h3 id=punctuation-trim><span class=secno>8.3. </span> Fullwidth
26642676
defined as follows:
26652677

26662678
<dl>
2667-
<dt><dfn id=none1 title="punctuation-trim:none">none</dfn>
2679+
<dt><dfn id=none2 title="punctuation-trim:none">none</dfn>
26682680

26692681
<dd>Do not trim or kern the blank half of fullwidth opening or closing
26702682
punctuation glyphs.
@@ -2695,9 +2707,7 @@ <h3 id=punctuation-trim><span class=secno>8.3. </span> Fullwidth
26952707
(U+3000).
26962708
</dl>
26972709

2698-
<p class=issue> add description for what to do if the font has kerning pair
2699-
defined. add description for what to do if the character is not 1em.
2700-
classes and Unicode code point should be re-reviewed.
2710+
<p class=issue>classes and Unicode code point should be reviewed.
27012711

27022712
<div class=example>
27032713
<p>The following example table lists the punctuation pairs affected by the
@@ -2815,8 +2825,10 @@ <h3 id=punctuation-trim><span class=secno>8.3. </span> Fullwidth
28152825
</dl>
28162826

28172827
<p>Fullwidth opening and closing punctuation must not be trimmed if the
2818-
glyph is not actually fullwidth. A fullwidth glyph is one that has the
2819-
same advance width as a typical Han character in the same font.
2828+
glyph is not actually fullwidth. This includes the case where the glyph is
2829+
not fullwidth as a result of the kerning in the font. A fullwidth glyph is
2830+
one that has the same advance width as a typical Han character in the same
2831+
font.
28202832

28212833
<p>Whether fullwidth colon punctuation and fullwidth dot punctuation should
28222834
be considered fullwidth closing punctuation or fullwidth middle dot
@@ -2973,22 +2985,34 @@ <h3 id=text-autospace><span class=secno>8.4. </span> <a
29732985
<p>Values have the following meanings:
29742986

29752987
<dl>
2976-
<dt><dfn id=none2 title="text-autospace:none"><code>none</code></dfn>
2988+
<dt><dfn id=none3 title="text-autospace:none"><code>none</code></dfn>
29772989

29782990
<dd>No extra space is created.
29792991

29802992
<dt><dfn id=ideograph-numeric
29812993
title="text-autospace:ideograph-numeric"><code>ideograph-numeric</code></dfn>
29822994

29832995
<dd>Creates 1/4em extra spacing between runs of ideographic letters and
2984-
numeric glyphs.
2996+
non-ideographic numeric glyphs. The extra spacing should not be created
2997+
if the numeric glyphs are fullwidth, upright in vertical text flow using
2998+
the &lsquo;<code class=property>text-orientation</code>&rsquo; property
2999+
or the &lsquo;<code class=property>text-combine</code>&rsquo; property,
3000+
or have different computed value of the &lsquo;<code
3001+
class=property>writing-mode</code>&rsquo; property than the ideographic
3002+
letters.
29853003

29863004
<dt><dfn id=ideograph-alpha
29873005
title="text-autospace:ideograph-alpha"><code>ideograph-alpha</code></dfn>
29883006

29893007
<dd>Creates 1/4em extra spacing between runs of ideographic letters and
29903008
non-ideographic letters, such as Latin-based, Cyrillic, Greek, Arabic or
2991-
Hebrew.
3009+
Hebrew. The extra spacing should not be created if the non-ideographic
3010+
letters are fullwidth, upright in vertical text flow using the
3011+
&lsquo;<code class=property>text-orientation</code>&rsquo; property or
3012+
the &lsquo;<code class=property>text-combine</code>&rsquo; property, or
3013+
have different computed value of the &lsquo;<code
3014+
class=property>writing-mode</code>&rsquo; property than the ideographic
3015+
letters.
29923016

29933017
<dt><dfn id=ideograph-space
29943018
title="text-autospace:ideograph-space"><code>ideograph-space</code></dfn>
@@ -3021,6 +3045,9 @@ <h3 id=text-autospace><span class=secno>8.4. </span> <a
30213045
<p class=issue>It was requested to add a value for doubling the space after
30223046
periods.
30233047

3048+
<p>At element boundaries, the font size of the extra spacing is given by
3049+
and rendered within the innermost element that contains the boundary.
3050+
30243051
<p>Ideograph letters in this definitions includes the following characters.
30253052

30263053
<ul>
@@ -3644,7 +3671,7 @@ <h4 id=text-decoration-skip><span class=secno>10.1.5. </span> Text
36443671
drawn by its ancestors. Values have the following meanings:
36453672

36463673
<dl>
3647-
<dt><dfn id=none3 title="text-decoration-skip:none">none</dfn>
3674+
<dt><dfn id=none4 title="text-decoration-skip:none">none</dfn>
36483675

36493676
<dd>Skip nothing: text-decoration is drawn for all text content and for
36503677
inline replaced elements.
@@ -3832,7 +3859,7 @@ <h4 id=text-emphasis-style><span class=secno>10.2.1. </span> Emphasis Mark
38323859
the following meanings:
38333860

38343861
<dl>
3835-
<dt><dfn id=none4 title="text-emphasis:none"><code>none</code></dfn>
3862+
<dt><dfn id=none5 title="text-emphasis:none"><code>none</code></dfn>
38363863

38373864
<dd>No emphasis marks.
38383865

@@ -3885,23 +3912,26 @@ <h4 id=text-emphasis-style><span class=secno>10.2.1. </span> Emphasis Mark
38853912
</dl>
38863913

38873914
<p>If a shape keyword is specified but neither of &lsquo;<code
3888-
class=property>filled</code>&rsquo; nor &lsquo;<code
3889-
class=property>open</code>&rsquo; is specified, &lsquo;<code
3890-
class=property>filled</code>&rsquo; is assumed. If only &lsquo;<code
3891-
class=property>filled</code>&rsquo; or 'open is specified, the shape
3892-
keyword computes to &lsquo;<code class=property>dot</code>&rsquo; in
3893-
horizontal writing mode and &lsquo;<code
3894-
class=property>sesame</code>&rsquo; in vertical writing mode.
3915+
class=css>filled</code>&rsquo; nor &lsquo;<code
3916+
class=css>open</code>&rsquo; is specified, &lsquo;<code
3917+
class=css>filled</code>&rsquo; is assumed. If only &lsquo;<code
3918+
class=css>filled</code>&rsquo; or &lsquo;<code
3919+
class=css>open</code>&rsquo; is specified, the shape keyword computes to
3920+
&lsquo;<code class=css>circle</code>&rsquo; in horizontal writing mode and
3921+
&lsquo;<code class=css>sesame</code>&rsquo; in vertical writing mode.
38953922

38963923
<p>The marks should be drawn using the element's font settings with its
3897-
size scaled down to 50%. UA should fall back to an appropriate font if the
3898-
glyph is missing in the font. The marks may instead be synthesized by the
3899-
UA.
3924+
size scaled down to 50%. However, not all fonts have all these glyphs, and
3925+
some fonts use inappropriate sizes for emphasis marks in these code
3926+
points. The UA may opt to use a font known to be good for emphasis marks,
3927+
or the marks may instead be synthesized by the UA.
39003928

3901-
<p class=issue>This rendering scheme is based on ruby algorithm and the one
3902-
used in Japanese printing industries. But the size of glyphs varies so
3903-
much that this may result in inconsistent and/or bad visuals. If you have
3904-
any feedback on this, it's appreciated.
3929+
<div class=example>
3930+
<p>One example of good fonts for emphasis marks is Adobe's opensource
3931+
project, <a href="http://sourceforge.net/adobe/kenten-generic/">Kenten
3932+
Generic OpenType Font</a>, which is specially designed for the emphasis
3933+
marks.</p>
3934+
</div>
39053935

39063936
<p>The marks are drawn once for each grapheme cluster. However, emphasis
39073937
marks are not drawn for a grapheme cluster consisting of:
@@ -4778,6 +4808,15 @@ <h3 class=no-num id=normative-ref>Normative references</h3>
47784808
</dd>
47794809
<!---->
47804810

4811+
<dt id=JLREQ>[JLREQ]
4812+
4813+
<dd>Kenzou Onozawa; et al. <a
4814+
href="http://www.w3.org/TR/2009/NOTE-jlreq-20090604"><cite>Requirements
4815+
for Japanese Text Layout.</cite></a> 4 June 2009. W3C Note. URL: <a
4816+
href="http://www.w3.org/TR/2009/NOTE-jlreq-20090604">http://www.w3.org/TR/2009/NOTE-jlreq-20090604</a>
4817+
</dd>
4818+
<!---->
4819+
47814820
<dt id=RFC2119>[RFC2119]
47824821

47834822
<dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key
@@ -5155,8 +5194,8 @@ <h2 class=no-num id=appendix-b-property-index> Appendix B: Property index</h2>
51555194
<tr valign=baseline>
51565195
<td><a class=property href="#text-justify0">text-justify</a>
51575196

5158-
<td>auto | [ trim || [ inter-word | inter-ideograph | inter-cluster |
5159-
distribute | kashida ] ]
5197+
<td>auto | none | [ trim || [ inter-word | inter-ideograph |
5198+
inter-cluster | distribute | kashida ] ]
51605199

51615200
<td>auto
51625201

@@ -5217,7 +5256,8 @@ <h2 class=no-num id=appendix-b-property-index> Appendix B: Property index</h2>
52175256
<tr valign=baseline>
52185257
<td><a class=property href="#text-transform0">text-transform</a>
52195258

5220-
<td>none | capitalize | uppercase | lowercase | fullwidth | large-kana
5259+
<td>none | [ [ capitalize | uppercase | lowercase ] || fullwidth ||
5260+
large-kana ]
52215261

52225262
<td>none
52235263

@@ -5455,7 +5495,7 @@ <h2 class=no-num id=index>Index</h2>
54555495
<li>punctuation-trim:end, <a href="#end0"
54565496
title="punctuation-trim:end"><strong>8.3.</strong></a>
54575497

5458-
<li>punctuation-trim:none, <a href="#none1"
5498+
<li>punctuation-trim:none, <a href="#none2"
54595499
title="punctuation-trim:none"><strong>8.3.</strong></a>
54605500

54615501
<li>punctuation-trim:start, <a href="#start0"
@@ -5527,7 +5567,7 @@ <h2 class=no-num id=index>Index</h2>
55275567
<li>text-autospace:ideograph-space, <a href="#ideograph-space"
55285568
title="text-autospace:ideograph-space"><strong>8.4.</strong></a>
55295569

5530-
<li>text-autospace:none, <a href="#none2"
5570+
<li>text-autospace:none, <a href="#none3"
55315571
title="text-autospace:none"><strong>8.4.</strong></a>
55325572

55335573
<li>text-autospace:punctuation, <a href="#punctuation"
@@ -5554,7 +5594,7 @@ <h2 class=no-num id=index>Index</h2>
55545594
<li>text-decoration-skip:ink, <a href="#ink"
55555595
title="text-decoration-skip:ink"><strong>10.1.5.</strong></a>
55565596

5557-
<li>text-decoration-skip:none, <a href="#none3"
5597+
<li>text-decoration-skip:none, <a href="#none4"
55585598
title="text-decoration-skip:none"><strong>10.1.5.</strong></a>
55595599

55605600
<li>text-decoration-skip:spaces, <a href="#spaces"
@@ -5581,7 +5621,7 @@ <h2 class=no-num id=index>Index</h2>
55815621
<li>text-emphasis:filled, <a href="#filled"
55825622
title="text-emphasis:filled"><strong>10.2.1.</strong></a>
55835623

5584-
<li>text-emphasis:none, <a href="#none4"
5624+
<li>text-emphasis:none, <a href="#none5"
55855625
title="text-emphasis:none"><strong>10.2.1.</strong></a>
55865626

55875627
<li>text-emphasis:open, <a href="#open"
@@ -5630,6 +5670,9 @@ <h2 class=no-num id=index>Index</h2>
56305670
<li>text-justify:kashida, <a href="#kashida"
56315671
title="text-justify:kashida"><strong>7.3.</strong></a>
56325672

5673+
<li>text-justify:none, <a href="#none1"
5674+
title="text-justify:none"><strong>7.3.</strong></a>
5675+
56335676
<li>text-justify:trim, <a href="#trim"
56345677
title="text-justify:trim"><strong>7.3.</strong></a>
56355678

0 commit comments

Comments
 (0)