Discover how to effectively 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 developing 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

Test values for the inputs are particularly useful during development as they allow you to verify your formula works correctly without needing to set up actual data flows.

Formulas 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, define reusable formulas that can be referenced 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

   Reference it wherever needed

Reusable formulas provide these benefits:

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

In Nordcraft you can create nested formulas where one formula can call another:

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

By breaking down complex operations into smaller, reusable pieces, you can build sophisticated functionality while keeping each formula simple and focused on a single responsibility.

The formula editor supports many JavaScript-like operations, presented through Nordcraft's visual approach. Below are some common formula examples to help you get started.

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

The Filter method creates 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 the array of items, applying the predicate formula to each item and returns the first item where the predicate formula returns true.

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