...
...
Section | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Custom Tab Area
The Custom tab is like a favorite's favorites area for the current designer. Adding control templates to or removing them from the Custom tab is not the same as adding or removing control templates. This removes the templates from the currently logged in designer's favorites. There could be 100's of control templates published by designers in a given tenant, but only 10 of them have been added by the designer to his/her Custom tab favorites.
...
There are two types of control templates that you can create in – in frevvo – modifiable templates and read-only templates. In some cases may you want to publish a control template and allow them to be completely modified when used in other forms. These modifiable control templates are basically a starting point to a slightly or entirely different control at the discretion of the designer using it. Note that by changing the name of a control, you may break rules published with the control. In other cases, you may want to publish read-only control templates. A designer using a read-only control will not be able to remove nested controls nor change any properties that affect the underlying data binding (e.g., the name property). The designer can still change other UI-related properties such as styles and labels, and rearrange any nested controls on read-only templates.
...
There are two ways you can publish a control in frevvo:
- Clicking the Publish Control Template link, in the control properties pane, or
- Dragging and dropping the control onto the Custom tab header
There is a small difference between these two ways of publishing controls, though. When clicking the Publish Control Template link, you are only publishing the control as a template, but when you drag & drop you are also adding the published control to the Custom tab, in one shot.
...
Note |
---|
The image, video, table, upload and pagebreak controls are not allowed in a custom control. You will see this message if you try to publish a section that contains any of these controls: "Sorry - the custom control contains a control that is not allowed in the custom palette." |
Publishing Controls with Rules
...
- the control is a Panel or a Section (support for simple controls will be added in the future)
- the rule only references the control being published or any of it's its nested controls
When the above conditions are met, the Publish Control Template dialog will list the candidate rules (see next screenshot) allowing you to select the ones you want to publish with the control. Note that as soon as at least one rule is selected the read-only checkbox will also be selected: you can only publish controls with rules in read-only mode. Since it is not possible to edit rules after the control is published, this restriction exists to make sure that no changes that could break the rules will be allowed when using the template.
...
Custom groups with rules included when dropped back onto the same or another form , will contain a special "Prefix" property. The prefix property will automatically be given a unique value if you drop the group onto the same form 2 or more times. This ensures that the group controls have unique element names. You can view the impact the prefix has on the element names by viewing the form's schema or the control's property panel.
The Section control of custom read-only controls are is named with a prefix value. The prefix is automatically assigned whenever the custom control is dragged more than once onto the form. In this way, you can write a separate rule to manipulate the controls within the 2nd and greater instances of the custom control. The first custom control dragged into the from form will not have an assigned prefix.
For example, let's say you have a Section control named Flavors which contains a text control named a. There is a rule attached to populate a with the text "sweet" when the form loads. You publish the control as read-only and carry the rule along with it. Then you create a new form and drag Flavors into your new form three times. The Section control name of the of the first instance will not contain the prefix. However, the second and third instances will include the prefix. Now you can write a rule that will populate the control named 'a' in the second and third instances using the assigned prefix.
...
You can edit the Prefix property but will frevvo will not allow you to make it non-unique.
...
If you want to remove control templates (instead of removing from the Custom pane) from frevvo, you need to make sure you are logged in as the tenant admin. See Manage Control Templates for the details.