Appboard/2.5/builder/widgets/actions/show widget

Revision as of 15:52, 26 June 2014 by imported>Jason.nicholls (1 revision)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The "Show Widget" Action works in conjunction with Stacked Widgets. There may be a situation where a specific interaction by the User in one Widget (Widget A) should display one of the specific Widgets inside of the Stacked Widget container (Widget B). In this case, you can configure the Show Widget Action on Widget A to name a specific Widget to be displayed in Widget B.


How To Create a Show Widget Action

For instructions on adding a Show Widget Action, see the general instructions in How To Create an Action in a Widget.


How To Configure a Show Widget Action

Perform the following steps to configure the "Show Widget" action for a Widget:

  1. Follow the instructions above to create the Action in the Widget Actions panel.
  2. Name: Enter a name for this Action. For convenience, a default name is provided. The Name is not used anywhere else in AppBoard, and only displayed on this configuration page.
  3. On selection of:
    1. Select "any" or "specific" for the type of data selection by the User that will trigger the Action. When selecting "specific", perform the following additional steps:
      1. Click the Filter button. The Filter Editor is displayed.
      2. Click Add Rule to create one or more rules that indicate what data should trigger the Action, when selected.
      3. Click Close to save the Filter settings.
    2. Select the Data Source name. When the Widget is run, selection of data in this Data Source will trigger the Action.
  4. Under Show Widget, select the name of the Widget to show when the Action is invoked.
Template-note.png
When configuring the Show Widget action, the drop-down list of widgets will only show widgets that are part of a stack, and only widgets from boards that have been visited by the builder.

Sample Use Case

There is a Stacked Widget that auto-cycles between different charts related to a Table Widget. When the User clicks in the Table Widget, it is required to show the Pie Chart Widget in the Stacked Widget container. In this case, configure a Show Widget Action on the Table Widget that will select the Pie Chart Widget to be shown when the Action is invoked.