[cssom-view-1] Linkify root element

w3c#8224

Author: bramus

cssom-view-1/Overview.bs

@@ -387,7 +387,7 @@ To <dfn export>scroll to the beginning of the document</dfn> for a document <var
  <li>If <var>position</var> is the same as <var>viewport</var>'s current scroll position, and <var>viewport</var> does not have an ongoing
  <a>smooth scroll</a>, abort these steps.
  <li><a>Perform a scroll</a> of <var>viewport</var> to <var>position</var>,
- and <var>document</var>'s root element as the associated element, if there is one, or null otherwise.
+ and <var>document</var>'s [=root element=] as the associated element, if there is one, or null otherwise.
 </ol>
 
 Note: This algorithm is used when navigating to the <code>#top</code> fragment identifier, as defined in HTML. [[!HTML]]
@@ -580,7 +580,7 @@ steps must be run:
     and the <a>viewport</a> does not have an ongoing <a>smooth scroll</a>, abort these steps.
 1. Let <var>document</var> be the <a>viewport’s</a> associated {{Document}}.
 1. <a>Perform a scroll</a> of the <a>viewport</a> to <var>position</var>,
-    <var>document</var>'s root element as the associated element, if there is one, or null otherwise,
+    <var>document</var>'s [=root element=] as the associated element, if there is one, or null otherwise,
     and the scroll behavior being the value of the {{ScrollOptions/behavior}} dictionary member of <var>options</var>.
 
 When the <dfn method for=Window lt="scrollTo(options)|scrollTo(x, y)">scrollTo()</dfn> method is invoked, the
@@ -915,7 +915,7 @@ The <dfn method for=Document caniuse=element-from-point>elementFromPoint(<var>x<
     associated with the document, return null and terminate these steps.
 1. If there is a [=CSS/box=] in the <a>viewport</a> that would be a target for hit testing at coordinates <var>x</var>,<var>y</var>,
     when applying the <a>transforms</a> that apply to the descendants of the <a>viewport</a>, return the associated element and terminate these steps.
-1. If the document has a root element, return the root element and terminate these steps.
+1. If the document has a [=root element=], return the [=root element=] and terminate these steps.
 1. Return null.
 
 Note: The {{elementFromPoint()}} method does not necessarily return the top-most painted element. For
@@ -931,7 +931,7 @@ instance, an element can be excluded from being a target for hit testing by usin
 1. For each [=CSS/box=] in the <a>viewport</a>, in paint order, starting with the topmost box, that would be a target for hit testing at
     coordinates <var>x</var>,<var>y</var> even if nothing would be overlapping it, when applying the <a>transforms</a> that apply to the descendants of the
     <a>viewport</a>, append the associated element to <var>sequence</var>.
-1. If the document has a root element, and the last item in <var>sequence</var> is not the root element, append the root element to <var>sequence</var>.
+1. If the document has a [=root element=], and the last item in <var>sequence</var> is not the [=root element=], append the [=root element=] to <var>sequence</var>.
 1. Return <var>sequence</var>.
 
 The <dfn method for=Document>caretPositionFromPoint(<var>x</var>, <var>y</var>)</dfn> method must return the
@@ -993,7 +993,7 @@ revision of CSS or HTML.
         a value of ''overflow:clip'' on the <a>the <code>body</code> element</a>'s parent element
         must be treated as ''overflow:hidden''.
     1. Return null and abort these steps.
-1. If there is a root element, return the root element and abort these steps.
+1. If there is a [=root element=], return the [=root element=] and abort these steps.
 1. Return null.
 
 Note: For non-conforming user agents that always use the <a>quirks mode</a> behavior for {{Element/scrollTop}}
@@ -1184,8 +1184,8 @@ The <dfn method for=Element lt="scroll(options)|scroll(x, y)">scroll()</dfn> met
 1. If <var>document</var> is not the <a>active document</a>, terminate these steps.
 1. Let <var>window</var> be the value of <var>document</var>'s {{Document/defaultView}} attribute.
 1. If <var>window</var> is null, terminate these steps.
-1. If the element is the root element and <var>document</var> is in <a>quirks mode</a>, terminate these steps.
-1. If the element is the root element invoke {{Window/scroll()}} on <var>window</var> with {{Window/scrollX}} on <var>window</var> as first argument and <var>y</var> as second argument,
+1. If the element is the [=root element=] and <var>document</var> is in <a>quirks mode</a>, terminate these steps.
+1. If the element is the [=root element=] invoke {{Window/scroll()}} on <var>window</var> with {{Window/scrollX}} on <var>window</var> as first argument and <var>y</var> as second argument,
     and terminate these steps.
 1. If the element is <a>the <code>body</code> element</a>,
     <var>document</var> is in <a>quirks mode</a>,
@@ -1224,8 +1224,8 @@ The <dfn attribute for=Element>scrollTop</dfn> attribute, on getting, must retur
 1. If <var>document</var> is not the <a>active document</a>, return zero and terminate these steps.
 1. Let <var>window</var> be the value of <var>document</var>'s {{Document/defaultView}} attribute.
 1. If <var>window</var> is null, return zero and terminate these steps.
-1. If the element is the root element and <var>document</var> is in <a>quirks mode</a>, return zero and terminate these steps.
-1. If the element is the root element return the value of {{Window/scrollY}} on <var>window</var>.
+1. If the element is the [=root element=] and <var>document</var> is in <a>quirks mode</a>, return zero and terminate these steps.
+1. If the element is the [=root element=] return the value of {{Window/scrollY}} on <var>window</var>.
 1. If the element is <a>the <code>body</code> element</a>, <var>document</var> is in <a>quirks mode</a>, and the element is not <a>potentially scrollable</a>, return the value of {{Window/scrollY}} on <var>window</var>.
 1. If the element does not have any associated [=CSS/box=], return zero and terminate these steps.
 1. Return the y-coordinate of the <a>scrolling area</a> at the alignment point with the top of the <a>padding edge</a> of the element.
@@ -1238,8 +1238,8 @@ When setting the {{Element/scrollTop}} attribute these steps must be run:
 1. If <var>document</var> is not the <a>active document</a>, terminate these steps.
 1. Let <var>window</var> be the value of <var>document</var>'s {{Document/defaultView}} attribute.
 1. If <var>window</var> is null, terminate these steps.
-1. If the element is the root element and <var>document</var> is in <a>quirks mode</a>, terminate these steps.
-1. If the element is the root element invoke {{Window/scroll()}} on <var>window</var> with {{Window/scrollX}} on <var>window</var> as first argument and <var>y</var> as second argument, and terminate these steps.
+1. If the element is the [=root element=] and <var>document</var> is in <a>quirks mode</a>, terminate these steps.
+1. If the element is the [=root element=] invoke {{Window/scroll()}} on <var>window</var> with {{Window/scrollX}} on <var>window</var> as first argument and <var>y</var> as second argument, and terminate these steps.
 1. If the element is <a>the <code>body</code> element</a>, <var>document</var> is in <a>quirks mode</a>, and the element is not <a>potentially scrollable</a>, invoke {{Window/scroll()}} on <var>window</var> with {{Window/scrollX}} as first argument and <var>y</var> as second argument, and terminate these steps.
 1. If the element does not have any associated [=CSS/box=], the element has no associated <a>scrolling box</a>, or the element has no overflow, terminate these steps.
 1. <a lt='scroll an element'>Scroll the element</a> to {{Element/scrollLeft}},<var>y</var>, with the scroll behavior being "<code>auto</code>".
@@ -1250,8 +1250,8 @@ The <dfn attribute for=Element>scrollLeft</dfn> attribute, on getting, must retu
 1. If <var>document</var> is not the <a>active document</a>, return zero and terminate these steps.
 1. Let <var>window</var> be the value of <var>document</var>'s {{Document/defaultView}} attribute.
 1. If <var>window</var> is null, return zero and terminate these steps.
-1. If the element is the root element and <var>document</var> is in <a>quirks mode</a>, return zero and terminate these steps.
-1. If the element is the root element return the value of {{Window/scrollX}} on <var>window</var>.
+1. If the element is the [=root element=] and <var>document</var> is in <a>quirks mode</a>, return zero and terminate these steps.
+1. If the element is the [=root element=] return the value of {{Window/scrollX}} on <var>window</var>.
 1. If the element is <a>the <code>body</code> element</a>, <var>document</var> is in <a>quirks mode</a>, and the element is not <a>potentially scrollable</a>, return the value of {{Window/scrollX}} on <var>window</var>.
 1. If the element does not have any associated [=CSS/box=], return zero and terminate these steps.
 1. Return the x-coordinate of the <a>scrolling area</a> at the alignment point with the left of the <a>padding edge</a> of the element.
@@ -1264,8 +1264,8 @@ When setting the {{Element/scrollLeft}} attribute these steps must be run:
 1. If <var>document</var> is not the <a>active document</a>, terminate these steps.
 1. Let <var>window</var> be the value of <var>document</var>'s {{Document/defaultView}} attribute.
 1. If <var>window</var> is null, terminate these steps.
-1. If the element is the root element and <var>document</var> is in <a>quirks mode</a>, terminate these steps.
-1. If the element is the root element invoke {{Window/scroll()}} on <var>window</var> with <var>x</var> as first argument and {{Window/scrollY}} on <var>window</var> as second argument, and terminate these steps.
+1. If the element is the [=root element=] and <var>document</var> is in <a>quirks mode</a>, terminate these steps.
+1. If the element is the [=root element=] invoke {{Window/scroll()}} on <var>window</var> with <var>x</var> as first argument and {{Window/scrollY}} on <var>window</var> as second argument, and terminate these steps.
 1. If the element is <a>the <code>body</code> element</a>, <var>document</var> is in <a>quirks mode</a>, and the element is not <a>potentially scrollable</a>, invoke {{Window/scroll()}} on <var>window</var> with <var>x</var> as first argument and {{Window/scrollY}} on <var>window</var> as second argument, and terminate these steps.
 1. If the element does not have any associated [=CSS/box=], the element has no associated <a>scrolling box</a>, or the element has no overflow, terminate these steps.
 1. <a lt='scroll an element'>Scroll the element</a> to <var>x</var>,{{Element/scrollTop}}, with the scroll behavior being "<code>auto</code>".
@@ -1275,7 +1275,7 @@ The <dfn attribute for=Element>scrollWidth</dfn> attribute must return the resul
 1. Let <var>document</var> be the element's <a>node document</a>.
 1. If <var>document</var> is not the <a>active document</a>, return zero and terminate these steps.
 1. Let <var>viewport width</var> be the width of the <a>viewport</a> excluding the width of the scroll bar, if any, or zero if there is no <a>viewport</a>.
-1. If the element is the root element and <var>document</var> is not in <a>quirks mode</a> return max(<a>viewport</a> <a>scrolling area</a> width, <var>viewport width</var>).
+1. If the element is the [=root element=] and <var>document</var> is not in <a>quirks mode</a> return max(<a>viewport</a> <a>scrolling area</a> width, <var>viewport width</var>).
 1. If the element is <a>the <code>body</code> element</a>, <var>document</var> is in <a>quirks mode</a> and the element is not <a>potentially scrollable</a>, return max(<a>viewport</a> <a>scrolling area</a> width, <var>viewport width</var>).
 1. If the element does not have any associated [=CSS/box=] return zero and terminate these steps.
 1. Return the width of the element's <a>scrolling area</a>.
@@ -1285,7 +1285,7 @@ The <dfn attribute for=Element>scrollHeight</dfn> attribute must return the resu
 1. Let <var>document</var> be the element's <a>node document</a>.
 1. If <var>document</var> is not the <a>active document</a>, return zero and terminate these steps.
 1. Let <var>viewport height</var> be the height of the <a>viewport</a> excluding the height of the scroll bar, if any, or zero if there is no <a>viewport</a>.
-1. If the element is the root element and <var>document</var> is not in <a>quirks mode</a> return max(<a>viewport</a> <a>scrolling area</a> height, <var>viewport height</var>).
+1. If the element is the [=root element=] and <var>document</var> is not in <a>quirks mode</a> return max(<a>viewport</a> <a>scrolling area</a> height, <var>viewport height</var>).
 1. If the element is <a>the <code>body</code> element</a>, <var>document</var> is in <a>quirks mode</a> and the element is not <a>potentially scrollable</a>, return max(<a>viewport</a> <a>scrolling area</a> height, <var>viewport height</var>).
 1. If the element does not have any associated [=CSS/box=] return zero and terminate these steps.
 1. Return the height of the element's <a>scrolling area</a>.
@@ -1303,13 +1303,13 @@ The <dfn attribute for=Element>clientLeft</dfn> attribute must run these steps:
 The <dfn attribute for=Element>clientWidth</dfn> attribute must run these steps:
 
 1. If the element has no associated [=CSS/box=] or if the [=CSS/box=] is inline, return zero.
-1. If the element is the root element and the element's <a>node document</a> is not in <a>quirks mode</a>, or if the element is <a>the <code>body</code> element</a> and the element's <a>node document</a> <em>is</em> in <a>quirks mode</a>, return the <a>viewport</a> width excluding the size of a rendered scroll bar (if any).
+1. If the element is the [=root element=] and the element's <a>node document</a> is not in <a>quirks mode</a>, or if the element is <a>the <code>body</code> element</a> and the element's <a>node document</a> <em>is</em> in <a>quirks mode</a>, return the <a>viewport</a> width excluding the size of a rendered scroll bar (if any).
 1. Return the width of the <a>padding edge</a> excluding the width of any rendered scrollbar between the <a>padding edge</a> and the <a>border edge</a>, ignoring any <a>transforms</a> that apply to the element and its ancestors.
 
 The <dfn attribute for=Element>clientHeight</dfn> attribute must run these steps:
 
 1. If the element has no associated [=CSS/box=] or if the [=CSS/box=] is inline, return zero.
-1. If the element is the root element and the element's <a>node document</a> is not in <a>quirks mode</a>, or if the element is <a>the <code>body</code> element</a> and the element's <a>node document</a> <em>is</em> in <a>quirks mode</a>, return the <a>viewport</a> height excluding the size of a rendered scroll bar (if any).
+1. If the element is the [=root element=] and the element's <a>node document</a> is not in <a>quirks mode</a>, or if the element is <a>the <code>body</code> element</a> and the element's <a>node document</a> <em>is</em> in <a>quirks mode</a>, return the <a>viewport</a> height excluding the size of a rendered scroll bar (if any).
 1. Return the height of the <a>padding edge</a> excluding the height of any rendered scrollbar between the <a>padding edge</a> and the <a>border edge</a>, ignoring any <a>transforms</a> that apply to the element and its ancestors.
 
 
@@ -1376,7 +1376,7 @@ a <a>scrolling box</a> <var>scrolling box</var>, in order of innermost to outerm
         <dt>If <var>scrolling box</var> is associated with a <a>viewport</a>
         <dd>
             Let <var>document</var> be the <a>viewport’s</a> associated {{Document}}.
-            Let <var>associated element</var> be <var>document</var>'s root element, if there is one, or null otherwise.
+            Let <var>associated element</var> be <var>document</var>'s [=root element=], if there is one, or null otherwise.
     </dl>
 1. <a>Perform a scroll</a> of <var>scrolling box</var> to <var>position</var>, <var>associated element</var> as the associated element and <var>behavior</var> as the scroll behavior.
 
@@ -1420,7 +1420,7 @@ The <dfn attribute for=HTMLElement>offsetParent</dfn> attribute must return the
 
 1. If any of the following holds true return null and terminate this algorithm:
     * The element does not have an associated [=CSS/box=].
-    * The element is the root element.
+    * The element is the [=root element=].
     * The element is <a>the <code>body</code> element</a>.
     * The element's computed value of the 'position' property is ''position/fixed''.
 1. Let <var>ancestor</var> be the parent of the element in the <a>flat tree</a> and repeat these substeps: