日付時刻コントロールではフォーカス制御に関する様々な機能を搭載しています。
自動フォーカス移動
setExitOnLastCharメソッドでtrueを設定すると、入力された文字列が、setFormatPatternメソッドで設定した最大文字数に達したときに、自動的に次のコントロールへフォーカスを移動できます。
矢印キーによるフォーカス移動
setExitOnLeftRightKeyメソッドを使用すると、キャレットがコントロール内のテキストの最初または最後の文字上にある状態で、[→]、[←]、または[Ctrl]+[→]、[Ctrl]+[←]の各キーを押したときに、フォーカスを前後のコントロールに移動することができます。setExitOnLeftRightKeyメソッドに設定できる値は次のとおりで、既定値はExitOnLeftRightKey.Noneです。
ExitOnLeftRightKeyの値
説明
None
矢印キーを使ってフォーカスを移動することはできません。
Left
キャレットが入力中のテキストの左端にあるときに[←]キーまたは[Ctrl]+[←]キーを押すと、フォーカスは1つ前のコントロールに移動します。
Right
キャレットが入力中のテキストの右端にあるときに[→]キーまたは[Ctrl]+[→]キーを押すと、フォーカスは次のコントロールに移動します。
Both
「Left」と「Right」の両方の機能を使用できます。
フィールド間の移動
日付時刻コントロールの表示領域は、通常、リテラル文字列と入力フィールドの2種類に分かれています。
setTabActionメソッドをTabAction.Controlに設定すると、[Tab]キーまたは[Shift]+[Tab]キーによるフォーカス移動は、コントロール 間で行われます。TabAction.Fieldに設定すると、フォーカス移動は入力フィールド間で行われます。
また、日付時刻コントロールのナビゲーションや選択などの操作は、リテラル文字列と入力フィールドの位置関係による影響を受けます。
キャレットとフィールドの設定
setCursorPositionメソッドとsetHighlightTextメソッドを使用すると、コントロールがフォーカスを受け取ったときにキャレットを配置するフィールドまたは選択状態にするフィールドを指定できます。
HighlightTextの値
キャレットまたはフィールドの状態
None
キャレットは、setCursorPositionメソッドで指定したフィールドの最初の桁に位置します。
Field
setCursorPositionメソッドで指定したフィールドが選択状態になります。
All
setCursorPositionメソッドの設定に関わらず、コントロール内のすべての内容が選択状態になります。
Enterキーによるフォーカス移動
setExitOnEnterKeyメソッドを使用すると、[Shift]+[Enter]、[Enter]の各キーを押したときに、フォーカスを前後のコントロールに移動することができます。setExitOnEnterKeyメソッドに設定できる値は次のとおりで、既定値はExitKey.Noneです。
ExitKeyの値
説明
None
Enterキーを使ってフォーカスを移動することはできません。
ShiftEnter
[Shift]+[Enter]キーを押すと、フォーカスは1つ前のコントロールに移動します。
Enter
[Enter]キーを押すと、フォーカスは次のコントロールに移動します。
Both
「ShiftEnter」と「Enter」の両方の機能を使用できます。
import '@grapecity/inputman/CSS/gc.inputman-js.css';
import { InputMan } from '@grapecity/inputman';
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
const gcDateTime1 = new InputMan.GcDateTime(document.getElementById('gcDateTime1'));
const gcDateTime2 = new InputMan.GcDateTime(document.getElementById('gcDateTime2'));
const gcDateTime3 = new InputMan.GcDateTime(document.getElementById('gcDateTime3'));
// 自動フォーカス移動
document.getElementById('setExitOnLastChar').addEventListener('change', (e) => {
const isExitOnLastChar = e.target.checked;
gcDateTime1.setExitOnLastChar(isExitOnLastChar);
gcDateTime2.setExitOnLastChar(isExitOnLastChar);
gcDateTime3.setExitOnLastChar(isExitOnLastChar);
});
// 矢印キーによるフォーカス移動
document.getElementById('setExitOnLeftRightKey').addEventListener('change', (e) => {
gcDateTime1.setExitOnLeftRightKey(exitOnLeftRightKeys[e.target.selectedIndex]);
gcDateTime2.setExitOnLeftRightKey(exitOnLeftRightKeys[e.target.selectedIndex]);
gcDateTime3.setExitOnLeftRightKey(exitOnLeftRightKeys[e.target.selectedIndex]);
});
document.getElementById('setTabAction').addEventListener('change', (e) => {
gcDateTime1.setTabAction(tabActions[e.target.selectedIndex]);
gcDateTime2.setTabAction(tabActions[e.target.selectedIndex]);
gcDateTime3.setTabAction(tabActions[e.target.selectedIndex]);
});
document.getElementById('setHighlightText').addEventListener('change', (e) => {
gcDateTime1.setHighlightText(highlightTexts[e.target.selectedIndex]);
gcDateTime2.setHighlightText(highlightTexts[e.target.selectedIndex]);
gcDateTime3.setHighlightText(highlightTexts[e.target.selectedIndex]);
});
const exitOnLeftRightKeys = [
InputMan.ExitOnLeftRightKey.None,
InputMan.ExitOnLeftRightKey.Both,
InputMan.ExitOnLeftRightKey.Left,
InputMan.ExitOnLeftRightKey.Right
];
const tabActions = [
InputMan.TabAction.Control,
InputMan.TabAction.Field
];
const highlightTexts = [
InputMan.HighlightText.None,
InputMan.HighlightText.Field,
InputMan.HighlightText.All
];
// Enterキーによるフォーカス移動
const ExitKeys = [
InputMan.ExitKey.None,
InputMan.ExitKey.Both,
InputMan.ExitKey.Enter,
InputMan.ExitKey.ShiftEnter
];
document.getElementById('setExitOnEnterKey').addEventListener('change', (e) => {
gcDateTime1.setExitOnEnterKey(ExitKeys[e.target.selectedIndex]);
gcDateTime2.setExitOnEnterKey(ExitKeys[e.target.selectedIndex]);
gcDateTime3.setExitOnEnterKey(ExitKeys[e.target.selectedIndex]);
});
<!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="gcDateTime1" tabindex="1"><br>
<input id="gcDateTime2" tabindex="2"><br>
<input id="gcDateTime3" tabindex="3"><br>
<table class="sample">
<tr>
<th>自動フォーカス移動</th>
<td><label><input type="checkbox" id="setExitOnLastChar">入力完了時に自動的に次のコントロールに移動する</label>
</td>
</tr>
<tr>
<th>矢印キーによるフォーカス移動</th>
<td>
<select id="setExitOnLeftRightKey">
<option>なし</option>
<option>両方</option>
<option>左</option>
<option>右</option>
</select>
</td>
</tr>
<tr>
<th>フォーカスの移動先</th>
<td>
<select id="setTabAction">
<option>コントロール間を移動</option>
<option>フィールド間を移動</option>
</select>
</td>
</tr>
<tr>
<th>フォーカス移動後の状態</th>
<td>
<select id="setHighlightText">
<option>キャレットをフィールドの先頭に移動</option>
<option>フィールドを選択</option>
<option>コントロールのすべての内容を選択</option>
</select>
</td>
</tr>
<tr>
<th>Enterキーによるフォーカス移動</th>
<td>
<select id="setExitOnEnterKey">
<option>なし</option>
<option>両方</option>
<option>Enter</option>
<option>Shift+Enter</option>
</select>
</td>
</tr>
</table>
</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'
},
}
});