Insert excerpt | ||||||||
---|---|---|---|---|---|---|---|---|
|
Understanding Labelled Fields
A labelled field is a composite component, see Using Composite Components, which means it acts as a single component. It is made up of:
an area that contains:When a
static text fielda data field that displays data from the attribute.
Naming
PhixFlow uses the same text for:
- the area name
- the data field name
- the static text Basic Settings → Display Text.
When you start with data, the text is labelled field is created from a table the label value and the names of the static text and data field will be set to the name of the attribute used to create it.
When you start with a labelled field is created directly from the a palette, the text is the name you give the component is used.
Properties
ThePhixFlow binds the labelled field fields to an attribute attributes with the same name, when one is present in the backing stream table or view .
Labelled fields: a composite component comprising a data field and a static text field
Illustration
The following screenshot shows the different components in a labelled field.
- The orange box highlights the containing area.
- The top green box highlights static text field, which has the Display text
Name
. - The bottom green box is a data field, in this case for a string.
The components are grouped together. If you drag one on the dashboard, all three components move.
You can also see the same structure in the repository Layouts list. Right-click on a component and selectused to back a screen.
Properties
The outer area for a labelled field has the properties:
- Basic Settings → Composite Component ticked.
This groups the child components together. If you drag the data field, the text field moves with it: see Grouping Components. - Advanced → View Type: Field container, to link the component with an attribute.
When the area or data field name is the same as an attribute in the backing stream table or view, PhixFlow display the attribute data in the field.
Changing Names and Labels
notePhixFlow binds the data field to an attribute in the backing data that has the same name. To bind the data field to a different attribute, change
- either the data field's name
- or the containing area's name.
If you change the name of
eitherthe
datalabelled field
or the area, PhixFlow automatically:
- updates the name of the other componentcomponents, so the names always match.
- looks in the backing data for an attribute with the same new name.
- displays data from the attribute , if there is one that matches.
The static text
field is called Label
. Edit
its properties to change it'
s name or thes Display Text.
Changing a Labelled Field
, below.Changing a Labelled Field
You may want to add another component to a labelled field. For example, you could add:
- a static text component, to explain what the user can do.
- a dynamic text component, to show information from a selected recordvalidation issues.
However, the The property View Type Field container prevents additional components being added to the container. To add another text field:
- From the palette, drag a static text or dynamic text component onto a form container.
- In the dashboard right-click the existing labelled field and select
.Insert excerpt _repository_find _repository_find nopanel true - If you are struggling to select the outer area use hold Shift when clicking.
PhixFlow opens the repository listing Layouts. In the layouts list, find the container for with the selected item highlighted.
Double-click the labelled field and double-click it to open its properties.
- Untick Composite Component.
In the Advanced section, the View Type is set to Field container. Expand the drop-down list and select the empty row.
the properties. This "opens" the container so you can add more components to it.In the layouts list,Insert excerpt _save _save nopanel true Now you will be able to add new components to the labelled field.
- Use shift-click and drag
Note title Remember - to add new components from the palette into the labelled field.
Go back to the
containerLabelled Field properties to
resettick Composite Component and set Advanced →View Type back to Field container and
.Insert excerpt _finish _finish nopanel true