Comment out prose describing 'dashed-attribute' behavior until a consensus is obtained on its inclusion.

Wed, 05 Jun 2013 09:36:49 +0900

author
Glenn Adams <glenn@skynav.com>
date
Wed, 05 Jun 2013 09:36:49 +0900
changeset 8354
965c8c7076a7
parent 8353
f66bca0312f4
child 8355
9a174c139361

Comment out prose describing 'dashed-attribute' behavior until a consensus is obtained on its inclusion.

cssom/Overview.html file | annotate | diff | comparison | revisions
cssom/Overview.src.html file | annotate | diff | comparison | revisions
     1.1 --- a/cssom/Overview.html	Wed Jun 05 00:05:13 2013 +0200
     1.2 +++ b/cssom/Overview.html	Wed Jun 05 09:36:49 2013 +0900
     1.3 @@ -32,14 +32,14 @@
     1.4  <div class="head">
     1.5   
     1.6  <!--begin-logo-->
     1.7 -<p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="https://www.w3.org/Icons/w3c_home" width="72"></a></p>
     1.8 +<p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"></a></p>
     1.9  <!--end-logo-->
    1.10  
    1.11  
    1.12   <h1>CSS Object Model (CSSOM)</h1>
    1.13  
    1.14  
    1.15 - <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 4 June 2013</h2>
    1.16 + <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 5 June 2013</h2>
    1.17  
    1.18   <dl>
    1.19  
    1.20 @@ -105,7 +105,7 @@
    1.21  can be found in the
    1.22  <a href="http://www.w3.org/TR/">W3C technical reports index at http://www.w3.org/TR/.</a></em>
    1.23  
    1.24 -<p class="dontpublish">This is the 4 June 2013 Editor's Draft of CSSOM. Please send comments to
    1.25 +<p class="dontpublish">This is the 5 June 2013 Editor's Draft of CSSOM. Please send comments to
    1.26  <a href="mailto:www-style@w3.org?subject=%5Bcssom%5D%20">www-style@w3.org</a>
    1.27  (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
    1.28  with <samp>[cssom]</samp> at the start of the subject line.
    1.29 @@ -2286,31 +2286,35 @@
    1.30  
    1.31  <p class="example">For example, for the 'font-size' property there would be a <code title="">fontSize</code> IDL attribute.
    1.32  
    1.33 -<p>For each CSS property <var title="">property</var> that the user agent supports, except for properties that have no "<code title="">-</code>" (U+002D) in the
    1.34 -property name, user agents must act as if there was a WebIDL <a class="external" href="http://dev.w3.org/2006/webapi/WebIDL/#dfn-regular-attribute">regular attribute</a> member as part of the
    1.35 -<code><a href="#cssstyledeclaration">CSSStyleDeclaration</a></code> interface with the type being <code title="">DOMString</code> and the <a class="external" href="http://dev.w3.org/2006/webapi/WebIDL/#dfn-identifier">identifier</a> being
    1.36 -<var title="">property</var>, and let <var title="">dashed attribute</var> be <var title="">property</var>.
    1.37 -
    1.38 -<p>The <dfn id="dom-cssstyledeclaration-dashed-attribute" title="dom-CSSStyleDeclaration-dashed-attribute"><code><var title="">dashed attribute</var></code></dfn> attribute, on getting, must return the
    1.39 -result of invoking <code title="dom-CSSStyleDeclaration-getPropertyValue"><a href="#dom-cssstyledeclaration-getpropertyvalue">getPropertyValue()</a></code> with the
    1.40 -argument being <var title="">dashed attribute</var>.</p>
    1.41 -
    1.42 -<p>Setting the <code title="dom-CSSStyleDeclaration-dashed-attribute"><a href="#dom-cssstyledeclaration-dashed-attribute"><var title="">dashed attribute</var></a></code> attribute must invoke
    1.43 -<code title="dom-CSSStyleDeclaration-setProperty"><a href="#dom-cssstyledeclaration-setproperty">setProperty()</a></code> with the
    1.44 -first argument being <var title="">dashed attribute</var>, as second argument the given value, and no third argument. Any
    1.45 +<!-- [GA] Remove spec text for so called "dashed-attribute" until consensus obtains on whether to include in spec.
    1.46 +
    1.47 +<p>For each CSS property <var title>property</var> that the user agent supports, except for properties that have no "<code title>-</code>" (U+002D) in the
    1.48 +property name, user agents must act as if there was a WebIDL <span data-anolis-spec=webidl>regular attribute</span> member as part of the
    1.49 +<code>CSSStyleDeclaration</code> interface with the type being <code title>DOMString</code> and the <span data-anolis-spec=webidl>identifier</span> being
    1.50 +<var title>property</var>, and let <var title>dashed attribute</var> be <var title>property</var>.
    1.51 +
    1.52 +<p>The <dfn title=dom-CSSStyleDeclaration-dashed-attribute><code><var title>dashed attribute</var></code></dfn> attribute, on getting, must return the
    1.53 +result of invoking <code title=dom-CSSStyleDeclaration-getPropertyValue>getPropertyValue()</code> with the
    1.54 +argument being <var title>dashed attribute</var>.</p>
    1.55 +
    1.56 +<p>Setting the <code title=dom-CSSStyleDeclaration-dashed-attribute><var title>dashed attribute</var></code> attribute must invoke
    1.57 +<code title=dom-CSSStyleDeclaration-setProperty>setProperty()</code> with the
    1.58 +first argument being <var title>dashed attribute</var>, as second argument the given value, and no third argument. Any
    1.59  exceptions thrown must be re-thrown.</p>
    1.60  
    1.61 -<div class="example">
    1.62 - <p>For example, for the 'font-size' property there would be a <code title="">font-size</code> IDL attribute. In JavaScript, the property can be accessed as
    1.63 - follows, assuming <var title="">element</var> is an <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/infrastructure.html#html-elements" title="HTML elements">HTML element</a>:
    1.64 - <pre><var title="">element</var>.style['font-size'];</pre>
    1.65 +<div class=example>
    1.66 + <p>For example, for the 'font-size' property there would be a <code title>font-size</code> IDL attribute. In JavaScript, the property can be accessed as
    1.67 + follows, assuming <var title>element</var> is an <span data-anolis-spec=html title="HTML elements">HTML element</span>:
    1.68 + <pre><var title>element</var>.style['font-size'];</pre>
    1.69  </div>
    1.70  
    1.71 -<p class="note">WebIDL does not allow dashes in identifiers in its syntax.
    1.72 -
    1.73 -<p class="XXX">The <code title="dom-CSSStyleDeclaration-dashed-attribute"><a href="#dom-cssstyledeclaration-dashed-attribute"><var title="">dashed attribute</var></a></code> attributes will be removed from the specification
    1.74 +<p class=note>WebIDL does not allow dashes in identifiers in its syntax.
    1.75 +
    1.76 +<p class=XXX>The <code title=dom-CSSStyleDeclaration-dashed-attribute><var title>dashed attribute</var></code> attributes will be removed from the specification
    1.77  if implementations remove support. User agents that currently support them are urged to experiment with removing support.
    1.78  
    1.79 +-->
    1.80 +
    1.81  <p>The <dfn id="css-property-to-idl-attribute">CSS property to IDL attribute</dfn> algorithm for <var title="">property</var> is as
    1.82  follows:</p>
    1.83  
     2.1 --- a/cssom/Overview.src.html	Wed Jun 05 00:05:13 2013 +0200
     2.2 +++ b/cssom/Overview.src.html	Wed Jun 05 09:36:49 2013 +0900
     2.3 @@ -2217,6 +2217,8 @@
     2.4  
     2.5  <p class=example>For example, for the 'font-size' property there would be a <code title>fontSize</code> IDL attribute.
     2.6  
     2.7 +<!-- [GA] Remove spec text for so called "dashed-attribute" until consensus obtains on whether to include in spec.
     2.8 +
     2.9  <p>For each CSS property <var title>property</var> that the user agent supports, except for properties that have no "<code title>-</code>" (U+002D) in the
    2.10  property name, user agents must act as if there was a WebIDL <span data-anolis-spec=webidl>regular attribute</span> member as part of the
    2.11  <code>CSSStyleDeclaration</code> interface with the type being <code title>DOMString</code> and the <span data-anolis-spec=webidl>identifier</span> being
    2.12 @@ -2242,6 +2244,8 @@
    2.13  <p class=XXX>The <code title=dom-CSSStyleDeclaration-dashed-attribute><var title>dashed attribute</var></code> attributes will be removed from the specification
    2.14  if implementations remove support. User agents that currently support them are urged to experiment with removing support.
    2.15  
    2.16 +-->
    2.17 +
    2.18  <p>The <dfn>CSS property to IDL attribute</dfn> algorithm for <var title>property</var> is as
    2.19  follows:</p>
    2.20  

mercurial