Use the Hover Label Editor to customize and add graphs, images, formatted text, names, and values in hover labels.
To launch the Hover Label Editor, right-click on a graph and select Hover Label > Hover Label Editor.
Figure 9.67 Hover Label Editor
On the left, you can choose Textlet, Gridlet, or Graphlet, depending on what you want to do in hover labels:
Textlet
Add formatted text to hover labels using JSL. For an example, see Example of Adding Text. For details about this window, see Add Rich Text to Hover Labels Using Textlets in the Scripting Guide.
Gridlet
Delete, add, rename, reformat, or choose a style for names and values that appear in hover labels. For an example, see Example of Updating Names and Values. For details about this window, see Gridlet Tabs.
Graphlet
Add an interactive graph or image to hover labels. For an example, see Example of Adding a Preset Graph. For details about this window, see Graphlet Tabs.
Markup
Define HTML markup used to create rich text on the hover label.
Presets
Examples of a preconfigured textlet.
– The Showcase textlet is an example of how to add color and style to the textlet content based on the underlying data. Add Rich Text to Hover Labels for an example.
– The Tabulate textlet is an example of how to add summary statistics for the underlying data to the textlet content.
– The Context textlet is an example of how to display the evaluation context variables in the textlet (for debugging purposes). Evaluation context variables define the environment in which your graphlet and textlet scripts are executed. See Work with the Hover Label Execution Context in the Scripting Guide for details.
JSL Variables
(Optional) Enables you to assign the result of expressions to local JSL variables. The variables are used in the HTML Markup field to create dynamic, data-driven rich text.
HTML Markup
Specifies a rich text paragraph template based on a subset of HTML tags. The markup can contain JSL variable references enclosed in delimiters. The default delimiters are braces ({}). Table 9.5 describes the supported HTML tags:
HTML Tag | Description |
---|---|
<b> </b> | bold text |
<i> </i> | italicized text |
<u> </u> | underlined text |
<font> </font> | stylized font with any of the following attributes: • color=color: The quoted foreground color value. Can be a color name or a hexadecimal RGB color value. • face=family: The quoted name of an installed font family. • size=size: The quoted font size. |
<background> </background> | background color value • color=color: The quoted color name or hexadecimal RGB color value. |
Other
Specify the delimiters and width of text on the hover label.
Delimiters
Select the delimiter that indicates variables for replacement in the Markup area. For example, you might use square bracket delimiters for JMP variables if the script contains C++ code or other code that also uses braces.
Width
Specify the preferred width in pixels for the hover label.
Note: After you make changes to the textlet configuration, you can click Apply to see your changes on a pinned hover label. When you are satisfied with the updated hover label, click OK to save your changes.
Gridlet tabs include Delete, Append (add), Rename, Reformat, and Style. In all of these tabs, you specify the Matching Criteria, which identifies the hover label entry that you want to modify.
Matching Criteria
Specify the hover label entry that you want to modify:
Choose the type of entry to select and the target entry.
Note: Not all choices appear in all tabs.
Name
Enter the exact name of the entry that you want to modify. For example, if the entry name is Mean(height), enter this target value: Mean(height).
Figure 9.68 Hover Label Example
Index
Enter the index of the entry in the grid that you want to modify. For example, if the third entry in the hover label is Mean(height), enter 3 as the Target value.
Column
Enter the column name of the entry that you want to modify. For example, if the entry is Mean(height), enter this target value: height.
Regex
Enter a regular expression matched against the name that you want to modify. For example, if the entry is Mean(height), enter this target value: ^.*\(height\)$. (The Pat Regex, parenthesis, and quotations are automatically added.)
All
Changes the style for all hover label entries.
Add
Adds a specified Target value under Entries. Click Apply to apply your changes to the hover label.
Remove
Removes a specified Target value under Entries. Click Apply to apply your changes to the hover label.
Replace
Replaces a selected Target value under Entries. Click an entry, enter a new target value, and click Replace. Click Apply to apply your changes to the hover label.
Delete
Specify entries to delete from hover labels.
Note: If you are using JSL, Delete is the Expunge command.
Append
Specify entries to add to hover labels.
Value
Specify the JSL to add the value to the hover label. For an example, see Update Names and Values.
Click
Add an action to the entry that will appear as a link. Specify the script to be executed when the link is clicked. For example, the script can create a visualization, open a web page, or launch a platform. Here are a few ways that you can copy and paste a script:
Create a visualization to link to: In Graph Builder, create the visualization that you want. Click the Graph Builder red triangle menu and select Save Script > To Clipboard. Paste the script under Click.
Link to a preset graph: In Graph Builder, from the underlying graph that has the preset hover label graphs, right-click > Hover Label > Hover Label Editor. Under Graphlet, in the Picture tab, copy the script. Paste the script under Click.
Click Apply to apply your changes to the hover label.
Note: If you are using JSL, Append is the Annex command.
Rename
Specify entries to rename in hover labels. Enter a new name to replace the current Target value.
Reformat
Specify a different format for entry values in hover labels. For example, you can change the date or duration format, or change the number of decimal points. Click Edit to choose a different format. For details about the Edit options, see Numeric Format Options
Style
Specify a background color, text color, or font details (such as bold, and so on) for entries in hover labels.
Scope
Specify if the style updates should be made to the names of the entries, the values, or both. For example, if you are applying a style change to all the matching criteria, you can easily align all the names to the left, or all the values to the right.
Background color
Specifies the background color for the Target value, name, or both in hover labels.
Text color
Specifies the text color for the Target value, name, or both in hover labels.
Font
Specifies font details, such as font, font style, and size for the Target value, name, or both in hover labels.
Alignment
Specifies how to align the text for the Target value, name, or both in hover labels.
Picture
Add a graph to hover labels. Click a preset graph at left or add a JSL script to define the graph or image. For details about preset graphs, see Add Graphs or Images to Hover Labels.
Click
Add a JSL script that is executed when a user clicks on the thumbnail (or hover graph) that is defined by the Picture script. If nothing is defined here, the Picture script is re-used, so that the image or graph defined under Picture is launched in a new window.
Filters
Remove a filter column from your hover graph. Click a column that you want to remove, or add a “1” under Skip Filters Flag. See Example of Removing a Filter Column from a Graph.
Other
Use JSL to specify the following information:
Title
Sets the title of the new window that is created when a hover graph is launched.
Reapply
Defines whether the current hover label graph customizations are applied to a new window launched when clicking on a hover graph.