Bubble Help Version 2.0.0.0Print this Page
Embedded Help Pattern Set
 
Description
Return to Top

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.

The information conveyed in bubble help must aid users in deciding whether they want to select the component. The help should not instruct users about what they must do on a following page.

You can use bubble help with the UI components shown in the following table.
 
Pattern Set Decision Table
Return to Top
 

Static Instruction Text

In-field Help Note

Terminology Definition

Bubble Help

User Assistance Popup

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 radio groups
  • Items in true/false radio 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 buttons
  • 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
to two lines
(of local area width) or 400 characters

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
Return to Top
Consider these design tips when creating bubble help:
  • Bubble help appears as a tooltip when users places their cursors over the component for 400 ms.
  • Bubble help is dismissed when users move their cursors to other locations on the screen.
  • Bubble help cannot be formatted (that is, it can contain no carriage returns, bolding, or bullets).

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
Return to Top
The bubble help in this example acts as a preview for the user who must decide whether to click the icon.
Bubble Help on Butcon
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.
Bubble Help on Action Button
Figure 2. Bubble help on an action button
The bubble help in this example tells users how to take action on a link.
Bubble Help On 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
Return to Top
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
 
About Oracle | Legal Notices | Terms of Use | Your Privacy Rights