Appboard/2.4/builder/widgets/html widget: Difference between revisions

imported>Jason.nicholls
No edit summary
imported>Jason.nicholls
Line 21: Line 21:




== HTML Widget (Specific) Configuration ==
== HTML Widget 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.
HTML Widgets share common configuration with native widgets for the following areas:
 
# Selection of Widget Type and Data Collection
# ''Options'' Configuration
# ''Actions'' Configuration
 
However, widget specific configuration needs to be implemented and made available by the widget itself. As a result HTML Widgets may not offer any configuration, or if there is configuration it may be made available in different ways.


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


[[File:appboard-2.4-html-example-table-widget.png|frame|exampleTableWidget - HTML Widget provided with AppBoard, showing the widget configuration]]
[[File:appboard-2.4-html-example-table-widget.png|frame|exampleTableWidget - HTML Widget provided with AppBoard, showing the widget configuration]]

Revision as of 07:41, 10 April 2014


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 Configuration

HTML Widgets share common configuration with native widgets for the following areas:

  1. Selection of Widget Type and Data Collection
  2. Options Configuration
  3. Actions Configuration

However, widget specific configuration needs to be implemented and made available by the widget itself. As a result HTML Widgets may not offer any configuration, or if there is configuration it may be made available in different ways.

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