Question about useWatch

[Dragomir-Ivanov]

Hi guys,
Looking at the documentation I don't quite understand what, following is supposed to be used, and what is its purpose. Any practical examples, or even Docs update appreciated. Thank you!

useWatch({
....
disabled: XXX
})

[Moshyfawn]

It's basically a conditional subscription. The same, as, say this (pseudo-code)

if (isChecked) {
  fieldValue.subscribe()
} else {
  fieldValue.unsubscribe()
}

Just a convenience prop to toggle the field values subscription (an optimization measure)

If you have some ideas on how to improve the docs to allow better understanding of the feature, we're open to suggestions!

[roksui]

What is the fieldValue exactly?

[BrendanC23]

fieldValue here is just psuedocode for whichever field name you pass into useWatch(). If you call

function Component() {
    const firstName = useWatch({
        control,
        name: "firstName",
        disabled: true
    });

    return (<></>);
}

then <Component /> will not subscribe to changes to firstName (until disabled is changed to back to false). If firstName changes, <Component /> will not re-render. If a different component uses useWatch({ name: "firstName", disabled: false }), that component will still re-render.