Visibility Setter Builder
In this topic ...
Use the Visibility Setter builder to control what is displayed in an application. By associating a Visibility Setter builder with a profile, we can selectively display page elements based on profile settings. This allows you to use a single model to present different users with different application content.
When you create a Visibility Setter builder, there are several ways we can determine and control the visibility of the control or UI element the Visibility Setter is attached to. We can:
- Hide a control always (if the Visibility Setter builder is enabled)
- Hide a control based on a value
- Hide a control based on the comparison of two values
Use a Visibility Setter builder anytime you want to suppress the display of a UI element created by a model builder.
Quick Tips
- Using a Visibility Setter with check boxes -- To associate a visibility setter with a check box, set the Tag Name for the visibility setter's Page Location to be CheckboxTag_wrapper. Where CheckBoxTag is the tag name on which the Check Box builder call operates. Verify the Check Box appears before the Visibility Setter in the builder call list.
Specifying Inputs
The Visibility Setter builder takes the inputs described in the table below. For help on inputs common to many or all builders such as those in the Properties and HTML Attributes input groups, see "Using the Builder Call Editor."
Input Name Description Name Enter a name for this builder call. The Designer displays this name in the Builder Call List. Page Location Use the Page Location input to specify the page or pages on which this builder call will act. Alternatively, we can type in the page location syntax directly. See "Locating Control Builders on Pages" for detailed documentation about the Page Location input and page location syntax.
Visibility Rule Select one of the listed rules on which to base visibility:
- Always Hide - Suppresses display whenever this builder is activated.
- Hide when Value is "false" or "hide" - Suppresses display when false or hide is entered in Value
- Hide when Value equals Comparison Value - Suppresses display when Value and Comparison Value are equal
- Hide when Value does not equal Comparison Value - Suppresses display when Value and Comparison Value are not equal
Value Enter or choose a value to be used in the comparison. Alternately, we can enter the following to suppress display of the element to which this Visibility Setter is attached:
- hide
- false
Comparison Value Enter or choose a value to be compared to the value specified.