[cssom-view] Specify moveBy moveTo resizeBy resizeTo. https://www.w3.org/Bugs/Public/show_bug.cgi?id=23127

Author: Simon Pieters

cssom-view/Overview.html

@@ -16,7 +16,7 @@
 
  <h1>CSSOM View Module</h1>
 
- <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 27 August 2013</h2>
+ <h2 class="no-num no-toc" id="w3c-doctype">Editor's Draft 3 September 2013</h2>
 
  <dl>
 
@@ -83,7 +83,7 @@ <h2 class="no-num no-toc" id="sotd">Status of This Document</h2>
 can be found in the <a href="http://www.w3.org/TR/">W3C technical reports
 index at http://www.w3.org/TR/.</a></em>
 
-<p>This is the 27 August 2013 Editor's Draft of CSSOM View. Please send
+<p>This is the 3 September 2013 Editor's Draft of CSSOM View. Please send
 comments to
 <a href="mailto:www-style@w3.org?subject=%5Bcssom-view%5D%20">www-style@w3.org</a>
 (<a href="http://lists.w3.org/Archives/Public/www-style/">archived</a>)
@@ -501,6 +501,12 @@ <h2 id="extensions-to-the-window-interface"><span class="secno">5 </span>Extensi
   <a href="#mediaquerylist">MediaQueryList</a> <a href="#dom-window-matchmedia" title="dom-Window-matchMedia">matchMedia</a>(DOMString query);
   [SameObject] readonly attribute <a href="#screen">Screen</a> <a href="#dom-window-screen" title="dom-Window-screen">screen</a>;
 
+  // browsing context
+  void <a href="#dom-window-moveto" title="dom-Window-moveTo">moveTo</a>(double x, double y);
+  void <a href="#dom-window-moveby" title="dom-Window-moveBy">moveBy</a>(double x, double y);
+  void <a href="#dom-window-resizeto" title="dom-Window-resizeTo">resizeTo</a>(double x, double y);
+  void <a href="#dom-window-resizeby" title="dom-Window-resizeBy">resizeBy</a>(double x, double y);
+
   // viewport
   readonly attribute double <a href="#dom-window-innerwidth" title="dom-Window-innerWidth">innerWidth</a>;
   readonly attribute double <a href="#dom-window-innerheight" title="dom-Window-innerHeight">innerHeight</a>;
@@ -537,6 +543,69 @@ <h2 id="extensions-to-the-window-interface"><span class="secno">5 </span>Extensi
 <p class="note">Accessing <code title="dom-Window-screen"><a href="#dom-window-screen">screen</a></code> through a <code class="external" data-anolis-spec="html"><a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#windowproxy">WindowProxy</a></code> object might yield different
 results when the <code class="external" data-anolis-spec="dom"><a href="http://dom.spec.whatwg.org/#document">Document</a></code> is navigated.</p>
 
+<p>The <dfn id="dom-window-moveto" title="dom-Window-moveTo">moveTo</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <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
+ object</a>.
+ <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>.
+ <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.
+ <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.
+ <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
+ the output device, measured in CSS pixels. The positive axes are rightward and downward.
+</ol>
+
+<p>The <dfn id="dom-window-moveby" title="dom-Window-moveBy">moveBy</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <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
+ object</a>.
+ <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>.
+ <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.
+ <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.
+ <li><p>Move <var>target</var>'s window <var>x</var> CSS pixels righward and <var>y</var> CSS pixels downward.
+</ol>
+
+
+<p>The <dfn id="dom-window-resizeto" title="dom-Window-resizeTo">resizeTo</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <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
+ object</a>.
+ <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>.
+ <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.
+ <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
+ space. 
+ <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 are <var>x</var> CSS
+ pixels and the distance between the top and bottom edges are <var>y</var> CSS pixels.
+ <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.
+</ol>
+
+<p>The <dfn id="dom-window-resizeby" title="dom-Window-resizeBy">resizeBy</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <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
+ object</a>.
+ <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>.
+ <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.
+ <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
+ space. 
+ <li><p>Resize <var>target</var>'s window by moving its right edge <var>x</var> CSS pixels righward and its bottom edge <var>y</var> CSS pixels downward.
+ <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.
+</ol>
+
+<p>A <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> <var>A</var> is <dfn id="allowed-to-resize-and-move">allowed to resize and move</dfn> a <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> <var>B</var> if all the following conditions are met:
+
+<ul>
+ <li><p><var>B</var> is an <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#auxiliary-browsing-context">auxiliary browsing context</a> that was created by a script (as opposed to by an action of the user).
+ <li><p><var>A</var> is <a class="external" data-anolis-spec="html" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/browsers.html#familiar-with">familiar with</a> <var>B</var>.
+</ul>
+
 <p>The <dfn id="dom-window-innerwidth" title="dom-Window-innerWidth"><code>innerWidth</code></dfn> attribute must return the <a href="#viewport">viewport</a> width including the size of a rendered
 scroll bar (if any), or zero if there is no <a href="#viewport">viewport</a>. <!--fingerprint--></p>
 <div class="example">
@@ -1585,6 +1654,7 @@ <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
 Michael Dyck,
 Mike Wilson,
 Morten Stenshorne,
+Olli Pettay,
 Pavel Curtis,
 Peter-Paul Koch,
 Rachel Kmetz,

cssom-view/Overview.src.html

@@ -463,6 +463,12 @@ <h2>Extensions to the <code title>Window</code> Interface</h2>
   <span>MediaQueryList</span> <span title=dom-Window-matchMedia>matchMedia</span>(DOMString query);
   [SameObject] readonly attribute <span>Screen</span> <span title=dom-Window-screen>screen</span>;
 
+  // browsing context
+  void <span title=dom-Window-moveTo>moveTo</span>(double x, double y);
+  void <span title=dom-Window-moveBy>moveBy</span>(double x, double y);
+  void <span title=dom-Window-resizeTo>resizeTo</span>(double x, double y);
+  void <span title=dom-Window-resizeBy>resizeBy</span>(double x, double y);
+
   // viewport
   readonly attribute double <span title=dom-Window-innerWidth>innerWidth</span>;
   readonly attribute double <span title=dom-Window-innerHeight>innerHeight</span>;
@@ -499,6 +505,69 @@ <h2>Extensions to the <code title>Window</code> Interface</h2>
 <p class='note'>Accessing <code title=dom-Window-screen>screen</code> through a <code data-anolis-spec=html>WindowProxy</code> object might yield different
 results when the <code data-anolis-spec=dom>Document</code> is navigated.</p>
 
+<p>The <dfn title=dom-Window-moveTo>moveTo</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <li><p>Let <var>target</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=dom>context
+ object</span>.
+ <li><p>Let <var>source</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=html>incumbent script</span>.
+ <li><p>If <var>source</var> is not <span>allowed to resize and move</span> <var>target</var>, terminate these steps.
+ <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.
+ <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
+ the output device, measured in CSS pixels. The positive axes are rightward and downward.
+</ol>
+
+<p>The <dfn title=dom-Window-moveBy>moveBy</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <li><p>Let <var>target</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=dom>context
+ object</span>.
+ <li><p>Let <var>source</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=html>incumbent script</span>.
+ <li><p>If <var>source</var> is not <span>allowed to resize and move</span> <var>target</var>, terminate these steps.
+ <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.
+ <li><p>Move <var>target</var>'s window <var>x</var> CSS pixels righward and <var>y</var> CSS pixels downward.
+</ol>
+
+
+<p>The <dfn title=dom-Window-resizeTo>resizeTo</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <li><p>Let <var>target</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=dom>context
+ object</span>.
+ <li><p>Let <var>source</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=html>incumbent script</span>.
+ <li><p>If <var>source</var> is not <span>allowed to resize and move</span> <var>target</var>, terminate these steps.
+ <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
+ space. 
+ <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 are <var>x</var> CSS
+ pixels and the distance between the top and bottom edges are <var>y</var> CSS pixels.
+ <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.
+</ol>
+
+<p>The <dfn title=dom-Window-resizeBy>resizeBy</dfn> method must follow these steps:
+
+<ol>
+ <li><p>Optionally, terminate these steps.
+ <li><p>Let <var>target</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=dom>context
+ object</span>.
+ <li><p>Let <var>source</var> be the <span data-anolis-spec=html>browsing context</span> of the <span data-anolis-spec=html>incumbent script</span>.
+ <li><p>If <var>source</var> is not <span>allowed to resize and move</span> <var>target</var>, terminate these steps.
+ <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
+ space. 
+ <li><p>Resize <var>target</var>'s window by moving its right edge <var>x</var> CSS pixels righward and its bottom edge <var>y</var> CSS pixels downward.
+ <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.
+</ol>
+
+<p>A <span data-anolis-spec=html>browsing context</span> <var>A</var> is <dfn>allowed to resize and move</dfn> a <span data-anolis-spec=html>browsing
+context</span> <var>B</var> if all the following conditions are met:
+
+<ul>
+ <li><p><var>B</var> is an <span data-anolis-spec=html>auxiliary browsing context</span> that was created by a script (as opposed to by an action of the user).
+ <li><p><var>A</var> is <span data-anolis-spec=html>familiar with</span> <var>B</var>.
+</ul>
+
 <p>The <dfn title=dom-Window-innerWidth><code>innerWidth</code></dfn> attribute must return the <span>viewport</span> width including the size of a rendered
 scroll bar (if any), or zero if there is no <span>viewport</span>. <!--fingerprint--></p>
 <div class='example'>
@@ -1527,6 +1596,7 @@ <h2 class="no-num">Acknowledgments</h2>
 Michael Dyck,
 Mike Wilson,
 Morten Stenshorne,
+Olli Pettay,
 Pavel Curtis,
 Peter-Paul Koch,
 Rachel Kmetz,