Attachment

What is it?

End users can download file(s) that have been uploaded to the system using the Attachment widget. You can upload one to multiple files and display them all in one widget. 

How and When to use it?

To add a new Attachment to your page, simply drag and drop the “Attachment” widget from the left-hand side of the page screen to the design area. 

To change the name of the attachment, simply click on the attachment widget to reveal the blue quick-setting panel. The Name of the Attachment is by default always shown on the upper left side of the widget.

How to configure it?

1. Drag the Attachment widget into the Form.

2. Click the Attachment and then click the setting button  to open Widget Property Settings. 

3. The Widget Property Settings is shown, which contains two tabs, General and Visibility. We will demonstrate how each tab and property is used. 

Introduction of General Tab Properties

Basic

Name

Users can change the name of the Attachment widget with the Name property.

For example, we create the Attachment, look through the Name property under Basic in the Widget Property Settings. We rename it “Files”.

The design time and the Run Time display are shown below:

Display Name

It changes the label of the Attachment widget in Web View with Display Name property. Compared to the Name property, the Name property is used in the configuration, while the Display Name is what the user will see in the Form in the Run Time of Web View.

For example, we set “Uploaded Files” as the Display Name. 

The Design Time and the Run Time display in Web View are shown below:

Notice that in the Run Time, users will see display names “Uploaded Files”.

In Mobile View, widgets use the value in Name in property settings by default as the display name for widget titles.

App designer can customize the displaying widget titles in design time, which can be different from the widget titles in Web View

To conclude, the Name property is used in the configurations and references in Design Time, while Display Name is what the user will see in Run Time. Display names in Mobile View use the values in Name property by default, and can be updated in the Design Time of Mobile View.

Description

It provides a space for the app designer’s remark purpose. 

For example, we create the Attachment, look through the Description property under Basic in the Widget Property Settings. 

It is an app designer’s internal use only, and does not affect the display in Design Time and Run Time.

Configurations

Choose File

App designers could upload files for users to download in Run Time.

For example, we want to upload a file for users. 

1. Click “Choose File”

2. Select the file you want to upload

3. Click “Open”

The Design Time and the Run Time display are shown below:

Style

The fields of Style are Show Label, Label Style, and Value Style.

By default, Show Label is unchecked, the left side of the widget that shows the widget name is removed and the field of the widget fills the entire widget area.

Label Style and Value Style both have the same Size option. 

Label Style has two more fields: Alignment, and Width, which are in units of pixels (px) and accepts a numerical value. In Alignment, you can choose to inherit the previous alignment or choose your own alignment (left, centre, right).

Positions, Size and Layout

The options for Sizing Mode are Absolute Size and Relative Size. In Position, various parameters of the widget can be adjusted. These parameters change depending on what is selected in Sizing Mode. In Absolute Size, the dimensions of the widget are the same in the Page Builder and Production. 

In Relative Size, the right and bottom sides of the widget expand to completely fill the screen/window in Production. 

The options of “Display in” are “Web & Mobile” (the default setting) and “Mobile Only”. It controls whether this label would be displayed on both platforms.