Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
_Banners
_Banners
namescreen
nopaneltrue

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:

Image Added

When a

static text field
  • a 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 fields 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.

    You can also see the same structure in the repository Layouts list. Right-click on a component and select 

    PhixFlow 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.

    Image Removed

    The components are grouped together. If you drag one on the dashboard, all three components move. 

    used to back a screen.

    Properties

    The outer area for a labelled field has the

    Insert excerpt
    _

    repository

    property_

    show

    settings
    _

    repository

    property_

    show

    settings
    nopaneltrue

    Properties

    The area for a labelled field has the properties

    :

    • Basic Settings → Advanced → Composite Component ticked enabled.
      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

    either

    the

    data

    labelled 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

    the static text

    its properties to change

    it's name or the Display Text.To add additional static or dynamic text fields to a labelled field; see Changing a Labelled Field, below. Anchormore-labelmore-label

    Changing a Labelled Field

    its Display Text.

    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 record.

    However, 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_findnopaneltrue.
  • PhixFlow opens the repository listing Layouts. In the layouts list, find the container for the labelled field and double-click it to open its properties.

  • In the Advanced section, the View Type is set to Field container. Expand the drop-down list and select the empty row. 
    • validation issues.


    Info

    Attribute backed fields cannot be moved inside data-bound components (e.g. Cards, Forms) that are backed by a different 

    Insert excerpt
    _

    save

    tables
    _

    save

    tables
    nopaneltrue

     the properties. This "opens" the container so you can add more components to it.

    In the layouts list, shift-click and drag the new text component into the container. PhixFlow moves your component to be a child of the container

    .

    NotetitleRemember

    Go back to the container properties to reset AdvancedView Type back to Field container and  Insert excerpt_finish_finishnopaneltrue

    .