Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

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

In PhixFlow it is easy to drag a template component from a palette onto a screen. If the template component has a preferred parent configured, PhixFlow can highlight the appropriate areas onto which you can drop the component. 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 container for data fields and text labels
  • a card container for cards
  • a button bar for buttons.

Sections on this page

You can configure any components to have a preferred parent, but it is most useful to do this for components on the palette  The nature and naming of parent types is up to you.  

The following palettes predate version 9.0.0 and the template components are not configured with preferred parents. 

  • Pre-installed palettes
    • Basic Components
    • Labelled Fields
  • Packaged palettes
    • Theme 1 - App Builder Base Components
    • Theme 1 - App Builder Prebuilt Components
    • Theme 2 - App Builder
    • Theme 2 - App Builder Base Components
    • Theme 2 - Buttons

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

See also

How to Configure Preferred Parents

  1. Create layout categories; see Layout Category Properties, below.
    • Either in the repository, expand the Layout Categories section and click  Add New.
    • Or in an area component properties, in Basic Settings → Layout Categories, click  Add New.
  2. Edit an area component. In Basic Settings → Layout Category, select a layout category.
  3. Open the repository and expand Layout Categories.
  4. Drag the repository tab to the left to display it next to the other tabs.
  5. Open a component's properties.
    For example, in the palette, right-click on a component and select Edit. 
  6. From the repository, drag a layout 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 parent
static and dynamic text fieldsheader area, form area
data fieldsform area
buttonsbutton-bar area

Step 4 illustrated:

Layout Category Properties 

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

Property Pane Toolbar

For information about the toolbar options, see the Common Properties page, Toolbars and Controls section.

Parent Details

If this item is within or belongs to another, it's parent name is shown here. See the Common Properties page, Parent Details section for more details.

Basic Settings

FieldDescription
Name

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.

Description

We recommend that you always enter a description to explain the purpose of this item.

 Audit Tab

Audit Summary

See the Common Properties page, Audit Summary section.

  • No labels