@k8ordo/form

独自の入力部品

リッチテキストエディタや独自の選択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で送信に含めます。

評価
isDirtyfalse

試してみる

  1. 星を選ぶと、HiddenValueがinputイベントを発火し、isDirtyがtrueになります。
  2. 「送信」を押すと、送られる値がrating=3のように表示されます。
  3. 「元に戻す」を押すと、星の選択もisDirtyも元に戻ります。
k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。