ui.Form.ensureElementVisible

Ensure the visibility of a form element.

Syntax

ensureElementVisible(
   name STRING )
  1. name defines the name of the form element, see Identifying elements in ui.Form methods.

Usage

Use the ensureElementVisible() method, to show the given form element (not form field) to the user. This method is typically used to show a folder page containing a static image.

The ensureElementVisible() method must only be used for static form elements. To make form fields temporarly visible without giving the focus to the field, use the ensureFieldVisible() method instead.

The form element is identified by its name. If several form elements have the same name, the first form element found is selected.

Note:

The ensureElementVisible() method can only show the specified element, if the focus handling in the current active dialog allows it. For more details, see the ensureFieldVisible() instead.