検証コントロールによる検証規則(検証ルール)について解説します。
概要
検証規則は、検証コントロールのインスタンスを初期化する際にruleSetプロパティを使用して設定します。検証規則を設定するruleプロパティには、既定の規則と独自の検証規則を設定することが可能です。なお、ruleSetプロパティには検証成功時のメッセージ(successMessageプロパティ)と検証失敗時のメッセージ(failMessageプロパティ)も設定することが可能です。これらのメッセージのデフォルト設定は、以下の通りです。
検証結果
メッセージ
検証成功
入力値が正常です
検証失敗
入力値が正しくありません
検証規則を設定するサンプルコードは、以下の通りです。(既定の検証規則の必須チェックを使用する場合)
import '@mescius/inputman/CSS/gc.inputman-js.css';
import { InputMan } from '@mescius/inputman';
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
const gcNumber1 = new InputMan.GcNumber(document.getElementById('gcNumber1'), {
allowDeleteToNull: true
});
gcNumber1.setValue(null);
const gcNumber2 = new InputMan.GcNumber(document.getElementById('gcNumber2'), {
minValue: 1,
maxValue: 100,
maxMinBehavior: InputMan.MaxMinBehavior.Keep,
});
gcNumber2.setValue(-1);
const gcNumber3 = new InputMan.GcNumber(document.getElementById('gcNumber3'), {
value: 1
});
const gcNumber4 = new InputMan.GcNumber(document.getElementById('gcNumber4'), {
allowDeleteToNull: true,
minValue: 1,
maxValue: 10000,
maxMinBehavior: InputMan.MaxMinBehavior.Keep
});
gcNumber4.setValue(null);
const validator = new InputMan.GcValidator({
items: [
// 入力必須
{
control: gcNumber1,
ruleSet: [
{
rule: InputMan.ValidateType.Required,
failMessage: '数値を入力してください'
}
]
},
// 正数のみ入力可
{
control: gcNumber2,
ruleSet: [
{
rule: InputMan.ValidateType.OutOfRange,
failMessage: '正数を入力してください'
}
]
},
// 偶数のみ入力可
{
control: gcNumber3,
ruleSet: [
{
rule: (control) => {
return control.getValue() % 2 == 0;
},
failMessage: (control, context) => {
return '偶数を入力してください。奇数' + control.getValue() + 'が入力されました。';
}
}
]
},
// すべての検証規則
{
control: gcNumber4,
ruleSet: [
{
rule: InputMan.ValidateType.Required,
failMessage: '数値を入力してください'
},
{
rule: InputMan.ValidateType.OutOfRange,
failMessage: '正数を入力してください'
},
{
rule: (control) => {
return control.getValue() % 2 == 0;
},
failMessage: (control, context) => {
return '偶数を入力してください。奇数' + control.getValue() + 'が入力されました。';
}
}
]
}
],
defaultNotify: {
tip: true
}
});
validator.validate();
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>検証コントロール - 検証規則 - 概要と基本的な使い方</title>
<!-- SystemJS -->
<script src="node_modules/systemjs/dist/system.src.js"></script>
<script src="systemjs.config.js"></script>
<script>
window.onload = function() {
System.import('./src/app');
}
</script>
</head>
<body>
入力必須<br>
<input id="gcNumber1"><br><br>
正数のみ入力可<br>
<input id="gcNumber2"><br><br>
偶数のみ入力可<br>
(カスタム検証規則を使用)<br>
<input id="gcNumber3"><br><br>
すべての検証規則<br>
<input id="gcNumber4">
</body>
</html>
System.config({
transpiler: 'plugin-babel',
babelOptions: {
es2015: true
},
meta: {
'*.css': { loader: 'css' }
},
paths: {
// paths serve as alias
'npm:': 'node_modules/'
},
// map tells the System loader where to look for things
map: {
'@mescius/inputman': 'npm:@mescius/inputman/index.js',
'@mescius/inputman/CSS': 'npm:@mescius/inputman/CSS',
'css': 'npm:systemjs-plugin-css/css.js',
'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel/systemjs-babel-browser.js'
},
// packages tells the System loader how to load when no filename and/or no extension
packages: {
src: {
defaultExtension: 'js'
},
"node_modules": {
defaultExtension: 'js'
},
}
});