ui.Form.ensureElementVisible

Ensure the visibility of a form element.

Syntax

ensureElementVisible(
   name STRING )
  1. name defines the name of the form element.

Usage

Use the ensureElementVisible() method to make sure that the given form element (not form field) is visible to the user. This method can for example be used to show a folder page by passing a field that is located in the folder page, even if the field is not used in a dialog.

This method must be used for static form elements, to make form fields visible, use the ensureFieldVisible() method instead.

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

Note that the ensureElementVisible() method can only show the specified element if it's possible, according to the focus handling in the current active dialog. For more details, see the ensureFieldVisible() instead.