html icon indicating copy to clipboard operation
html copied to clipboard

Reword popover "invoker" terminology to "control" or "source" where appropriate.

Open keithamus opened this issue 5 months ago • 2 comments

This editorial change attempts to fix #11352, by dropping the use of the word "invoker", instead referring to the invoker as the "control". However for some algorithms "control" feels a little generic as a variable and so I opted to use "source" as it also aligns better to the IDL definitions which have a .source property to refer to said control.

IOW, a popover is controlled by a "popover control", but "source" is a specifically provided "popover control".

This also renames the "invoker command steps" and "is valid invoker command steps" to "comamndfor steps" and "is valid commandfor steps" respectively.


/form-elements.html ( diff ) /interaction.html ( diff ) /interactive-elements.html ( diff ) /popover.html ( diff )

keithamus avatar Jun 17 '25 10:06 keithamus

Thanks for doing this! I hadn't realized there were cases where "source" was inappropriate; could you briefly explain that for me?

domenic avatar Jun 18 '25 01:06 domenic

I think "source" works fine in instances where it refers to the IDL property. In other cases it felt a little ambiguous, for example renaming "popover invoker" to "popover source" sounds as though its the element with the popover attribute, rather than the button controlling the popover, so here I felt "popover control" was a better fit. Likewise "invoker command steps" would be odd to be named "source command steps", but also "control command steps" is equally nonsensical, so "commandfor steps" seems to be more illustrative IMO.

As an aside I don't know why CI isn't generating the preview links for this PR.

keithamus avatar Jun 18 '25 09:06 keithamus

@keithamus I don't see PopoverInvokerElement in the diff, do you want to rename that? (If you do, I'd follow the pattern for InterestInvokerElement, most likely.)

foolip avatar Aug 12 '25 11:08 foolip

@foolip rebased and renamed PopoverInvokerElement to ElementPopover which aligns it to the other mixin, ElementContentEditable.

keithamus avatar Aug 12 '25 16:08 keithamus

Great suggestions @foolip - I went with them all.

keithamus avatar Aug 13 '25 08:08 keithamus

@keithamus there are some build errors still, looks like at least the "commandfor steps" rename is only partially done? I started to suggest edits but it's more than a few cases. Can you take a look?

foolip avatar Aug 13 '25 10:08 foolip