コンテンツへスキップ

hifiveのバリデーションで複雑な条件を設定する

by : 2017/04/06

hifiveの入力値チェック(バリデーション)機能であるFormControllerはHTMLタグに設定するだけで入力値チェック機能を追加できます。必須や数値の桁数チェックなどは簡単に行えますが、ワークフローによってはより複雑なフローが求められることでしょう。

そこで今回はより複雑な入力値チェックを実現する方法について紹介します。

1. 正規表現でチェックする

正規表現を用いることでより複雑なパターンによる入力値チェックが可能になります。これはHTML側で指定できます。例えば電話番号(国内限定)の場合は次のように設定できます。

<input id="tel" name="tel" type="text" class="form-control" data-pattern="^[0-9]{2,3}\-[0-9]{2,4}\-[0-9]{3,4}" />

view raw
gistfile1.txt
hosted with ❤ by GitHub

なお、正規表現でのエラーの場合、エラーメッセージに正規表現が出てしまいます。これは開発者以外には分かりづらいと思われますので、

this._formController.setSetting({
property: {
:
tel: {
displayName: '電話番号',
message: '{displayName}のフォーマットが違います',
},
}
});

view raw
index.html
hosted with ❤ by GitHub

のようにして message をカスタマイズすることをお勧めします。

2. customFuncを用いる

より複雑な処理の場合、customFuncオプションが利用できます。この場合、 FormController.addRule メソッドを利用します。

this.formController.addRule({
birthday: {
customFunc: function(value) {
// 処理を書く
}
}
});

view raw
index.js
hosted with ❤ by GitHub

入力値が問題なかった場合はtrue、問題がある場合はfalseを返すだけです。

非同期処理の場合

入力値を使ってサーバに問い合わせてレスポンスを受け取る場合があります。例えばユーザIDがユニークかどうかチェックする場合です。

そうした時には Promise オブジェクトを返すようにし、検証した結果が問題なければresolve、問題ある場合はrejectを返すようにします。

this.formController.addRule({
userId: {
customFunc: function(value) {
var dfd = h5.async.deferred();
h5.ajax('existUser', {
// 非同期処理
}).done(function(resp) {
// 入力値に問題なかった場合
dfd.resolve({
// 何かデータがあれば指定
});
// 入力値に問題があった場合
dfd.reject({
// 何かデータがあれば指定
});
});
return dfd.promise();
}
}
});

view raw
index.js
hosted with ❤ by GitHub

3. 入力値をグルーピングする

電話番号を-(ダッシュ)ごとに区切ったり、年月日を別な入力欄に分けることはよくあります。そして、それら複数の入力欄を一つに扱って入力値の検証に使うでしょう。その場合は data-h5-input-group-container でグループ名を定義します。この時にも各入力項目に対するバリデーション条件が指定できます。

<div data-h5-input-group-container="birthday">
<input name="year" type="text" data-max="[2015,true]" data-required />
<input name="month" type="text" data-required />
<input name="day" type="text" data-required />
</div>

view raw
index.js
hosted with ❤ by GitHub

このように定義すると入力チェック時に一つのデータとして扱えるようになります。

this.formController.addRule({
birthday: {
customFunc: function(value) {
// 分けて取り出す
var y = value.year;
var m = value.month;
var d = value.day;
}
}
});

view raw
index.html
hosted with ❤ by GitHub


入力値のチェックは常に求められる機能ですが、実際にどうチェックを行うかは業務フローによって異なってくることでしょう。hifiveのバリデーションライブラリは業務システムの設計に合わせて柔軟に実装できます。ぜひ導入してください。

banner_02

From → hifive

コメントは受け付けていません。

%d人のブロガーが「いいね」をつけました。