独自の入力部品
リッチテキストエディタや独自の選択UIのように、<input name>を描画しないコンポーネントの値をHiddenValueで送信に含めます。
このページの内容
値の送信
post-form.tsxコードをコピー
const [body, setBody] = useState(post.body);
<Editor onChange={setBody} value={body} />
<HiddenValue name="body" value={body} />コンポーネントの値はstateに持ち、同じ値をHiddenValueに渡します。nameにはスキーマでのパスを書きます。
HiddenValueは<input type="hidden">を描画します。値はほかの入力欄と一緒に送信されるので、送信時に値を集めるコードは要りません。
情報
メモ
@k8ordo/uiの部品は自分の値を送信に含めるので、HiddenValueは要りません(フォーム)。
値の変化の検知
Reactがvalueを書き換えても、DOMのイベントは発火しません。そのため、<input type="hidden">を直接置くと、複数の入力欄にまたがるルールとisDirtyは更新されません。
HiddenValueは値が変わるたびにinputイベントを発火します。キー入力と同じように、ルールの判定とisDirtyが更新されます。
リセットとブラウザの検証
post-form.tsxコードをコピー
<form
{...form.props}
onReset={() => {
form.props.onReset();
setBody(post.body);
}}
>値は呼び出し側のstateにあるので、フォームをリセットしてもHiddenValueの値は戻りません。stateを戻すまでisDirtyもtrueのままです。onResetでform.props.onReset()を呼んだあとに、stateを既定値に戻してください。
警告
落とし穴
<input type="hidden">は、ブラウザの検証の対象になりません。requiredやminのような制約はブラウザでは確かめられず、送信後にサーバーで確かめます。
Playground
星の評価のデモ
星のボタンは<input>を持たない自前の入力部品で、選んだ値をHiddenValueで送信に含めます。
試してみる
- 星を選ぶと、
HiddenValueがinputイベントを発火し、isDirtyがtrueになります。 - 「送信」を押すと、送られる値が
rating=3のように表示されます。 - 「元に戻す」を押すと、星の選択も
isDirtyも元に戻ります。