changeset
(1) move CSSStyleDeclaration member documentation into IDL;
Mon, 16 Jul 2012 09:50:04 -0600
- author
- Glenn Adams <glenn@skynav.com>
- date
- Mon, 16 Jul 2012 09:50:04 -0600
- changeset 6230
- 02cca9d95899
- parent 6229
- b721960fdbf2
- child 6231
- 4f093aa74a83
(1) move CSSStyleDeclaration member documentation into IDL;
(2) fix idl makefile deps
1.1 --- a/cssom/Overview.html Mon Jul 16 00:55:13 2012 -0600 1.2 +++ b/cssom/Overview.html Mon Jul 16 09:50:04 2012 -0600 1.3 @@ -1805,7 +1805,7 @@ 1.4 1.5 <p class="note">The <a href="#css-declaration-block-declarations">CSS declaration block declarations</a> are 1.6 ordered. This matters for the 1.7 - <code title="dom-CSSStyleDeclaration-item"><a href="#dom-cssstyledeclaration-item">item()</a></code> method.</p> 1.8 + <code title="dom-CSSStyleDeclaration-item">item()</code> method.</p> 1.9 1.10 1.11 <p class="XXX">To 1.12 @@ -1822,7 +1822,7 @@ 1.13 1.14 <h4 id="the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The <code>CSSStyleDeclaration</code> Interface</h4> 1.15 1.16 - 1.17 + <p>The <code>CSSStyleDeclaration</code> interface represents a <a href="#css-declaration-block">CSS declaration block</a>, including its underlying state, where this underlying state depends upon the source of the <code>CSSStyleDeclaration</code> instance.</p> 1.18 <pre class="idl"><span class="idlInterface" id="widl-def-CSSStyleDeclaration">interface <span class="idlInterfaceID">CSSStyleDeclaration</span> { 1.19 <span class="idlAttribute"> attribute <span class="idlAttrType"><a>DOMString</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-cssText">cssText</a></span>;</span> 1.20 <span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>unsigned long</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-length">length</a></span>;</span> 1.21 @@ -1836,175 +1836,52 @@ 1.22 <dl class="attributes"> 1.23 <dt class="attribute"> 1.24 <code>cssText</code> of type <span class="idlAttrType"><a>DOMString</a></span></dt> 1.25 +<dd> 1.26 +<p>The <code>cssText</code> attribute must return the result of <a href="#serialize-a-css-declaration-block" title="serialize a CSS declaration block">serializing</a> the <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</p> <p>Setting the <code>cssText</code> attribute must run these steps: <ol> <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code> exception and terminate these steps.</li> <li><p>Empty the <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li> <li><p><a href="#parse-a-css-declaration-block" title="Parse a CSS declaration block">Parse</a> the given value and, if the return value is not null, insert it into the <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li> </ol></dd> 1.27 <dt class="attribute"> 1.28 <code>length</code> of type <span class="idlAttrType"><a>unsigned long</a></span>, readonly</dt> 1.29 +<dd> 1.30 +<p>The <code>length</code> attribute must return the number of declarations in the <span>collection of CSS declarations</span>.</dd> 1.31 <dt class="attribute"> 1.32 <code>parentRule</code> of type <span class="idlAttrType"><a>CSSRule</a></span>, readonly</dt> 1.33 +<dd> 1.34 +<p>The <code>parentRule</code> attribute must return the <code>CSSrule</code> object the <code>CSSStyleDeclaration</code> is object is associated with or null if it is not associated with a <code>CSSrule</code> object.</dd> 1.35 </dl> 1.36 <dl class="methods"> 1.37 <dt class="method"> 1.38 <code>item</code> (<span class="idlParam"><span class="idlParamType"><a>unsigned long</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 1.39 +<dd> 1.40 +<p>The <code>item</code> operation must return the property at position <var>index</var>.</dd> 1.41 <dt class="method"> 1.42 <code>getPropertyValue</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 1.43 +<dd> 1.44 +<p>The <code>getPropertyValue</code> operation must ...</dd> 1.45 <dt class="method"> 1.46 <code>getPropertyPriority</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 1.47 +<dd> 1.48 +<p>The <code>getPropertyPriority</code> operation, when invoked, if <var>property</var> is an <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a property that has a priority user agents must return the canonical priority of that property as given in the syntax definition. Otherwise, the empty string must be returned.</p> <p class="example">E.g. for <code>background-color:lime !IMPORTANT</code> the return value would be '<code>important</code>'.</dd> 1.49 <dt class="method"> 1.50 <code>setProperty</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>, <span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>, <span class="idlParam">optional <span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>void</a></span></dt> 1.51 +<dd> 1.52 +<p>The <code>setProperty</code> operation must run these steps:</p> <ol> <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> an '<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>' and terminate these steps.</li> <li><p>If <var>property</var> is not an <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a supported property, terminate this algorithm.</li> <li><p>If <var>value</var> is the empty string, invoke <code title="dom-CSSStyleDeclaration-removeProperty">removeProperty()</code> with <var>property</var> as argument and terminate this algorithm.</li> <li><p>If the <var>priority</var> argument has been omitted let <var>priority</var> be the empty string.</li> <li><p>If <var>priority</var> is neither a valid priority nor the empty string terminate this algorithm.</li> <li> <p>If <a href="#parse-a-css-value" title="parse a CSS value">parsing the <var>value</var></a> returns null terminate this algorithm. <p class="note"><var>value</var> can not include '<code>!important</code>'.</p> </li> <li><p>Finally, set <var>property</var> to <var>value</var> with priority <var>priority</var> when <var>priority</var> is not the empty string. Otherwise set <var>property</var> to <var>value</var>.</li> </ol></dd> 1.53 <dt class="method"> 1.54 <code>removeProperty</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 1.55 +<dd> 1.56 +<p>The <code>removeProperty</code> operation must run these steps:</p> <ol> <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a '<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>' and terminate these steps.</li> <li><p>If <var>property</var> is an <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a property of a declaration in the <span>collection of CSS declarations</span> remove the declaration.</li> </ol></dd> 1.57 </dl> 1.58 1.59 1.60 - <!-- 1.61 - <pre class="idl">interface <dfn>CSSStyleDeclaration</dfn> { 1.62 - attribute DOMString <span title="dom-CSSStyleDeclaration-cssText">cssText</span>; 1.63 - 1.64 - readonly attribute unsigned long <span title="dom-CSSStyleDeclaration-length">length</span>; 1.65 - DOMString <span title="dom-CSSStyleDeclaration-item">item</span>(unsigned long <var>index</var>); 1.66 - 1.67 - DOMString <span title="dom-CSSStyleDeclaration-getPropertyValue">getPropertyValue</span>(DOMString <var>property</var>); 1.68 - DOMString <span title="dom-CSSStyleDeclaration-getPropertyPriority">getPropertyPriority</span>(DOMString <var>property</var>); 1.69 - void <span title="dom-CSSStyleDeclaration-setProperty">setProperty</span>(DOMString <var>property</var>, DOMString <var>value</var>, optional DOMString <var>priority</var>); 1.70 - DOMString <span title="dom-CSSStyleDeclaration-removeProperty">removeProperty</span>(DOMString <var>property</var>); 1.71 - 1.72 - readonly attribute <span>CSSRule</span> <span title="dom-CSSStyleDeclaration-parentRule">parentRule</span>; 1.73 - 1.74 - // CSS Properties 1.75 -};</pre> 1.76 - --> 1.77 - 1.78 - <p>The 1.79 - <dfn id="dom-cssstyledeclaration-csstext" title="dom-CSSStyleDeclaration-cssText"><code>cssText</code></dfn> 1.80 - attribute must return the result of 1.81 - <a href="#serialize-a-css-declaration-block" title="serialize a CSS declaration block">serializing</a> the 1.82 - <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</p> 1.83 - 1.84 - <p>Setting the <code>cssText</code> attribute must run these steps: 1.85 - 1.86 - <ol> 1.87 - <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, 1.88 - <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a 1.89 - "<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>" exception 1.90 - and terminate these steps.</li> 1.91 - 1.92 - <li><p>Empty the <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li> 1.93 - 1.94 - <li><p><a href="#parse-a-css-declaration-block" title="Parse a CSS declaration block">Parse</a> the given 1.95 - value and, if the return value is not null, insert it into the 1.96 - <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li> 1.97 - </ol> 1.98 - 1.99 - 1.100 - <!-- XXX WebIDL work --> 1.101 - <p>The 1.102 - <dfn id="dom-cssstyledeclaration-length" title="dom-CSSStyleDeclaration-length"><code>length</code></dfn> 1.103 - attribute must return the number of declarations in 1.104 - the <span>collection of CSS declarations</span>.</p> 1.105 - 1.106 - <p>The 1.107 - <dfn id="dom-cssstyledeclaration-item" title="dom-CSSStyleDeclaration-item"><code>item(<var>index</var>)</code></dfn> 1.108 - method must <span class="XXX">...</span>.</p> 1.109 - <!-- returns the name of property at position index. --> 1.110 - 1.111 - 1.112 - <p>The 1.113 - <dfn id="dom-cssstyledeclaration-getpropertyvalue" title="dom-CSSStyleDeclaration-getPropertyValue"><code>getPropertyValue(<var>property</var>)</code></dfn> 1.114 - method must <span class="XXX">...</span>.</p> 1.115 - <!-- Once we have defined how everything will be canonicalized we can start 1.116 - thinking about this... --><p></p> 1.117 - 1.118 - <p>The 1.119 - <dfn id="dom-cssstyledeclaration-getpropertypriority" title="dom-CSSStyleDeclaration-getPropertyPriority"><code>getPropertyPriority(<var>property</var>)</code></dfn> 1.120 - method, when invoked, if <var>property</var> is an 1.121 - <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a 1.122 - property that has a priority user agents must return the canonical 1.123 - priority of that property as given in the syntax definition. Otherwise, 1.124 - the empty string must be returned.</p> 1.125 - 1.126 - <p class="example">E.g. for <code>background-color:lime !IMPORTANT</code> 1.127 - the return value would be "<code>important</code>".</p> 1.128 - 1.129 - 1.130 - <p>The 1.131 - <dfn id="dom-cssstyledeclaration-setproperty" title="dom-CSSStyleDeclaration-setProperty"><code>setProperty(<var>property</var>, <var>value</var>, <var>priority</var>)</code></dfn> 1.132 - method must run these steps: 1.133 - 1.134 - <ol> 1.135 - <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, 1.136 - <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> an 1.137 - "<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>" and 1.138 - terminate these steps.</li> 1.139 - 1.140 - <li><p>If <var>property</var> is not an 1.141 - <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a 1.142 - supported property, terminate this algorithm.</li> 1.143 - 1.144 - <li><p>If <var>value</var> is the empty string, invoke 1.145 - <code title="dom-CSSStyleDeclaration-removeProperty"><a href="#dom-cssstyledeclaration-removeproperty">removeProperty()</a></code> 1.146 - with <var>property</var> as argument and terminate this 1.147 - algorithm.</li> 1.148 - 1.149 - <li><p>If the <var>priority</var> argument has been omitted let 1.150 - <var>priority</var> be the empty string.</li> 1.151 - 1.152 - <li><p>If <var>priority</var> is neither a valid priority nor 1.153 - the empty string terminate this algorithm.</li> 1.154 - <!-- define valid priority somehow --> 1.155 - 1.156 - <li> 1.157 - <p>If <a href="#parse-a-css-value" title="parse a CSS value">parsing the 1.158 - <var>value</var></a> returns null terminate this algorithm. 1.159 - 1.160 - <p class="note"><var>value</var> can not include 1.161 - "<code>!important</code>".</p> 1.162 - </li> 1.163 - 1.164 - <li><p>Finally, set <var>property</var> to <var>value</var> 1.165 - with priority <var>priority</var> when <var>priority</var> 1.166 - is not the empty string. Otherwise set 1.167 - <var>property</var> to <var>value</var>.</li> 1.168 - </ol> 1.169 - 1.170 - <p>The 1.171 - <dfn id="dom-cssstyledeclaration-removeproperty" title="dom-CSSStyleDeclaration-removeProperty"><code>removeProperty(<var>property</var>)</code></dfn> 1.172 - method must run these steps: 1.173 - 1.174 - <ol> 1.175 - <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, 1.176 - <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a 1.177 - "<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>" and 1.178 - terminate these steps.</li> 1.179 - 1.180 - <li><p>If <var>property</var> is an 1.181 - <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a 1.182 - property of a declaration in the 1.183 - <span>collection of CSS declarations</span> remove the declaration.</li> 1.184 - </ol> 1.185 - 1.186 - 1.187 - <p>The 1.188 - <dfn id="dom-cssstyledeclaration-values" title="dom-CSSStyleDeclaration-values"><code>values</code></dfn> 1.189 - attribute must return <span class="XXX">...</span></p> 1.190 - 1.191 - 1.192 - <p>The 1.193 - <dfn id="dom-cssstyledeclaration-parentrule" title="dom-CSSStyleDeclaration-parentRule"><code>parentRule</code></dfn> 1.194 - attribute must return the <code>CSSrule</code> object the 1.195 - <code>CSSStyleDeclaration</code> is object is associated with or null if 1.196 - it is not associated with a <code>CSSrule</code> object.</p> 1.197 - <!-- XXX introduce a concept for this instead --> 1.198 - 1.199 <hr> 1.200 1.201 <p>For the table below, the IDL attribute in the first column 1.202 must return the result of invoking 1.203 - <code title="dom-CSSStyleDeclaration-getPropertyValue"><a href="#dom-cssstyledeclaration-getpropertyvalue">getPropertyValue()</a></code> 1.204 + <code title="dom-CSSStyleDeclaration-getPropertyValue">getPropertyValue()</code> 1.205 with as argument the CSS property given in the second column on the same 1.206 row.</p> 1.207 1.208 <p>Similarly for the table below, setting the IDL attribute in the 1.209 first column must invoke 1.210 - <code title="dom-CSSStyleDeclaration-setProperty"><a href="#dom-cssstyledeclaration-setproperty">setProperty()</a></code> 1.211 + <code title="dom-CSSStyleDeclaration-setProperty">setProperty()</code> 1.212 with as first argument the CSS property given in the second column on the 1.213 same row, as second argument the given value, and no third argument. Any 1.214 exceptions thrown must be re-thrown.</p>
2.1 --- a/cssom/Overview.src.html Mon Jul 16 00:55:13 2012 -0600 2.2 +++ b/cssom/Overview.src.html Mon Jul 16 09:50:04 2012 -0600 2.3 @@ -1754,7 +1754,7 @@ 2.4 2.5 <h4>The <code>CSSStyleDeclaration</code> Interface</h4> 2.6 2.7 - 2.8 + <p>The <code>CSSStyleDeclaration</code> interface represents a <span>CSS declaration block</span>, including its underlying state, where this underlying state depends upon the source of the <code>CSSStyleDeclaration</code> instance.</p> 2.9 <pre class="idl"><span class="idlInterface" id="widl-def-CSSStyleDeclaration">interface <span class="idlInterfaceID">CSSStyleDeclaration</span> { 2.10 <span class="idlAttribute"> attribute <span class="idlAttrType"><a>DOMString</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-cssText">cssText</a></span>;</span> 2.11 <span class="idlAttribute"> readonly attribute <span class="idlAttrType"><a>unsigned long</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-length">length</a></span>;</span> 2.12 @@ -1768,164 +1768,41 @@ 2.13 <dl class="attributes"> 2.14 <dt class="attribute"> 2.15 <code>cssText</code> of type <span class="idlAttrType"><a>DOMString</a></span></dt> 2.16 +<dd> 2.17 +<p>The <code>cssText</code> attribute must return the result of <span title='serialize a CSS declaration block'>serializing</span> the <span>CSS declaration block declarations</span>.</p> <p>Setting the <code>cssText</code> attribute must run these steps: <ol> <li><p>If the <span>CSS declaration block readonly flag</span> is set, <span data-anolis-spec=dom title=concept-throw>throw</span> a <code data-anolis-spec=dom>NoModificationAllowedError</code> exception and terminate these steps.</li> <li><p>Empty the <span>CSS declaration block declarations</span>.</li> <li><p><span title='Parse a CSS declaration block'>Parse</span> the given value and, if the return value is not null, insert it into the <span>CSS declaration block declarations</span>.</p></li> </ol></dd> 2.18 <dt class="attribute"> 2.19 <code>length</code> of type <span class="idlAttrType"><a>unsigned long</a></span>, readonly</dt> 2.20 +<dd> 2.21 +<p>The <code>length</code> attribute must return the number of declarations in the <span>collection of CSS declarations</span>.</p></dd> 2.22 <dt class="attribute"> 2.23 <code>parentRule</code> of type <span class="idlAttrType"><a>CSSRule</a></span>, readonly</dt> 2.24 +<dd> 2.25 +<p>The <code>parentRule</code> attribute must return the <code>CSSrule</code> object the <code>CSSStyleDeclaration</code> is object is associated with or null if it is not associated with a <code>CSSrule</code> object.</p></dd> 2.26 </dl> 2.27 <dl class="methods"> 2.28 <dt class="method"> 2.29 <code>item</code> (<span class="idlParam"><span class="idlParamType"><a>unsigned long</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 2.30 +<dd> 2.31 +<p>The <code>item</code> operation must return the property at position <var>index</var>.</p></dd> 2.32 <dt class="method"> 2.33 <code>getPropertyValue</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 2.34 +<dd> 2.35 +<p>The <code>getPropertyValue</code> operation must ...</p></dd> 2.36 <dt class="method"> 2.37 <code>getPropertyPriority</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 2.38 +<dd> 2.39 +<p>The <code>getPropertyPriority</code> operation, when invoked, if <var>property</var> is an <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a property that has a priority user agents must return the canonical priority of that property as given in the syntax definition. Otherwise, the empty string must be returned.</p> <p class='example'>E.g. for <code>background-color:lime !IMPORTANT</code> the return value would be '<code>important</code>'.</p></dd> 2.40 <dt class="method"> 2.41 <code>setProperty</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>, <span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>, <span class="idlParam">optional <span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>void</a></span></dt> 2.42 +<dd> 2.43 +<p>The <code>setProperty</code> operation must run these steps:</p> <ol> <li><p>If the <span>CSS declaration block readonly flag</span> is set, <span data-anolis-spec=dom title=concept-throw>throw</span> an '<code data-anolis-spec=dom>NoModificationAllowedError</code>' and terminate these steps.</li> <li><p>If <var>property</var> is not an <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a supported property, terminate this algorithm.</p></li> <li><p>If <var>value</var> is the empty string, invoke <code title='dom-CSSStyleDeclaration-removeProperty'>removeProperty()</code> with <var>property</var> as argument and terminate this algorithm.</p></li> <li><p>If the <var>priority</var> argument has been omitted let <var>priority</var> be the empty string.</p></li> <li><p>If <var>priority</var> is neither a valid priority nor the empty string terminate this algorithm.</p></li> <li> <p>If <span title='parse a CSS value'>parsing the <var>value</var></span> returns null terminate this algorithm. <p class='note'><var>value</var> can not include '<code>!important</code>'.</p> </li> <li><p>Finally, set <var>property</var> to <var>value</var> with priority <var>priority</var> when <var>priority</var> is not the empty string. Otherwise set <var>property</var> to <var>value</var>.</p></li> </ol></dd> 2.44 <dt class="method"> 2.45 <code>removeProperty</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt> 2.46 +<dd> 2.47 +<p>The <code>removeProperty</code> operation must run these steps:</p> <ol> <li><p>If the <span>CSS declaration block readonly flag</span> is set, <span data-anolis-spec=dom title=concept-throw>throw</span> a '<code data-anolis-spec=dom>NoModificationAllowedError</code>' and terminate these steps.</li> <li><p>If <var>property</var> is an <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a property of a declaration in the <span>collection of CSS declarations</span> remove the declaration.</p></li> </ol></dd> 2.48 </dl> 2.49 2.50 2.51 - <!-- 2.52 - <pre class="idl">interface <dfn>CSSStyleDeclaration</dfn> { 2.53 - attribute DOMString <span title="dom-CSSStyleDeclaration-cssText">cssText</span>; 2.54 - 2.55 - readonly attribute unsigned long <span title="dom-CSSStyleDeclaration-length">length</span>; 2.56 - DOMString <span title="dom-CSSStyleDeclaration-item">item</span>(unsigned long <var>index</var>); 2.57 - 2.58 - DOMString <span title="dom-CSSStyleDeclaration-getPropertyValue">getPropertyValue</span>(DOMString <var>property</var>); 2.59 - DOMString <span title="dom-CSSStyleDeclaration-getPropertyPriority">getPropertyPriority</span>(DOMString <var>property</var>); 2.60 - void <span title="dom-CSSStyleDeclaration-setProperty">setProperty</span>(DOMString <var>property</var>, DOMString <var>value</var>, optional DOMString <var>priority</var>); 2.61 - DOMString <span title="dom-CSSStyleDeclaration-removeProperty">removeProperty</span>(DOMString <var>property</var>); 2.62 - 2.63 - readonly attribute <span>CSSRule</span> <span title="dom-CSSStyleDeclaration-parentRule">parentRule</span>; 2.64 - 2.65 - // CSS Properties 2.66 -};</pre> 2.67 - --> 2.68 - 2.69 - <p>The 2.70 - <dfn title="dom-CSSStyleDeclaration-cssText"><code>cssText</code></dfn> 2.71 - attribute must return the result of 2.72 - <span title="serialize a CSS declaration block">serializing</span> the 2.73 - <span>CSS declaration block declarations</span>.</p> 2.74 - 2.75 - <p>Setting the <code>cssText</code> attribute must run these steps: 2.76 - 2.77 - </p><ol> 2.78 - <li><p>If the <span>CSS declaration block readonly flag</span> is set, 2.79 - <span title="concept-throw" data-anolis-spec="dom">throw</span> a 2.80 - "<code data-anolis-spec="dom">NoModificationAllowedError</code>" exception 2.81 - and terminate these steps.</p></li> 2.82 - 2.83 - <li><p>Empty the <span>CSS declaration block declarations</span>.</p></li> 2.84 - 2.85 - <li><p><span title="Parse a CSS declaration block">Parse</span> the given 2.86 - value and, if the return value is not null, insert it into the 2.87 - <span>CSS declaration block declarations</span>.</p></li> 2.88 - </ol> 2.89 - 2.90 - 2.91 - <!-- XXX WebIDL work --> 2.92 - <p>The 2.93 - <dfn title="dom-CSSStyleDeclaration-length"><code>length</code></dfn> 2.94 - attribute must return the number of declarations in 2.95 - the <span>collection of CSS declarations</span>.</p> 2.96 - 2.97 - <p>The 2.98 - <dfn title="dom-CSSStyleDeclaration-item"><code>item(<var>index</var>)</code></dfn> 2.99 - method must <span class="XXX">...</span>.</p> 2.100 - <!-- returns the name of property at position index. --> 2.101 - 2.102 - 2.103 - <p>The 2.104 - <dfn title="dom-CSSStyleDeclaration-getPropertyValue"><code>getPropertyValue(<var>property</var>)</code></dfn> 2.105 - method must <span class="XXX">...</span>.</p> 2.106 - <!-- Once we have defined how everything will be canonicalized we can start 2.107 - thinking about this... --><p></p> 2.108 - 2.109 - <p>The 2.110 - <dfn title="dom-CSSStyleDeclaration-getPropertyPriority"><code>getPropertyPriority(<var>property</var>)</code></dfn> 2.111 - method, when invoked, if <var>property</var> is an 2.112 - <span data-anolis-spec="dom">ASCII case-insensitive</span> match for a 2.113 - property that has a priority user agents must return the canonical 2.114 - priority of that property as given in the syntax definition. Otherwise, 2.115 - the empty string must be returned.</p> 2.116 - 2.117 - <p class="example">E.g. for <code>background-color:lime !IMPORTANT</code> 2.118 - the return value would be "<code>important</code>".</p> 2.119 - 2.120 - 2.121 - <p>The 2.122 - <dfn title="dom-CSSStyleDeclaration-setProperty"><code>setProperty(<var>property</var>, <var>value</var>, <var>priority</var>)</code></dfn> 2.123 - method must run these steps: 2.124 - 2.125 - </p><ol> 2.126 - <li><p>If the <span>CSS declaration block readonly flag</span> is set, 2.127 - <span title="concept-throw" data-anolis-spec="dom">throw</span> an 2.128 - "<code data-anolis-spec="dom">NoModificationAllowedError</code>" and 2.129 - terminate these steps.</p></li> 2.130 - 2.131 - <li><p>If <var>property</var> is not an 2.132 - <span data-anolis-spec="dom">ASCII case-insensitive</span> match for a 2.133 - supported property, terminate this algorithm.</p></li> 2.134 - 2.135 - <li><p>If <var>value</var> is the empty string, invoke 2.136 - <code title="dom-CSSStyleDeclaration-removeProperty">removeProperty()</code> 2.137 - with <var>property</var> as argument and terminate this 2.138 - algorithm.</p></li> 2.139 - 2.140 - <li><p>If the <var>priority</var> argument has been omitted let 2.141 - <var>priority</var> be the empty string.</p></li> 2.142 - 2.143 - <li><p>If <var>priority</var> is neither a valid priority nor 2.144 - the empty string terminate this algorithm.</p></li> 2.145 - <!-- define valid priority somehow --> 2.146 - 2.147 - <li> 2.148 - <p>If <span title="parse a CSS value">parsing the 2.149 - <var>value</var></span> returns null terminate this algorithm. 2.150 - 2.151 - </p><p class="note"><var>value</var> can not include 2.152 - "<code>!important</code>".</p> 2.153 - </li> 2.154 - 2.155 - <li><p>Finally, set <var>property</var> to <var>value</var> 2.156 - with priority <var>priority</var> when <var>priority</var> 2.157 - is not the empty string. Otherwise set 2.158 - <var>property</var> to <var>value</var>.</p></li> 2.159 - </ol> 2.160 - 2.161 - <p>The 2.162 - <dfn title="dom-CSSStyleDeclaration-removeProperty"><code>removeProperty(<var>property</var>)</code></dfn> 2.163 - method must run these steps: 2.164 - 2.165 - </p><ol> 2.166 - <li><p>If the <span>CSS declaration block readonly flag</span> is set, 2.167 - <span title="concept-throw" data-anolis-spec="dom">throw</span> a 2.168 - "<code data-anolis-spec="dom">NoModificationAllowedError</code>" and 2.169 - terminate these steps.</p></li> 2.170 - 2.171 - <li><p>If <var>property</var> is an 2.172 - <span data-anolis-spec="dom">ASCII case-insensitive</span> match for a 2.173 - property of a declaration in the 2.174 - <span>collection of CSS declarations</span> remove the declaration.</p></li> 2.175 - </ol> 2.176 - 2.177 - 2.178 - <p>The 2.179 - <dfn title="dom-CSSStyleDeclaration-values"><code>values</code></dfn> 2.180 - attribute must return <span class="XXX">...</span></p> 2.181 - 2.182 - 2.183 - <p>The 2.184 - <dfn title="dom-CSSStyleDeclaration-parentRule"><code>parentRule</code></dfn> 2.185 - attribute must return the <code>CSSrule</code> object the 2.186 - <code>CSSStyleDeclaration</code> is object is associated with or null if 2.187 - it is not associated with a <code>CSSrule</code> object.</p> 2.188 - <!-- XXX introduce a concept for this instead --> 2.189 - 2.190 <hr/> 2.191 2.192 <p>For the table below, the IDL attribute in the first column
3.1 --- a/cssom/cssom-source Mon Jul 16 00:55:13 2012 -0600 3.2 +++ b/cssom/cssom-source Mon Jul 16 09:50:04 2012 -0600 3.3 @@ -1474,145 +1474,6 @@ 3.4 3.5 <!--{@idl(CSSStyleDeclaration)}--> 3.6 3.7 - <!-- 3.8 - <pre class="idl">interface <dfn>CSSStyleDeclaration</dfn> { 3.9 - attribute DOMString <span title="dom-CSSStyleDeclaration-cssText">cssText</span>; 3.10 - 3.11 - readonly attribute unsigned long <span title="dom-CSSStyleDeclaration-length">length</span>; 3.12 - DOMString <span title="dom-CSSStyleDeclaration-item">item</span>(unsigned long <var>index</var>); 3.13 - 3.14 - DOMString <span title="dom-CSSStyleDeclaration-getPropertyValue">getPropertyValue</span>(DOMString <var>property</var>); 3.15 - DOMString <span title="dom-CSSStyleDeclaration-getPropertyPriority">getPropertyPriority</span>(DOMString <var>property</var>); 3.16 - void <span title="dom-CSSStyleDeclaration-setProperty">setProperty</span>(DOMString <var>property</var>, DOMString <var>value</var>, optional DOMString <var>priority</var>); 3.17 - DOMString <span title="dom-CSSStyleDeclaration-removeProperty">removeProperty</span>(DOMString <var>property</var>); 3.18 - 3.19 - readonly attribute <span>CSSRule</span> <span title="dom-CSSStyleDeclaration-parentRule">parentRule</span>; 3.20 - 3.21 - // CSS Properties 3.22 -};</pre> 3.23 - --> 3.24 - 3.25 - <p>The 3.26 - <dfn title="dom-CSSStyleDeclaration-cssText"><code>cssText</code></dfn> 3.27 - attribute must return the result of 3.28 - <span title="serialize a CSS declaration block">serializing</span> the 3.29 - <span>CSS declaration block declarations</span>.</p> 3.30 - 3.31 - <p>Setting the <code>cssText</code> attribute must run these steps: 3.32 - 3.33 - <ol> 3.34 - <li><p>If the <span>CSS declaration block readonly flag</span> is set, 3.35 - <span data-anolis-spec=dom title=concept-throw>throw</span> a 3.36 - "<code data-anolis-spec=dom>NoModificationAllowedError</code>" exception 3.37 - and terminate these steps.</li> 3.38 - 3.39 - <li><p>Empty the <span>CSS declaration block declarations</span>.</li> 3.40 - 3.41 - <li><p><span title="Parse a CSS declaration block">Parse</span> the given 3.42 - value and, if the return value is not null, insert it into the 3.43 - <span>CSS declaration block declarations</span>.</p></li> 3.44 - </ol> 3.45 - 3.46 - 3.47 - <!-- XXX WebIDL work --> 3.48 - <p>The 3.49 - <dfn title="dom-CSSStyleDeclaration-length"><code>length</code></dfn> 3.50 - attribute must return the number of declarations in 3.51 - the <span>collection of CSS declarations</span>.</p> 3.52 - 3.53 - <p>The 3.54 - <dfn title="dom-CSSStyleDeclaration-item"><code>item(<var>index</var>)</code></dfn> 3.55 - method must <span class="XXX">...</span>.</p> 3.56 - <!-- returns the name of property at position index. --> 3.57 - 3.58 - 3.59 - <p>The 3.60 - <dfn title="dom-CSSStyleDeclaration-getPropertyValue"><code>getPropertyValue(<var>property</var>)</code></dfn> 3.61 - method must <span class="XXX">...</span>.</p> 3.62 - <!-- Once we have defined how everything will be canonicalized we can start 3.63 - thinking about this... --></p> 3.64 - 3.65 - <p>The 3.66 - <dfn title="dom-CSSStyleDeclaration-getPropertyPriority"><code>getPropertyPriority(<var>property</var>)</code></dfn> 3.67 - method, when invoked, if <var>property</var> is an 3.68 - <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a 3.69 - property that has a priority user agents must return the canonical 3.70 - priority of that property as given in the syntax definition. Otherwise, 3.71 - the empty string must be returned.</p> 3.72 - 3.73 - <p class="example">E.g. for <code>background-color:lime !IMPORTANT</code> 3.74 - the return value would be "<code>important</code>".</p> 3.75 - 3.76 - 3.77 - <p>The 3.78 - <dfn title="dom-CSSStyleDeclaration-setProperty"><code>setProperty(<var>property</var>, <var>value</var>, <var>priority</var>)</code></dfn> 3.79 - method must run these steps: 3.80 - 3.81 - <ol> 3.82 - <li><p>If the <span>CSS declaration block readonly flag</span> is set, 3.83 - <span data-anolis-spec=dom title=concept-throw>throw</span> an 3.84 - "<code data-anolis-spec=dom>NoModificationAllowedError</code>" and 3.85 - terminate these steps.</li> 3.86 - 3.87 - <li><p>If <var>property</var> is not an 3.88 - <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a 3.89 - supported property, terminate this algorithm.</p></li> 3.90 - 3.91 - <li><p>If <var>value</var> is the empty string, invoke 3.92 - <code title="dom-CSSStyleDeclaration-removeProperty">removeProperty()</code> 3.93 - with <var>property</var> as argument and terminate this 3.94 - algorithm.</p></li> 3.95 - 3.96 - <li><p>If the <var>priority</var> argument has been omitted let 3.97 - <var>priority</var> be the empty string.</p></li> 3.98 - 3.99 - <li><p>If <var>priority</var> is neither a valid priority nor 3.100 - the empty string terminate this algorithm.</p></li> 3.101 - <!-- define valid priority somehow --> 3.102 - 3.103 - <li> 3.104 - <p>If <span title="parse a CSS value">parsing the 3.105 - <var>value</var></span> returns null terminate this algorithm. 3.106 - 3.107 - <p class="note"><var>value</var> can not include 3.108 - "<code>!important</code>".</p> 3.109 - </li> 3.110 - 3.111 - <li><p>Finally, set <var>property</var> to <var>value</var> 3.112 - with priority <var>priority</var> when <var>priority</var> 3.113 - is not the empty string. Otherwise set 3.114 - <var>property</var> to <var>value</var>.</p></li> 3.115 - </ol> 3.116 - 3.117 - <p>The 3.118 - <dfn title="dom-CSSStyleDeclaration-removeProperty"><code>removeProperty(<var>property</var>)</code></dfn> 3.119 - method must run these steps: 3.120 - 3.121 - <ol> 3.122 - <li><p>If the <span>CSS declaration block readonly flag</span> is set, 3.123 - <span data-anolis-spec=dom title=concept-throw>throw</span> a 3.124 - "<code data-anolis-spec=dom>NoModificationAllowedError</code>" and 3.125 - terminate these steps.</li> 3.126 - 3.127 - <li><p>If <var>property</var> is an 3.128 - <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a 3.129 - property of a declaration in the 3.130 - <span>collection of CSS declarations</span> remove the declaration.</p></li> 3.131 - </ol> 3.132 - 3.133 - 3.134 - <p>The 3.135 - <dfn title="dom-CSSStyleDeclaration-values"><code>values</code></dfn> 3.136 - attribute must return <span class="XXX">...</span></p> 3.137 - 3.138 - 3.139 - <p>The 3.140 - <dfn title="dom-CSSStyleDeclaration-parentRule"><code>parentRule</code></dfn> 3.141 - attribute must return the <code>CSSrule</code> object the 3.142 - <code>CSSStyleDeclaration</code> is object is associated with or null if 3.143 - it is not associated with a <code>CSSrule</code> object.</p> 3.144 - <!-- XXX introduce a concept for this instead --> 3.145 - 3.146 <hr> 3.147 3.148 <p>For the table below, the IDL attribute in the first column
4.1 --- a/cssom/idl/CSSStyleDeclaration.idl Mon Jul 16 00:55:13 2012 -0600 4.2 +++ b/cssom/idl/CSSStyleDeclaration.idl Mon Jul 16 09:50:04 2012 -0600 4.3 @@ -5,16 +5,86 @@ 4.4 // 2. removal of raises(DOMException) on {set,remove}Property 4.5 // 3. removal of getPropertyCSSValue() method 4.6 // 4.7 + 4.8 +[Documentation= 4.9 + "<p>The {@name} {@type} represents a <span>CSS declaration block</span>, including its underlying state, where this\ 4.10 + underlying state depends upon the source of the {@name} instance.</p>" 4.11 +] 4.12 interface CSSStyleDeclaration { 4.13 - attribute DOMString cssText; 4.14 4.15 + [Documentation= 4.16 + "<p>The {@name} {@type} must return the result of <span title='serialize a CSS declaration block'>serializing</span> the\ 4.17 + <span>CSS declaration block declarations</span>.</p>\ 4.18 + <p>Setting the <code>cssText</code> attribute must run these steps:\ 4.19 + <ol>\ 4.20 + <li><p>If the <span>CSS declaration block readonly flag</span> is set, <span data-anolis-spec=dom title=concept-throw>throw</span> a\ 4.21 + <code data-anolis-spec=dom>NoModificationAllowedError</code> exception and terminate these steps.</li>\ 4.22 + <li><p>Empty the <span>CSS declaration block declarations</span>.</li>\ 4.23 + <li><p><span title='Parse a CSS declaration block'>Parse</span> the given value and, if the return value is not null, insert it into the\ 4.24 + <span>CSS declaration block declarations</span>.</p></li>\ 4.25 + </ol>" 4.26 + ] 4.27 + attribute DOMString cssText; 4.28 + 4.29 + [Documentation= 4.30 + "<p>The {@name} {@type} must return the number of declarations in the <span>collection of CSS declarations</span>.</p>" 4.31 + ] 4.32 readonly attribute unsigned long length; 4.33 + 4.34 + [Documentation= 4.35 + "<p>The {@name} {@type} must return the property at position <var>index</var>.</p>" 4.36 + ] 4.37 DOMString item(unsigned long index); 4.38 4.39 + [Documentation= 4.40 + "<p>The {@name} {@type} must ...</p>" 4.41 + ] 4.42 DOMString getPropertyValue(DOMString property); 4.43 + 4.44 + [Documentation= 4.45 + "<p>The {@name} {@type}, when invoked, if <var>property</var> is an <span data-anolis-spec=dom>ASCII case-insensitive</span>\ 4.46 + match for a property that has a priority user agents must return the canonical priority of that property as given in the\ 4.47 + syntax definition. Otherwise, the empty string must be returned.</p>\ 4.48 + <p class='example'>E.g. for <code>background-color:lime !IMPORTANT</code> the return value would be '<code>important</code>'.</p>" 4.49 + ] 4.50 DOMString getPropertyPriority(DOMString property); 4.51 + 4.52 + [Documentation= 4.53 + "<p>The {@name} {@type} must run these steps:</p>\ 4.54 + <ol>\ 4.55 + <li><p>If the <span>CSS declaration block readonly flag</span> is set, <span data-anolis-spec=dom title=concept-throw>throw</span>\ 4.56 + an '<code data-anolis-spec=dom>NoModificationAllowedError</code>' and terminate these steps.</li>\ 4.57 + <li><p>If <var>property</var> is not an <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a supported property,\ 4.58 + terminate this algorithm.</p></li>\ 4.59 + <li><p>If <var>value</var> is the empty string, invoke <code title='dom-CSSStyleDeclaration-removeProperty'>removeProperty()</code>\ 4.60 + with <var>property</var> as argument and terminate this algorithm.</p></li>\ 4.61 + <li><p>If the <var>priority</var> argument has been omitted let <var>priority</var> be the empty string.</p></li>\ 4.62 + <li><p>If <var>priority</var> is neither a valid priority nor the empty string terminate this algorithm.</p></li>\ 4.63 + <li>\ 4.64 + <p>If <span title='parse a CSS value'>parsing the <var>value</var></span> returns null terminate this algorithm.\ 4.65 + <p class='note'><var>value</var> can not include '<code>!important</code>'.</p>\ 4.66 + </li>\ 4.67 + <li><p>Finally, set <var>property</var> to <var>value</var> with priority <var>priority</var> when <var>priority</var>\ 4.68 + is not the empty string. Otherwise set <var>property</var> to <var>value</var>.</p></li>\ 4.69 + </ol>" 4.70 + ] 4.71 void setProperty(DOMString property, DOMString value, optional DOMString priority); 4.72 + 4.73 + [Documentation= 4.74 + "<p>The {@name} {@type} must run these steps:</p>\ 4.75 + <ol>\ 4.76 + <li><p>If the <span>CSS declaration block readonly flag</span> is set, <span data-anolis-spec=dom title=concept-throw>throw</span> a\ 4.77 + '<code data-anolis-spec=dom>NoModificationAllowedError</code>' and terminate these steps.</li>\ 4.78 + <li><p>If <var>property</var> is an <span data-anolis-spec=dom>ASCII case-insensitive</span> match for a property of a declaration in the\ 4.79 + <span>collection of CSS declarations</span> remove the declaration.</p></li>\ 4.80 + </ol>" 4.81 + ] 4.82 DOMString removeProperty(DOMString property); 4.83 4.84 + [Documentation= 4.85 + "<p>The {@name} {@type} must return the <code>CSSrule</code> object the <code>CSSStyleDeclaration</code> is object is associated with\ 4.86 + or null if it is not associated with a <code>CSSrule</code> object.</p>" 4.87 + ] 4.88 readonly attribute CSSRule parentRule; 4.89 + 4.90 };
5.1 --- a/cssom/idl/Makefile Mon Jul 16 00:55:13 2012 -0600 5.2 +++ b/cssom/idl/Makefile Mon Jul 16 09:50:04 2012 -0600 5.3 @@ -1,24 +1,23 @@ 5.4 5.5 IDLDRIVER = cssom.idl 5.6 -IDLFRAGS = cssfontfacerule.idl \ 5.7 - cssimportrule.idl \ 5.8 - cssmediarule.idl \ 5.9 - cssnamespacerule.idl \ 5.10 - cssom.idl \ 5.11 - csspagerule.idl \ 5.12 - cssrule.idl \ 5.13 - cssrulelist.idl \ 5.14 - cssstyledeclaration.idl \ 5.15 - cssstylerule.idl \ 5.16 - cssstylesheet.idl \ 5.17 - document.idl \ 5.18 - elementcssinlinestyle.idl \ 5.19 - linkstyle.idl \ 5.20 - medialist.idl \ 5.21 - processinginstruction.idl \ 5.22 - stylesheet.idl \ 5.23 - stylesheetlist.idl \ 5.24 - window.idl 5.25 +IDLFRAGS = CSSFontFaceRule.idl \ 5.26 + CSSImportRule.idl \ 5.27 + CSSMediaRule.idl \ 5.28 + CSSNamespaceRule.idl \ 5.29 + CSSPageRule.idl \ 5.30 + CSSRule.idl \ 5.31 + CSSRuleList.idl \ 5.32 + CSSStyleDeclaration.idl \ 5.33 + CSSStyleRule.idl \ 5.34 + CSSStyleSheet.idl \ 5.35 + Document.idl \ 5.36 + ElementCSSInlineStyle.idl \ 5.37 + LinkStyle.idl \ 5.38 + MediaList.idl \ 5.39 + ProcessingInstruction.idl \ 5.40 + StyleSheet.idl \ 5.41 + StyleSheetList.idl \ 5.42 + Window.idl 5.43 JSONFILE = cssom.json 5.44 5.45 all: $(JSONFILE)
