日付コントロールでは未入力のときや入力が完了していないとき、様々な補助機能を提供しています。
未入力時に表示する代替テキスト
setWatermarkメソッドを使用すれば、コントロールが未入力のときや和暦表示できない日付が設定された場合に、代わりに表示するテキスト（ウォーターマーク）を設定することができます。setWatermarkメソッドを使用して以下の代替テキストを設定できます。
メソッド
代替テキストの内容
setWatermarkDisplayNullText
コントロールにフォーカスがなく、未入力のときの代替テキスト
setWatermarkDisplayEmptyEraText
コントロールにフォーカスがなく、その値が和暦表示できないときの代替テキスト
setWatermarkNullText
コントロールにフォーカスがあり、未入力のときの代替テキスト
setWatermarkEmptyEraText
コントロールにフォーカスがあり、その値が和暦表示できないときの代替テキスト
和暦表示が可能な日付の範囲は、1868年9月8日～2087年12月31日です。
setWatermarkDisplayEmptyEraTextおよびsetWatermarkEmptyEraTextメソッドは、setDisplayFormatPattern、setFormatPatternメソッドによる書式設定で和暦を指定している場合に有効です。
次のサンプルコードは、上図のような代替テキストを表示する方法です。
プロンプト文字
フィールドに何も入力されていないときに表示するプロンプト文字は、setPromptCharメソッドを使用して設定します。プロンプト文字はsetFormatPatternメソッドに定義された入力マスクの位置にプレースホルダとして表示され、ユーザに入力を促します。なお、setPromptCharメソッドには、半角または全角の文字を設定できますが、文字列は設定できません。
代替テキストを設定している場合、コントロールに文字が入力されていないときには代替テキストの設定が優先されます。
import '@mescius/inputman/CSS/gc.inputman-js.css';
import './styles.css';
import { InputMan } from '@mescius/inputman';
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
const gcDateTime1 = new InputMan.GcDateTime(document.getElementById('gcDateTime1'), {
formatPattern: 'yyyy/MM/dd',
displayFormatPattern: 'yyy/M/d',
// 未入力のときの代替テキスト
watermarkDisplayNullText: '生年月日',
watermarkNullText: '西暦で入力してください'
});
gcDateTime1.setValue(null);
const gcDateTime2 = new InputMan.GcDateTime(document.getElementById('gcDateTime2'), {
formatPattern: 'gggee年MM月dd日',
displayFormatPattern: 'gggE年M月d日',
// 値が和暦表示できないときの代替テキスト
watermarkDisplayEmptyEraText: '和暦表示できない日付です',
watermarkEmptyEraText: '正しい和暦を入力してください'
});
gcDateTime2.setValue(new Date(1850, 0, 1));
const setPromptChar = new InputMan.GcTextBox(document.getElementById('setPromptChar'), {
text: '_',
maxLength: 1
});
setPromptChar.onTextChanged(() => {
gcDateTime1.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>
window.onload = function() {
System.import('./src/app');
}
</script>
</head>
<body>
<input id="gcDateTime1" style="width: 200px;">
<input id="gcDateTime2" style="width: 200px;">
<table class="sample">
<tr>
<th>プロンプト文字</th>
<td><input type="text" id='setPromptChar' value="_"></td>
</tr>
</table>
</body>
</html>
/* ウォーターマークのスタイル */
.gcim_watermark_null {
color: lightgray;
}
.gcim_watermark_empty-era {
color: pink;
}
/* ウォーターマークのスタイル */
[gcim-control-appearance="modern"] .gcim_watermark_null {
color: lightgray;
}
[gcim-control-appearance="modern"] .gcim_watermark_empty-era {
color: pink;
}
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',
'@mescius/inputman.richtexteditor': 'npm:@mescius/inputman.richtexteditor/index.js',
"@mescius/inputman.richtexteditor/CSS": "npm:@mescius/inputman.richtexteditor/CSS",
'@mescius/inputman.richtexteditor/JS/plugins/advlist': 'npm:@mescius/inputman.richtexteditor/JS/plugins/advlist/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/all': 'npm:@mescius/inputman.richtexteditor/JS/plugins/all/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/autosave': 'npm:@mescius/inputman.richtexteditor/JS/plugins/autosave/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/charmap': 'npm:@mescius/inputman.richtexteditor/JS/plugins/charmap/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/directionality': 'npm:@mescius/inputman.richtexteditor/JS/plugins/directionality/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/emoticons': 'npm:@mescius/inputman.richtexteditor/JS/plugins/emoticons/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/fullscreen': 'npm:@mescius/inputman.richtexteditor/JS/plugins/fullscreen/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/htmlcode': 'npm:@mescius/inputman.richtexteditor/JS/plugins/htmlcode/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/image': 'npm:@mescius/inputman.richtexteditor/JS/plugins/image/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/link': 'npm:@mescius/inputman.richtexteditor/JS/plugins/link/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/lists': 'npm:@mescius/inputman.richtexteditor/JS/plugins/lists/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/media': 'npm:@mescius/inputman.richtexteditor/JS/plugins/media/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/pagebreak': 'npm:@mescius/inputman.richtexteditor/JS/plugins/pagebreak/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/preview': 'npm:@mescius/inputman.richtexteditor/JS/plugins/preview/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/save': 'npm:@mescius/inputman.richtexteditor/JS/plugins/save/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/searchreplace': 'npm:@mescius/inputman.richtexteditor/JS/plugins/searchreplace/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/table': 'npm:@mescius/inputman.richtexteditor/JS/plugins/table/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/template': 'npm:@mescius/inputman.richtexteditor/JS/plugins/template/plugin.js',
'@mescius/inputman.richtexteditor/JS/plugins/wordcount': 'npm:@mescius/inputman.richtexteditor/JS/plugins/wordcount/plugin.js',
'@mescius/inputman.comment': 'npm:@mescius/inputman.comment/index.js',
'@mescius/inputman.comment/CSS': 'npm:@mescius/inputman.comment/CSS',
'@mescius/wijmo': 'npm:@mescius/wijmo/index.js',
'@mescius/wijmo.styles': 'npm:@mescius/wijmo.styles',
'@mescius/wijmo.cultures': 'npm:@mescius/wijmo.cultures',
'@mescius/wijmo.input': 'npm:@mescius/wijmo.input/index.js',
'@mescius/wijmo.grid': 'npm:@mescius/wijmo.grid/index.js',
'@mescius/wijmo.nav': 'npm:@mescius/wijmo.nav/index.js',
'@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js',
'@mescius/spread-sheets-resources-ja': 'npm:@mescius/spread-sheets-resources-ja/index.js',
'@mescius/spread-sheets/styles': 'npm:@mescius/spread-sheets/styles',
'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'
},
}
});
