ui.Form.setFieldHidden

Show or hide a form field.

Syntax

setFieldHidden(
   name STRING,
   hide INTEGER )
  1. name defines the name of the form field.
  2. hide the integer value to show or hide the element.

Usage

Change the visibility of a form field with the setFieldHidden() method. You must pass the identifier of the form field, as defined in the .per form definition. The form field is identified by column name, with an optional prefix (table.column or column). The form field can be a regular field or a column of a list container such as a TABLE.

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 field visible.
1 The field 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.