File Display Gallery Properties

Owned by Zoe Baldwin
Last updated: Oct 28, 2024
1 min read

Overview

A   File Display Gallery is a component used to facilitate the uploading and displaying of multiple files in PhixFlow. Files are previewed and where this is not possible, a generic placeholder image is displayed. 

Example File Display Gallery

For a worked example of how to create a File Display Gallery, see Adding a File Gallery Display.

 Properties Tab

Parent Details

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

 For components, this property is read-only. The parent is the application, package or parent component to which it belongs.

Basic Settings

FieldDescription
Name
Enter the name of the component.

The names for some components do not support spaces such as form fields and card components.

Aggregate Function
Facilitates the aggregation of the values held in a data backed components. See /wiki/spaces/HELP12/pages/9615616332. For example, sum the value for InvoiceAmount across all records to give a total. 
Allow file download

 Tick to allow users to click on a File Component to download the associated file.

Show the file name

 Tick to display the name of the file associated to the File Component.

Show preview

 Tick to display a preview of the file associated to the File Component. For files where a preview is not possible, such as a CSV, a generic image is displayed which illustrates the file type, e.g. .

 Untick to display an appropriate holding image illustrating the file type for the record.

Backing Attribute

Field
Description
Table AttributeThe name of the underlying attribute.
TableThe name of the Table the attribute originates from. See Table.
Relational AttributeIndicates if the attribute is relational. This field is read-only. See Using Relational Views.

The backing attribute must be on a  Table with a relationship to the folderId attribute on the  File Table.

In this  Table's  Properties it must have Advanced → Audit Manual Changes disabled.

Preferred Parent Categories 

This section includes a list of the Preferred Parent Categories the component can be dragged onto. For example, a button template can have a preferred parent category of button bar, therefore when the button template is dragged onto a screen the button bar will highlight indicating it is a preferred parent for the button template.

This property relates to configuring preferred parents for components; see /wiki/spaces/HELP12/pages/9615609427.

To add a category, open the repository Layout Categories section and drag one into the list.

Advanced Settings

FieldDescription
Type
PhixFlow populates this property with the type of component.
Internal Icon Source
Select an image from the list of uploaded images to be used as the icon for this component. The icon will appear alongside the name of the component in the Layers section, Repository and property editors.
External Icon Source
Enter the path to an icon that is stored in your file system.

Description

FieldDescription
TooltipEnter tooltip text. When using the application, if the user hovers their mouse over this component,  PhixFlow displays this text.
If this text is in the translation table, PhixFlow can display translated text that matches the user's locale; see Translating an Application Interface.
DescriptionEnter a description to explain the purpose of this component.

 Styles Tab

Shared Styles

Shared Styles are reusable styles that can be applied to multiple components. Editing a shared style will impact all components where it is being used, therefore proceed with caution when editing and deleting. See /wiki/spaces/HELP12/pages/9615615745.

Click Show the List of Styles to see the styles available in the repository. You can drag styles from the repository into the grid to add a shared style to this component. 

CSS Properties

A list of CSS properties. Click  Create New to add a new CSS style; see /wiki/spaces/HELP12/pages/9615609976.

Formatting Rules

A list of rules about when to apply formatting. Click  Create New to add a new rule; see /wiki/spaces/HELP12/pages/9615610103.

Style Settings

PhixFlow uses the style settings to construct CSS for the component; see w3schools.com CSS for details of CSS. If the formatting you require is not available in this section, you can also create custom styling, see /wiki/spaces/HELP12/pages/9615609976. PhixFlow applies the style to the component when you save changes to the properties tab.

FieldDescription
File Record Style
Set a style for the gallery to determine how the tiles are displayed.


 Security Tab

Access Permissions

See the Common Properties page, Access Permissions section.

 Audit Tab

Audit Summary

See the Common Properties page, Audit Summary section.