|
| 1 | +# Oracle APEX Dynamic Action Plugin - APEX Tooltip |
| 2 | +A powerful, flexible APEX plugin enabling you to easily create semantic, modern tooltips. Using the open source JQuery plugin tooltipster. |
| 3 | + |
| 4 | +## Changelog |
| 5 | +### 1.0 - Initial Release |
| 6 | + |
| 7 | +## Install |
| 8 | +- Import plugin file "dynamic_action_plugin_de_danielh_apextooltip.sql" from source directory into your application |
| 9 | +- (Optional) Deploy the JS and CSS files from "server" directory on your webserver and change the "File Prefix" to webservers folder. |
| 10 | + |
| 11 | +## Plugin Settings |
| 12 | +The plugin settings are highly customizable and you can change: |
| 13 | +- **Theme** - APEX Tooltip theme (5 different themes to choose from) |
| 14 | +- **Content Text** - Content text of the tooltip |
| 15 | +- **Content with HTML** - If the content of the tooltip is provided as a string, it is displayed as plain text by default. If this content should actually be interpreted as HTML, set this option to true |
| 16 | +- **Animation** - Determines how the tooltip will animate in and out (Fade, Grow, Swing, Slide, Fall) |
| 17 | +- **Position** - Set the position of the tooltip (Top, Bottom, Left, Right, Top-Left, Top-Right, Bottom-Left, Bottom-Right) |
| 18 | +- **Trigger** - Set how tooltips should be activated and closed. Default 'hover' |
| 19 | +- **Delay** - Delay how long it takes (in milliseconds) for the tooltip to start animating in. Default 200ms. |
| 20 | +- **min Width** - Set a minimum width (in pixels) for the tooltip. Default: 0 (auto width) |
| 21 | +- **max Width** - Set a maximum width (in pixels) for the tooltip. Default: null (no max width) |
| 22 | +- **Logging** - Whether to log events in the console |
| 23 | + |
| 24 | +## How to use |
| 25 | +- Create a new Dynamic Action with event "onload" (other events also possible) |
| 26 | +- As action choose "APEX Tooltip". |
| 27 | +- Choose best fitting plugin attributes (help included) |
| 28 | +- Choose Affected Elements which tooltips are binded to (Items, Buttons, Regions or JQuery Selectors) |
| 29 | + |
| 30 | +## Plugin Events |
| 31 | +- **APEX Tooltip - on Show** - DA event to do things when a tooltip opens |
| 32 | +- **APEX Tooltip - on Hide** - DA event to do things when a tooltip closes |
| 33 | + |
| 34 | +## Demo Application |
| 35 | +[https://apex.oracle.com/pls/apex/f?p=APEXPLUGIN](https://apex.oracle.com/pls/apex/f?p=APEXPLUGIN) |
| 36 | + |
| 37 | +## Preview |
| 38 | +##  |
| 39 | +- [tooltipster](https://github.com/iamceege/tooltipster) |
0 commit comments