Skip to content

Commit 16cb780

Browse files
keithamuskeithamus
authored
Editorial: reword popover "invoker" terminology to "control" or "source" as appropriate
1 parent 787316d commit 16cb780

File tree

1 file changed

+45
-45
lines changed

1 file changed

+45
-45
lines changed

‎source

Lines changed: 45 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -46792,7 +46792,7 @@ interface <dfn interface>HTMLInputElement</dfn> : <span>HTMLElement</span> {
4679246792

4679346793
// <a href="#HTMLInputElement-partial">also has obsolete members</a>
4679446794
};
46795-
<span>HTMLInputElement</span> includes <span>PopoverInvokerElement</span>;</code></pre>
46795+
<span>HTMLInputElement</span> includes <span>PopoverTargetAttributes</span>;</code></pre>
4679646796
</dd>
4679746797
<dd w-dev>Uses <code>HTMLInputElement</code>.</dd>
4679846798
</dl>
@@ -53437,7 +53437,7 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
5343753437

5343853438
readonly attribute <span>NodeList</span> <span data-x="dom-lfe-labels">labels</span>;
5343953439
};
53440-
<span>HTMLButtonElement</span> includes <span>PopoverInvokerElement</span>;</code></pre>
53440+
<span>HTMLButtonElement</span> includes <span>PopoverTargetAttributes</span>;</code></pre>
5344153441
</dd>
5344253442
<dd w-dev>Uses <code>HTMLButtonElement</code>.</dd>
5344353443
</dl>
@@ -53621,12 +53621,12 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
5362153621
data-x="concept-element-namespace">namespace</span> is the
5362253622
<span>HTML namespace</span>.</p></li>
5362353623

53624-
<li><p>If this standard does not define <span>is valid invoker command steps</span> for
53624+
<li><p>If this standard does not define <span>is valid command steps</span> for
5362553625
<var>target</var>'s <span data-x="concept-element-local-name">local name</span>, then
5362653626
return.</p></li>
5362753627

5362853628
<li><p>Otherwise, if the result of running <var>target</var>'s corresponding <span>is valid
53629-
invoker command steps</span> given <var>command</var> is false, then
53629+
command steps</span> given <var>command</var> is false, then
5363053630
return.</p></li>
5363153631
</ol>
5363253632
</li>
@@ -53694,9 +53694,9 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
5369453694
</ol>
5369553695
</li>
5369653696

53697-
<li><p>Otherwise, if this standard defines <span>invoker command steps</span> for
53697+
<li><p>Otherwise, if this standard defines <span>command steps</span> for
5369853698
<var>target</var>'s <span data-x="concept-element-local-name">local name</span>, then run the
53699-
corresponding <span>invoker command steps</span> given <var>target</var>, <var>element</var>,
53699+
corresponding <span>command steps</span> given <var>target</var>, <var>element</var>,
5370053700
and <var>command</var>.</p></li>
5370153701
</ol>
5370253702
</li>
@@ -53707,7 +53707,7 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
5370753707
</ol>
5370853708

5370953709
<p>An <span data-x="HTML Elements">HTML element</span> can have specific
53710-
<dfn>is valid invoker command steps</dfn> and <dfn>invoker command steps</dfn> defined for the
53710+
<dfn>is valid command steps</dfn> and <dfn>command steps</dfn> defined for the
5371153711
element's <span data-x="concept-element-local-name">local name</span>.</p>
5371253712

5371353713
</div>
@@ -62927,7 +62927,7 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
6292762927
</li>
6292862928
</ol>
6292962929

62930-
<p>The <span>is valid invoker command steps</span> for <code>dialog</code> elements, given a <code
62930+
<p>The <span>is valid command steps</span> for <code>dialog</code> elements, given a <code
6293162931
data-x="attr-button-command">command</code> attribute <var>command</var>, are:</p>
6293262932

6293362933
<ol>
@@ -62939,8 +62939,8 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
6293962939
<li><p>Return false.</p></li>
6294062940
</ol>
6294162941

62942-
<p>The <span>invoker command steps</span> for <code>dialog</code> elements, given an element
62943-
<var>element</var>, an element <var>invoker</var>, and a <code
62942+
<p>The <span>command steps</span> for <code>dialog</code> elements, given an element
62943+
<var>element</var>, an element <var>source</var>, and a <code
6294462944
data-x="attr-button-command">command</code> attribute <var>command</var>, are:</p>
6294562945

6294662946
<ol>
@@ -62950,20 +62950,20 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
6295062950
<li><p>If <var>command</var> is in the <span
6295162951
data-x="attr-button-command-close-state">Close</span> state and <var>element</var> has an <code
6295262952
data-x="attr-dialog-open">open</code> attribute, then <span>close the dialog</span>
62953-
<var>element</var> with <var>invoker</var>'s <span data-x="concept-fe-optional-value">optional
62954-
value</span> and <var>invoker</var>.</p></li>
62953+
<var>element</var> with <var>source</var>'s <span data-x="concept-fe-optional-value">optional
62954+
value</span> and <var>source</var>.</p></li>
6295562955

6295662956
<li><p>If <var>command</var> is in the <span
6295762957
data-x="attr-button-command-request-close-state">Request Close</span> state and
6295862958
<var>element</var> has an <code data-x="attr-dialog-open">open</code> attribute, then <span
6295962959
data-x="dialog-request-close">request to close the dialog</span> <var>element</var> with
62960-
<var>invoker</var>'s <span data-x="concept-fe-optional-value">optional value</span> and
62961-
<var>invoker</var>.</p></li>
62960+
<var>source</var>'s <span data-x="concept-fe-optional-value">optional value</span> and
62961+
<var>source</var>.</p></li>
6296262962

6296362963
<li><p>If <var>command</var> is the <span
6296462964
data-x="attr-button-command-show-modal-state">Show Modal</span> state and <var>element</var> does
6296562965
not have an <code data-x="attr-dialog-open">open</code> attribute, then
62966-
<span>show a modal dialog</span> given <var>element</var> and <var>invoker</var>.</p></li>
62966+
<span>show a modal dialog</span> given <var>element</var> and <var>source</var>.</p></li>
6296762967
</ol>
6296862968

6296962969
<div class="example">
@@ -81407,7 +81407,7 @@ dictionary <dfn dictionary>CommandEventInit</dfn> : <span>EventInit</span> {
8140781407

8140881408
<p>A node is a <dfn>focus navigation scope owner</dfn> if it is a <code>Document</code>, a
8140981409
<span>shadow host</span>, a <span>slot</span>, or an element which is the <span>popover
81410-
invoker</span> of an element in the <span data-x="popover-showing-state">popover showing
81410+
trigger</span> of an element in the <span data-x="popover-showing-state">popover showing
8141181411
state</span>.</p>
8141281412

8141381413
<p>Each <span>focus navigation scope owner</span> has a <dfn>focus navigation scope</dfn>, which
@@ -81430,8 +81430,8 @@ dictionary <dfn dictionary>CommandEventInit</dfn> : <span>EventInit</span> {
8143081430
parent's <span>node document</span>.</p></li>
8143181431

8143281432
<li><p>If <var>element</var> is in the <span data-x="popover-showing-state">popover showing
81433-
state</span> and has a <span>popover invoker</span> set, then return <var>element</var>'s
81434-
<span>popover invoker</span>.</p></li>
81433+
state</span> and has a <span>popover trigger</span> set, then return <var>element</var>'s
81434+
<span>popover trigger</span>.</p></li>
8143581435

8143681436
<li><p>Return <var>element</var>'s parent's <span>associated focus navigation owner</span>.</p></li>
8143781437
</ol>
@@ -87079,7 +87079,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8707987079
<p>Every <code>Document</code> has a <dfn>popover pointerdown target</dfn>, which is an <span
8708087080
data-x="HTML elements">HTML element</span> or null, initially null.</p>
8708187081

87082-
<p>Every <span data-x="HTML elements">HTML element</span> has a <dfn>popover invoker</dfn>, which
87082+
<p>Every <span data-x="HTML elements">HTML element</span> has a <dfn>popover trigger</dfn>, which
8708387083
is an <span data-x="HTML elements">HTML element</span> or null, initially set to null.</p>
8708487084

8708587085
<p>Every <span data-x="HTML elements">HTML element</span> has a <dfn>popover showing or
@@ -87138,25 +87138,25 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8713887138
data-x="dom-showPopover">showPopover(<var>options</var>)</code></dfn> method steps are:</p>
8713987139

8714087140
<ol>
87141-
<li><p>Let <var>invoker</var> be <var>options</var>["<code
87141+
<li><p>Let <var>source</var> be <var>options</var>["<code
8714287142
data-x="dom-ShowPopoverOptions-source">source</code>"] if it <span data-x="map
8714387143
exists">exists</span>; otherwise, null.</p></li>
8714487144

8714587145
<li><p>Run <span>show popover</span> given <span>this</span>, true, and
87146-
<var>invoker</var>.</p></li>
87146+
<var>source</var>.</p></li>
8714787147
</ol>
8714887148

8714987149
<p>To <dfn>show popover</dfn>, given an <span data-x="HTML elements">HTML element</span>
8715087150
<var>element</var>, a boolean <var>throwExceptions</var>, and an <span data-x="HTML elements">HTML
87151-
element</span> or null <var>invoker</var>:</p>
87151+
element</span> or null <var>source</var>:</p>
8715287152

8715387153
<ol>
8715487154
<li><p>If the result of running <span>check popover validity</span> given <var>element</var>,
8715587155
false, <var>throwExceptions</var>, and null is false, then return.</p></li>
8715687156

8715787157
<li><p>Let <var>document</var> be <var>element</var>'s <span>node document</span>.</p></li>
8715887158

87159-
<li><p><span>Assert</span>: <var>element</var>'s <span>popover invoker</span> is null.</p></li>
87159+
<li><p><span>Assert</span>: <var>element</var>'s <span>popover trigger</span> is null.</p></li>
8716087160

8716187161
<li><p><span>Assert</span>: <var>element</var> is not in <var>document</var>'s <span>top
8716287162
layer</span>.</p></li>
@@ -87183,7 +87183,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8718387183
data-x="dom-ToggleEvent-oldState">oldState</code> attribute initialized to "<code
8718487184
data-x="">closed</code>", the <code data-x="dom-ToggleEvent-newState">newState</code> attribute
8718587185
initialized to "<code data-x="">open</code>", and the <code
87186-
data-x="dom-ToggleEvent-source">source</code> attribute initialized to <var>invoker</var> at
87186+
data-x="dom-ToggleEvent-source">source</code> attribute initialized to <var>source</var> at
8718787187
<var>element</var> is false, then run <var>cleanupShowingFlag</var> and return.</p></li>
8718887188

8718987189
<li>
@@ -87205,11 +87205,11 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8720587205

8720687206
<li><p>Let <var>autoAncestor</var> be the result of running the <span>topmost popover
8720787207
ancestor</span> algorithm given <var>element</var>, <var>document</var>'s <span>showing auto
87208-
popover list</span>, <var>invoker</var>, and true.</p></li>
87208+
popover list</span>, <var>source</var>, and true.</p></li>
8720987209

8721087210
<li><p>Let <var>hintAncestor</var> be the result of running the <span>topmost popover
8721187211
ancestor</span> algorithm given <var>element</var>, <var>document</var>'s <span>showing hint
87212-
popover list</span>, <var>invoker</var>, and true.</p></li>
87212+
popover list</span>, <var>source</var>, and true.</p></li>
8721387213

8721487214
<li>
8721587215
<p>If <var>originalType</var> is the <span data-x="attr-popover-auto-state">Auto</span> state,
@@ -87221,7 +87221,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8722187221

8722287222
<li><p>Let <var>ancestor</var> be the result of running the <span>topmost popover
8722387223
ancestor</span> algorithm given <var>element</var>, <var>document</var>'s <span>showing auto
87224-
popover list</span>, <var>invoker</var>, and true.</p></li>
87224+
popover list</span>, <var>source</var>, and true.</p></li>
8722587225

8722687226
<li><p>If <var>ancestor</var> is null, then set <var>ancestor</var> to
8722787227
<var>document</var>.</p></li>
@@ -87368,10 +87368,10 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8736887368
<li><p>Set <var>element</var>'s <span>popover visibility state</span> to <span
8736987369
data-x="popover-showing-state">showing</span>.</p></li>
8737087370

87371-
<li><p>Set <var>element</var>'s <span>popover invoker</span> to <var>invoker</var>.</p></li>
87371+
<li><p>Set <var>element</var>'s <span>popover trigger</span> to <var>source</var>.</p></li>
8737287372

8737387373
<li><p>Set <var>element</var>'s <span>implicit anchor element</span> to
87374-
<var>invoker</var>.</p></li>
87374+
<var>source</var>.</p></li>
8737587375

8737687376
<li><p>Run the <span>popover focusing steps</span> given <var>element</var>.</p></li>
8737787377

@@ -87381,7 +87381,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8738187381
<span>previously focused element</span> to <var>originallyFocusedElement</var>.</p></li>
8738287382

8738387383
<li><p><span>Queue a popover toggle event task</span> given <var>element</var>, "<code
87384-
data-x="">closed</code>", "<code data-x="">open</code>", and <var>invoker</var>.</p></li>
87384+
data-x="">closed</code>", "<code data-x="">open</code>", and <var>source</var>.</p></li>
8738587385

8738687386
<li><p>Run <var>cleanupShowingFlag</var>.</p></li>
8738787387
</ol>
@@ -87535,7 +87535,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8753587535
<li><p>Otherwise, <span>remove an element from the top layer immediately</span> given
8753687536
<var>element</var>.</p></li>
8753787537

87538-
<li><p>Set <var>element</var>'s <span>popover invoker</span> to null.</p></li>
87538+
<li><p>Set <var>element</var>'s <span>popover trigger</span> to null.</p></li>
8753987539

8754087540
<li><p>Set <var>element</var>'s <span>opened in popover mode</span> to null.</p></li>
8754187541

@@ -87579,7 +87579,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8757987579
set <var>force</var> to <var>options</var>["<code
8758087580
data-x="dom-TogglePopoverOptions-force">force</code>"].</p></li>
8758187581

87582-
<li><p>Let <var>invoker</var> be <var>options</var>["<code
87582+
<li><p>Let <var>source</var> be <var>options</var>["<code
8758387583
data-x="dom-ShowPopoverOptions-source">source</code>"] if it <span data-x="map
8758487584
exists">exists</span>; otherwise, null.</p></li>
8758587585

@@ -87589,7 +87589,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8758987589
null.</p></li>
8759087590

8759187591
<li><p>Otherwise, if <var>force</var> is null or true, then run <span>show popover</span> given
87592-
<span>this</span>, true, and <var>invoker</var>.</p></li>
87592+
<span>this</span>, true, and <var>source</var>.</p></li>
8759387593

8759487594
<li>
8759587595
<p>Otherwise:</p>
@@ -87729,7 +87729,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8772987729

8773087730
<p>To find the <dfn export>topmost popover ancestor</dfn>, given a <code>Node</code>
8773187731
<var>newPopoverOrTopLayerElement</var>, a <span>list</span> <var>popoverList</var>, an <span
87732-
data-x="HTML elements">HTML element</span> or null <var>invoker</var>, and a boolean
87732+
data-x="HTML elements">HTML element</span> or null <var>source</var>, and a boolean
8773387733
<var>isPopover</var>, perform the following steps. They return an <span data-x="HTML
8773487734
elements">HTML element</span> or null.</p>
8773587735

@@ -87744,10 +87744,10 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8774487744
<li><p>The popovers are nested within each other in the node tree. In this case, the descendant
8774587745
popover is the "child" and its topmost ancestor popover is the "parent".</p></li>
8774687746

87747-
<li><p>An invoking element (e.g., a <code>button</code>) has a <code
87747+
<li><p>A popover trigger element (e.g., a <code>button</code>) has a <code
8774887748
data-x="attr-popovertarget">popovertarget</code> attribute pointing to a popover. In this case,
87749-
the popover is the "child", and the popover subtree the invoking element is in is the
87750-
"parent". The invoker has to be in a popover and reference an open popover.</p></li>
87749+
the popover is the "child", and the popover subtree the trigger element is in is the
87750+
"parent". The trigger element has to be in a popover and reference an open popover.</p></li>
8775187751
</ol>
8775287752

8775387753
<p>In each of the relationships formed above, the parent popover has to be strictly earlier in
@@ -87785,7 +87785,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8778587785
<p>Otherwise:</p>
8778687786

8778787787
<ol>
87788-
<li><p><span>Assert</span>: <var>invoker</var> is null.</p></li>
87788+
<li><p><span>Assert</span>: <var>source</var> is null.</p></li>
8778987789
</ol>
8779087790
</li>
8779187791

@@ -87861,7 +87861,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8786187861
<li><p>Run <var>checkAncestor</var> given <var>newPopoverOrTopLayerElement</var>'s parent node
8786287862
within the <span>flat tree</span>.</p></li>
8786387863

87864-
<li><p>Run <var>checkAncestor</var> given <var>invoker</var>.</p></li>
87864+
<li><p>Run <var>checkAncestor</var> given <var>source</var>.</p></li>
8786587865

8786687866
<li><p>Return <var>topmostPopoverAncestor</var>.</p></li>
8786787867
</ol>
@@ -88165,7 +88165,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8816588165
</div>
8816688166

8816788167
<span data-x="concept-element-dom">DOM interface</span>:
88168-
<pre><code class="idl">interface mixin <dfn interface>PopoverInvokerElement</dfn> {
88168+
<pre><code class="idl">interface mixin <dfn interface>PopoverTargetAttributes</dfn> {
8816988169
[<span>CEReactions</span>, <span data-x="xattr-Reflect">Reflect</span>] attribute Element? <dfn attribute for="HTMLElement" data-x="dom-popoverTargetElement">popoverTargetElement</dfn>;
8817088170
[<span>CEReactions</span>] attribute DOMString <span data-x="dom-popoverTargetAction">popoverTargetAction</span>;
8817188171
};</code></pre>
@@ -88290,15 +88290,15 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8829088290
<li><p>Let <var>clickedPopover</var> be the result of running <span>nearest inclusive open
8829188291
popover</span> given <var>node</var>.</p></li>
8829288292

88293-
<li><p>Let <var>invokerPopover</var> be the result of running <span>nearest inclusive target
88294-
popover for invoker</span> given <var>node</var>.</p></li>
88293+
<li><p>Let <var>targetPopover</var> be the result of running <span>nearest inclusive target
88294+
popover</span> given <var>node</var>.</p></li>
8829588295

8829688296
<li><p>If the result of <span data-x="get the popover stack position">getting the popover stack
8829788297
position</span> given <var>clickedPopover</var> is greater than the result of <span data-x="get
8829888298
the popover stack position">getting the popover stack position</span> given
88299-
<var>invokerPopover</var>, then return <var>clickedPopover</var>.</p></li>
88299+
<var>targetPopover</var>, then return <var>clickedPopover</var>.</p></li>
8830088300

88301-
<li><p>Return <var>invokerPopover</var>.</p></li>
88301+
<li><p>Return <var>targetPopover</var>.</p></li>
8830288302
</ol>
8830388303

8830488304
<p>To <dfn>get the popover stack position</dfn>, given an <span data-x="html elements">HTML
@@ -88320,7 +88320,7 @@ dictionary <dfn dictionary>DragEventInit</dfn> : <span>MouseEventInit</span> {
8832088320
<li><p>Return 0.</p></li>
8832188321
</ol>
8832288322

88323-
<p>To find the <dfn>nearest inclusive target popover for invoker</dfn> given a <code>Node</code>
88323+
<p>To find the <dfn>nearest inclusive target popover</dfn> given a <code>Node</code>
8832488324
<var>node</var>:</p>
8832588325

8832688326
<ol>

0 commit comments

Comments
 (0)