ui.Form.setElementHidden

Show or hide form elements.

Syntax

setElementHidden(
   name STRING,
   hidden INTEGER )
  1. name defines the name of the node, see Identifying elements in form methods.
  2. hidden the integer value to show or hide the element.

Usage

Change the visibility of a form element with the setElementHidden() method.

Pass the identifier of the form element. The identifier is the element name as defined in the form definition.
Note: All elements with this name will be affected. If you want to distinguish all form elements, use unique names in the form definition file.

The setElementHidden() method changes the hidden attribute of all form elements identified by the name.

The value passed to hide/show the element can be 0, 1 or 2:

Table 1. Hidden attribute integer values
Hidden value Description
0 Makes the element visible.
1 The element is hidden and the user cannot make it visible. Typically used to hide information the user is not allowed to see.
2 The element is hidden and the user can make it visible.
Note: Do not hide all fields of a dialog, otherwise the dialog execution stops. At least one field must get the focus during a dialog execution.