Bit Form - Currency field
The Bit Form Currency field is a feature in the Bit Form form builder that allows administrators to add a field for users to input currency values in a form. With this field, users can input monetary values in their desired currency, making it suitable for various types of forms such as payment forms, donation forms, and order forms. Administrators can customize the appearance and behavior of the Currency field, including setting the default currency, formatting options, and validation rules.
⚙ General Settings
1.Field Key
A Field Key is distinct for each field, with b1-5 serving as an illustration. b stands for Bit Form and 1 signifies the form ID , and 5 indicates the 5th field of the form. These keys are utilized in Success/Error Messages, WebHooks, Redirect Pages, Email Templates, Workflows, and Integrations.
2.Name
The name of a field is a unique identifier used in form submissions. It typically consists of, text-1-2 is an example of the field name. the text means field-type, 1 represents form id , and 5 represents the 5th field of the form. This field name can be used for various purposes such as Fetch data from url parameter.
3. Field Label
You can set a proper name of the field that is considered a field label. This label name will appear on the front end of the form you will display. You can hide the field label if you want.
A. Leading and Trailing icon: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the field label. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.
4. Subtitle
The subtitle is an additional piece of text that appears below the label of a field in a form. It offers further clarification or context to help visitors understand the purpose of the field.
A. Leading and Trailing Icons: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the subtitle. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.
5. Admin Label
This field is designated for administrative use and allows an administrator to set a label name that will be displayed on the responses page.
6. Size & Position
It typically refers to the dimensions and placement of an input or output field within a user interface. It specifies the width and position, x-position, and w-width of the field on the screen or page.
7. Placeholder
A Placeholder is a property by which the user can understand the usage of the field. Any text entered on the placeholder will be displayed on the fields. The placeholder text will disappear when the user starts writing on the field.
8. Helper Text
It offers further clarification or context to help visitors understand the purpose of the field. This option allows you to guide your user on what kind of information should be entered, any restrictions on the input, and any formatting requirements.
A. Leading and Trailing Icons: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the helper text. It serves as visual cues to help users understand the context of the text. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.
9. Required
The Required Field option allows you to make a form field mandatory for the user to fill out. You can also specify an error message to be displayed if the field is left blank. With the "Custom Error Message" option, you have the flexibility to customize the error message according to your needs. Additionally, you can add Leading and Trailing Icons to the error message for better visual representation.
A. Leading and Trailing Icons: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the error message. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.
B. Asterisk Position: The asterisk symbol position indicating a required field can be set with this option. You can choose to display it before or after the field label and on the right or left side of the field.
10. ReadOnly
The read-only field option makes it possible to show information to visitors without giving them the ability to modify it. Visitors can only view the information and not edit it. This is helpful in cases where you want to display important information that should remain unchanged. By setting the field as read-only, the information remains unaltered and accurate.
11. Disabled
The disables field option disables user input and interaction, ensuring the accuracy and integrity of form data by preventing the visitor from entering or changing any information in the form.
12. Hidden
This option allows you to make the field hidden when the form is displayed on the front end.
13. Input Amount Range(Min/Max)
This allows administrators to define a minimum and maximum value for the input amount range. Users will only be able to enter currency values within this specified range. If the limit is exceeded, administrators can configure an error message to be displayed as well as customize the message to your specific needs.
Minimum amount: By using this option, administrators can set a minimum amount that can be input by users. If a user enters an amount below the specified minimum, the administrator can configure an error message to be displayed, and customize the message according to their specific requirements.
Maximum amount: By using this option, administrators can set a maximum amount that can be input by users. If a user enters an amount above the specified maximum, the administrator can configure an error message to be displayed, and customize the message as per their specific needs.
14. Input Format Options
Input Formatter refers to the way data is formatted and displayed in an input field. There are two types of input formats available: Browser and Custom.
Browser: This option allows the user to input the amount with the default format of their browser, without the need for manual formatting.
Custom: This option requires the user to enter the amount with a specific format, such as 20.00, and the user must manually include any additional formatting, such as trailing zeros.
Currency Symbol: By disabling this option, the currency symbol will be show
Round to Closest Integer: It automatically rounds the input value of a currency field to the nearest whole number, by enabling this option. For example, if the input is $9.75, it will be rounded to $10.
Round to Closest Fraction Digits: This option rounds off a numerical value to a specific number of decimal places. For instance, the value 3.453 would be rounded to 3.45 when rounded off to two decimal places.
Minimum and Maximum Fraction Digits: This option refers to the range of digits allowed after the decimal point in a numerical value. The minimum fraction digit specifies the minimum number and maximum fraction digit specifies the maximum number of digits that must be displayed after the decimal point. For example, if the minimum fraction digit is set to 2 and the maximum fraction digit is set to 4, a value such as 3.4567 would be rounded to 3.46, as it exceeds the maximum allowed number of digits after the decimal point.
Decimal Separator: need to know
Symbol Position: This option allows admin to the placement of the currency symbol relative to the numerical value in a currency field. If the current position is set to "left", the symbol will appear on the left side of the value (e.g., $20.00), whereas if it is set to "right", the symbol will appear on the right side (e.g., 20.00€).
Symbol Position:
- Left (Symbol precedes the number)
- Right (Symbol follows the number)
- Left with Currency (Symbol precedes the number, with currency code displayed next to it)
- Right with Currency (Symbol follows the number, with currency code displayed next to it)
15. Value Format Options
Value Formatter refers to the way data is formatted and displayed in an input field. There are two types of input formats available: Browser and Custom.
Browser: This option allows the user to input the amount with the default format of their browser, without the need for manual formatting.
Custom: This option requires the user to enter the amount with a specific format, such as 20.00, and the user must manually include any additional formatting, such as trailing zeros.
Currency Symbol: By disabling this option, the currency symbol will be show
Round to Closest Integer: It automatically rounds the input value of a currency field to the nearest whole number, by enabling this option. For example, if the input is $9.75, it will be rounded to $10.
Round to Closest Fraction Digits: This option rounds off a numerical value to a specific number of decimal places. For instance, the value 3.453 would be rounded to 3.45 when rounded off to two decimal places.
Minimum and Maximum Fraction Digits: This option refers to the range of digits allowed after the decimal point in a numerical value. The minimum fraction digit specifies the minimum number and maximum fraction digit specifies the maximum number of digits that must be displayed after the decimal point. For example, if the minimum fraction digit is set to 2 and the maximum fraction digit is set to 4, a value such as 3.4567 would be rounded to 3.46, as it exceeds the maximum allowed number of digits after the decimal point.
Decimal Separator: need to know
Symbol Position: This option allows admin to the placement of the currency symbol relative to the numerical value in a currency field. If the current position is set to "left", the symbol will appear on the left side of the value (e.g., $20.00), whereas if it is set to "right", the symbol will appear on the right side (e.g., 20.00€).
Symbol Position:
- Left (Symbol precedes the number)
- Right (Symbol follows the number)
- Left with Currency (Symbol precedes the number, with currency code displayed next to it)
- Right with Currency (Symbol follows the number, with currency code displayed next to it)
16. Search Placeholder
By this option, admin can add/edit a search placeholder text for the field. The placeholder text will disappear, and the search results will be displayed.
17. Currency Not Found Text
This option allows the admin to customize the text that is displayed when the user searches for a currency that is not found. By default, the text displayed is "No Currency Found", but you can modify it to your liking.
18. Show Selected Flag Image
Enabling this option will display the flag image of the selected country on the left side of the field.
19. Selected Currency Clearable
This option allows users to clear the selected currency from the field. By enabling this option, a small "X" button will appear on the right side of the field, allowing the user to easily remove the selected option. If disabled, the user will not be able to clear the selected country from the field.
20. Search Clearable
This option allows the user to clear the search. There is a small "X" icon within the search box, allowing users to easily clear their search with a single click and start a new one.
21. Option Flag Image
Enabling this option will display the flag image of each country next to its name in the dropdown options. If you disable this option, only the name of each country will be displayed without any flag image.
22. Options List Height
This option allows the administrator to set the maximum height of the dropdown list. By setting a maximum height, the dropdown list will only display a certain number of options at once, and the user will be able to scroll through the remaining options if needed.Administrators can set the height of the options list in pixels (px)
23. Edit Options
This option allows administrators to customize the label and list of countries by adding them as per their requirements. They can also set the default Currency, disable or hide specific countries in the list, and make other modifications as per their preferences. Also, admin can reorder the options by Dragging and Drop