@k8ordo/form

トラブルシューティング

よくある症状の原因と直し方です。エラー文で探すときは、ページの中を検索してください。

このページの内容

スキーマにあるフィールドが送信されていません

原因

スキーマにあるフィールドの名前が送信されたFormDataに無いと、parseFormがこのエラーになります。多くの場合、その入力欄にinputを展開していないか、条件によって入力欄を描画していないのが原因です。

直し方

すべての入力欄にinputを展開します。.optional()の付いたオブジェクトの中の入力欄も描画します。何も選んでいないラジオボタンと、プレースホルダーのままの<select>は、値が無いものとして読まれます。チェックしていないチェックボックスはfalseとして読まれます。どれもこのエラーにはなりません。

.optional()でも通らない空欄

原因

空のテキスト欄は""を送ります。.optional()が許すのは値が無い場合だけなので、.min(1)のような検証は""にもそのまま適用されます。

直し方

空欄を許すには、z.union([z.literal(''), z.string().min(3)])のように""を受け付けるスキーマを書きます。この.min(3)はunionの中にあるため、ブラウザでは検証されずdroppedに入ります。

Invalid input

原因

zod/miniはエラーメッセージのロケールを自動では読み込みません。ロケールが無いと、どのエラーもInvalid inputになります。

直し方

サーバーで最初に読み込まれるモジュールで、z.config(z.locales.ja())のようにロケールを読み込みます。または、スキーマの検証ごとに文言を書きます。

復元されないラジオボタンの選択

原因

自分で書いた<input type="radio">に、enumのフィールドのinputをそのまま展開しています。送信のあとはinputのdefaultValueに前回の選択が入ります。これが各ラジオボタンのvalueと衝突し、選択が復元されません。

直し方

inputからはnameとrequiredだけを渡します。defaultCheckedは、state.valuesの値と選択肢を比べて決めます。

2回目の失敗で動かないフォーカス

原因

useFormは、受け取ったstateを中身とtokenで見分けます。自分で組み立てたstateに新しいtokenが無いと、同じ内容の2回目の失敗は前と同じ応答とみなされます。

直し方

parseFormが返したstateをそのまま返します。自分で組み立てるときは、毎回新しいtokenを入れます。

隠れたステップへのフォーカス

原因

hiddenの付いたステップの中の入力欄は、フォーカスを受け取れません。

直し方

新しいstateを受け取ったら、描画の中でエラーのある最初のステップへ切り替えます。手順は複数ステップのフォームを見てください。

k8ordo

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