マスクコントロールには、未入力のときに代替文字を表示する機能を搭載しています。
未入力時に表示する代替テキスト
次のメソッドを使用すれば、コントロールが未入力のときに代わりに表示するテキスト(ウォーターマーク)を設定することができます。
コントロールにフォーカスがあるときのテキストを設定するには、setWatermarkDisplayNullTextメソッドを使用します。コントロールにフォーカスがないときのテキストを設定するには、setWatermarkNullTextメソッドを使用します。
プロンプト文字
フィールドに何も入力されていないときに表示するプロンプト文字は、setPromptCharメソッドを使用して設定します。プロンプト文字はsetFormatPatternメソッドに定義された入力マスクの位置にプレースホルダとして表示され、ユーザに入力を促します。なお、setPromptCharメソッドには、半角または全角の文字を設定できますが、文字列は設定できません。
代替テキストを設定している場合、コントロールに文字が入力されていないときには代替テキストの設定が優先されます。
import '@grapecity/inputman/CSS/gc.inputman-js.css';
import { InputMan } from '@grapecity/inputman';
import './styles.css';
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
const gcMask = new InputMan.GcMask(document.getElementById('gcMask'), {
formatPattern: '\\D{2,4}-\\D{2,4}-\\D{4}',
// フォーカスがないときの代替テキスト
watermarkDisplayNullText: '電話番号',
// フォーカスがあるときの代替テキスト
watermarkNullText: '市外局番から入力ください'
});
document.getElementById('setWatermarkDisplayNullText').addEventListener('change', (e) => {
gcMask.setWatermarkDisplayNullText(e.target.checked ? '電話番号' : '');
});
document.getElementById('setWatermarkNullText').addEventListener('change', (e) => {
gcMask.setWatermarkNullText(e.target.checked ? '市外局番から入力ください' : '');
});
const setPromptChar = new InputMan.GcTextBox(document.getElementById('setPromptChar'), {
text: '_'
});
setPromptChar.onTextChanged(() => {
gcMask.setPromptChar(setPromptChar.getText());
});
<!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>
<input id="gcMask" style="width: 200px;">
<table class="sample">
<tr>
<th>代替テキスト</th>
<td>
<label><input type="checkbox" checked
id="setWatermarkDisplayNullText">フォーカスがないときの代替テキスト</label><br>
<label><input type="checkbox" checked
id="setWatermarkNullText">フォーカスがあるときの代替テキスト</label>
</td>
</tr>
<tr>
<th>プロンプト文字</th>
<td><input type="text" id="setPromptChar"></td>
</tr>
</table>
</body>
</html>
/* ウォーターマークのスタイル */
.gcim_watermark_null {
color: lightgrey;
}
/* ウォーターマークのスタイル */
[gcim-control-appearance="modern"] .gcim_watermark_null {
color: lightgrey;
}
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'
},
}
});