Skip to content

Commit 88c2569

Browse files
annevkannevk
authored
Editorial: slotable ➡️ slottable
While preserving IDs. Corresponding HTML PR: whatwg/html#5355. Closes #844.
1 parent 81ee431 commit 88c2569

File tree

1 file changed

+68
-63
lines changed

1 file changed

+68
-63
lines changed

‎dom.bs‎

Lines changed: 68 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ Shortname: dom
55
Text Macro: TWITTER thedomstandard
66
Abstract: DOM defines a platform-neutral model for events, aborting activities, and node trees.
77
Translation: ja https://triple-underscore.github.io/DOM4-ja.html
8+
Translate IDs: slottable slotable
89
Ignored Terms: EmptyString, Array, Document
910
Indent: 1
1011
</pre>
@@ -1304,8 +1305,8 @@ for discussion).
13041305
<a for=EventTarget>activation behavior</a>, then set <var>activationTarget</var> to
13051306
<var>target</var>.
13061307

1307-
<li><p>Let <var>slotable</var> be <var>target</var>, if <var>target</var> is a <a>slotable</a>
1308-
and is <a for=slotable>assigned</a>, and null otherwise.
1308+
<li><p>Let <var>slottable</var> be <var>target</var>, if <var>target</var> is a <a>slottable</a>
1309+
and is <a for=slottable>assigned</a>, and null otherwise.
13091310

13101311
<li><p>Let <var>slot-in-closed-tree</var> be false.
13111312

@@ -1317,20 +1318,20 @@ for discussion).
13171318

13181319
<ol>
13191320
<li>
1320-
<p>If <var>slotable</var> is non-null:
1321+
<p>If <var>slottable</var> is non-null:
13211322

13221323
<ol>
13231324
<li><p>Assert: <var>parent</var> is a <a for=/>slot</a>.
13241325

1325-
<li><p>Set <var>slotable</var> to null.
1326+
<li><p>Set <var>slottable</var> to null.
13261327

13271328
<li><p>If <var>parent</var>'s <a for=tree>root</a> is a <a for=/>shadow root</a> whose
13281329
<a for=ShadowRoot>mode</a> is "<code>closed</code>", then set <var>slot-in-closed-tree</var>
13291330
to true.
13301331
</ol>
13311332

1332-
<li><p>If <var>parent</var> is a <a>slotable</a> and is <a for=slotable>assigned</a>, then set
1333-
<var>slotable</var> to <var>parent</var>.
1333+
<li><p>If <var>parent</var> is a <a>slottable</a> and is <a for=slottable>assigned</a>, then
1334+
set <var>slottable</var> to <var>parent</var>.
13341335

13351336
<li><p>Let <var>relatedTarget</var> be the result of <a>retargeting</a> <var>event</var>'s
13361337
<a for=Event>relatedTarget</a> against <var>parent</var>.
@@ -2126,27 +2127,27 @@ otherwise it is the empty string.</p>
21262127

21272128
<li><p>Otherwise, set <var>element</var>'s <a for=slot>name</a> to <var>value</var>.
21282129

2129-
<li><p>Run <a>assign slotables for a tree</a> with <var>element</var>'s <a for=tree>root</a>.
2130+
<li><p>Run <a>assign slottables for a tree</a> with <var>element</var>'s <a for=tree>root</a>.
21302131
</ol>
21312132
</ol>
21322133

21332134
<p class="note">The first <a>slot</a> in a <a>shadow tree</a>, in <a>tree order</a>, whose
21342135
<a for=slot>name</a> is the empty string, is sometimes known as the "default slot".</p>
21352136

21362137
<p>A <a>slot</a> has an associated <dfn export for=slot>assigned nodes</dfn> (a list of
2137-
<a>slotables</a>). Unless stated otherwise it is empty.</p>
2138+
<a>slottables</a>). Unless stated otherwise it is empty.</p>
21382139

2139-
<h5 id=light-tree-slotables>Slotables</h5>
2140+
<h5 id=light-tree-slotables>Slottables</h5>
21402141

21412142
<p>{{Element}} and {{Text}} <a for=/>nodes</a> are
2142-
<dfn export id=concept-slotable lt=slotable>slotables</dfn>.</p>
2143+
<dfn export id=concept-slotable lt=slottable>slottables</dfn>.</p>
21432144

2144-
<p class="note">A <a>slot</a> can be a <a>slotable</a>.
2145+
<p class="note">A <a>slot</a> can be a <a>slottable</a>.
21452146

2146-
<p>A <a>slotable</a> has an associated <dfn export for=slotable>name</dfn> (a string). Unless stated
2147-
otherwise it is the empty string.</p>
2147+
<p>A <a>slottable</a> has an associated <dfn export for=slottable id=slotable-name>name</dfn> (a
2148+
string). Unless stated otherwise it is the empty string.</p>
21482149

2149-
<p>Use these <a>attribute change steps</a> to update a <a>slotable</a>'s <a for=slotable>name</a>:
2150+
<p>Use these <a>attribute change steps</a> to update a <a>slottable</a>'s <a for=slottable>name</a>:
21502151

21512152
<ol>
21522153
<li>
@@ -2160,31 +2161,33 @@ otherwise it is the empty string.</p>
21602161
<li><p>If <var>value</var> is the empty string and <var>oldValue</var> is null, then return.
21612162

21622163
<li><p>If <var>value</var> is null or the empty string, then set <var>element</var>'s
2163-
<a for=slotable>name</a> to the empty string.
2164+
<a for=slottable>name</a> to the empty string.
21642165

2165-
<li><p>Otherwise, set <var>element</var>'s <a for=slotable>name</a> to <var>value</var>.
2166+
<li><p>Otherwise, set <var>element</var>'s <a for=slottable>name</a> to <var>value</var>.
21662167

2167-
<li><p>If <var>element</var> is <a for=slotable>assigned</a>, then run <a>assign slotables</a>
2168-
for <var>element</var>'s <a for=slotable>assigned slot</a>.
2168+
<li><p>If <var>element</var> is <a for=slottable>assigned</a>, then run <a>assign slottables</a>
2169+
for <var>element</var>'s <a for=slottable>assigned slot</a>.
21692170

21702171
<li><p>Run <a>assign a slot</a> for <var>element</var>.
21712172
</ol>
21722173
</ol>
21732174

2174-
<p>A <a>slotable</a> has an associated <dfn export for=slotable>assigned slot</dfn> (null or a
2175-
<a>slot</a>). Unless stated otherwise it is null. A <a>slotable</a> is
2176-
<dfn export for=slotable>assigned</dfn> if its <a>assigned slot</a> is non-null.</p>
2175+
<p>A <a>slottable</a> has an associated
2176+
<dfn export for=slottable id=slotable-assigned-slot>assigned slot</dfn> (null or a <a>slot</a>).
2177+
Unless stated otherwise it is null. A <a>slottable</a> is
2178+
<dfn export for=slottable id=slotable-assigned>assigned</dfn> if its <a>assigned slot</a> is
2179+
non-null.</p>
21772180

2178-
<h5 id=finding-slots-and-slotables>Finding slots and slotables</h5>
2181+
<h5 id=finding-slots-and-slotables>Finding slots and slottables</h5>
21792182

2180-
<p>To <dfn export lt="find a slot|finding a slot">find a slot</dfn> for a given <a>slotable</a>
2181-
<var>slotable</var> and an optional <i>open flag</i> (unset unless stated otherwise), run these
2183+
<p>To <dfn export lt="find a slot|finding a slot">find a slot</dfn> for a given <a>slottable</a>
2184+
<var>slottable</var> and an optional <i>open flag</i> (unset unless stated otherwise), run these
21822185
steps:</p>
21832186

21842187
<ol>
2185-
<li><p>If <var>slotable</var>'s <a for=tree>parent</a> is null, then return null.</p></li>
2188+
<li><p>If <var>slottable</var>'s <a for=tree>parent</a> is null, then return null.</p></li>
21862189

2187-
<li><p>Let <var>shadow</var> be <var>slotable</var>'s <a for=tree>parent</a>'s
2190+
<li><p>Let <var>shadow</var> be <var>slottable</var>'s <a for=tree>parent</a>'s
21882191
<a for=Element>shadow root</a>.</p></li>
21892192

21902193
<li><p>If <var>shadow</var> is null, then return null.</p></li>
@@ -2193,12 +2196,12 @@ steps:</p>
21932196
<em>not</em> "<code>open</code>", then return null.</p></li>
21942197

21952198
<li><p>Return the first <a>slot</a> in <a>tree order</a> in <var>shadow</var>'s
2196-
<a for=tree>descendants</a> whose <a for=slot>name</a> is <var>slotable</var>'s
2197-
<a for=slotable>name</a>, if any, and null otherwise.</p></li>
2199+
<a for=tree>descendants</a> whose <a for=slot>name</a> is <var>slottable</var>'s
2200+
<a for=slottable>name</a>, if any, and null otherwise.</p></li>
21982201
</ol>
21992202

2200-
<p>To <dfn export lt="find slotables|finding slotables">find slotables</dfn> for a given <a>slot</a>
2201-
<var>slot</var>, run these steps:</p>
2203+
<p>To <dfn export lt="find slottables|finding slottables" id=find-slotables>find slottables</dfn>
2204+
for a given <a>slot</a> <var>slot</var>, run these steps:</p>
22022205

22032206
<ol>
22042207
<li><p>Let <var>result</var> be an empty list.</p></li>
@@ -2210,14 +2213,14 @@ steps:</p>
22102213
<a for=DocumentFragment>host</a>.</p></li>
22112214

22122215
<li>
2213-
<p>For each <a>slotable</a> <a for=tree>child</a> of <var>host</var>, <var>slotable</var>, in
2216+
<p>For each <a>slottable</a> <a for=tree>child</a> of <var>host</var>, <var>slottable</var>, in
22142217
<a>tree order</a>:</p>
22152218

22162219
<ol>
22172220
<li><p>Let <var>foundSlot</var> be the result of <a>finding a slot</a> given
2218-
<var>slotable</var>.</p></li>
2221+
<var>slottable</var>.</p></li>
22192222

2220-
<li><p>If <var>foundSlot</var> is <var>slot</var>, then append <var>slotable</var> to
2223+
<li><p>If <var>foundSlot</var> is <var>slot</var>, then append <var>slottable</var> to
22212224
<var>result</var>.</p></li>
22222225
</ol>
22232226
</li>
@@ -2226,7 +2229,7 @@ steps:</p>
22262229
</ol>
22272230

22282231
<p>To
2229-
<dfn export lt="find flattened slotables|finding flattened slotables">find flattened slotables</dfn>
2232+
<dfn export lt="find flattened slottables|finding flattened slottables" id=find-flattened-slotables>find flattened slottables</dfn>
22302233
for a given <a>slot</a> <var>slot</var>, run these steps:</p>
22312234

22322235
<ol>
@@ -2235,25 +2238,25 @@ for a given <a>slot</a> <var>slot</var>, run these steps:</p>
22352238
<li><p>If <var>slot</var>'s <a for=tree>root</a> is not a <a for=/>shadow root</a>, then return
22362239
<var>result</var>.</p></li>
22372240

2238-
<li><p>Let <var>slotables</var> be the result of <a>finding slotables</a> given
2241+
<li><p>Let <var>slottables</var> be the result of <a>finding slottables</a> given
22392242
<var>slot</var>.</p></li>
22402243

2241-
<li><p>If <var>slotables</var> is the empty list, then append each <a>slotable</a>
2242-
<a for=tree>child</a> of <var>slot</var>, in <a>tree order</a>, to <var>slotables</var>.</p></li>
2244+
<li><p>If <var>slottables</var> is the empty list, then append each <a>slottable</a>
2245+
<a for=tree>child</a> of <var>slot</var>, in <a>tree order</a>, to <var>slottables</var>.</p></li>
22432246

22442247
<li>
2245-
<p>For each <var>node</var> in <var>slotables</var>:
2248+
<p>For each <var>node</var> in <var>slottables</var>:
22462249

22472250
<ol>
22482251
<li>
22492252
<p>If <var>node</var> is a <a>slot</a> whose <a for=tree>root</a> is a <a for=/>shadow root</a>,
22502253
then:
22512254

22522255
<ol>
2253-
<li><p>Let <var>temporaryResult</var> be the result of <a>finding flattened slotables</a> given
2256+
<li><p>Let <var>temporaryResult</var> be the result of <a>finding flattened slottables</a> given
22542257
<var>node</var>.</p></li>
22552258

2256-
<li><p>Append each <a>slotable</a> in <var>temporaryResult</var>, in order, to
2259+
<li><p>Append each <a>slottable</a> in <var>temporaryResult</var>, in order, to
22572260
<var>result</var>.</p></li>
22582261
</ol>
22592262

@@ -2264,33 +2267,34 @@ for a given <a>slot</a> <var>slot</var>, run these steps:</p>
22642267
<li><p>Return <var>result</var>.</p></li>
22652268
</ol>
22662269

2267-
<h5 id=assigning-slotables-and-slots>Assigning slotables and slots</h5>
2270+
<h5 id=assigning-slotables-and-slots>Assigning slottables and slots</h5>
22682271

2269-
<p>To <dfn noexport>assign slotables</dfn> for a <a>slot</a> <var>slot</var>, run these steps:
2272+
<p>To <dfn noexport id=assign-slotables>assign slottables</dfn> for a <a>slot</a> <var>slot</var>,
2273+
run these steps:
22702274

22712275
<ol>
2272-
<li><p>Let <var>slotables</var> be the result of <a>finding slotables</a> for <var>slot</var>.
2276+
<li><p>Let <var>slottables</var> be the result of <a>finding slottables</a> for <var>slot</var>.
22732277

2274-
<li><p>If <var>slotables</var> and <var>slot</var>'s <a for=slot>assigned nodes</a> are not
2278+
<li><p>If <var>slottables</var> and <var>slot</var>'s <a for=slot>assigned nodes</a> are not
22752279
identical, then run <a>signal a slot change</a> for <var>slot</var>.
22762280

2277-
<li><p>Set <var>slot</var>'s <a for=slot>assigned nodes</a> to <var>slotables</var>.
2281+
<li><p>Set <var>slot</var>'s <a for=slot>assigned nodes</a> to <var>slottables</var>.
22782282

2279-
<li><p>For each <var>slotable</var> in <var>slotables</var>, set <var>slotable</var>'s
2283+
<li><p>For each <var>slottable</var> in <var>slottables</var>, set <var>slottable</var>'s
22802284
<a>assigned slot</a> to <var>slot</var>.
22812285
</ol>
22822286

2283-
<p>To <dfn noexport>assign slotables for a tree</dfn>, given a <a for=/>node</a>
2284-
<var>root</var>, run <a>assign slotables</a> for each <a>slot</a> <var>slot</var> in
2285-
<var>root</var>'s <a for=tree>inclusive descendants</a>, in <a>tree order</a>.
2287+
<p>To <dfn noexport id=assign-slotables-for-a-tree>assign slottables for a tree</dfn>, given a
2288+
<a for=/>node</a> <var>root</var>, run <a>assign slottables</a> for each <a>slot</a> <var>slot</var>
2289+
in <var>root</var>'s <a for=tree>inclusive descendants</a>, in <a>tree order</a>.
22862290

2287-
<p>To <dfn noexport>assign a slot</dfn>, given a <a>slotable</a> <var>slotable</var>, run these
2291+
<p>To <dfn noexport>assign a slot</dfn>, given a <a>slottable</a> <var>slottable</var>, run these
22882292
steps:
22892293

22902294
<ol>
2291-
<li><p>Let <var>slot</var> be the result of <a>finding a slot</a> with <var>slotable</var>.
2295+
<li><p>Let <var>slot</var> be the result of <a>finding a slot</a> with <var>slottable</var>.
22922296

2293-
<li><p>If <var>slot</var> is non-null, then run <a>assign slotables</a> for <var>slot</var>.
2297+
<li><p>If <var>slot</var> is non-null, then run <a>assign slottables</a> for <var>slot</var>.
22942298
</ol>
22952299

22962300
<h5 id=signaling-slot-change>Signaling slot change</h5>
@@ -2447,13 +2451,13 @@ before a <var>child</var>, with an optional <i>suppress observers flag</i>, run
24472451
<a for=tree>children</a> before <var>child</var>'s <a for=tree>index</a>.
24482452

24492453
<li><p>If <var>parent</var> is a <a for=Element>shadow host</a> and <var>node</var> is a
2450-
<a>slotable</a>, then <a>assign a slot</a> for <var>node</var>.
2454+
<a>slottable</a>, then <a>assign a slot</a> for <var>node</var>.
24512455

24522456
<li><p>If <var>parent</var>'s <a for=tree>root</a> is a <a for=/>shadow root</a>, and
24532457
<var>parent</var> is a <a>slot</a> whose <a for=slot>assigned nodes</a> is the empty list,
24542458
then run <a>signal a slot change</a> for <var>parent</var>.
24552459

2456-
<li><p>Run <a>assign slotables for a tree</a> with <var>node</var>'s <a for=tree>root</a>.
2460+
<li><p>Run <a>assign slottables for a tree</a> with <var>node</var>'s <a for=tree>root</a>.
24572461

24582462
<li>
24592463
<p>For each <a>shadow-including inclusive descendant</a> <var>inclusiveDescendant</var> of
@@ -2663,7 +2667,7 @@ indicated in the <a for=/>remove</a> algorithm below.
26632667

26642668
<li><p><a for=set>Remove</a> <var>node</var> from its <var>parent</var>'s <a for=tree>children</a>.
26652669

2666-
<li><p>If <var>node</var> is <a for=slotable>assigned</a>, then run <a>assign slotables</a> for
2670+
<li><p>If <var>node</var> is <a for=slottable>assigned</a>, then run <a>assign slottables</a> for
26672671
<var>node</var>'s <a>assigned slot</a>.
26682672

26692673
<li><p>If <var>parent</var>'s <a for=tree>root</a> is a <a for=/>shadow root</a>, and
@@ -2674,9 +2678,9 @@ indicated in the <a for=/>remove</a> algorithm below.
26742678
<p>If <var>node</var> has an <a>inclusive descendant</a> that is a <a>slot</a>, then:
26752679

26762680
<ol>
2677-
<li><p>Run <a>assign slotables for a tree</a> with <var>parent</var>'s <a for=tree>root</a>.
2681+
<li><p>Run <a>assign slottables for a tree</a> with <var>parent</var>'s <a for=tree>root</a>.
26782682

2679-
<li><p>Run <a>assign slotables for a tree</a> with <var>node</var>.
2683+
<li><p>Run <a>assign slottables for a tree</a> with <var>node</var>.
26802684
</ol>
26812685

26822686
<li><p>Run the <a>removing steps</a> with <var>node</var> and <var>parent</var>.
@@ -3043,18 +3047,19 @@ steps:
30433047
</ol>
30443048

30453049

3046-
<h4 id=mixin-slotable>Mixin {{Slotable}}</h4>
3050+
<h4 id=mixin-slotable>Mixin {{Slottable}}</h4>
30473051

30483052
<pre class=idl>
3049-
interface mixin Slotable {
3053+
interface mixin Slottable {
30503054
readonly attribute HTMLSlotElement? assignedSlot;
30513055
};
3052-
Element includes Slotable;
3053-
Text includes Slotable;
3056+
Element includes Slottable;
3057+
Text includes Slottable;
30543058
</pre>
30553059

3056-
<p>The <dfn attribute for=Slotable><code>assignedSlot</code></dfn> attribute's getter must return
3057-
the result of <a>find a slot</a> given <a>this</a> and with the <i>open flag</i> set.</p>
3060+
<p>The <dfn attribute for=Slottable id=dom-slotable-assignedslot><code>assignedSlot</code></dfn>
3061+
attribute's getter must return the result of <a>find a slot</a> given <a>this</a> and with the
3062+
<i>open flag</i> set.</p>
30583063

30593064

30603065
<h4 id=old-style-collections>Old-style collections: {{NodeList}} and {{HTMLCollection}}</h4>

0 commit comments

Comments
 (0)