Widgets are built-in controls to be placed on a Page in a Dragonce App. There are 3 types of widgets offered, Layout, Input and Display. Users can put widgets of their choice on to the pages they create, in order to customize the pages in a way that best interacts with end users.
The widgets panel is on the left hand side of the Page Builder. You can click the arrow on the top right corner to enlarge or smallen the panel.
To add any widget onto the page, drag and drop its icon to the blank design area.
To quickly relocate the widget, mouse over the top left corner of the widget.
The cross arrow will transform into your mouse pointer and appear on the screen.
Click and drag the widget to your desired location.
To quickly resize the widget, mouse over the right bottom corner of the widget.
Click on the triangle and drag to resize the widget.
To open the quick control panel, click on a widget in the design area.
Here are some descriptions of the quick setting panel controls:
Widget Property Settings can be opened by this button or by double clicking a widget. Permission refers to workflow stakeholders permission and user role permission.
These 2 buttons are available for all widgets. For particular widgets, they have more buttons on this row for configurations, such as Data Source, Form Validation etc.
The Delete button removes the widget.
Be aware that widget name and value are different. Name helps distinguish different widgets being referred to. Value (Configured in widget settings) is the display value in the input field of the widget.
You cannot use these keyboard symbols ~ ! @ # $ ^ & * in the widget name.
You can decide whether the size of the widget is fixed (Absolute Size) or automatically adjusted based on the window size (Relative Size).
This states the coordination, width and height of the widget on the form.
This information is for internal purposes. It is never shown to end users.
‘Layout’ type widgets help arrange widgets in proper order and group them up clearly.
Container allows users to group widgets together clearly.
Formatted Container allows users to group widgets together clearly. Its difference with containers is that widgets being put in a formatted container will be arranged one after another without free relocation. Users can reorder the elements by dragging and dropping the body of the widget.
Form allows users to input, edit value and perform action to individual form records. It is the only widget that can connect to a workflow.
Container
Yes
Yes
Formatted Container
Yes
Yes
Form
No
Yes
Sub Form
Yes
No
Tabs
Yes
Yes
Input Box
Yes
Yes
Auto Complete
Yes
Yes
Selection Box
Yes
Yes
Dropdown Menu
Yes
Yes
Date & Time
Yes
Yes
User & Group
Yes
Yes
File Uploader
Yes
No
Image Uploader
Yes
No
Label
Yes
Yes
Chart
Yes
Yes
Calendar
Yes
Yes
Table (Sub Form)
No
Yes
Reference Table
Yes
No
Table
Yes
Yes
Batch Action
Yes
Yes
Report Viewer
Yes
Yes
Attachment
Yes
Yes
Sub Form is a widget within a form that allows users to create and edit sub-entry for individual form records. Different from a form, it looks like a table during Run Time.
Yes
Yes
No
No
Yes
Yes
Yes
Yes
Yes
Yes
Yes
No
No
Yes
No
No
No
No
No
No
Yes
No
Tab container is formed by dragging container(s)/formatted container(s) into it which allows end users to switch between them easily. They are used to categorize widgets, inputs and information clearly.
Tabs can be renamed by pressing "Tab Container
" on the quick settings menu.
Yes
Yes
No
No
No
‘Input’-type widgets provide fields for end users to input values or upload files, which can be stored in the system.
A field for inputting values in Run Time, supporting String, Integer, Decimal, and Percent types.
A field that provides recommended values based on previous inputs.
A field for selecting options in Run Time, available as Radio Box or Check Box.
A field that allows the end user to select a value from a list of options in Run Time.
A field for choosing date and/or time in Run Time, with Date Picker, Time Picker, or Datetime Picker.
A field that allows the end user to select user(s) and/or group(s) in Run Time.
A field that allows end users to upload files in Run Time.
A field that allows the end user to upload an image file in Run Time.
‘Display’-type widgets serve to display information, data or files.
Label is used to display text and cannot be edited by the end user.
Chart is used to generate a graph that shows data obtained from a form.
Calendar is used to display data from a form in an event calendar view.
PDF Report is a connector to a designed dynamic PDF report. End users can download the required report by entering the criteria on the page and then click on the Report Viewer to download it.
Attachment is file(s) uploaded to the system available for end users to download.
‘Table’-type widgets are used to display data in a tabular format, allowing for various interactions and displays of form data.
Displays data from a sub form in rows and columns.
Displays data from a child form connected by a unique key to the parent form.
Displays data from a form in rows and columns.
Allows performing actions on a batch of form records of a specific workflow state.