Getting Started with Calculator widget

With our Calculator widget, your website visitors can effortlessly tackle complex math tasks directly on your site - whether it's calculating prices or managing mortgages. Setting up the widget is pretty easy, especially if you're familiar with spreadsheet editors like Excel.

If you're feeling confident about setting up the visual interface and want to skip ahead to writing formulas, check out this article - Working with Formulas in Calculator widget.

Adding Calculator Fields

To allow visitors to input data, you'll need to create a visible interface. To do that, navigate to the Build tab of the widget editor and choose the Fields that best suit your use case:

Our widget offers a choice of 6 field types:

1. Slider - provides an intuitive interface for users to select values within specified limits. Here, you can easily set the minimum and maximum values to customize the range.

2. Number - enables users to input any numerical value of their choice.

3. Dropdown - offers various options for users to select from. Each option should have a visible label for the user and an associated value for calculations.

4. Choice - presents a list of options with visible labels and corresponding hidden values. This field type supports both radio buttons (allowing selection of only one option) and checkboxes (enabling Multiple Selection).

5. Image Choice - offers the same functionality as the Choice field, but allows you to include an image as well. For this field type, you can also use radio buttons and checkboxes.

6. Heading - serves as a decorative element to help you divide your form into sections.

After adding the required fields, it's time to write formulas to process the data collected from users.

Adding Calculations

A Calculation is the key component of the widget where you add formulas to process user-provided data and generate results. To display any outcome within your widget, you'll need to create at least one Calculation.

To get started, navigate to the Build tab and click on Add Calculation:

In the context menu that appears, you can configure your calculation using the following features:

1

Name

Naming your calculation is optional. However, consider adding it if you plan to create multiple calculations or aim to present the result clearly to the user:

2

Formula

Here, you bring together all the data and specify how it should be processed to get the final result.

Before you write your formula, you won't see any results in the widget's designated section. But once you've written the formula, the result will show up and change as the data is updated:

As you can see, the editor offers various building blocks for writing formulas. Some are easy to use, while others may need a bit more understanding.

For guidance on crafting formulas using Fields, Calculations, and Functions, please take a look at this article - Working with Formulas in Calculator widget.

3

Styling options

The final section of the Calculation editor focuses on styling how your calculation’s output appears in Results.

Here are the available settings:

• The Show in Results toggle allows you to hide or show the output:
• The Primary Result / Secondary Result modes visually indicate the relative importance of the result to the user:
• The Format options display your output as a Number, Currency, or Percentage:
• Caption adds any additional information about the calculation that you find necessary:
• Divider adds a horizontal ruler useful for visually separating related sets of calculations:

Nicely done! Now that everything's set up, the widget can handle input and crunch numbers. Next up, let's style the calculator to give it that finishing touch.

Styling the Widget

You can improve the widget's appearance using styling options available in various tabs of the widget editor.

1

The Build tab allows you to add Header (1) and Results Section (2):

• Header includes a Title and a Caption appearing at the top of the widget:
• Results consists of a Section Heading, Call-To-Action elements and a Footer:

2

On the Style tab, you can customize the following details:

• Input style and Font:
• Other elements such as Background, Text Color, Accent Color, Results Background Color:

3

On the Settings tab, you can also adjust the Thousands Separator, Decimal Separator and the Width of the widget:

For more advanced users comfortable with coding, there are Custom CSS and Custom JS fields available for further customization.

Now that you've learned how to make the widget work and look nice, you're all set to create your first Calculator.

Feel like our widget is missing an important feature? Please do not hesitate to add your request to our Wishlist. Your feedback is super important to us 🙌