Versions Compared

Key

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

This page is for application designers who are editing or creating palettes with custom components. It explains how to use layout categories on template components to set preferred parent highlighting.

Overview

The PhixFlow palette contains sets of template layouts and components. It is easy to drag a layout or component from a palette onto a screen.

If a component or layout on the palette has a preferred parent configured, PhixFlow will highlight the appropriate areas onto which you can drop it. This can be useful where you have a screen with different areas designed to display different things, such as:

  • a header for static and dynamic text
  • a form-area for data fields and text labels
  • a card-area for cards
  • a button bar for buttons
  • a tile container for tiles.
    Some palettes include layouts called tile containers and tiles. These layouts are configured to with styles and properties that ensure a screen is responsive to changes in screen size or form-factor.

Live Search
spaceKey@self
additionalnone
placeholderSearch all help pages
typepage

Panel
borderColor#00374F
titleColorwhite
titleBGColor#00374F
borderStylesolid
titleSections on this page

Table of Contents
maxLevel3
indent12px
stylenone

Configure a preferred parent for a layout or component that is either already on the palette, or that you intend to add to the palette. The nature and naming of parent types is up to you.  

Insert excerpt
_Banners
_Banners
namescreen
nopaneltrue

Overview

Component Categories are used to highlight on a screen where an item is expected to be placed.

For example, a Tile Container has the Component Category "Tile Holder". If a user then drags a tile with "Tile Holder" specified as its Preferred Parent onto a screen that has a Tile Container it will highlight with a pink surround.

Image Added 

The PhixFlow palettes contain templates with component categories and preferred parent specified to help make creating screens easier. For example,:

  • Header areas highlight when header items are dragged over a screen.
  • Button bars highlight when buttons are dragged over a screen.


Note

The following palettes predate version 9.0.0 and the

template components are not configured with preferred parentsCreate layout categories; see Layout Category Properties, below.Either in the repository, expand the Layout Categories section and click 

preferred parent feature is not supported for them. We recommend using the Serene Grey Template Package, see Installing Template Packages

Insert excerpt
_theme_list2
_theme_list2
nopaneltrue

This means when you drag components from them, PhixFlow is unable to highlight potential parent areas.

To install the latest version of Theme 2, which has been updated to add preferred parents, see Installing Template Packages.

See also

How to Configure Preferred Parents

How to Configure Preferred Parents

Define a Component Category and apply it to an object, then any objects we want to be place in this object have this Component Category set as their Preferred Parent. A Component Category is just a label that is used to create an association. Objects can have multiple Preferred Parents and can also have their own Component Category.

Image Added

Setup

  1. For the item you want to be the Parent,
    1. Open its properties.
    2. In Basic SettingsComponent Category
    3. If you have a Component Category already defined, click
      Insert excerpt
      _
add
    1. componentCategory
      _
add
    1. componentCategory
      nopaneltrue
.Or in an area component properties, in Basic Settings → Layout Categories
    1.  and from the window that opens drag the component category into the box.
    2. If you have not defined a Component Category yet, click 
      Insert excerpt
      _add
      _add
      nopaneltrue
.
  • Edit an area component. In Basic SettingsLayout Category, select a layout category.
  • Open the repository and expand Layout Categories.
  • Drag the repository tab to the left to display it next to the other tabs.
  • Open a component's properties.
    For example, in the palette, right-click on a component and select Edit
      1.  to create one.
    1. For all the template items that you want to be placed in this Component Category repeat the following:
      1. Open the template section in the repository where your desired items is held.
        1. It is advised to add this feature to a template, however if you have not yet made your component a template, simply open its properties from where it resides.
      2. Double click on item to open its Properties.
      3. In the Preferred Parent Categories section click
        Insert excerpt
        _componentCategory
        _componentCategory
        nopaneltrue
        .
      4. From the repository, drag
    a layout category
      1. the required Component Category onto the Preferred Parent Categories list
    .

    The following table shows some examples of the layout categories you could create, and the components that would be appropriate for them.

    Template componentLayout category/preferred parentstatic and dynamic text fieldsheader-area, form-areadata fieldsform-areabuttonsbutton bar Anchorpropertiesproperties

    Step 4 illustrated:

    Image Removed

    Notes
      1. and save your changes. This is illustrated below:
      2. Image Added


    Note

    When you are dragging a component from the palette, you can drop it onto any suitable container - it does not have to be a preferred parent.

    However, if you drop a component onto a container that is not a preferred parent, PhixFlow will look at any other containers in order to put it in there?

    Layout Category Properties 

    Use layout categories to configure highlighting of an area that is a preferred parent, when you drag components from the palette onto a screen.

    Insert excerpt_property_toolbar_property_toolbarnopaneltrue Insert excerpt_parent_parentnopaneltrue

    Basic Settings

    FieldDescriptionName

    Enter the name for the layout category, which PhixFlow will add to the Layout Categories section of the repository.

    Drag layout categories from the repository into the Preferred Parent Categories section of components.

    Insert excerpt_description_descriptionnopaneltrue Insert excerpt_audit_auditnopaneltrue

    Simply hold the shift key to force the item into the desired location. See Moving Components on a Screen for more help on this subject.