検証コントロールによる検証方法（検証タイミング）について解説します。
概要
検証方法は、検証コントロールのインスタンスを初期化する際にvalidateWhenプロパティを使用して設定します。このプロパティに設定可能な値は、以下の３つです。
validateWhenの値
説明
LostFocus
コントロールがフォーカスを失ったときに検証します。（既定値）
Manual
Validateメソッドを実行したときに検証します。
Typing
入力中にリアルタイムで検証します。
たとえば、テキストボックス「gcTextBox1」に対する必須入力チェックを、Validateメソッドを実行した時に行う場合のサンプルコードは、以下の通りです。
以下のように、onclickイベントからValidateメソッドを呼び出すことで、ボタンクリック時に検証することができます。
なお、 validateWhenプロパティを省略した場合、既定値である「LostFocus」が検証方法に適用されます。
import '@grapecity/inputman/CSS/gc.inputman-js.css';
import { InputMan } from '@grapecity/inputman';
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
const gcTextBox1 = new InputMan.GcTextBox(document.getElementById('gcTextBox1'));
const gcTextBox2 = new InputMan.GcTextBox(document.getElementById('gcTextBox2'));
const gcTextBox3 = new InputMan.GcTextBox(document.getElementById('gcTextBox3'));
const validator1 = new InputMan.GcValidator({
items: [
{
control: gcTextBox1,
ruleSet: [
{
rule: InputMan.ValidateType.Required
}
],
// フォーカスを失ったときに検証する
validateWhen: InputMan.ValidateWhen.LostFocus
},
{
control: gcTextBox2,
ruleSet: [
{
rule: InputMan.ValidateType.Required
}
],
// 入力中に検証する
validateWhen: InputMan.ValidateWhen.Typing
}
],
defaultNotify: {
tip: true
}
});
const validator2 = new InputMan.GcValidator({
items: [
{
control: gcTextBox3,
ruleSet: [
{
rule: InputMan.ValidateType.Required
}
],
// 手動で検証する
validateWhen: InputMan.ValidateWhen.Manual
}
],
defaultNotify: {
tip: true
}
});
document.getElementById('btn').addEventListener('click', () => {
if (validator2.validate()) {
alert('検証に成功しました。');
} else {
alert('検証に失敗しました。');
}
});
<!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>
System.import('./src/app');
</script>
</head>
<body>
フォーカスを失ったときに検証する<br>
<input id="gcTextBox1"><br><br>
入力中に検証する<br>
<input id="gcTextBox2"><br><br>
手動で検証する<br>
<input id="gcTextBox3"><br>
<button id='btn'>検証</button>
</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: {
'@grapecity/inputman': 'npm:@grapecity/inputman/index.js',
'@grapecity/inputman/CSS': 'npm:@grapecity/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'
},
}
});
