Skip to content

Commit 7dc9459

Browse files
author
Simon Pieters
committed
[cssom*] Prepare CSSOM and CSSOM View for publication
1 parent 9339d6f commit 7dc9459

6 files changed

Lines changed: 4612 additions & 4206 deletions

File tree

cssom-view/Overview.html

Lines changed: 28 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616

1717
<h1>CSSOM View Module</h1>
1818

19-
<h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 1 November 2013</h2>
19+
<h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 4 December 2013</h2>
2020

2121
<dl>
2222

@@ -83,7 +83,7 @@ <h2 class="no-num no-toc" id="sotd">Status of This Document</h2>
8383
can be found in the <a href="http://www.w3.org/TR/">W3C technical reports
8484
index at http://www.w3.org/TR/.</a></em>
8585

86-
<p>This is the 1 November 2013 Editor's Draft of CSSOM View. Please send
86+
<p>This is the 4 December 2013 Editor's Draft of CSSOM View. Please send
8787
comments to
8888
<a href="mailto:www-style@w3.org?subject=%5Bcssom-view%5D%20">www-style@w3.org</a>
8989
(<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
@@ -449,7 +449,7 @@ <h2 id="common-infrastructure"><span class="secno">4 </span>Common Infrastructur
449449

450450
<h3 id="scrolling"><span class="secno">4.1 </span>Scrolling</h3>
451451

452-
<p>When a user agent is to <dfn id="perform-a-scroll">perform a scroll</dfn> of a <a href="#scrolling-box">scrolling box</a> <var>box</var>, to a given position <var>position</var>, with a set of
452+
<p>When a user agent is to <dfn id="perform-a-scroll">perform a scroll</dfn> of a <a href="#scrolling-box">scrolling box</a> <var>box</var>, to a given position <var>position</var>, with a set of
453453
steps <var>task</var>, an associated element <var>element</var> and optionally a scroll behavior <var>behavior</var> (which is
454454
<code title="">auto</code> if omitted), the following steps must be run:
455455

@@ -566,7 +566,8 @@ <h2 id="extensions-to-the-window-interface"><span class="secno">5 </span>Extensi
566566
<li><p>Optionally, terminate these steps.
567567
<li><p>Let <var>target</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#context-object">context
568568
object</a>.
569-
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-script">incumbent script</a>.
569+
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#responsible-browsing-context">responsible browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-settings-object">incumbent settings
570+
object</a>.
570571
<li><p>If <var>source</var> is not <a href="#allowed-to-resize-and-move">allowed to resize and move</a> <var>target</var>, terminate these steps.
571572
<li><p>Optionally, clamp <var>x</var> and <var>y</var> in a user-agent-defined manner so that the window does not move outside the available space.
572573
<li><p>Move <var>target</var>'s window such that the window's top left corner is at coordinates (<var>x</var>, <var>y</var>) relative to the top left corner of
@@ -579,7 +580,8 @@ <h2 id="extensions-to-the-window-interface"><span class="secno">5 </span>Extensi
579580
<li><p>Optionally, terminate these steps.
580581
<li><p>Let <var>target</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#context-object">context
581582
object</a>.
582-
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-script">incumbent script</a>.
583+
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#responsible-browsing-context">responsible browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-settings-object">incumbent settings
584+
object</a>.
583585
<li><p>If <var>source</var> is not <a href="#allowed-to-resize-and-move">allowed to resize and move</a> <var>target</var>, terminate these steps.
584586
<li><p>Optionally, clamp <var>x</var> and <var>y</var> in a user-agent-defined manner so that the window does not move outside the available space.
585587
<li><p>Move <var>target</var>'s window <var>x</var> CSS pixels of <var>target</var> righward and <var>y</var> CSS pixels of <var>target</var> downward.
@@ -592,10 +594,11 @@ <h2 id="extensions-to-the-window-interface"><span class="secno">5 </span>Extensi
592594
<li><p>Optionally, terminate these steps.
593595
<li><p>Let <var>target</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#context-object">context
594596
object</a>.
595-
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-script">incumbent script</a>.
597+
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#responsible-browsing-context">responsible browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-settings-object">incumbent settings
598+
object</a>.
596599
<li><p>If <var>source</var> is not <a href="#allowed-to-resize-and-move">allowed to resize and move</a> <var>target</var>, terminate these steps.
597600
<li><p>Optionally, clamp <var>x</var> and <var>y</var> in a user-agent-defined manner so that the window does not get too small or bigger than the available
598-
space.
601+
space.
599602
<li><p>Resize <var>target</var>'s window by moving its right and bottom edges such that the distance between the left and right edges of the viewport are
600603
<var>x</var> CSS pixels of <var>target</var> and the distance between the top and bottom edges of the viewport are <var>y</var> CSS pixels of
601604
<var>target</var>.
@@ -608,10 +611,11 @@ <h2 id="extensions-to-the-window-interface"><span class="secno">5 </span>Extensi
608611
<li><p>Optionally, terminate these steps.
609612
<li><p>Let <var>target</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#context-object">context
610613
object</a>.
611-
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#browsing-context">browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-script">incumbent script</a>.
614+
<li><p>Let <var>source</var> be the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#responsible-browsing-context">responsible browsing context</a> of the <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#incumbent-settings-object">incumbent settings
615+
object</a>.
612616
<li><p>If <var>source</var> is not <a href="#allowed-to-resize-and-move">allowed to resize and move</a> <var>target</var>, terminate these steps.
613617
<li><p>Optionally, clamp <var>x</var> and <var>y</var> in a user-agent-defined manner so that the window does not get too small or bigger than the available
614-
space.
618+
space.
615619
<li><p>Resize <var>target</var>'s window by moving its right edge <var>x</var> CSS pixels of <var>target</var> righward and its bottom edge <var>y</var> CSS
616620
pixels of <var>target</var> downward.
617621
<li><p>Optionally, move <var>target</var>'s window in a user-agent-defined manner so that it does not grow outside the available space.
@@ -777,15 +781,15 @@ <h4 id="the-features-argument-to-the-open()-method"><span class="secno">5.1 </sp
777781
<li><p>If <code title="dom-open-features-width"><a href="#dom-open-features-width">width</a></code> is present in <var>parsed features</var>, follow these substeps:
778782
<ol>
779783
<li><p>Let <var>x</var> be the value of <code title="dom-open-features-width"><a href="#dom-open-features-width">width</a></code>.
780-
<li><p>Optionally, clamp <var>x</var> in a user-agent-defined manner so that the window does not get too small or bigger than the available space.
784+
<li><p>Optionally, clamp <var>x</var> in a user-agent-defined manner so that the window does not get too small or bigger than the available space.
781785
<li><p>Optionally, size <var>target</var>'s window by moving its right edge such that the distance between the left and right edges of the viewport are
782786
<var>x</var> CSS pixels of <var>target</var>.
783787
<li><p>Optionally, move <var>target</var>'s window in a user-agent-defined manner so that it does not grow outside the available space.
784788
</ol>
785789
<li><p>If <code title="dom-open-features-height"><a href="#dom-open-features-height">height</a></code> is present in <var>parsed features</var>, follow these substeps:
786790
<ol>
787791
<li><p>Let <var>y</var> be the value of <code title="dom-open-features-height"><a href="#dom-open-features-height">height</a></code>.
788-
<li><p>Optionally, clamp <var>y</var> in a user-agent-defined manner so that the window does not get too small or bigger than the available space.
792+
<li><p>Optionally, clamp <var>y</var> in a user-agent-defined manner so that the window does not get too small or bigger than the available space.
789793
<li><p>Optionally, size <var>target</var>'s window by moving its bottom edge such that the distance between the top and bottom edges of the viewport are
790794
<var>y</var> CSS pixels of <var>target</var>.
791795
<li><p>Optionally, move <var>target</var>'s window in a user-agent-defined manner so that it does not grow outside the available space.
@@ -803,7 +807,7 @@ <h4 id="the-features-argument-to-the-open()-method"><span class="secno">5.1 </sp
803807
<dd><p>The left position of the window.
804808
<dt><dfn id="dom-open-features-top" title="dom-open-features-top">top</dfn>
805809
<dd><p>The top position of the window.
806-
</dl>
810+
</dl>
807811

808812

809813
<h3 id="the-mediaquerylist-interface"><span class="secno">5.2 </span>The <code title="">MediaQueryList</code> Interface</h3>
@@ -970,7 +974,7 @@ <h3 id="the-caretposition-interface"><span class="secno">6.1 </span>The <code ti
970974

971975
<p>A <dfn id="caret-position">caret position</dfn> gives the position of a text insertion point indicator. It always has an associated
972976
<dfn id="caret-node">caret node</dfn>, <dfn id="caret-offset">caret offset</dfn>, and <dfn id="caret-range">caret range</dfn>. It is represented by a <code><a href="#caretposition">CaretPosition</a></code> object.</p>
973-
977+
974978
<pre class="idl">interface <dfn id="caretposition">CaretPosition</dfn> {
975979
readonly attribute <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#node">Node</a> <a href="#dom-caretposition-offsetnode" title="dom-CaretPosition-offsetNode">offsetNode</a>;
976980
readonly attribute unsigned long <a href="#dom-caretposition-offset" title="dom-CaretPosition-offset">offset</a>;
@@ -1205,7 +1209,7 @@ <h2 id="extensions-to-the-element-interface"><span class="secno">7 </span>Extens
12051209
<li><p>Return the computed value of the 'border-top-width' property plus the height of any scrollbar rendered between the top <a href="#padding-edge">padding
12061210
edge</a> and the top <a href="#border-edge">border edge</a>, ignoring any <a href="#transforms">transforms</a> that apply to the element and its ancestors.
12071211
</ol>
1208-
1212+
12091213
<p>The <dfn id="dom-element-clientleft" title="dom-Element-clientLeft"><code>clientLeft</code></dfn> attribute must run these steps:
12101214
<ol>
12111215
<li><p>If the element has no associated <a href="#css-layout-box">CSS layout box</a> or if the <a href="#css-layout-box">CSS layout box</a> is inline, return zero.
@@ -1256,14 +1260,14 @@ <h3 id="element-scrolling-members"><span class="secno">7.2 </span><code title=""
12561260
<code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#document">Document</a></code> associated with the element or
12571261
<a href="#viewport">viewport</a> associated with <var>box</var>, terminate these
12581262
steps.</li>
1259-
1263+
12601264
<li><p>Let <var>element bounding border box</var> be the box that the return value of invoking
12611265
<code title="dom-Element-getBoundingClientRect"><a href="#dom-element-getboundingclientrect">getBoundingClientRect()</a></code> on <var>element</var> represents.
1262-
1266+
12631267
<li><p>Let <var>scrolling box edge A</var> be the <a href="#beginning-edges" title="beginning edges">beginning edge</a> in the <a href="#block-flow-direction">block flow direction</a> of
12641268
<var>scrolling box</var>, and let <var>element edge A</var> be <var>element bounding border box</var>'s edge on the same physical side as that of
12651269
<var>scrolling box edge A</var>.
1266-
1270+
12671271
<li><p>Let <var>scrolling box edge B</var> be the <a href="#ending-edges" title="ending edges">ending edge</a> in the <a href="#block-flow-direction">block flow direction</a> of <var>scrolling
12681272
box</var>, and let <var>element edge B</var> be <var>element bounding border box</var>'s edge on the same physical side as that of <var>scrolling box edge
12691273
B</var>.
@@ -1276,7 +1280,7 @@ <h3 id="element-scrolling-members"><span class="secno">7.2 </span><code title=""
12761280
box</var>, and let <var>element edge D</var> be <var>element bounding border box</var>'s edge on the same physical side as that of <var>box edge D</var>.
12771281

12781282
<li><p>Let <var>element width</var> be the distance between <var>element edge C</var> and <var>element edge D</var>.
1279-
1283+
12801284
<li><p>Let <var>scrolling box width</var> be the distance between <var>scrolling box edge C</var> and <var>scrolling box edge D</var>.
12811285

12821286
<li><p>Let <var>position</var> be the scroll position <var>scrolling box</var> would have by following these steps:
@@ -1285,12 +1289,12 @@ <h3 id="element-scrolling-members"><span class="secno">7.2 </span><code title=""
12851289
<li><p>If the <i>align to top flag</i> is set align <var>element edge A</var> with <var>scrolling box edge A</var>.</li>
12861290

12871291
<li><p>Otherwise, the <i>align to top flag</i> is not set; align <var>element edge B</var> with <var>scrolling box edge B</var>.</li>
1288-
1292+
12891293
<li>
12901294
<dl class="switch">
12911295
<dt>If <var>element edge C</var> and <var>element edge D</var> are both outside <var>scrolling box edge C</var> and <var>scrolling box edge D</var>
12921296
<dd><p>Do nothing.
1293-
1297+
12941298
<dt>If <var>element edge C</var> is outside <var>scrolling box edge C</var> and <var>element width</var> is less than <var>scrolling box width</var>
12951299
<dt>If <var>element edge D</var> is outside <var>scrolling box edge D</var> and <var>element width</var> is greater than <var>scrolling box width</var>
12961300
<dd><p>Align <var>element edge C</var> with <var>scrolling box edge C</var>.
@@ -1367,7 +1371,7 @@ <h3 id="element-scrolling-members"><span class="secno">7.2 </span><code title=""
13671371
<var>element</var> <a href="#padding-edge">padding edge</a> height -
13681372
<var>element</var> <a href="#scrolling-area">scrolling area</a> height)).</dd>
13691373
</dl>
1370-
1374+
13711375
<li><p>Let <var>position</var> be the scroll position <var>box</var> would have by aligning <a href="#scrolling-area">scrolling area</a> x-coordinate
13721376
<var>x</var> with the left of <var>box</var> and aligning <a href="#scrolling-area">scrolling area</a> y-coordinate <var>y</var> with
13731377
the top of <var>box</var>.
@@ -1657,12 +1661,12 @@ <h3 class="atrisk" id="the-geometryutils-interface"><span class="secno">12.1 </s
16571661
<a href="#dompoint">DOMPoint</a> <a href="#dom-geometryutils-convertpointfromnode" title="dom-GeometryUtils-convertPointFromNode">convertPointFromNode</a>(<a href="#dompointinit">DOMPointInit</a> point, <!--
16581662
--><a href="#geometrynode">GeometryNode</a> from, optional <a href="#convertcoordinateoptions">ConvertCoordinateOptions</a> options);
16591663
};
1660-
1664+
16611665
<a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#text">Text</a> implements <a href="#geometryutils">GeometryUtils</a>;
16621666
<a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#element">Element</a> implements <a href="#geometryutils">GeometryUtils</a>;
16631667
<a class="external" data-anolis-spec="cssom" href="http://dev.w3.org/csswg/cssom/#pseudoelement">PseudoElement</a> implements <a href="#geometryutils">GeometryUtils</a>;
16641668
<a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#document">Document</a> implements <a href="#geometryutils">GeometryUtils</a>;
1665-
1669+
16661670
typedef (<a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#text">Text</a> or <a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#element">Element</a> or <a class="external" data-anolis-spec="cssom" href="http://dev.w3.org/csswg/cssom/#pseudoelement">PseudoElement</a> or <!--
16671671
--><a class="external" data-anolis-spec="dom" href="http://dom.spec.whatwg.org/#document">Document</a>) <dfn id="geometrynode">GeometryNode</dfn>;</pre>
16681672

@@ -1730,7 +1734,7 @@ <h3 id="smooth-scrolling:-the-'scroll-behavior'-property"><span class="secno">14
17301734
Initial: instant
17311735
Applies to: <a href="#scrolling-box" title="scrolling box">scrolling boxes</a>
17321736
Inherited: no
1733-
Computed value: specified value
1737+
Computed value: specified value
17341738
Media: visual
17351739
Animatable: no
17361740
Canonical Order: per grammar

0 commit comments

Comments
 (0)