スキーマの対応
zodのスキーマから導かれる入力欄の種類と属性、空のときに送られる値の一覧です。ブラウザで確かめない検証と、エラーになるスキーマも分かります。
このページの内容
入力欄の種類
スキーマの型ごとに、inputのtypeは次のとおりです。
z.string():type="text"z.email()、z.url():type="email"、type="url"z.iso.date()、z.iso.time():type="date"、type="time"z.iso.datetime({ local: true }):type="datetime-local"z.coerce.number():type="number"z.boolean()、z.literal(true):type="checkbox"z.stringbool():type="checkbox"と、チェックしたときに送るvaluez.file():type="file"input: "password"のメタ情報を付けた文字列:type="password"z.enum([…]):typeなし。<select>に展開しますz.array(z.enum([…])):typeなし。選択肢ごとのチェックボックスにします- それ以外(
z.uuid()やz.coerce.date()など):type="text"
z.email()やz.iso.date()に.regex()などの検証を重ねても、入力欄の種類は変わりません。
制約と属性
スキーマの制約は、次の属性になります。
- 文字列の
.min()、.max():minLength、maxLength .regex():pattern。正規表現が1つだけで、フラグを持たない場合に限ります- 数値の
.min()、.max():min、max .multipleOf():その値のstep。.int()だけならstep="1"、どちらも無ければstep="any"- ファイルの
.mime():accept - 空のときに送られる値がスキーマに合わないとき:
required
空のときに送られる値
parseFormは、空の入力欄を次の値としてスキーマに渡します。
- テキストの入力欄:
"" - チェックの無い
z.boolean()のチェックボックス:false - 数値、
z.coerce.bigint()、ファイル:何も送らない(undefined) - 未選択のラジオと、プレースホルダーのままの
<select>:何も送らない(undefined) - チェックの無い
z.stringbool()のチェックボックス:何も送らない(undefined) - チェックの無いチェックボックスの集まり:
[]
ブラウザで確かめない検証
次の検証はHTMLの属性で表せないので、droppedに載ります。どれもサーバーでは確かめます。
- スキーマ全体に付けた
.refine() - 小数に付けた
.gt()、.lt()(境界を含まない範囲) - フラグやアンカーを持つ正規表現と、1つの文字列に重ねた複数の正規表現
patternを無視する入力欄(type="date"など)に付けた正規表現- ファイルの
.mime()。acceptは選択画面の候補を絞るだけで、ブラウザは種類を確かめません - ファイルの大きさの
.min()、.max() datetime-localの入力欄では満たせないz.iso.datetime()- チェックボックスの集まりの
.min()。minCheckedを宣言するとブラウザでも確かめます .transform()やz.custom()を通したあとの制約。スキーマから読み取れません
警告
落とし穴
1つのフィールドや入れ子のオブジェクト、配列の行に付けた.refine()は、まだdroppedに載りません。ブラウザでは確かめず、サーバーでだけ確かめます。
エラーになるスキーマ
次のスキーマを渡すと、formFieldsとparseFormはエラーになります。エラー文には場所と理由が入ります(例:[@k8ordo/form] 'rows.tags': 繰り返しの中の繰り返しは name の添字が一意に決まらないため表現できません)。
z.number()とz.bigint()とz.date()とz.literal(1):送られる値はすべて文字列なので、どの入力も通りません。z.coerceを使いますz.record、タプル、nullableなオブジェクト:nameが1つに決まりません- 繰り返しの中の繰り返し:
nameの添字が1つに決まりません .や[、]を含むキー:nameの中の区切りと区別できませんz.stringbool().default(true):チェックを外してもfalseを送れません
まだできないこと
- 1つの入力欄で複数のファイルを受け取ること。
z.array(z.file())は、ファイル1つずつの行の繰り返しになります - 配列の行の中の入力欄に、ルールを宣言すること
- 入力のマスク。値は書き換えられますが、カーソル位置は保ちません