Flexible form: Difference between revisions
No edit summary |
|||
| Line 15: | Line 15: | ||
== Configuring layout == | == Configuring layout == | ||
Edit a form and click '''Layout''' to set up its display options. | Edit a form and click '''Form Layout''' to set up its display options. | ||
; Flexible Form | ; Flexible Form | ||
* Project Default – Form is displayed in old or new UI, depending on Flexible Form | * Project Default – Form is displayed in old or new UI, depending on the Flexible Form setting in the project’s Configuration. | ||
* Enable – Enables the New UI Form. | * Enable – Enables the New UI Form. | ||
* Disable – Form with tabs will be used. | * Disable – Form with tabs will be used. | ||
{{Note|Per-form setting has priority over project configuration.}} | {{Note|Per-form setting has priority over project configuration.}} | ||
; Layout (Applicable for tablet devices | ; Layout (Applicable for tablet devices when the form is in full screen) | ||
* Single Panel – Form is displayed in one column; all items are below each other, like on phone devices. | * Single Panel – Form is displayed in one column; all items are below each other, like on phone devices. | ||
* 2 Panel Auto – Right or left panel covers more space (depending on the content – which panel has more items on it). | * 2 Panel Auto – Right or left panel covers more space (depending on the content – which panel has more items on it). | ||
| Line 30: | Line 30: | ||
; Full Screen | ; Full Screen | ||
* Project Default – | * Project Default – The form follows the project settings. | ||
* Enable – Form | * Enable – Form opens in full screen. | ||
* Disable – Form | * Disable – Form opens in one column. | ||
; User Resize | ; User Resize | ||
* Project Default – | * Project Default – The form follows the project settings. | ||
* Enable – User can resize the form (switch | * Enable – User can resize the form (switch between full screen and single-column mode). | ||
* Disable – User cannot resize the form. | * Disable – User cannot resize the form. | ||
Revision as of 08:33, 16 March 2023
Forms are one of the components of mobile apps. Flexible forms offer an alternate rendering of forms. All form tabs are displayed simultaneously; users no longer have to switch between tabs. Flexible forms work particularly well with larger screens, where users get a perfect overview of any record at a glance.
A potential disadvantage of flexible forms is speed. The entire form is loaded every time, resulting in a higher number of database requests (and API calls in online mode) compared to the tabbed view (where tabs are loaded on demand).
Enabling flexible forms
Flexible forms need to be enabled in the project's configuration. If you don't enable them, the classic UI using tabs is used.
- Edit an app project.
- Select Configuration from the Project menu.
- Set Full-screen Forms to True. This option applies to tablets only and determines whether forms open in full-screen mode or one column.
- Set Flexible Forms to True. This option enables flexible forms.
Configuring layout
Edit a form and click Form Layout to set up its display options.
- Flexible Form
- Project Default – Form is displayed in old or new UI, depending on the Flexible Form setting in the project’s Configuration.
- Enable – Enables the New UI Form.
- Disable – Form with tabs will be used.
| Note | Per-form setting has priority over project configuration. |
- Layout (Applicable for tablet devices when the form is in full screen)
- Single Panel – Form is displayed in one column; all items are below each other, like on phone devices.
- 2 Panel Auto – Right or left panel covers more space (depending on the content – which panel has more items on it).
- 2 Panel 33% – Right panel is larger.
- 2 Panel 66% – Left panel is larger.
- Full Screen
- Project Default – The form follows the project settings.
- Enable – Form opens in full screen.
- Disable – Form opens in one column.
- User Resize
- Project Default – The form follows the project settings.
- Enable – User can resize the form (switch between full screen and single-column mode).
- Disable – User cannot resize the form.
Setting up item properties
For additional tweaking, you can configure the properties of each item.
- Side
- Set whether the item should be displayed on the left or right side. By default, the detail item (where you can add entity fields) is set to be on the left side, and the associated or unrelated list is on the right. Users can rearrange it as they wish.
- Header
- Select what to show on the item’s header. Options are:
- Hidden – Item won’t have a header.
- Icon & Label – The icon and the label (name of the item) will be shown.
- Label – Only the item name will be shown.
- Width
- Set the item's width to one (normal) or two (large) columns.
- Height
- If the tab is a list view, it means the number of rows (other rows are accessible with a scrollbar); otherwise, it is the number of "segments" of a pre-defined height. The height can also be defined in pseudo-pixels (e.g., 100px). To learn more about it, please check this webinar. Webinar
Configuring flexible forms in the app
To enable flexible forms in Resco apps, tap Setup and enable Appearance > New Form UI.