Currency

A currency field control is a specific type of number field that formats the number as a currency amount. You can specify a currency symbol (the default symbol is $), the number of significant digits, and whether or not to allow negative currency amounts.

We do not currently support allowing multiple currencies within the same currency field. 

Add Currency to the form

Firstly, find the Currency control in the controls add panel. Then, drag and drop it into a section or container on your form.

Basic of the Currency

Open the Content > Basic block and set the Title's text of this Multiple Metadata control. For more information about Title for field control, please refer:

Understand the Title of field controls

Set the Associated variable for this Currency control. When you add a new Currency control, a default variable will be generated automatically. You can click the Edit Button to change the ID and name, or click the Reset button to bind this Currency control to other existing variables. For more information, please refer:

Understand form controls and the associated variables / fields

Appearance of the Currency

Open the Content > Appearance block to set the appearance and layout of this Currency control.

Placeholder: Set the text of the placeholder for this Currency control.

Currency: Select the proper currency type from the dropdown list.

Display as: Choose the character used to identify the currency type which can be Symbol ($, €, ﷼, ৳, ¥) or Code (USD, EUR, CZK, SGD) etc.

Thousands Separator: Choose the character used as the thousands separator. In the United States, this character is a comma (,). In Germany, it is a period (.). Thus one thousand and twenty-five is displayed as 1,025 in the United States and 1.025 in Germany. In Sweden, the thousands separator is a space.

Rounded to: The option of selecting the precision, up to 10 decimal places.

Display Title: Choose display or hide the label of this control. For more information, please refer: Understand the label of field controls

Allow comment: Turn on this option will allow users to add comments on this control.  

Dynamic Display Rules:  When you set a dynamic display rules, It behaves differently based on specific conditions and rules. Learn how to create dynamic display rules for a control.

Validation of the Currency

Open the Content > Validation block to set the properties of this Currency control.

Readonly: Turn this ON will make this field control as view only status. 

Required: Make this field as required. Users cannot leave the content as empty.

Minimum Value: The minimum number that are accepted.

Maximum Value: The maximum number that are accepted.

Step Value: The step of increase or decrease value by clicking the up/down button on the right input box. minimum number that are accepted.

Default Value: Set a default value of this Currency control.

Custom Validation: Set the custom validation rules. An error message that will display under your field when specified conditions become true. It will allow you to add any number of rules for validating your field. Learn more about the Custom Validation.

Action call of the Currency

Open the Content > Action block to call a pre-defined action from the dropdown list. This action will be triggered once the value of this Currency field is changed.

Style the Currency

Field - Editable

Open the Style > Field - Editable block to set the styles of the field control for it's editable status.

1. Typography: Set the typography options for the value in the Currency control.
2. Normal / Focus: Set different styles for normal state and focus state of the Currency control. Styles below are supported to be set separately for Normal and Focus state.
   • Color: Choose the color of the field's value.
   • Background Color: Set background color of the field. By default, the background color is set as transparent.
   • Border Type: Select the type of border, choosing from none, solid, double, dotted, dashed, or grooved.
   • Radius: Set the border radius to control corner roundness.
   • Shadow: Adjust box shadow options
3. Placeholder Color: Choose the color of the placeholder text.
4. Align: Set the alignment of text inside the field control. Can be Left, Center or Right. 
5. Padding: Set the Padding of the field control.
6. Field Width: Set the width of the field control in PX or %.
7. Field Alignment: Set the alignment of the field control. This will only be effected when the field width is less than the outside container.
8. Error Message: Set the styles of the error message, 
   • Typography: Set the typography options for the error message.
   • Color: Choose the color of the error message's text.

Field - Read Only

Open the Style > Field - Read Only block to set the styles of the field control for it's view only status.

1. Typography: Set the typography options for the text in the text box.
2. Color: Choose the color of the field's text.
3. Background Color: Set background color of the field. By default, the background color is set as transparent.
4. Align: Set the alignment of text inside the field control. Can be Left, Center or Right. 
5. Padding: Set the Padding of the field control.
6. Border Type: Select the type of border, choosing from none, solid, double, dotted, dashed, or grooved.
7. Radius: Set the border radius to control corner roundness.

Style of title

Set the Title of field controls that are applicable to this control.

Advanced Settings

Set the Advanced options that are applicable to this control.