Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
namescreen
nopaneltrue

What is a Palette?

A palette is part of a Template Package, it can also be part of an application, and it contains ready-made template components that you can drag onto a screen canvas to add content. Palette components can be simple, such as data entry forms or maps. Our Palettes have been a data field. They can also be multi-component layouts that provide sections of a screen with a header, data display and action buttons. Layouts can even be a complete screen. Layouts and components can display data, enable application users to enter data, or can display information from external sites, such as a Google map.

Screen Structure

Image AddedYou can create your own layouts and add them to palettes; see Changing or Creating a Palette. However, we recommend you start with the palettes designed by the PhixFlow team. These layouts are designed to create responsive screens , meaning that your application will adapt rearrange to suit the device you are viewing it on.

What do the items in a palette look like?

See About Template Packages for an overview of the styling or to see the examples in an application for:

  • Theme 2.1
    • open the Theme 2.1 app and select one of the options to see an example.

Using a Palette

Palettes are divided into logical groups, such as complete screens or tiles (which make up sections on a screen). 

Adding Screen Content

  1. Content is added by dragging palette items onto a screen and dropping them.
  2. Where appropriate PhixFlow highlights the area onto which it is recommended the selected item be dropped, as shown below. This is known as a Preferred Parent.
  3. Image Removed

Screens are design to contain information in tiles that respond to size of the screen you are working on, we call this responsive design and you can find out more about this topic as well as editing the positioning and size of objects in Sizing and Positioning Screen Content.

size and aspect ratio of the device on which the application is running. 

Excerpt

The palettes available to your application are:

  • the basic palettes provided with every PhixFlow installation
  • for applications created in version 9.0 and later, the palettes provided by the template package selected when you created the application, for example Serene Grey
  • any palettes included in a package that you added to your application; see Package
  • any palettes you created for the application; see Changing or Creating a Palette

To use a palette, drag layouts and components onto the screen canvas; see Adding Screen Content

If you close the palette tab, in the screen canvas toolbar, click 

Insert excerpt
_palette
_palette
nopaneltrue
 to reopen it.

Searching the Palette

From PhixFlow version 10.1 a search option has been added to the top of the palettes area that locates template components that contain the text typed in the search box.


What do Components Look Like?

For an overview of the general style of different palettes, see Understanding Template Packages. To see the example content using the Serene Grey palette, load the Serene Grey example application.

Each item in a palette has a description that can be viewed by hovering the mouse cursor over a specific item. In addition it is possible to view a palette item by:

  1. Right-clicking on a palette item
  2. Selecting Display
  3. The item will be displayed in a popup window

Palettes are divided into sections for different screen components. Many are prebuilt to make it easy to add:

  • complete screens
  • layouts and tiles, in which several components are combined to make sections of a screen 
  • individual components, such as data fields

Tiles are layouts with properties to help them adjust in response to the size and shape of the screen on which the application is running. This means you can easily create an application that works on a mobile device, as well as on a laptop or desktop computer. To find out more about responsive design, see Sizing and Positioning Screen Content.

Understanding the Layer Structure of a Screen

Before we look in more detail at using a a palette, it helps to understand structure that the components of a typical screen , this is illustrated below. are grouped into containers which form layers, as shown in the following image.

  • Click on the image to enlarge it
. More information n this topic can be found in Screen Structure.
Image Removed
You can download and print this image
Image Added
For more information about layers, see Screen Structure.

How do I Rearrange Components?

Click on any item on your screen, and it will be highlighted in the layouts section on the left. To move components within the Layouts, drag it to the desired position.

  1. Move it next to: dragging items onto another item will place it next to it.
  2. Move an item inside another: Hold shift + drag the item onto the item you would like to place it in.

Changing the Layout Direction

Typically, components designed to house other components, such as a Tiles, will use CSS Flex to handle the layout of their content. This means content is set out in rows or columns. Palettes items icons will contain an arrow in their icon to indicate the direction of content. You can change the direction using the layout properties.

To do this:

  • Select the item on the screen.
  • In the properties window that opens, click on the Styles tab.
  • Scroll down to the Direction settings:
    1. Image Removed 
  • Set the desired properties:
  • Direction: row or column layout, defined as the main axis.
  • Wrap: Whether or not the content should wrap
    Anchor
    addContent
    addContent

    Adding Screen Content 

    To add content to a screen:

    1. Drag components from the palette and drop them onto the canvas.
    2. If PhixFlow recognises a suitable container for the component, it highlights the container, as shown below. This is known as a preferred parent container; see Component Categories and Preferred Parents.
      Image Added

    Moving Components

    See Moving Content on a Screen.

    Adding Tiles 
    Anchor
    Tiles
    Tiles

    The Serene Grey palette includes sections for complete screens and for tiles. The complete screens have tile containers, in which the responsive design settings are configured. When you drag a tile from the palette onto the screen canvas, PhixFlow highlights suitable tile containers where you can drop the tile.

    If you create your own screen, to use tiles from the palette, you must first provide a suitable tile container by:

    Adding Components to a Tile 
    Anchor
    EditPalette
    EditPalette

    To add a component into a tile that you have added to your screen, Shift-drag the component from the palette and drop it into the tile.

    Changing a Layout Direction 
    Anchor
    layoutDirection
    layoutDirection

    Tile containers and tiles use the CSS Flex option to specify the layout of contained components as being in either columns or rows. In the palette, the icon for a tile has an arrow to show which direction its contained components will flow.

    To change the flow direction:

    1. Click on a component on the canvas to find it in the layers panel
    2. If necessary, identify the container for the component and its siblings.
    3. Right-click the name of the parent and click 
      Insert excerpt
      _edit
      _edit
      nopaneltrue
      .
    4. PhixFlow opens the component's 
      Insert excerpt
      _property_tabs
      _property_tabs
      nopaneltrue
    5. Click the 
      Insert excerpt
      _property_tabs
      _property_tabs
      namestyle
      nopaneltrue
       and scroll down to the Direction section:
      Image Added 
    6. Set:
      • Direction: either Row or Column. This provides the main axis along which components flow.
      • Wrap: whether or not the content should Wrap around to the next line.
      • Justify:
      the alignment
      • how components align along the main axis. For example, Flex Start
      will align
      • aligns a row to the left. 
      • Align:
      the alignment
      • how components align perpendicular to the main axis. For example, Center
      will align items
      •  
        • for a row: aligns components between the top and bottom of a row
      , or the
        • for a column
      it
        • : aligns
      them
        • components between the left and right
      hand sides. 

    See Component for more details

    How do I Add Tiles?

    Tiles need to sit within the Tile Container, this ensures they layout responsively and looks the way we intended. To add a tile simply drag it onto any complete screen and drop it on the highlighted tile container.

    If you have created a screen from scratch make sure you add a tile container before adding tiles.  

    Adding content within a Tile

    To add a component into a tile use SHIFT+drag and then drop the item in the desired location.

    AnchorEditPaletteEditPalette

    Editing the Palette Items

    WarningEditing the styles
        • of
    any item in the palette will impact all items using this style!

    This includes items already added to a screen both in your application and those used by others in your organisation.

    There are two ways to edit the palette the items,

    1. Editing the Whole Palette: you may wish to change the style of all items in a palette, for example to add a company logo or change the colour scheme to that of your company. To perform these changes:
      1. Select the item in a palette, right click on it and select edit.
      2. To edit an item held within another item, such as editing a header on a complete screen, 
        1. right click on the outer item and select find in repository.
        2. drill down to find the item and double click to open its properties.
        3. Click on the styles tab.
        4. Edit the styles and save your changes.
    2. Editing palette items in isolation: If you want to edit a palette item so that it does not change existing items the best method to do this is create a style to override any existing style.
      1.  Select the item in a palette, right click on it and select edit.
      2. Click on the Styles tab
      3. In the shared styles section, click the add button
      4. Complete the shared style as required
      5. Save all your changes.

    Here is a worked example:

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

    Creating New Items in a Palette

    see Adding to a Palette.

    Creating a New Palette

    see Creating a Palette
        • the column.

    See also: