W3C home > Mailing lists > Public > public-html-commits@w3.org > August 2008

html5/spec Overview.html,1.1189,1.1190

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 05 Aug 2008 09:16:54 +0000
To: public-html-commits@w3.org
Message-Id: <E1KQIf0-0005l6-UT@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv21915

Modified Files:
	Overview.html 
Log Message:
Define 'directionality' in terms of the dir='' attribute for cases where the 'direction' property has no computed value. (credit: db) (whatwg r2001)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1189
retrieving revision 1.1190
diff -u -d -r1.1189 -r1.1190
--- Overview.html	5 Aug 2008 07:58:07 -0000	1.1189
+++ Overview.html	5 Aug 2008 09:16:52 -0000	1.1190
@@ -8028,17 +8028,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
@@ -22332,14 +22342,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="#references">[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="#references">[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 -->
 
@@ -22367,13 +22374,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.
@@ -22383,13 +22390,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.
@@ -22517,10 +22524,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 - ->
@@ -22549,14 +22556,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
@@ -22567,14 +22572,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
Received on Tuesday, 5 August 2008 09:17:35 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:32:58 GMT