Properties

The Properties tab contains properties for a control, view, or form that you can use to change how they look and behave.

When you use fields, methods, or controls on a view or form, they contain properties that you can configure. See Controls for more information on these properties.

When you design a view, you can configure the properties of that view. Click the outline of the view in the designer to open the properties on the right.

Properties
Feature Description How to use it
Name Each view requires a unique name. This property is required and defaults to the name of the view. Type a new name if necessary.
Spinners Shows a spinner on the view while the view loads. This property is on by default. Deselect the option if you do not want a spinner to display as the view is loading.
Delay This is the delay, in milliseconds, before the spinner shows. If the Spinners property is on and the Delay property is 1000, then the spinner shows after a second. This is useful when the view takes less than the delay specified to load, but you want to show that it’s busy if it takes longer than expected. Type a number in milliseconds.
Overlay Opacity

The opacity level that is applied to views and forms when the overlay is shown. This property allows you to darken a view or form while it is loading, and then lighten it once loaded. This provides users with a visual indication that the view or form is loading. You can enter any whole number from 0 (fully transparent while view or form loads) to a maximum of 100 (darkest overlay until view or form has loaded). The actual opacity depends on the theme you use for your form. If this property is empty, a default theme opacity is used.

 Type a number.
Anonymous Access Marks a view and form to be available anonymously. Select the option if you want people to anonymously access the form.

When you work with a view on a form, you can configure the view's properties on the form. Click the view to open the view's properties.

Properties
Feature Description How to use it
Name Each view requires a unique name. This property is required and defaults to the name of the view. Type a new name if necessary.
Tab Index

Defines the sequence to follow when you use the Tab key to navigate through a page.

 Select the tab order.
Visible Shows or hides the view. This property is selected by default.

Select or deselect the option.
Enabled

Enables or disables the view. If you disable the view, people cannot interact with it in runtime. This property is selected by default.

 Select or deselect the option.
Collapsible Allows you to collapse the view. This property is selected by default.

Select or deselect the option.
Default This is the default setting to use when the form opens. Choose if the view must be collapsed or expanded on the form. Select the option.
Width

Adjusts the width of the view. You can enter any whole percentage up to 100%, whole number or pixel value to a maximum of 32767px.

Type the dimension.
Height

Adjusts the height of the view. You can enter any whole number or pixel value to a maximum of 32767px. When this property is set to zero, it automatically changes the size to fit the content of the page.

Type the dimension.

When you work with forms, you can configure the properties of the form. Click the outline of the form in the designer to open the properties on the right.

Properties
Feature Description How to use it
Name Each form requires a unique name. This property is required and defaults to the name of the form. Type a new name if necessary.
Visible Shows or hides the form. The property is selected by default.

Select or deselect the option.
Enabled

Enables or disables the form. If you disable the form, people cannot interact with it in runtime. This property is selected by default.

 Select or deselect the option.
Read-Only Shows the form as read-only. Select the option.
Styles Opens the Style Builder allowing you to specify style features like format, font, borders, padding and margins. See the Style Builder topic for more information on styling options. No
Conditional Styles Opens the Conditional Formatting page. You can design styles that apply only when certain conditions are met. See the Conditional Styles section for more information. Click the ellipsis to open the Conditional Formatting page. No
Title Specify the title to show at the top of the browser tab. Type a title.
Theme Choose a theme for your form. Select a theme.
Form Margin Adjusts the border size of the form. The default is 12px, but you can enter any whole number or pixel value to a maximum of 32767px. Type a value.
Page Color The color of the page. You can type text for the name of the color or the hexidecimal code of your color. Type text or the hexidecimal code.
Padding Padding controls the spacing between the contents of a form and the form's border. The default is 12px. Type the number of pixels.
Form Color The color of the form. You can type text for the name of the color or the hexidecimal code of your color. Type text or the hexidecimal code.
Width

Adjusts the width of the form. You can enter any whole percentage up to 100%, whole number, or pixel value (maximum of 32767px).

Type the dimension.
Min Form Width

The minimum width of the form. Use this to limit the minimum size of your form.

Type the number of pixels.
Max Form Width

The maximum width of the form. Use this to limit the maximum size of your form.

Type the number of pixels.
Spinners Shows a spinner on the form while the form loads. This property is on by default. Deselect the option if a spinner should not be displayed.
Delay

This is the delay, in milliseconds, before the spinner shows. If the Spinners property is on and the Delay property is 1000, then the spinner shows after a second. This is useful when the form takes less than the delay specified to load, but you want to show that it’s busy if it takes longer than expected.

Type a number in milliseconds.
Overlay Opacity

The opacity level that is applied to views and forms when the overlay is shown. This property allows you to darken a view or form while it is loading, and then lighten it once loaded. This provides users with a visual indication that the view or form is loading. You can enter any whole number from 0 (fully transparent while view or form loads) to a maximum of 100 (darkest overlay until view or form has loaded). The actual opacity depends on the theme you use for your form. If this property is empty, a default theme opacity is used.

 Type a number.
Anonymous Access Marks a view and form to be available anonymously. Select the option.
Application Form Marks a form to be available in K2 mobile. Select the option.
Offline Availability Marks a form to be available offline in K2 mobile. Select the option.
  • You cannot use rules to set the Advanced properties of a control, view, or form at runtime.
  • The form's Spinners setting overrides the view's Spinners setting. View spinners only appear if the following conditions are true:
    • The Spinners view property is selected.
    • The Spinners form property is deselected on the form (parent) containing the view (child).
  • The Spinners setting only applies to the initialize method, and displays when the view loads for the first time.
  • If you add a control to a form, the form is the parent and the control is the child. If you select the Spinners property of the control and the form, the control's spinner does not display. If you configure a delay on the form's spinner or the spinner disappears while the control is busy, the control's spinner displays.
  • If a form contains a view that has a control, the form is the parent to the view and the view is the parent to the control. The form's spinner overrides the other spinners. The view's spinner overrides the control's spinner.