IBM BPM version 8570 cumulative fix 2017.06Tooltip control

This control displays an information message on other controls.

The Tooltip control is most commonly used to display helpful tips about input controls.

Configuration properties

Set or modify configuration properties for the control, such as appearance and behavior properties, in the Configuration properties tab. Set the formula configuration properties in the Events tab.
Screen size
A configuration property that has the Screen Sizes icon The Screen Sizes icon beside the property name can have different values for each screen size. If you do not set a value, the screen size inherits the value of the next larger screen size as its default value. If you are using the Process Designer desktop editor, you are setting the value for the large screen size. The other screen sizes inherit this value.
Theme definitions
Theme definitions specify the colors and styles for a control and determine the appearance of the control. You can preview the look and feel of controls in the theme editor. See Themes.
The appearance configuration properties for the Tooltip control are shown in the following table:
Table 1. Appearance configuration properties for the Tooltip control
Appearance configuration property Description Data type
Show label The Screen Sizes icon Determines whether or not the label is displayed. Boolean
Label placement The Screen Sizes icon Specifies the label position: Top or Left. String
Width The Screen Sizes icon Specifies the width of the tooltip in pixels or percents. You can specify the width in px (pixels), % (percent), or em units. For example: 50px or 20%. If only a number is specified without any unit, the number is interpreted as the number of pixels. Integer
Color style Specifies a color style for the control. The colors correspond to variables in the specified theme. ColorStyle
Horizontal position Specifies the horizontal positioning of the tooltip: Left, Center, or Right.  
Vertical position Specifies the vertical positioning of the tooltip: Top or Bottom.  

The behavior configuration properties for the Tooltip control are shown in the following table:

Table 2. Behavior configuration properties for the Tooltip control
Behavior configuration property Description Data type
Show tooltip The Screen Sizes icon Determines whether or not the tooltip is displayed when the page loads. Boolean
Show on hover Determines whether or not the tooltip is displayed when the user hovers over the related control. Boolean
Text as HTML Specifies whether or not you want to customize the tooltip text using HTML. If so, you must type in the tooltip text in the Help text box, in the General tab. Boolean

Example

In this example, there is a Text control inside a Tooltip control, and the following configuration properties are set for the Tooltip control:

  • Events tab:
    • The Tooltip formula is set to "My tooltip".
  • Appearance configuration:
    • Show label is not selected.
    • Label placement is set to Left.
    • Width is set to 50%.
    • Color style is set to Default.
    • Horizontal position is set to Left.
    • Vertical position is set to Top.
  • Behavior configuration:
    • Show tooltip is selected.
    • Show on hover is not selected.
    • Text as HTML is selected.

These properties and their values result in a tooltip element which is half the size of the default Tooltip control size, and that says My tooltip on a black background. This tooltip element is displayed above a text area, on the left hand side, and is visible as soon as the page loads.

Note: The Tooltip control is a container control. At runtime, it wraps itself around the nested control.

Events

Set or modify the formula configuration properties and the event handlers for the control in the Events tab. You can set events to be triggered programmatically or when a user interacts with the control. For information on how to define and code events, see User-defined events.
The formula configuration properties for the Tooltip control are shown in the following table:
Table 3. Formula configuration properties for the Tooltip control
Formula configuration property Description Data type
Tooltip formula Formula or expression used to calculate the Tooltip text. String
The Tooltip control has the following types of event handlers:
  • On load: Activated when the page loads.
  • On click: Activated when the tooltip is clicked.

Methods

For detailed information on the available methods for the Tooltip control, see the JavaScript documentation.

Additional resources

For information about how to create a coach, see Building coaches.
For information about standard properties (General, Configuration, Positioning, Visibility, and HTML Attributes), see Coach view properties.

Parent topic: IBM BPM version 8570 cumulative fix 2017.06Controls in the BPM UI toolkit