| Embedded Help Pattern Set |
| Bubble Help | Version 2.0.0.0 |
||
|
|||
| Description | |
Bubble help appears only on user interface (UI) components that users can select to perform certain actions (icon buttons, buttons, links, or tabs). Do not use bubble help for items in menu components, such as Action menus. Use bubble help to clarify the use of unlabeled UI components. In the exceptional case, use bubble help with labeled UI components when the actions associated with these components need further explanation. Do not write bubble help for the Alt text for the common Oracle Fusion icons. Make sure that bubble help text written for other icons can also serve as Alt text for these icons, as the text for both purposes is derived from the same source: the shortDesc property on the relevant Application Developer Framework (ADF) component. |
| Pattern Set Decision Table | |
Bubble Help |
|||||
| Valid UI components that use this type of help | - Page header - Subheader - Sub-subheader |
- Standalone check box - Multiselect check box group - Single-select choice list - Multiselect choice list - Single-select list box - Multiselect list box - Text box - Single-select option groups - Items in true/false option groups - Items in true/false check box groups - Color picker - Date/time picker - Flexfield - LOV - Spin box - Slider - File upload - Shuttle - Rich Text Editor |
- Check box prompt - Check box group prompt - Single-select choice list - Multiselect choice list - Single-select list box - Multiselect list box - Text box - Option group prompt - Color picker - Date/time picker - Flexfield - LOV - Column headers - Spin box - Slider - File upload - Shuttle - Rich Text Editor |
- Icon Button - Button - Link - Tab |
- Page header - Subheader - Sub-subheader - Tab - Dashboard region |
| Does the user need help understanding the effects of entering a value or leaving the component blank? | N |
Y |
N |
N |
N |
| Does the user need a detailed description of what the UI component means or does? | N |
N |
Y |
Y |
N |
| Does the user need help understanding what to do on a page or within a header region? | Y |
N |
N |
N |
Y |
| Does the user require in-depth assistance or need to explore more information? | N |
N |
N |
N |
Y |
| How long is the help text, including spaces? | Less than or equal |
Less than or equal to 160 characters |
Less than or equal to 80 characters |
Less than or equal to 80 characters |
Less than or equal to 400 characters, including optional links to nonembedded help |
| Design Considerations | |
Consider these design tips when creating bubble help:
When deciding when to use bubble help versus Detail on Demand, remember that bubble help explains an object or action, while Detail on Demand elaborates on an object by delivering additional information about that object. |
| Pattern Sample |
| The bubble help in this example acts as a preview for the user who must decide whether to click the icon. |
 |
| Figure 1. Bubble help on the Details icon button |
| The bubble help in this example tells users how to take action by clicking the Share with Appraisee button. |
 |
| Figure 2. Bubble help on an action button |
| The bubble help in this example tells users how to take action on a link. |
 |
| Figure 3. Bubble help on a link |
Required Screen Elements |
||
Component Type |
Required Components |
Customizable or Extendable Components |
Tooltip |
Text embedded in a tooltip that provides help for unlabeled UI components or for labeled UI components that require further explanation |
NA |
| Related Documentation | |
| Help Framework Usage Guideline | Describes ways that help appear in the Rich Client User Experience-based UI |
| Oracle Fusion Help UI Guideline | Guidance on which type of help to use in Oracle Fusion Applications |
