Spec WG consensus on text-combine, first cut.

Author: fantasai

css3-writing-modes/Overview.html

@@ -271,8 +271,8 @@ <h2 class="no-num no-toc" id=Contents> Table of Contents</h2>
     page progression direction</a>
 
    <li><a href="#text-combine"><span class=secno>9. </span> Glyph
-    Composition: the &lsquo;<code class=property>text-combine</code>&rsquo;
-    property</a>
+    Composition: the &lsquo;<code
+    class=property>text-combine-horizontal</code>&rsquo; property</a>
 
    <li class=no-num><a href="#changes">Changes</a>
     <ul class=toc>
@@ -2729,20 +2729,21 @@ <h2 id=page-direction><span class=secno>8. </span> Page Flow: the page
    progression.)
 
   <h2 id=text-combine><span class=secno>9. </span> Glyph Composition: the
-   &lsquo;<a href="#text-combine0"><code
-   class=property>text-combine</code></a>&rsquo; property</h2>
+   &lsquo;<a href="#text-combine-horizontal"><code
+   class=property>text-combine-horizontal</code></a>&rsquo; property</h2>
 
   <table class=propdef>
    <tbody>
     <tr>
      <th>Name:
 
-     <td><dfn id=text-combine0>text-combine</dfn>
+     <td><dfn id=text-combine-horizontal>text-combine-horizontal</dfn>
 
     <tr>
      <th>Value:
 
-     <td>none | [ horizontal &lt;number&gt;? ]
+     <td>none | all | [ digits &lt;integer>? || alpha &lt;integer>? ||
+      alphanumeric &lt;integer>? ] && [ use-glyphs | scale ]?
 
     <tr>
      <th>Initial:
@@ -2757,7 +2758,7 @@ <h2 id=text-combine><span class=secno>9. </span> Glyph Composition: the
     <tr>
      <th>Inherited:
 
-     <td>no
+     <td>yes
 
     <tr>
      <th>Percentages:
@@ -2786,33 +2787,71 @@ <h2 id=text-combine><span class=secno>9. </span> Glyph Composition: the
 
    <dd>No special processing.
 
-   <dt><dfn id=horizontal title="text-combine:horizontal">horizontal</dfn>
+   <dt><dfn id=all title="text-combine:all">all</dfn>
 
    <dd>
     <p>In vertical writing mode, attempt to display the text contents of the
      element horizontally within the vertical line box, ideally within the
      space of one ideographic character (1em square).
 
-    <p>The glyphs are stacked horizontally (similar to the contents of an
-     inline-box with a horizontal writing mode and a line-height of 1em) and
-     the baseline of the resulting composition chosen such that it is
-     centered between the content edges of its parent inline box.
-
-    <p>The UA should determine how to render the composed glyph into the
-     space. If the UA has compressed glyphs available for the contents of the
-     element, then it may use those glyphs to attempt sizing the contents to
-     1em square. For example, a two digit number may use halfwidth or
-     proportional glyphs, a three-digit number may use 1/3-em glyphs (if
-     available, else halfwidth glyphs), etc.
+    <p>The combined glyphs are stacked horizontally (similar to the contents
+     of an inline-box with a horizontal writing mode and a line-height of
+     1em) and the baseline of the resulting composition chosen such that it
+     is centered between the content edges of its parent inline box. The
+     effective height of the composition is assumed to be 1em square;
+     anything outside the square bleeds and is not measured for layout
+     purposes.
+
+    <p>In horizontal mode, this value is equivalent to &lsquo;<code
+     class=css>none</code>&rsquo;.
+
+   <dt><dfn id=digits title="text-combine:digits">digits</dfn>
+
+   <dd>Within the element, each sequence of consecutive horizontal digits
+    that has as many or fewer characters than the integer given (or 2, if
+    none is given) is treated as if it were in an anonymous inline box with
+    &lsquo;<code class=css>text-combine: all</code>&rsquo;. For this
+    property, a digit is any character belonging to a Number category (N*)
+    that does not belong to a vertical script.
+
+   <dt><dfn id=alpha title="text-combine:alpha">alpha</dfn>
+
+   <dd>Within the element, each sequence of consecutive horizontal letters
+    that has as many or fewer characters than the integer given (or 2, if
+    none is given) is treated as if it were in an anonymous inline box with
+    &lsquo;<code class=css>text-combine: all</code>&rsquo;. For this
+    property, a horizonal letter is any character belonging to a Letter
+    category (L*) that is not East Asian Fullwidth or Wide, and that does not
+    belong to a vertical script.
+
+   <dt><dfn id=alphanumeric
+    title="text-combine:alphanumeric">alphanumeric</dfn>
+  </dl>
 
-    <p>The UA may scale the contents to fit instead, or in addition to the
-     method above.
+  <p>Within the element, each sequence of consecutive horizontal digits
+   and/or letters that has as many or fewer characters than the integer given
+   (or 2, if none is given) is treated as if it were in an anonymous inline
+   box with &lsquo;<code class=css>text-combine: all</code>&rsquo;.
 
-    <p>In horizontal mode, or if the number of <i>grapheme clusters</i> in
-     the element exceeds the number specified (if any), this value is
-     equivalent to &lsquo;<code class=css>none</code>&rsquo;.
+  <dl>
+   <dt><dfn id=use-glyphs title="text-combine:use-glyphs">use-glyphs</dfn> If
+    the UA has compressed glyphs available for the contents of the element,
+    then it must use those glyphs to attempt sizing the contents to 1em
+    square. For example, a two digit number may use halfwidth or proportional
+    glyphs, a three-digit number may use 1/3-em glyphs (if available, else
+    halfwidth glyphs), etc. If such glyphs are not available, the UA must
+    compress the composition horizontally until they fit within the 1em
+    square.
+
+   <dt><dfn id=scale title="text-combine:scale">scale</dfn> Compress the
+    composition horizontally until it fits within 1em square.
   </dl>
 
+  <p class=issue>Define interaction with text-transform
+
+  <p class=issue>Do we need a tolerance value for scaling? (e.g. 1.1 instead
+   of 1em)
+
   <div class=example>
    <p>In East Asian documents, the &lsquo;<code class=css>text-combine:
     horizontal</code>&rsquo; effect is often used to display Latin-based
@@ -2844,13 +2883,6 @@ <h2 id=text-combine><span class=secno>9. </span> Glyph Composition: the
 
    <p>In Japanese, this effect is known as <i lang=ja>tate-chu-yoko</i>.
   </div>
-  <!--
-    Some people have requested a way to have numbers
-    automatically text-combine'd. Maybe a text-auto-combine property?
-    Note that whether a number should be tate-chu-yoko'd is often
-    context-sensitive: this would give very weird results when applied
-    to an arbitrary paragraph.</p>
--->
 
   <h2 class=no-num id=changes>Changes</h2>
 
@@ -3675,15 +3707,17 @@ <h2 class=no-num id=property-index> Property Index</h2>
      <td>as defined in [CSS21]
 
     <tr>
-     <td><a class=property href="#text-combine0">text-combine</a>
+     <td><a class=property
+      href="#text-combine-horizontal">text-combine-horizontal</a>
 
-     <td>none | [ horizontal &lt;number&gt;? ]
+     <td>none | all | [ digits &lt;integer>? || alpha &lt;integer>? ||
+      alphanumeric &lt;integer>? ] && [ use-glyphs | scale ]?
 
      <td>none
 
      <td>non-replaced inline elements
 
-     <td>no
+     <td>yes
 
      <td>N/A
 

css3-writing-modes/Overview.src.html

@@ -2029,17 +2029,19 @@ <h2 id="page-direction">
     progression.)
 
 <h2 id="text-combine">
-Glyph Composition: the 'text-combine' property</h2>
+Glyph Composition: the 'text-combine-horizontal' property</h2>
 
   <table class="propdef">
     <tbody>
       <tr>
         <th>Name:</th>
-        <td><dfn>text-combine</dfn></td>
+        <td><dfn>text-combine-horizontal</dfn></td>
       </tr>
       <tr>
         <th>Value:</th>
-        <td>none | [ horizontal &lt;number&gt;? ]</td>
+        <td>none | all |
+            [ digits &lt;integer>? || alpha &lt;integer>? || alphanumeric &lt;integer>? ]
+            && [ use-glyphs | scale ]?</td>
       </tr>
       <tr>
         <th>Initial:</th>
@@ -2051,7 +2053,7 @@ <h2 id="text-combine">
       </tr>
       <tr>
         <th>Inherited:</th>
-        <td>no</td>
+        <td>yes</td>
       </tr>
       <tr>
         <th>Percentages:</th>
@@ -2078,30 +2080,53 @@ <h2 id="text-combine">
   <dl>
     <dt><dfn title="text-combine:none">none</dfn>
     <dd>No special processing.</dd>
-    <dt><dfn title="text-combine:horizontal">horizontal</dfn>
+    <dt><dfn title="text-combine:all">all</dfn>
     <dd><p>In vertical writing mode, attempt to display the text contents
       of the element horizontally within the vertical line box, ideally
       within the space of one ideographic character (1em square).
-    <p>The glyphs are stacked
+    <p>The combined glyphs are stacked
       horizontally (similar to the contents of an inline-box with a
       horizontal writing mode and a line-height of 1em) and the baseline
       of the resulting composition chosen such that it is centered between
-      the content edges of its parent inline box.
-    <p>The UA should determine how to render the composed glyph
-      into the space.
+      the content edges of its parent inline box. The effective height of
+      the composition is assumed to be 1em square; anything outside the
+      square bleeds and is not measured for layout purposes.
+    <p>In horizontal mode, this value is equivalent to ''none''.
+    <dt><dfn title="text-combine:digits">digits</dfn>
+    <dd>Within the element, each sequence of consecutive horizontal digits
+      that has as many or fewer characters than the integer given (or 2,
+      if none is given) is treated as if it were in an anonymous inline box
+      with ''text-combine: all''. 
+      For this property, a digit is any character belonging to a Number
+      category (N*) that does not belong to a vertical script.
+    <dt><dfn title="text-combine:alpha">alpha</dfn>
+    <dd>Within the element, each sequence of consecutive horizontal letters
+      that has as many or fewer characters than the integer given (or 2,
+      if none is given) is treated as if it were in an anonymous inline box
+      with ''text-combine: all''. 
+      For this property, a horizonal letter is any character belonging to
+      a Letter category (L*) that is not East Asian Fullwidth or Wide, and
+      that does not belong to a vertical script.
+    <dt><dfn title="text-combine:alphanumeric">alphanumeric</dfn>
+    <p>Within the element, each sequence of consecutive horizontal digits and/or
+      letters that has as many or fewer characters than the integer given (or 2,
+      if none is given) is treated as if it were in an anonymous inline box
+      with ''text-combine: all''.
+    <dt><dfn title="text-combine:use-glyphs">use-glyphs</dfn>
       If the UA has compressed glyphs available for the contents of the
-      element, then it may use those glyphs to attempt sizing the
+      element, then it must use those glyphs to attempt sizing the
       contents to 1em square. For example, a two digit number may use
       halfwidth or proportional glyphs, a three-digit number may use 1/3-em glyphs
       (if available, else halfwidth glyphs), etc.
-    <p>The UA may scale the contents to fit instead,
-      or in addition to the method above.
-    <p>In horizontal mode, or if the number of <i>grapheme clusters</i> in the
-      element exceeds the number specified (if any), this value is
-      equivalent to ''none''.
-    </dd>
+      If such glyphs are not available, the UA must compress the composition
+      horizontally until they fit within the 1em square.
+    <dt><dfn title="text-combine:scale">scale</dfn>
+      Compress the composition horizontally until it fits within 1em square.
   </dl>
 
+  <p class="issue">Define interaction with text-transform
+  <p class="issue">Do we need a tolerance value for scaling? (e.g. 1.1 instead of 1em)
+
   <div class="example">
     <p>In East Asian documents, the ''text-combine: horizontal'' effect is often
       used to display Latin-based strings such as components of a date or
@@ -2129,14 +2154,6 @@ <h2 id="text-combine">
     <p>In Japanese, this effect is known as <i lang="ja">tate-chu-yoko</i>.
   </div>
 
-<!--
-    Some people have requested a way to have numbers
-    automatically text-combine'd. Maybe a text-auto-combine property?
-    Note that whether a number should be tate-chu-yoko'd is often
-    context-sensitive: this would give very weird results when applied
-    to an arbitrary paragraph.</p>
--->
-
 <h2 class="no-num" id="changes">Changes</h2>
   <h3 class="no-num" id="recent-changes">
   Changes from the <a href="http://www.w3.org/TR/2011/WD-css3-writing-modes-20110428/">April