Vue & Vuetifyでバリデーション付きのフォームを作ってみる


VueVuetifyを組み合わせて、下図キャプチャのようなバリデーション付きのフォームを作ってみます。Vueの基本事項は知っている前提です。だいぶ回りくどい記事になっています。

バージョン

  • Vue 2.6.10
  • Vuetify 2.1.1

STEP0: ベース

デモ

表示されない場合はこちら→ Vue & Vuetifyでのバリデーション付きフォーム STEP:0

解説

以下のコードをベースにします。

HTML
<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>
javascript
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の中に、必須入力文字数制限の規則を反映させるための関数を用意しました。

javascript
...()...
  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個でも何個でも反映させることができます。

HTML
...(略)...
        <!-- :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という属性を付与することができます。これを使うと、その名の通りテキストボックスにカウンタが表示され、あと何文字入力できるか、ひと目でわかるようになります。

HTML
...(略)...
        <!-- 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

HTML
...(略)...
      <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ということがわかりました。