$form-resources and $fr-resources

Just a bit curious, what do these point to? I assume they are setup for the form runner and also that $form-resources is a reference to instance('fr-form-resources') (is that correct?) but what does $fr-resources reference?

thanks,
brian...

Forgot to add

Can I use these in the same way from within an XBL control? I'm taking a common collection of controls in an existing form and creating an XBL control from them but am not sure about what to do with these references (I haven't tried to run my control yet).

thanks
brian...

Hi Brian,

- $form-resources points to the form's resources in the current language (e.g. selected with the language picker).
- $fr-resources points to the Form Runner resources in the current language. Those come from:

https://github.com/orbeon/orbeon-forms/blob/master/form-runner/jvm/src/main/resources/apps/fr/i18n/resources.xml

In general, an XBL control shouldn't rely on the form's resources, as you typically don't want XBL controls to have a dependency on the form where they are used. If you're not worried about your component having a dependency on Form Runner, you can refer to the Form Runner resources using xxf:r() (see doc linked). To access a top-level instance, use something like: xxf:r('components.wizard.edit', '|fr-fr-resources|').

https://doc.orbeon.com/xforms/xpath/extension-core.html#xxfr

Note the pipes in the instance name; they allow you to access to access an instance outside of the XBL component, and thus break encapsulation. For this reason, this use is undocumented, but we use this in build-in XBL components that are not expected to be used outside of Form Runner.

Alex

Thanks Alex,
    Is there a similar convention for resources inside an XBL control for labels and the like?

brian...

Hi Brian,

You can use the `lang` attribute on a LHHA attribute, as done here:

https://github.com/orbeon/orbeon-forms/blob/tag-release-2016.3-ce/src/main/resources/xbl/orbeon/autocomplete/autocomplete.xbl#L83

Or you can have a "local" instance, and use `xxf:r()`, as in:

https://github.com/orbeon/orbeon-forms/blob/tag-release-2016.3-ce/src/main/resources/xbl/orbeon/wpaint/wpaint.xbl#L127

Does one of those techniques work for you?

Alex