Hidden field

Last updated 24 days ago

Availability

[SINCE Orbeon Forms 2018.2]

What it does

This control supports all the features of a regular control, including:

  • label

  • validations and alerts

  • formulas

However, it doesn't show in the form at runtime. At design-time, the control shows as a box with an icon so that the form author knows that a hidden control is in use.

This is useful in the following cases:

  • Holding intermediary calculations: If the control has a "Calculated Value" and/or "Initial Value" formula, it can be referred to by variable name (like $my-intermediary-result) from other formulas.

  • handling out-of-band validations: If the control has a label and alert and validations, a failing validation will show in the Error Summary. In addition, this also impacts the Wizard View's lax and strict validation modes, preventing forward navigation until the error is fixed by the user.

NOTE: With Form Builder, you cannot directly edit the label of a hidden field inline. Instead, use "Control Settings".

Basic usage

<fr:hidden ref="validating">
<xf:label>Validation</xf:label>
<xf:alert>Please start the validation before proceeding to the import</xf:alert>
</fr:hidden>