Vue & Vuetifyでバリデーション付きのフォームを作ってみる
VueとVuetifyを組み合わせて、下図キャプチャのようなバリデーション付きのフォームを作ってみます。Vueの基本事項は知っている前提です。だいぶ回りくどい記事になっています。
バージョン
- Vue 2.6.10
- Vuetify 2.1.1
STEP0: ベース
デモ
デモ
表示されない場合はこちら→ Vue & Vuetifyでのバリデーション付きフォーム STEP:0
解説
以下のコードをベースにします。
<div id="app">
<v-app>
<v-card>
<v-card-title>STEP:0 フォーム</v-card-title>
<v-card-text>
<v-text-field
v-model="text1"
label="入力必須で文字数制限のあるテキストフィールド"
>
</v-text-field>
<v-text-field
v-model="text2"
label="入力必須のみあるテキストフィールド"
>
</v-text-field>
<v-text-field
v-model="text3"
label="なんの制約もないテキストフィールド"
>
</v-text-field>
</v-card-text>
<v-divider></v-divider>
<v-card-actions>
<v-btn text v-on:click="submit">送信する</v-btn>
<span v-if="success">送信成功!</span>
</v-card-actions>
</v-card>
</v-app>
</div>
new Vue({
el: '#app',
vuetify: new Vuetify(),
data: {
// 各テキストボックスの値
text1: "",
text2: "",
text3: "",
// 送信が成功したかどうかのフラグ
success: false,
},
methods: {
// 送信を試みるメソッド(「送信する」がクリックされたときに呼ばれる)
submit() {
this.success = true;
}
}
});
Vuetifyを使用しているので、だいたいのコントロールはv-
から始まる名前のタグになります。
入力必須や文字数制限のあるテキストボックスや、なんの制約もないテキストボックスも存在します。本来は、「送信する」をクリックすると、すべてのテキストボックスの入力検証をクリアしたときのみ、「送信成功!」と表示されてほしいのですが、今は、どんな状態でも「送信成功!」と表示されてしまします。
STEP1: 各テキストボックスに制約をつける
このSTEPでは、各テキストボックスに入力規則を設けます。これにより、各テキストボックスの値が規則にそぐわない場合は、エラー表示させることができます。
デモ
表示されない場合はこちら→ Vue & Vuetifyでのバリデーション付きフォーム STEP:1
解説
今回使用しているv-text-field
を含め、Vuetifyのすべてのフォームコントロールには、rules
という属性を付与でき、反映させたいバリデーション用関数の配列を渡すことで、1つ以上の制約をつけることができます。
rules
属性を付与する前に、あらかじめvue側で、バリデーション用関数を準備しておきます。
ここでは、data
の中に、必須入力と文字数制限の規則を反映させるための関数を用意しました。
...(略)...
data: {
// 各テキストボックスの値
text1: "",
text2: "",
text3: "",
// 送信が成功したかどうかのフラグ
success: false,
// ↓***** 新規追加
// 入力規則
required: value => !!value || "必ず入力してください", // 入力必須の制約
limit_length: value => value.length <= 10 || "10文字以内で入力してください" // 文字数の制約
// ↑***** 新規追加
},
...(略)...
それぞれの関数はどちらとも、引数として入力された文字列が渡され、制約に合致していればtrue
を返し、合致していなければエラーメッセージの文字列を返す関数です。
ここではアロー関数という書き方で書いています。アロー関数を見慣れない方は、下記記事が参考になります。
【JavaScript】アロー関数式を学ぶついでにthisも復習する話
また、||
を使った書き方が見慣れない方は、下記ページが参考になります。
演算子 || の特殊な使用方法 [Java Script - 基本 - Tips]
基本的に入出力の形があっていれば、どんな関数の書き方でもいけるはず。。。
ここでは、data
の中に書いていますが、methods
の中に書いても構いません。例えば、他のプロパティと比較をして検証したい場合などもあると思いますので、そのときはmethods
の中に書く必要があります。
以上で、用意したバリデーション用関数を、各テキストボックスへ反映させます。最初に説明した、rules
属性を付与することで、必要な規則を1個でも2個でも何個でも反映させることができます。
...(略)...
<!-- :rules属性を追加 -->
<v-text-field
v-model="text1"
label="入力必須で文字数制限のあるテキストフィールド"
:rules="[required, limit_length]"
>
<!-- :rules属性を追加 -->
</v-text-field>
<v-text-field
v-model="text2"
label="入力必須のみあるテキストフィールド"
:rules="[required]"
>
<!-- 特に変更なし -->
</v-text-field>
<v-text-field
v-model="text3"
label="なんの制約もないテキストフィールド"
>
...(略)...
rules
属性の中で、さきほど作った関数を指定しています。(ですので、属性名の手前には、:
コロンまたは、v-bind:
をつける必要があります。詳しくはVueドキュメント参照。)
ご覧の通り、rules
属性が受け付けるのは、配列です。1番目のテキストボックスには、required
と、limit_length
の2つの規則を付与しています。2番目は、required
のみ。3番目は、特に規則がないため、rules
属性も付与していません。
実際に、キーボードで入力してみると、バリデーションが動いていることがわかります。
注意点: 必ずv-model
を使う
必ず、v-model
を使って、フォームの入力値とプロパティをバインドさせないと、STEP2での動作に不具合が生じる場合があることを確認しました。
Tips: 文字数カウンタをつける
このままでも良いのですが、1番目のテキストボックスは、「10文字まで」という制限があるにもかかわらず、ユーザは、入力を始めた時点では、最大入力可能文字数が何文字かがわかりません。さきほど実装したバリデーション用関数が発動してエラーメッセージが出て初めて、最大文字数の制約を知ることになります。これはちょっと不親切です。
これを解決する手段として、v-text-field
には、counter
という属性を付与することができます。これを使うと、その名の通りテキストボックスにカウンタが表示され、あと何文字入力できるか、ひと目でわかるようになります。
...(略)...
<!-- counter属性を追加 -->
<v-text-field
v-model="text1"
label="入力必須で文字数制限のあるテキストフィールド"
:rules="[required, limit_length]"
counter="10"
>
...(略)...
注意点としては、rules
属性を使わずに、counter
属性だけを使ったとしても、入力文字数の制約自体はなく、実質何文字でも入力できる点です。文字数制限をかけたいときは、必ずrules
属性も併せて使ってください。
STEP2: フォーム全体をバリデーションチェック
STEP1が終わった時点で、各テキストボックスには入力規則をつけることができました。しかし、この時点でも、不正値が入力されていたとしても、「送信する」をクリックすると、送信成功となってしまいます。
このSTEPでは、これを解決します。
デモ
表示されない場合はこちら→ Vue & Vuetifyでのバリデーション付きフォーム STEP:2
解説
考え方としては、すべてのテキストボックスのバリデーションが通過しているかを確認し、通過している場合のみ、その先の処理を進める、という流れになります。
まず、現時点では、各テキストボックスが個々でバリデーションチェックをしているだけになりますので、これらをv-form
タグで囲って、1つのフォームであることを認識させます。このv-form
に対しては、後ほどVue側からアクセスしますので、ref
属性を使って名前をつけておきます。(ここではtest_form
)
...(略)...
<v-card-text>
<!-- ↓ 新規追加 -->
<v-form ref="test_form">
<!-- ↑ 新規追加 -->
<v-text-field
v-model="text1"
label="入力必須で文字数制限のあるテキストフィールド"
:rules="[required, limit_length]"
counter="10"
>
</v-text-field>
<v-text-field
v-model="text2"
label="入力必須のみあるテキストフィールド"
:rules="[required]"
>
</v-text-field>
<v-text-field
v-model="text3"
label="なんの制約もないテキストフィールド"
>
</v-text-field>
<!-- ↓ 新規追加 -->
</v-form>
<!-- ↑ 新規追加 -->
</v-card-text>
...(略)...
次に、Vue側では、「送信する」がクリックされたときに、v-form
内のすべてのコントロールのバリデーションが通過しているかを確認する処理を追記します。
...(略)...
methods: {
// 送信を試みるメソッド(「送信する」がクリックされたときに呼ばれる)
submit() {
// ↓***** 新規追加 & 修正
if (this.$refs.test_form.validate()) {
// すべてのバリデーションが通過したときのみ
// if文の中に入る
this.success = true;
} else {
this.success = false;
}
// ↑***** 新規追加 & 修正
}
}
...(略)...
test_form
という名前をつけてあげたv-form
に対して、validate()
関数を呼ぶことで、v-form
で囲まれた全コントロールのバリデーションチェックをしてくれます。そして、もし通過しなかったコントロールがあった場合、false
が返され、同時に、該当コントロールをエラー表示にしてくれます。
すべて通過できた場合のみ、true
が返されますので、そのときは、先の処理(ここでは「送信成功!」と表示させる)を進めさせます。
なお、v-form
には、validate()
関数を含む3つの関数があります。
関数名 | 動作 |
---|---|
validate() |
バリデーションチェックを実施します。すべて通過した場合はtrue を返します。そうで無い場合はfalse を返すと同時に、該当コントロールをエラー表示させます。 |
resetValidation() |
バリデーションチェックをリセットします。使いみちとしては、エラー表示を一旦すべて解除させたときなど。返り値はなし。 |
reset() |
すべての入力内容を初期値に戻します。また、バリデーションチェックもリセットされます。返り値はなし。 |
以上で、目標としていたフォームを作ることができました!
まとめ
基本的に、rules
属性とv-form
を使えばOKということがわかりました。
Author And Source
この問題について(Vue & Vuetifyでバリデーション付きのフォームを作ってみる), 我々は、より多くの情報をここで見つけました https://qiita.com/tekunikaruza_jp/items/0a68d86084d961d632ac著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .