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 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 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.