Documentation of $(internal:b_text_1_2_3) & creation of $(this:text)

[Coupe70]

Is this a feature relevant to companion itself, and not a specific module?

• [x] I believe this to be a feature for companion, and is not specific to a module

Is there an existing issue for this?

• [x] I have searched for similiar existing issues

Describe the feature

I came across the need to read the text of the actual button and also saw people asking about how to do it several times.

There is no $(this:text). I know there a are ways to handle this in single cases by creating a variable and showing this as button text.

But there is also $(internal:b_text_1_2_3) which just seems to be totally undocumented. My wish would be to have this documented (including maybe the other hidden internal button variables I don't even know about).

While $(internal:b_text_1_2_3) is flexible it is absolute (no good for copy,paste,move) and also a bit off from what I would search for. So I would also like to see the implementation of $(this:text) as THIS is what I would look for...

Btw, it seems that the documentation of existing ($this:xxx) is also not 100% complete.

Usecases

No response

[ChadJeffreyAnderson]

While $(internal:b_text_1_2_3) is flexible it is absolute (no good for copy,paste,move)

$(internal:b_ can be made more button-agnostic with $(internal:b_text_$(this:page)_$(this:row)_$(this:column)), or any combination of variables and static numbers. For example, the expression parseVariables('$(internal:b_step_$(this:page)_0_0)') returns the step of the first button on the page.