|
|
| Line 1: |
Line 1: |
| <!-- !!! -->
| | The content on this page has moved to https://documentation.open-xchange.com/latest/ui/components/actions-and-links.html |
| <!-- PLEASE APPLY CHANGES ONLY TO THE NEW TECHNICAL DOCUMENTATION: wd/frontend/web/documentation -->
| |
| <!-- !!! -->
| |
|
| |
|
| | | Note: Open-Xchange is in the process of migrating all its technical documentation to a new and improved documentation system (documentation.open-xchange.com). Please note as the migration takes place more information will be available on the new system and less on this system. Thank you for your understanding during this period of transition. |
| {{Stability-experimental}}
| |
| | |
| <div class="status-disclaimer">
| |
| '''Please note:'''
| |
| This page is currently under construction. It might change any minute now.
| |
| </div>
| |
| | |
| <div class="title">Understanding action links</div>
| |
| | |
| Action links can be used to apply an action to an item or even a selection of items. Use them to extend actions for existing items or create a toolbox for your custom items available in your [[Appsuite:Writing a simple application|application]].
| |
| | |
| = The API =
| |
| | |
| == Action ==
| |
| | |
| Creating a new action is pretty straight forward. Just create a new Action and give it a unique name (internally we use slashes to indicate a module hierarchy, so names are inherently unique) and provide a few options.
| |
| | |
| <pre class="language-javascript">
| |
| var action = new Action('unique/name/of/my/action', {
| |
| //some options go in here
| |
| });
| |
| </pre>
| |
| | |
| === Available options ===
| |
| | |
| In the options parameter you can provide the actual logic for the action. You can provide callbacks, requirements and more.
| |
| | |
| * id
| |
| ** a unique identifier (String)
| |
| * requires (optional)
| |
| ** (String) - a String containing one or more special keywords that are required for this action to be active
| |
| *** toplevel
| |
| *** one
| |
| *** some
| |
| *** delete
| |
| *** …
| |
| ** (Function) - a function that returns a Boolean value and gets a Baton object as parameter
| |
| * multiple (optional)
| |
| ** (Function) - a callback function, called when the action is triggered with a list of elements
| |
| * action (optional)
| |
| ** (Function) - a callback function, called when the action is triggered for one element
| |
| | |
| == ActionLink ==
| |
| | |
| == ActionGroup ==
| |
| | |
| == Link ==
| |
| | |
| == XLink ==
| |
| | |
| == Button ==
| |
| | |
| == ButtonGroup ==
| |
| | |
| == ToolbarButtons ==
| |
| | |
| == ToolbarLinks ==
| |
| | |
| == InlineLinks ==
| |
| | |
| == DropdownLinks ==
| |
| | |
| == Dropdown ==
| |
| | |
| = Examples =
| |