Appboard/2.4/builder/widgets/html widget

Revision as of 07:37, 10 April 2014 by imported>Jason.nicholls


The HTML Widget is not a specific widget but provides access to custom HTML widgets made available through the HTML Widget API. AppBoard ships with an example HTML table widget for experimentation out of the box.

HTML Widgets using the API are able to behave as native widgets:

  • Linked to data collections. Any changes to the data collections such as through server side filter actions are reflected in the HTML Widget.
  • Standard Widget Options such as text search, quick filters, and data collection download.
  • HTML Widget is able to trigger standard AppBoard actions. These are defined on the widget just like a native widget.
  • HTML Widgets can also have their own configuration which is stored with AppBoard. This ensures a consistent way to backup/restore configuration and allow for separate configured instances of the same HTML Widget type.

For more information on creating HTML Widgets please refer to the API documentation.


Using HTML Widgets

For instructions on creating an instance of a HTML Widget, see the general instructions in Adding Widgets. The HTML Widget is located under the Web category on the Widget Type selection screen.

Widget Type selection dialog


HTML Widget (Specific) Configuration

Although HTML Widget configuration is stored with AppBoard the actual configuration interface must be provided by the widget itself. This differs from native widgets where the configuration options are provided when editing the widget.

The exampleTableWidget shipped with AppBoard provides an example implementation of widget specific configuration, refer to the image below:

exampleTableWidget - HTML Widget provided with AppBoard, showing the widget configuration