The Miscellaneous tab contains all other other widgets you can use in the User Interaction Editor. Most commonly used are the Data widgets such as Datagrid and Repeater. The Rocketship Custom Widget contains all other available widgets that are not visible in the Toolbar.
Adding a Tabbar allows you to organize your user interaction screen and divide it into different screens (tabs). A user can click on a tab, after which the corresponding information will be displayed. Tabs are in fact a specific graphical representation of a Concept field. Therefore, tabs require a Concept field (single select) to work with. Clicking on a tab will select that Concept value. When you want to show the specific information corresponding to that tab, a conditional widget is required that contain an expression which relates to the tab concept. Therefore, for each tab that is used, a conditional with the desired content in it (When condition is true) should be created. More information about conditionals can be found below.
This is one of the google maps widgets WEM supports. This widget shows a map centered on a certain coordinate with one or more marked locations.
With nested templates you can (re)use template fragments within existing user interaction templates. Template fragments allow you to (re)use other (parts of) user interaction templates. There are 3 major advantages to using template fragments / nested templates:
- 1.you can design a part of a user interaction screen once and reuse that within other user interaction templates;
- 2.your current user interaction screen will look very clear, because all the details are within the nested templates;
- 3.user interaction screens become easier and more manageable when you use template fragments. You only have to modify the template fragment and the change will be implemented to all the user interaction screens that uses that template fragment
To add a nested template you first have to make a template fragment. These can be created in the "Template, widgets, files and hyperlinks" tab on the project resource pane. Here you select the template fragments folder with a right mouse click to get the new template option. In this folder all your template fragments are saved. If you create a few, do not forget to use folders.
Note: when you use the script widget, it is possible to overwrite (intended or unintended) the Master template settings.
Drag and drop the script widget to the template and the box below appears.
Here you can enter or paste your HTML script.
The reference is used to reference a row in your database.
A conditional is a control that you can use on your canvas to show information based on a condition that you specify in an expression.
For example, you could show a personalized welcome message when someone is logged in, but not when they are anonymous.
Conditionals can show one of 3 options depending on the result of the expression. These can be individually activated within the tool control of the conditional component.
- Show when true – when the condition that you enter returns true, then show this part.
- Show when false – when the condition that you enter returns false, then show this part.
- Show when unknown – when the condition does not evaluate properly - perhaps because a field doesn’t contain data or for some other reason - then you show this part.
A Datagrid is a component that you can add to the User Interaction Screen to display data from the database in a list. A Datagrid is always linked to a List in your Data Model. It can either be a Database List or a Transient List. When you want to use a datagrid throuh dragging the widget onto the canvas, an overlay will be shown which asks for the list that is the source for the datagrid. After selecting the appropriate list, a new overlay will allow you to pick the columns you want to display in your Datagrid.
Once you have created your Datagrid you will be able to add fields to it. The Datagrid displays a table which includes a row for each of your records in the list you select.
When you create a Datagrid there are a number of properties that you can use to customize the appreance and behavior. A key property is On Row Click, with which you can select what happens when a user selects one of the rows in your Datagrid. You can use this, for example, to open an overlay to edit the current row. By clicking on the row, WEM will automatically select the row in your list that you have selected.
A Repeater is always linked to a List in your Data Model. It can be either a Database List or a Transient List. As discussed before, a Datagrid is row oriented. You can add columns to the row, but the Datagrid will always present the data row by row. A repeater works differently. It allows you to present the data horizontally, vertically or in a grid.
The grid is especially useful when presenting a portfolio or a web shop. The repeater displays a number of entities on a row, and proceeds to the next row to display the other entities. One disadvantage of the repeater is that there is no on row click option. This is because the repeater gives the modeler a lot more flexibility. For example, if you add a button in a repeater WEM will automatically know which record the button refers to.
With the Rich text widget you can add rich text to elements on your user interaction screen, for example in the title of a block panel.
This is a library of custom widgets created by WEM and by partners of WEM. This library grows continuously and has a lot of different widgets. When you drag the rocket to your template you get prompted to select the widget you want to add. The first time you do this there are probably not many widgets listed, and you need add a library first. Select the "Add more widgets here." link and select a library you want to add to your account. Take a look around here. There are a lot of different widgets and every one is for a different use-case. There is also a place dedicated to managing Widget Libraries. Some widgets specific explanation can be found in the Widgetsfolder.