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

imported>Jason.nicholls
(Created page with '{{DISPLAYTITLE:HTML Widget}} Category:AppBoard 2.4')
 
imported>Jason.nicholls
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:HTML Widget}}
{{DISPLAYTITLE:HTML Widget}}
[[Category:AppBoard 2.4]]
[[Category:AppBoard 2.4]]
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 [[appboard/2.4/builder/widgets/html_widget/api|API documentation]].
== Using HTML Widgets ==
For instructions on creating an instance of a HTML Widget, see the general instructions in [[appboard/2.4/builder/widgets#Adding_Widgets|Adding Widgets]].  The '''HTML Widget''' is located under the '''Web''' category on the Widget Type selection screen.
[[File:appboard-2.4-html-widget-selection.png|frame|Widget Type selection dialog]]
== HTML Widget Configuration ==
HTML Widgets share common configuration with native widgets for the following areas:
# Selection of Widget Type and Data Collection
# ''[[appboard/2.4/builder/widgets/options|Options]]'' Configuration
# ''[[appboard/2.4/builder/widgets/actions|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:
[[File:appboard-2.4-html-example-table-widget.png|frame|exampleTableWidget - HTML Widget provided with AppBoard, showing the widget configuration]]

Latest revision as of 07:42, 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