List Properties

The Attributes section includes the object name.

Name	Enter a name for the object. This is the name of the object as it will show in field chooser, the Navigation panel and other object lists.

We strongly recommend that each input object is given a suitable and unique name that reflects the data that will be held within it. The object name will, very likely, be referred to when adding behavior and workflow logic as well as when designing reports.

The Behavior section lists possible events on the object that can prompt a behavior to run.

List changes field data

This event occurs when an app user changes data in the object.

List gains focus

This event occurs when the object becomes the active field.

List loses focus

This event occurs when the list object is exited.

List is clicked

This event occurs when an app user clicks on the object.

This event is different than 'List gains focus' in that the app user must mouse-click on the object in order for the event to occur and any linked behavior commands to run.

List is shown

This event occurs when the object is shown. This would normally be when the page opens.

The settings section includes the caption and value, mandatory answer, positioning, tabbing and tool-tip.

List Settings
Object	Details	Additional Information
Caption	Click in the Caption column and enter the drop-down option item. Repeat in each row for all the drop-down options needed. Each option in the drop-down list presented to the user will have a caption. The caption is the user-friendly representation of the data value equivalent for that selection.
Value	Enter a text or numeric value to be returned when the option is selected and submitted. Click in the Value column and enter the data value to be associated with that drop-down option. The value can match the caption text if desired. Repeat in each row for all the drop-down options needed.
	Click this Add Item button to add a row to the options list.
	Click this Remove Item button to remove a row from the options list.
	Click these Move Item Up and Move Item Down buttons to move options up and down in the options list.
	Click the Add Predefined List button to supply a predefined list that will automatically populate the drop-down. Examples of predefined lists include States, Countries, Canadian Provinces or any list of resources that have been set up on the account.	Adding a List as an Account Resource The options presented in a list object can be dynamic and based on a background look-up to another app or database. See Setting Up a Background Lookup Using a Connect Command.
Allow multiple selection	Select this check box to allow multiple selections within your list object. App users will be able to select more than one option at once by pressing CTRL + Shift and choosing the desired options from the list.
Autofill	The autofill feature permits compliance with WCAG 2.1	The default value of 'On' will allow the field to auto-populate with frequently used data recorded in the app users browser.
Mandatory
Mandatory Answer	Select the Mandatory Answer check box to make the contents of the object required in order to submit the app instance. You may enter a custom message in the text input below the check box. This message will be displayed if some part of the object has not been completed prior to app submission. Click the ellipses button to display the Edit Mandatory dialog. Use this matrix to make the object mandatory based on conditions of roles and stages.	Marking as Mandatory Checking for Mandatory Fields
Position
Top	Displays the object's location in from the top of the app (in pixels).
Left	Displays the object's location in from the left margin of the app (in pixels).
Width	Shows the width of the object.
Height	Shows the height of the object.	The minimum height is determined by the font size and cannot be less than 10px.
Layer	Indicates the layer number this object occupies. You can drag an object so that it fully or partially covers another object. Depending on the layer number it occupies, it may be positioned underneath another other object.
Tabbing
Tab Index	Indicates the order in the tabbing sequence that this object will be arrived at when the app user is using their Tab key to navigate through the app fields.	Tab Index
Tab Stop	Clear this check box to exclude the object from the tab order altogether.
Tooltip	Enter tooltip text to show to an app user when they hover their mouse over the object.

The Style section contains properties that control the font appearance and theme applied to the object.

Text
Object	Details	Additional Information
	Select the font face for the caption text.	Fonts from the designers local machine will also be available provided the option to Use Custom Font has been selected in the Account Settings, however if the same font is not installed on the users machine then a standard font will be used to display the data.
	Choose the size and style of the font for the caption text.	Manually enter font sizes smaller than the minimum selectable in the drop-down.
Color	Enter a Hex color code or click on the color box to pick a default color for the caption text.
	Choose the style of the font for the caption text.
Border
	Select the border appearance type. Choose from None or Solid.
Size	Choose a line weight for the border (in pixels).
	Enter a Hex color code or click on the color box to pick a color for the border.
Radius	Select a numeric value to represent the curvature of the list object corners. The higher the number, the more curved the the edges of the object will be.
Background
	Enter a Hex color code or click on the color box to pick a background color for the object.
Use App Theme
	Resets the appearance options to the default settings configured on the app's Theme properties.	Applying or Resetting a Theme

The Access section contains properties for field state management.

State
Object	Details	Additional Information
	Choose from Default, Normal, Read-Only, Disabled or Hidden for List objects. With field state management, you control access to individual objects on the app. You can prevent individual roles from changing, or even viewing, specific data or areas on the app. See Limiting User Access to App Fields for more information on how to control access to fields.	Adding Workflow The Workflow Diagram Loading the Object States Overview Explanation of State Priority Understanding the Default State
	Click the ellipses button to display the Edit State dialog. Use this option to hide, show or disable objects depending on the user's role and/or the workflow stage.

PerfectApps ® Help Guide