Working with formulas

Learn how to work with formulas to manipulate data and streamline logic in Nordcraft.

Create a formula

Live

To create a new formula in Nordcraft:

1. 1

   Navigate to the data panel with no element selected
2. 2

   Click the + button in the Formulas section
3. 3

   Enter a name for your formula
4. 4

   (Optional) Add inputs with test values to use while building the formula
5. 5

   (Optional) Expose the formula in context to make it available to child components
6. 6

   (Optional) Delete the formula when it is no longer needed
7. 7

   Define the formula logic using the formula editor

In the formula editor, you can access various data sources within your component:

• Inputs: Formula-specific inputs
• Attributes: Values passed into the component
• Variables: Variables defined in the component
• API data: Results from API calls
• Context values: Data exposed by parent components
• Component formulas: Formulas defined in the component
• Global formulas: Formulas defined at the global project level

To keep your formulas efficient and maintainable, you can define reusable formulas to use throughout your project. If you find yourself repeating the same formula logic in multiple places, follow these steps:

1. 1

   Create a component-level formula in the data panel
2. 2

   Give it a descriptive name
3. 3

   Define its logic once
4. 4

   Use it wherever needed

Reusable formulas provide these benefits:

• Reduce duplication in your project
• Improve maintainability (changes in one place affect all usages)
• Enhance performance through result caching (due to their pure function nature)

You can create nested formulas where one formula can call another:

• Build small, single-responsibility formulas that perform specific tasks
• Combine these smaller formulas to create more complex logic
• This modular approach makes your formula logic more readable and easier to maintain

The formula editor supports many JavaScript-like operations. Below are some common formula examples to help you get started.

The Map method returns a new array by applying a function to each element in the original array.

The Filter method returns a new array with elements that pass a specific condition.

The Sort by method arranges array elements in a specific order.

The Reduce method applies a function to reduce an array to a single value.

The Find formula searches through an array of items, applying a callback formula to each item, and returning the first item where the callback formula returns true.

The Get formula extracts a value from an object, array or string at a specified path, returning null if no value is found.