Versions Compared

Key

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

Overview

A palette provides quick access to set of configured layout templates, which you can dragging onto forms to create layout components. 

PhixFlow comes with two default palettes:

  • Basic Components: contains all basic layout components, such as String Field and CheckBox without any additional labels and styling.
    Image Removed
  • Labeled Fields: contains a set of predefined form fields that have configurable labels. This is the palette to use when designing application forms. 
    Image Removed

You can also install additional Theme palettes. These are designed to have everything you need to create GUI screens by simply dragging the tiles from the palette into a dashboard. See also About ThemesUsing Theme 2 and /wiki/spaces/HELP11/pages/9711229273.

You can also configure PhixFlow to use automatically use your prefered palette, see application properties → Basic Settings → Default Component Palette.

Panel
borderColor#7da054
titleColorwhite
titleBGColor#7da054
borderStylesolid
titleSections on this page

Table of Contents
indent12px
stylenone

Creating a Palettes

To create a palette:

Right-click the repository branch → Application → Palette

Insert excerpt
_Banners
_Banners
namescreen
nopaneltrue

Overview

You can make changes to the palettes, by adding components or removing them. You can also change the appearance of components in a palette, for example to use corporate colours.

You may prefer to leave the palettes supplied by PhixFlow unchanged and instead create your own palette.

Changing Styles

Warning

Changing the style of a component on the palette affects any future use of the component for all applications that have access to the palette. Existing uses of the component are not affected.

Changing shared styles affect all existing uses of the component as well as future uses; see Screen Styling.

For example, if you change a button to have a pink background:

  • using the style, only new buttons are pink
  • using the shared style, in any application all the components that use that colour setting will turn pink.

To change a palette component without affecting any existing uses of it, create a style that overrides the existing style.

  1.  In the palette, right-click on a component and select  
    Insert excerpt
    _edit
    _edit
    nopaneltrue
    .
    If you need to find a child component, such as a header on a complete screen, right-click on the parent and select 
    Insert excerpt
    _repository_
add
  1. find
    _repository_
add
  1. find
    nopaneltrue
.PhixFlow opens a properties tab for the palette. Name the palette and save it
  1. This lists all the child components. Double-click the specific component to open its properties.
  2. In the
Layouts section
  1. component properties, click on the 
    Insert excerpt
    _
layout
  1. property_
list
  1. tabs
    _
layout_list
  1. property_tabs
    namestyle
    nopaneltrue
 button to see all the layout templates in the repository.
  • Drag layouts into the Layout list.
  • Optionally set up Default Components
  • Optionally define Palette Groups.
  • Save your palette.
  • To remove items from a palette right-click on the item in the palette and click 
    1. .
    2. Edit the style properties to have the required settings; see Style properties.
    3. Insert excerpt
      _save
      _save
      nopaneltrue
       your changes.


    To change an aspect of the style of all components in a palette, for example to add a company logo or change the colour scheme to that of your company:

    1.  In the palette, right-click on a component and select  
      Insert excerpt
      _
    delete
    1. edit
      _
    delete
    1. edit
      nopaneltrue
      .
    This removes the layout from the palette, but does not remove it from the repository.

    Default Components

    For any screen that you design, there are common elements, such as forms, true/false fields, or fields for specific types of data, such as long strings or floating point numbers. After you have added these to the Layouts section of the palette properties, use the Default Component section to select which of the layout components you want to use for the base components. PhixFlow displays these in a "Base Component" palette. For these

    Adding a Layout Template to a Palette

    If you have a layout
    1. In the component properties, click on the 
      Insert excerpt
      _property_tabs
      _property_tabs
      namestyle
      nopaneltrue
      .
    2. In the Shared Styles section, click
      Insert excerpt
      _add
      _add
      nopaneltrue
      .
    3. Edit the shared style properties to have the required settings; see Style properties.
    4. Insert excerpt
      _save
      _save
      nopaneltrue
       your changes.

    The following video shows how to do this.

    Iframe
    srchttps://www.youtube.com/embed/X8A_8l4rSMM?rel=0
    width560px
    height315px

    Adding Components

    If you have a component that you want to add to a palette, you must first save a copy

    it

    as a template component; see 

    Layout layout

    template component to a palette:

    1. Open the repository
    tab and palette tab
    1. .
    2. Navigate to the palette and right-click select edit.
    3. Drag
    one of
    1. the
    tabs
    1. Palette tab into the workspace to show the tabs side-by-side.
    2. From the repository branch →
    Layout
    1. Template, drag a template from the repository into a palette or open one of the groups and add it there.
    Palette Groups

    Removing Components

    To remove

    items

    components from a palette, right-click on the item in the palette and click 

    Insert excerpt
    _delete
    _delete
    nopaneltrue
    . This

    removes the layout from the palette, but

    does not remove

    it

    the component from the repository.

    Palette Properties

    Creating a New Palette

    1. In the repository navigate to your Application → Palette section and select 
      Insert excerpt
      _
    standard_settings
    1. new
      _
    standard_settings
    1. new
      nopaneltrue

    For each palette, the following settings are configured.

    Basic Settings

    FieldDescriptionNameName of the palette.Help URL

    For palettes supplied by PhixFlow, this URL links to the help page about the palette.

    If you create your own palette, add a link to additional information to help people to use your palette.

    PhixFlow displays the palette header bar with a 
    1. .
    2. PhixFlow opens a properties tab for the palette. Name the palette and save it.
    3. Click the 
      Insert excerpt
      _
    help
    1. template
      _
    help
    1. template
      nopaneltrue
       icon
    which links to the URL specified here.

    Layouts

    This section has a toolbar with standard buttons and  Insert excerpt_layout_list_layout_listnopaneltrue

    The grid contains a list of layout components that this palette contains. To add a layout to the list:

    Click
    1. to display the available templates. If you have not created any templates yet see Making Template Components.
    2. Drag the templates into the palette properties →  Component section.
    3. Optionally, define Palette Groups and drag templates into the groups.

    This creates a palette to which you can add components. This is only available to your application.

    Sharing a Palette

    If you want to share your palette with other applications, move the palette and template components from your application into a package that the other applications use. You can then set some components to be defaults.

    1. In the repository expand Packages and select 
      Insert excerpt
      _
    layout_list
    1. new
      _
    layout_list
    1. new
      nopaneltrue
     to list all the layout components in the repository.
  • Drag layout components into this list to add them to the palette. 
  • To remove a layout template from the palette, use the
    1. .
    2. Create your package and complete the details.
    3. Optionally, to make this a template package, tick Template; see Understanding Template Packages. Then specify the components you want to use as default components in the Template Details section.

    Setting Default Components

    When you create a new application you select a template package. PhixFlow uses the information in the template package to configure the default components. When creating a screen, if you drag in a table or attribute, PhixFlow uses the default component for forms, true/false fields, or fields for specific types of data, such as long strings or floating point numbers.

    You can see which default components have been set in Application Properties → 

    Insert excerpt
    _property_

    delete

    tabs

    _delete

    _property_tabs
    namestyle
    nopaneltrue

     in the toolbarString Component              

    Add a layout template

  • either select one from the drop-down list. 
  • or drag in a layout template from the repository list, opened from the Layouts section toolbar: 

    .

    Default Components

    FieldDescription

    To change the default palette or components for your application:

    1. In the repository, expand Applications.
    2. Double-click on the application name. 
    3. Click the
      Insert excerpt
      _
    layout
    1. property_
    list
    1. tabs
      _
    layout_list
    1. property_tabs
      namestyle
      nopaneltrue
    Bigstring ComponentLong ComponentFloat ComponentTrue/False ComponentDate ComponentDateTime ComponentAction ComponentForm ComponentCard Component

    Description

    FieldDescriptionTooltipThe description that will appear at the tooltip for this palette.DescriptionDescription of this palette
    1. .
    2. Scroll down to Default Components.
    3. Select the palette or components you want to use.
    4. Save your changes

    Next time you drag a table or attribute onto a screen canvas, PhixFlow uses the default components you have set.