Skip to content

formio/ai / plugin/skills/formio-form

formio-form

Verified

Embed and render Form.io forms in any web app with the `@formio/js` renderer — by URL or JSON, pre-filled, controlled from JavaScript — and own field behavior: conditionals, calculated values, JSON Logic validation, cascading selects. The default "embed a form" entry point. Use when the user asks to "embed a form", "render a form", "add this form to my page", "pre-fill a form", "show or hide a field based on another field", "calculate a field value", "add custom validation to a field", or add conditional wizard pages — field behavior in ANY framework's form stays here. Not for: Angular (see `formio-angular`) or React-named (see `formio-react`) embedding; building an app (see `formio-application`) or its data model (see `formio-resource-planner`); REST endpoints (see `formio-api`); the raw SDK (see `formio-sdk`); creating a new form (see `formio-form-builder`); agent-filled forms or chats (see `formio-uag`).

references/calculated-values.md

View on GitHub
# Calculated Values

## Overview

A component's `calculateValue` property derives the component's value from other fields. With a JSON Logic expression the result of the expression becomes the value, recomputed on every data change. Expression syntax and operations live in [json-logic.md](./json-logic.md).

## Canonical example

`total` = `quantity` × `price`:

```json
{
  "display": "form",
  "components": [
    { "type": "number", "key": "quantity", "label": "Quantity", "input": true },
    { "type": "number", "key": "price", "label": "Price", "input": true },
    {
      "type": "number",
      "key": "total",
      "label": "Total",
      "input": true,
      "calculateValue": {
        "*": [{ "var": "data.quantity" }, { "var": "data.price" }]
      }
    }
  ]
}
```

Change `quantity` or `price` and `total` recomputes immediately — `form.submission.data.total` always reflects the current product.

Inside `calculateValue`, `data` is the submission data and `row` is the contextual row, so a Data Grid line total is `{ "*": [{ "var": "row.quantity" }, { "var": "row.price" }] }`.

## allowCalculateOverride

By default the calculation wins — user edits to a calculated field are overwritten on the next recompute. Set `allowCalculateOverride: true` to let a manual edit stick (the calculation stops applying once the user changes the value):

```json
{
  "type": "number",
  "key": "total",
  "calculateValue": { "*": [{ "var": "data.quantity" }, { "var": "data.price" }] },
  "allowCalculateOverride": true
}
```

Pair with `calculateServer: true` when the value must also be recomputed server-side on submission (prevents tampering with client-calculated values).

## See also

- [json-logic.md](./json-logic.md) — operations and `var` resolution.
- [validation.md](./validation.md) — validating calculated results.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall