What happened to the labelHtml param for widget.aui.form.text?

Question

Some of my plugins use the soy text form and the labelHtml parameter is showing up as undefined in my plugins. The rest of the parameters show up correctly.

I'm developing plugins for stash 3.3.0 and I'm having trouble finding any documentation on what this parameter has been renamed to.

Where should I be looking?

Thanks

Adam · Accepted Answer

It's worth noting that most of Stash's Soy templates are not actually considered API, and are not stable. The scope of the API is listed here https://developer.atlassian.com/stash/docs/latest/reference/soy-api.html#API_Scope (currently includes Stash.template.* and aui.*)  If you want to use the real AUI-provided Soy templates, they live under aui.*, not widget.aui.*.

I would suggest switching to the AUI templates, where possible. There is currently little/no documentation for them, unfortunately, but the source for form templates  is at https://bitbucket.org/atlassian/aui/src/29e1d8dfed69693c0058e95a2430fe062d9698b8/src/soy/form.soy?at=master

aui.form.textField is probably the most interesting template to you right now.

With all that said, the labelHtml param was renamed to labelContent, but that could change at any time. To be honest, we'd ideally like to kill off the widget.aui.* templates as soon as we can, so your best bet is to switch to using a stable API.