Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
namescreen
nopaneltrue

This page explains how to add a custom menu bar to your application, to provide navigation and options for the application user.

Overview

You can add navigation or actions to individual screens by adding components. To add menu that appears on every screen you can:

  • Create a custom application menu bar. In the screen toolbar, select App Menu.
    • There can be several application menus.
    • An application menu is configured as a screen. It is set to Open on Startup, so is always present.
    • It can be positioned in different places on the screen.
  • Legacy method: To add an application menu in PhixFlow versions earlier than 9.0.0, set the menu property →  Default menu. In version 9.0.0 the option has moved to the application properties.
    • There is only one default menu.
    • You cannot customise the styling.
    • The position is fixed at the top of the screen.

Create a Custom Menu

Click  Insert excerpt_app_menu_bar_app_menu_barnopaneltrue to create a new screen. In the pop-up menu, select the location for the menu bar.
Image Removed
  • Select a blank menu or a template. Menu's are set to Open on Startup automatically.
  • PhixFlow prompts you to enter the name and description for the menu bar.
  • Specify the the dimensions of the menu bar in percentages or pixel's. For example:
    • vertical dimensions:

      • width: 100%

      • height: 50px

    • horizontal dimensions

      • width: 200px 

      • height: 100%

  • Click Confirm.
  • PhixFlow opens a new screen canvas on the left and the palette on the right.
  • Adding Menu Options

    To add a top-level menu option that will open a screen:

    1. Open the repository to show the list of screens.
    2. Drag a screen-name from the repository onto the menu bar.
    3. PhixFlow prompts you to add the Display Name text you want to appear in the menu. By default, the text is the screen's name.
    4. PhixFlow adds the menu option and automatically creates the actionflow.
      When a user clicks the option, the screen opens automatically.
    Use the Startup Actions properties to configure more complex menus, for example, nested menus or options that run an actionflow.

    Overview

    PhixFlow allows you to create navigation menus that always appear. This allows for a single menu to be set up that can be accessed from any point in your application. It is also possible to set up a menu that only displays when called. Template navigation menus are provided with the Serene Grey Template Package.

    Create a Custom Menu

    1. From the Screens home page, click

      Insert excerpt
      _createMenu
      _createMenu
      nopaneltrue
      .

    2. Complete the details:

      1. Name - indicative of the menu being created

      2. Add to startup action - 

        Insert excerpt
        _toggle_on
        _toggle_on
        nopaneltrue
        if you want the menu to open with the application

      3. All users can View Data - toggle off to only allow selected user groups to view the menu. See Managing User Groups and Privileges.

      4. Position - where you would like the menu to appear. Defaults to Pinned to Top

      5. Height/Width - If using Pinned to Top, the Serene Grey Navigation menu is designed to be 50px

      6. Description, for example, Main navigation menu for application

      7. Template section, click on the desired navigation menu. Hover over each one to see the full description, or right-click and press Display to see a preview.

    3. Click Create Application Menu.

      1. This may take a few minutes to generate the menu.

    Image Added

    Adding Navigation Menu Buttons

    There are two methods to add buttons.

    Method 1: Drag Screen onto Navigation Menu

    1. Open your Navigation Menu and ensure it is

      Insert excerpt
      _unlock
      _unlock
      nopaneltrue
      ed 

    2. From the toolbar, click 
      Insert excerpt
      _screen
      _screen
      nopaneltrue
      s to open the list of available Screens in the Repository
    3. Drag the screen you wish to open onto a clear space on the Navigation Menu, i.e. not on top of an existing button
    4. Provide a name for the button and continue

    5. PhixFlow automatically creates an actionflow that will open this screen

      1. To edit the actionflow, right-click the button and select Display Actionflow; see Understanding Actionflows.

    6. This process is illustrated here:

    Image Added

    Note

    The default settings for a menu button must be set up for this method to work.  

    In your application's

    Insert excerpt
    _property_settings
    _property_settings
    nopaneltrue
    , ensure a style is set for the Menu Button Component in the Default Components section of the
    Insert excerpt
    _property_tabs
    _property_tabs
    namestyle
    nopaneltrue
    . See Application Properties.

    This can also be setup in the System Configuration. See System Configuration.

    Method 2: Create button and link to screen

    1. Open your Navigation Menu and ensure it is

      Insert excerpt
      _unlock
      _unlock
      nopaneltrue
      ed 

    2. Open the Palette and open Buttons - Navigation

    3. Drag Button - Custom onto the Navigation Menu and give it a name

    4. From the toolbar, click 

      Insert excerpt
      _screen
      _screen
      nopaneltrue
      s to open the list of available Screens in the Repository

    5. Drag the required screen and drop it onto the button you just created
    6. PhixFlow automatically creates an actionflow that will open this screen

      1. To edit the actionflow, right-click the button and select Display Actionflow; see Understanding Actionflows.

    7. This process is illustrated here:

    Image Added

    Updating the Navigation Button Icon

    1. Click on the button to open its properties

    2. Click the 

      Insert excerpt
      _property_tabs
      _property_tabs
      namestyle
      nopaneltrue

    3. Scroll down to Image

    4. Tick the box to override the style

    5. Insert excerpt
      _addIcon
      _addIcon
      nopaneltrue
       allows you to add a new image

      1. Follow the prompts to add a new image

    6. Insert excerpt
      _image_list
      _image_list
      nopaneltrue
       allows you to select an existing image

      1. A list of available images appears, drag the desired image into the input box

    7. Insert excerpt
      _save
      _save
      nopaneltrue
       your changes

    Example Setup

    Image Added