Form Widgets¶
Emakin forms consist of widgets that display and update data from the data model based on user interactions. A wide range of widgets is available to support various data entry, data display, reporting, and layout requirements.
Size & Layout¶
In Emakin forms, most widgets support a Size property, which defines the widget's width or height depending on its type. This allows precise control over the widget's appearance and layout within the form.
The Size property can be set to one of the following predefined values:
- Small: Occupies 1/4 of the available space.
- Medium: Occupies 1/2 of the available space.
- Big: Occupies 3/4 of the available space.
- Large: Occupies the full available space.
Widgets can be combined within the same container using different Size values, enabling flexible and visually appealing layouts. This approach allows developers to create custom form designs tailored to specific interface requirements.
Widget Categories¶
Widgets are categorized into the following sections:
Data Entry¶
Widgets that allow users to input data into the form:
TextBox
Single-line text input.
CheckBox
Simple yes/no input.
CheckList
Multiple selection using checkboxes.
ColorPicker
Color selection widget.
DateTimeBox
Date and time selection tool.
DecisionTable
Spreadsheet-like business rule editor.
DropDown
Single-option selector from a list.
Duration
Time duration picker.
File
File upload/download widget.
HtmlBox
Rich text editor for long texts.
IdentityPicker
User/Position/Department selector.
NumericBox
Numeric input field.
RadioList
Single-option selector using radio buttons.
TagList
Multiple-option selector using tags.
Multiple Data Entry¶
Widgets for entering multiple rows of data:
TableContent
Full-featured table for multiple-row entry.
DataTable
Simple table for data entry and display.
RepeatingContent
Repeating content for dynamic entries.
Spreadsheet
Spreadsheet-like table for multi-row input.
Data Display¶
Widgets that show data from the data model:
Label
Static text display.
ProgressBar
Progress indicator.
QRCode
QR code generator.
Message
Message display box.
Barcode
Barcode generator.
Expression
Displays calculated values and updates the data model.
Layout¶
Widgets for organizing form elements:
RowContent
Row-based layout with multiple columns.
TabbedContent
Tab-based content organizer.
Reporting¶
Widgets that visually display data for reporting purposes:
BarChart
Vertical bar chart for data visualization.
ColumnChart
Vertical column chart for data visualization.
LineChart
Line chart for trend visualization.
PieChart
Pie chart for proportion visualization.
PivotTable
Advanced reporting with data aggregation.
Other¶
Widgets providing additional functionality:
ActivityStream
Displays activity logs for an object.
ApplyTemplate
Renders form templates.
Query
Populates the data model from a database query.
Button
Executes scripts on click.
Html
Displays HTML content.
Widget
Custom widget for advanced use cases.