fix(Forms): provide connectWithPath in the change validator and onBlurValidator

[tujoworker]

This feature allows a validator for a field to connect to another data path. Changes to the data path value will be reflected in a rerender of the validator. But only if the validator is actually in use. This can be controlled with field properties, such as validateUnchanged etc.

Good to know: Why do validators not rerender on every data change? Because field A should not emit the validator of field B. It can be used for various cases, such as backend requests.

But with the new feature called connectWithPath you as a dev get the possibility to control this in a fine granted way.

Quick examples:

import { Form, Field } from '@dnb/eufemia/extensions/forms'

const validator = (value, { connectWithPath }) => {
  const { getValue } = connectWithPath('/myReference')
  const amount = getValue()
  if (amount >= value) {
    return new Error(`The amount should be greater than ${amount}`)
  }
}

render(
  <Form.Handler>
    <Field.Number path="/myReference" defaultValue={2} />

    <Field.Number
      path="/withValidator"
      defaultValue={2}
      validator={validator} // NB: You may use "onBlurValidator" depending on use case.

      //
    />
  </Form.Handler>,
)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
eufemia	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 6, 2024 7:07am

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

[langz]

I added a few minor commits, hopefully improving the docs a bit.
Looks good🍦

[tujoworker]

🎉 This PR is included in version 10.47.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀