[html5] r2001 - [g] (2) Define 'directionality' in terms of the dir='' attribute for cases where [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Aug 5 02:16:18 PDT 2008


Author: ianh
Date: 2008-08-05 02:16:17 -0700 (Tue, 05 Aug 2008)
New Revision: 2001

Modified:
   index
   source
Log:
[g] (2) Define 'directionality' in terms of the dir='' attribute for cases where the 'direction' property has no computed value. (credit: db)

Modified: index
===================================================================
--- index	2008-08-05 07:58:03 UTC (rev 2000)
+++ index	2008-08-05 09:16:17 UTC (rev 2001)
@@ -8000,17 +8000,27 @@
    <code title="">rtl</code> mapping to the state <em>rtl</em>. The attribute
    has no defaults.
 
-  <p>If the attribute has the state <em>ltr</em>, the element's
-   directionality is left-to-right. If the attribute has the state
-   <em>rtl</em>, the element's directionality is right-to-left. Otherwise,
-   the element's directionality is the same as its parent element, or
-   <em>ltr</em> if there is no parent element.
+  <p>The processing of this attribute is primarily performed by the
+   presentation layer. For example, CSS 2.1 defines a mapping from this
+   attribute to the CSS 'direction' and 'unicode-bidi' properties, and
+   defines rendering in terms of those properties.
 
-  <p>The processing of this attribute depends on the presentation layer. For
-   example, CSS 2.1 defines a mapping from this attribute to the CSS
-   'direction' and 'unicode-bidi' properties, and defines rendering in terms
-   of those properties.</p>
-  <!-- XXXDIR -->
+  <p><dfn id=the-directionality>The directionality</dfn> of an element, which
+   is used in particular by the <code><a href="#canvas">canvas</a></code>
+   element's text rendering API, is either 'ltr' or 'rtl'. If the user agent
+   supports CSS and the 'direction' property on this element has a computed
+   value of either 'ltr' or 'rtl', then that is <a
+   href="#the-directionality">the directionality</a> of the element.
+   Otherwise, if the element is being rendered, then <a
+   href="#the-directionality">the directionality</a> of the element is the
+   directionality used by the presentation layer, potentially determined from
+   the value of the <code title=attr-dir><a href="#dir">dir</a></code>
+   attribute on the element. Otherwise, if the element's <code
+   title=attr-dir><a href="#dir">dir</a></code> attribute has the state
+   <em>ltr</em>, the element's directionality is 'ltr' (left-to-right); if
+   the attribute has the state <em>rtl</em>, the element's directionality is
+   'rtl' (right-to-left); and oherwise, the element's directionality is the
+   same as its parent element, or 'ltr' if there is no parent element.
 
   <p>The <dfn id=dir0 title=dom-dir><code>dir</code></dfn> DOM attribute on
    an element must <a href="#reflect">reflect</a> the <code title=attr-dir><a
@@ -22304,14 +22314,11 @@
     <p>Form a hypothetical infinitely wide CSS line box containing a single
      inline box containing the text <var title="">text</var>, with all the
      properties at their initial values except the 'font' property of the
-     inline element set to <var title="">font</var> and the 'direction'
-     property of the inline element set to the 'direction' property of the
-     <code><a href="#canvas">canvas</a></code> element. <a
-     href="#refsCSS">[CSS]</a>
+     inline box set to <var title="">font</var> and the 'direction' property
+     of the inline box set to <a href="#the-directionality">the
+     directionality</a> of the <code><a href="#canvas">canvas</a></code>
+     element. <a href="#refsCSS">[CSS]</a>
    </li>
-   <!-- XXXDIR somehow mention
-   somewhere that if you don't support CSS, dir="" still maps to
-   'direction' for the purposes of things like this. -->
    <!-- if you insert a step here, make sure to adjust the next step's
    final words -->
 
@@ -22339,13 +22346,13 @@
 
      <dt> If <code title=dom-context-2d-textAlign><a
       href="#textalign">textAlign</a></code> is <code title="">start</code>
-      and the 'direction'<!--XXXDIR--> property on the <code><a
-      href="#canvas">canvas</a></code> element has a computed value of 'ltr'
+      and <span>the directionality of the <code><a
+      href="#canvas">canvas</a></code> element is 'ltr'</span>
 
      <dt> If <code title=dom-context-2d-textAlign><a
       href="#textalign">textAlign</a></code> is <code title="">end</code> and
-      the 'direction'<!--XXXDIR--> property on the <code><a
-      href="#canvas">canvas</a></code> element has a computed value of 'rtl'
+      <span>the directionality of the <code><a
+      href="#canvas">canvas</a></code> element is 'rtl'</span>
 
      <dd>Let the <var title="">anchor point</var>'s horizontal position be
       the left edge of the inline box.
@@ -22355,13 +22362,13 @@
 
      <dt> If <code title=dom-context-2d-textAlign><a
       href="#textalign">textAlign</a></code> is <code title="">end</code> and
-      the 'direction'<!--XXXDIR--> property on the <code><a
-      href="#canvas">canvas</a></code> element has a computed value of 'ltr'
+      <span>the directionality of the <code><a
+      href="#canvas">canvas</a></code> element is 'ltr'</span>
 
      <dt> If <code title=dom-context-2d-textAlign><a
       href="#textalign">textAlign</a></code> is <code title="">start</code>
-      and the 'direction'<!--XXXDIR--> property on the <code><a
-      href="#canvas">canvas</a></code> element has a computed value of 'rtl'
+      and <span>the directionality of the <code><a
+      href="#canvas">canvas</a></code> element is 'rtl'</span>
 
      <dd>Let the <var title="">anchor point</var>'s horizontal position be
       the right edge of the inline box.
@@ -22489,10 +22496,10 @@
    <li><p>Form a <em class="big-issue">whatever CSS ends up calling
    vertical line boxes and inline boxes</em> containing the text <var
    title="">text</var>, with all the properties at their initial
-   values except the 'font' property of the inline element set to <var
+   values except the 'font' property of the inline box set to <var
    title="">font</var> and the 'direction' property of the inline
-   element set to the 'direction' property of the <code>canvas</code>
-   element.</p></li><!- - XXXDIR - ->
+   box set to <span>the directionality<//span> of the <code>canvas</code>
+   element.</p></li>
 
    <!- - if you insert a step here, make sure to adjust the next step's
    final words - ->
@@ -22521,14 +22528,12 @@
      title="">start</code></dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">left</code> and the 'direction'<!- -XXXDIR- -> property
-     on the <code>canvas</code> element has a computed value of
-     'ltr'</dt>
+     title="">left</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'ltr'</dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">right</code> and the 'direction'<!- -XXXDIR- -> property
-     on the <code>canvas</code> element has a computed value of
-     'rtl'</dt>
+     title="">right</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'rtl'</dt>
 
      <dd>Let the <var title="">anchor point</var>'s vertical
      position be the top edge of the <em class="big-issue">inline
@@ -22539,14 +22544,12 @@
      title="">end</code></dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">right</code> and the 'direction'<!- -XXXDIR- -> property
-     on the <code>canvas</code> element has a computed value of
-     'ltr'</dt>
+     title="">right</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'ltr'</dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">left</code> and the 'direction'<!- -XXXDIR- -> property on
-     the <code>canvas</code> element has a computed value of
-     'rtl'</dt>
+     title="">left</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'rtl'</dt>
 
      <dd>Let the <var title="">anchor point</var>'s vertical
      position be the bottom edge of the <em class="big-issue">inline

Modified: source
===================================================================
--- source	2008-08-05 07:58:03 UTC (rev 2000)
+++ source	2008-08-05 09:16:17 UTC (rev 2001)
@@ -5865,18 +5865,28 @@
   mapping to the state <em>rtl</em>. The attribute has no
   defaults.</p>
 
-  <p>If the attribute has the state <em>ltr</em>, the element's
-  directionality is left-to-right. If the attribute has the state
-  <em>rtl</em>, the element's directionality is
-  right-to-left. Otherwise, the element's directionality is the same
-  as its parent element, or <em>ltr</em> if there is no parent
+  <p>The processing of this attribute is primarily performed by the
+  presentation layer. For example, CSS 2.1 defines a mapping from this
+  attribute to the CSS 'direction' and 'unicode-bidi' properties, and
+  defines rendering in terms of those properties.</p>
+
+  <p><dfn>The directionality</dfn> of an element, which is used in
+  particular by the <code>canvas</code> element's text rendering API,
+  is either 'ltr' or 'rtl'. If the user agent supports CSS and the
+  'direction' property on this element has a computed value of either
+  'ltr' or 'rtl', then that is <span>the directionality</span> of the
+  element. Otherwise, if the element is being rendered, then <span>the
+  directionality</span> of the element is the directionality used by
+  the presentation layer, potentially determined from the value of the
+  <code title="attr-dir">dir</code> attribute on the
+  element. Otherwise, if the element's <code
+  title="attr-dir">dir</code> attribute has the state <em>ltr</em>,
+  the element's directionality is 'ltr' (left-to-right); if the
+  attribute has the state <em>rtl</em>, the element's directionality
+  is 'rtl' (right-to-left); and oherwise, the element's directionality
+  is the same as its parent element, or 'ltr' if there is no parent
   element.</p>
 
-  <p>The processing of this attribute depends on the presentation
-  layer. For example, CSS 2.1 defines a mapping from this attribute to
-  the CSS 'direction' and 'unicode-bidi' properties, and defines
-  rendering in terms of those properties.</p><!-- XXXDIR -->
-
   <p>The <dfn title="dom-dir"><code>dir</code></dfn> DOM attribute on
   an element must <span>reflect</span> the <code
   title="attr-dir">dir</code> content attribute of that element,
@@ -19519,12 +19529,10 @@
    <li><p>Form a hypothetical infinitely wide CSS line box containing
    a single inline box containing the text <var title="">text</var>,
    with all the properties at their initial values except the 'font'
-   property of the inline element set to <var title="">font</var> and
-   the 'direction' property of the inline element set to the
-   'direction' property of the <code>canvas</code> element. <a
-   href="#refsCSS">[CSS]</a></p></li><!-- XXXDIR somehow mention
-   somewhere that if you don't support CSS, dir="" still maps to
-   'direction' for the purposes of things like this. -->
+   property of the inline box set to <var title="">font</var> and the
+   'direction' property of the inline box set to <span>the
+   directionality</span> of the <code>canvas</code> element. <a
+   href="#refsCSS">[CSS]</a></p></li>
 
    <!-- if you insert a step here, make sure to adjust the next step's
    final words -->
@@ -19554,14 +19562,12 @@
      title="">left</code></dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">start</code> and the 'direction'<!--XXXDIR--> property
-     on the <code>canvas</code> element has a computed value of
-     'ltr'</dt>
+     title="">start</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'ltr'</dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">end</code> and the 'direction'<!--XXXDIR--> property
-     on the <code>canvas</code> element has a computed value of
-     'rtl'</dt>
+     title="">end</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'rtl'</dt>
 
      <dd>Let the <var title="">anchor point</var>'s horizontal
      position be the left edge of the inline box.</dd>
@@ -19572,14 +19578,12 @@
      title="">right</code></dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">end</code> and the 'direction'<!--XXXDIR--> property
-     on the <code>canvas</code> element has a computed value of
-     'ltr'</dt>
+     title="">end</code> and  <span>the directionality<//span> of the
+     <code>canvas</code> element is 'ltr'</dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">start</code> and the 'direction'<!--XXXDIR--> property
-     on the <code>canvas</code> element has a computed value of
-     'rtl'</dt>
+     title="">start</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'rtl'</dt>
 
      <dd>Let the <var title="">anchor point</var>'s horizontal
      position be the right edge of the inline box.</dd>
@@ -19723,10 +19727,10 @@
    <li><p>Form a <em class="big-issue">whatever CSS ends up calling
    vertical line boxes and inline boxes</em> containing the text <var
    title="">text</var>, with all the properties at their initial
-   values except the 'font' property of the inline element set to <var
+   values except the 'font' property of the inline box set to <var
    title="">font</var> and the 'direction' property of the inline
-   element set to the 'direction' property of the <code>canvas</code>
-   element.</p></li><!- - XXXDIR - ->
+   box set to <span>the directionality<//span> of the <code>canvas</code>
+   element.</p></li>
 
    <!- - if you insert a step here, make sure to adjust the next step's
    final words - ->
@@ -19755,14 +19759,12 @@
      title="">start</code></dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">left</code> and the 'direction'<!- -XXXDIR- -> property
-     on the <code>canvas</code> element has a computed value of
-     'ltr'</dt>
+     title="">left</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'ltr'</dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">right</code> and the 'direction'<!- -XXXDIR- -> property
-     on the <code>canvas</code> element has a computed value of
-     'rtl'</dt>
+     title="">right</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'rtl'</dt>
 
      <dd>Let the <var title="">anchor point</var>'s vertical
      position be the top edge of the <em class="big-issue">inline
@@ -19773,14 +19775,12 @@
      title="">end</code></dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">right</code> and the 'direction'<!- -XXXDIR- -> property
-     on the <code>canvas</code> element has a computed value of
-     'ltr'</dt>
+     title="">right</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'ltr'</dt>
      <dt> If <code
      title="dom-context-2d-textAlign">textAlign</code> is <code
-     title="">left</code> and the 'direction'<!- -XXXDIR- -> property on
-     the <code>canvas</code> element has a computed value of
-     'rtl'</dt>
+     title="">left</code> and <span>the directionality<//span> of the
+     <code>canvas</code> element is 'rtl'</dt>
 
      <dd>Let the <var title="">anchor point</var>'s vertical
      position be the bottom edge of the <em class="big-issue">inline




More information about the Commit-Watchers mailing list