Skip to content

Commit 54e6984

Browse files
committed
Review, format changes
1 parent b6019ad commit 54e6984

File tree

1 file changed

+27
-31
lines changed

1 file changed

+27
-31
lines changed

dom.bs

Lines changed: 27 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -3040,7 +3040,7 @@ optional <i>suppress observers flag</i>, run these steps:
30403040
<a>shadow-including inclusive descendant</a> of <var>node</var>, set its <a for=range>start</a> to
30413041
(<var>parent</var>, <var>index</var>).
30423042

3043-
<li><p>For each <a>composed live range</a> whose <a for=range>end node</a> is an
3043+
<li><p>For each <a>composed live range</a> whose <a for=range>end node</a> is a
30443044
<a>shadow-including inclusive descendant</a> of <var>node</var>, set its <a for=range>end</a> to
30453045
(<var>parent</var>, <var>index</var>).
30463046

@@ -5785,8 +5785,7 @@ are:
57855785
<hr>
57865786

57875787
<p>The <dfn method for=Document><code>createRange()</code></dfn> method steps are to return a new
5788-
{{Range}} <a>live range</a> with (<a>this</a>, 0) as its <a for=range>start</a> and <a
5789-
for=range>end</a>.
5788+
{{Range}} object with (<a>this</a>, 0) as its <a for=range>start</a> and <a for=range>end</a>.
57905789

57915790
<p class=note>The {{Range/Range()}} constructor can be used instead.
57925791

@@ -7921,11 +7920,11 @@ range.setEnd(secondText, 4)
79217920
<a>node tree</a> above cannot be represented by a <a>range</a>. <a>Ranges</a> are only useful for
79227921
<a for=/>nodes</a>.
79237922

7924-
<p>{{Range}} objects, unlike {{StaticRange}} objects, are affected by mutations to the <a>node
7925-
tree</a>. Therefore they are <a>live ranges</a>. Such mutations will not invalidate them and will
7926-
try to ensure that it still represents the same piece of content. Necessarily, a <a>live range</a>
7927-
might itself be modified as part of the mutation to the <a>node tree</a> when, e.g., part of the
7928-
content it represents is mutated.
7923+
<p>{{Range}} objects, unlike {{StaticRange}} objects, are affected by mutations to the
7924+
<a>node tree</a>. Therefore they are <a>live ranges</a>. Such mutations will not invalidate them and
7925+
will try to ensure that it still represents the same piece of content. Necessarily, a
7926+
<a>live range</a> might itself be modified as part of the mutation to the <a>node tree</a> when,
7927+
e.g., part of the content it represents is mutated.
79297928

79307929
<p class=note>See the <a for=/>insert</a> and <a for=/>remove</a> algorithms, the
79317930
{{Node/normalize()}} method, and the <a>replace data</a> and <a lt="split a Text node">split</a>
@@ -8162,12 +8161,11 @@ mutations to the <a>node tree</a>.</p>
81628161
<a>live ranges</a> associated with that <a>tree</a>.</p>
81638162

81648163
<p>A <dfn export id=concept-composed-live-range>composed live range</dfn> is a <a>live range</a>
8165-
that has one associated {{Range}} object - <dfn export
8166-
id=concept-composed-live-range-cached-live-range for="composed live range">cached live
8167-
range</dfn>.</p>
8164+
that has one associated {{Range}} object —
8165+
<dfn export id=concept-cached-live-range for="composed live range">cached live range</dfn>.</p>
81688166

8169-
<p class=note>The <a>cached live range</a> is used to maintain backward compatibility with the
8170-
{{getRangeAt}} API.</p>
8167+
<p class=note>The <a for="composed live range">cached live range</a> is used to maintain backward
8168+
compatibility with the {{getRangeAt}} API.</p>
81718169

81728170
<p>The <dfn export id=concept-range-root for="live range">root</dfn> of a <a>live range</a> is the
81738171
<a for=tree>root</a> of its <a for=range>start node</a>.
@@ -8237,7 +8235,7 @@ but not its <a for=range>end node</a>, or vice versa.
82378235

82388236
<dl class=domintro>
82398237
<dt><code><var>range</var> = new <a constructor>Range()</a></code>
8240-
<dd>Returns a new {{Range}} <a>live range</a>.
8238+
<dd>Returns a new {{Range}} object.
82418239
</dl>
82428240

82438241
<p>The <dfn constructor for=Range lt="Range()"><code>new Range()</code></dfn> constructor steps are
@@ -8303,9 +8301,9 @@ steps:
83038301
<li>Set <var>range</var>'s
83048302
<a for=range>start</a> to <var>bp</var>.
83058303

8306-
<li>If <var>range</var> is the associated <a>cached live range</a> of a <a>composed live
8307-
range</a> <var>composed live range</var>, set <var>composed live range</var>’s <a
8308-
for="range">start</a> to <var>bp</var>.
8304+
<li>If <var>range</var> is the <a for="composed live range">cached live range</a> of a
8305+
<var>composed live range</var>, set <var>composed live range</var>’s
8306+
<a or="range">start</a> to <var>bp</var>.
83098307
</ol>
83108308
<dt>If these steps were invoked as "set the end"
83118309
<dd>
@@ -8322,9 +8320,9 @@ steps:
83228320
<li>Set <var>range</var>'s
83238321
<a for=range>end</a> to <var>bp</var>.
83248322

8325-
<li>If <var>range</var> is the associated <a>cached live range</a> of a <a>composed live range</a>
8326-
<var>composed live range</var>, set <var>composed live range</var>’s <a for="range">end</a> to
8327-
<var>bp</var>.
8323+
<li>If <var>range</var> is the <a for="composed live range">cached live range</a> of a
8324+
<var>composed live range</var>, set <var>composed live range</var>’s
8325+
<a for="range">end</a> to <var>bp</var>.
83288326
</ol>
83298327
</dl>
83308328
</ol>
@@ -8605,8 +8603,8 @@ method steps are:
86058603
(<var>new node</var>, <var>new offset</var>).
86068604
</ol>
86078605

8608-
<p>To <dfn export id=concept-range-extract for="live range">extract</dfn> a {{Range}} <a>live
8609-
range</a> <var>range</var>, run these steps:
8606+
<p>To <dfn export id=concept-range-extract for="live range">extract</dfn> a {{Range}} object
8607+
<var>range</var>, run these steps:
86108608

86118609
<ol>
86128610
<li><p>Let <var>fragment</var> be a new {{DocumentFragment}} <a for=/>node</a> whose
@@ -8782,8 +8780,7 @@ range</a> <var>range</var>, run these steps:
87828780
<li><a>Append</a> <var>clone</var>
87838781
to <var>fragment</var>.
87848782

8785-
<li>Let <var>subrange</var> be a new {{Range}} <a>live range</a>
8786-
whose <a for=range>start</a> is
8783+
<li>Let <var>subrange</var> be a new {{Range}} object whose <a for=range>start</a> is
87878784
(<var>original start node</var>, <var>original start offset</var>) and
87888785
whose <a for=range>end</a> is
87898786
(<var>first partially contained child</var>, <var>first partially contained child</var>'s
@@ -8836,8 +8833,7 @@ range</a> <var>range</var>, run these steps:
88368833
<li><a>Append</a> <var>clone</var>
88378834
to <var>fragment</var>.
88388835

8839-
<li>Let <var>subrange</var> be a new {{Range}} <a>live range</a>
8840-
whose <a for=range>start</a> is
8836+
<li>Let <var>subrange</var> be a new {{Range}} object whose <a for=range>start</a> is
88418837
(<var>last partially contained child</var>, 0) and whose
88428838
<a for=range>end</a> is
88438839
(<var>original end node</var>, <var>original end offset</var>).
@@ -8861,7 +8857,7 @@ result of <a for="live range">extracting</a> <a>this</a>.
88618857

88628858
<p>To
88638859
<dfn export id=concept-range-clone for="live range" lt="clone the contents|cloning the contents">clone the contents</dfn>
8864-
of a {{Range}} <a>live range</a> <var>range</var>, run these steps:
8860+
of a {{Range}} object <var>range</var>, run these steps:
88658861

88668862
<ol>
88678863
<li><p>Let <var>fragment</var> be a new {{DocumentFragment}} <a for=/>node</a> whose
@@ -8989,7 +8985,7 @@ of a {{Range}} <a>live range</a> <var>range</var>, run these steps:
89898985
<li><a>Append</a> <var>clone</var>
89908986
to <var>fragment</var>.
89918987

8992-
<li>Let <var>subrange</var> be a new {{Range}} <a>live range</a>
8988+
<li>Let <var>subrange</var> be a new {{Range}} object
89938989
whose <a for=range>start</a> is
89948990
(<var>original start node</var>, <var>original start offset</var>) and
89958991
whose <a for=range>end</a> is
@@ -9047,7 +9043,7 @@ of a {{Range}} <a>live range</a> <var>range</var>, run these steps:
90479043
<li><a>Append</a> <var>clone</var>
90489044
to <var>fragment</var>.
90499045

9050-
<li>Let <var>subrange</var> be a new {{Range}} <a>live range</a>
9046+
<li>Let <var>subrange</var> be a new {{Range}} object
90519047
whose <a for=range>start</a> is
90529048
(<var>last partially contained child</var>, 0) and whose
90539049
<a for=range>end</a> is
@@ -9067,7 +9063,7 @@ of a {{Range}} <a>live range</a> <var>range</var>, run these steps:
90679063
result of <a for="live range">cloning the contents</a> of <a>this</a>.
90689064

90699065
<p>To <dfn export id=concept-range-insert for="live range">insert</dfn> a <a for=/>node</a>
9070-
<var>node</var> into a {{Range}} <a>live range</a> <var>range</var>, run these steps:
9066+
<var>node</var> into a {{Range}} object <var>range</var>, run these steps:
90719067

90729068
<ol>
90739069
<li>If <var>range</var>'s <a for=range>start node</a> is a {{ProcessingInstruction}} or {{Comment}}
@@ -9217,7 +9213,7 @@ check first thing, which matches everyone but Firefox.
92179213
</ol>
92189214

92199215
<p>The <dfn method for=Range><code>cloneRange()</code></dfn> method steps are to return a new
9220-
{{Range}} <a>live range</a> with the same <a for=range>start</a> and <a for=range>end</a> as
9216+
{{Range}} object with the same <a for=range>start</a> and <a for=range>end</a> as
92219217
<a>this</a>.
92229218

92239219
<p>The <dfn method for=Range><code>detach()</code></dfn> method steps are to do nothing.

0 commit comments

Comments
 (0)