コンボコントロールには、ドロップダウンリストの項目を順番に指定できるスピン機能が搭載されています。以下では、このスピン機能を含む、コンボコントロールでの入力方法について説明します。
概要
コンボコントロールでは、ドロップダウンリストに設定された項目を選択する方法として、以下のような方法を提供しています。
ドロップダウンボタンをクリックし、リストアイテムを選択する
コントロールにフォーカスがある状態で、[↓]・[↑]・[Page Up]・[Page Down]のいずれかのボタンを押下する
コントロールにフォーカスがある状態で、マウスホイールを回転させる
スピンボタンをクリックする
なお、コンボコントロールのisMultiSelectプロパティをtrueに設定し、複数のアイテムを同時に選択できる設定にしている場合、上記2~4の方法は無効です。
また、1のドロップダウンボタンと4のスピンボタンは、表示有無や表示位置を変更することが可能です。
さらに、3のマウスホイールの操作は、setSpinWheelメソッドで制御することができます。
スピンボタン
スピンボタンの表示有無は、showSpinButtonプロパティで設定することが可能です。showSpinButtonプロパティをtrueに設定すると、スピンボタンが表示されます。(既定値はfalseです。)
また、spinButtonPositionプロパティを使用することで、スピンボタンの表示位置を設定することが可能です。spinButtonPositionプロパティに設定可能な値(SpinButtonAlignment列挙型)は、以下の通りです。
値
説明
LeftSide
スピンボタンをコントロールの左側に配置します。
RightSide
スピンボタンをコントロールの右側に配置します。(既定値)
コンボコントロールの左側にスピンボタンを表示する場合、以下のようなコードになります。
ドロップダウンボタン
ドロップダウンボタンの表示有無は、showDropDownButtonプロパティで設定することが可能です。showDropDownButtonプロパティをtrueに設定すると、ドロップダウンボタンが表示されます。(既定値はtrueです。)
また、dropDownButtonPositionプロパティを使用することで、スピンボタンの表示位置を設定することが可能です。dropDownButtonPositionプロパティに設定可能な値(DropDownButtonAlignment列挙型)は、以下の通りです。
値
説明
LeftSide
ドロップダウンボタンをコントロールの左側に配置します。
RightSide
ドロップダウンボタンをコントロールの右側に配置します。(既定値)
コンボコントロールの左側にドロップダウンボタンを表示する場合、以下のようなコードになります。
備考
スピンボタンとドロップダウンボタンを同じ方向に配置した場合、スピンボタンはドロップダウンボタンの 外側 に表示されます。たとえば、spinButtonPositionとdropDownButtonPositionの両プロパティをどちらもRightSideに設定した場合、スピンボタンがドロップダウンボタンの右側に表示されます。
なお、スピンボタンを表示する方法としては、showSpinButtonプロパティを使用する以外に、addSpinButtonメソッドを使用する方法があります。addSpinButtonメソッドのパラメータに設定可能な値は、以下の通りです。
値
説明
false
スピンボタンをコントロールの左側に配置します。(既定値)
true
スピンボタンをコントロールの右側に配置します。
たとえば、スピンボタンをコントロールの左側に配置したい場合、以下のようなコードになります。。
ただし、addSpinButtonメソッドを使用してドロップダウンボタンと同じ方向に追加した場合、スピンボタンはドロップダウンボタンの 内側 に表示されます。また、showSpinButtonプロパティがtrueに設定された状態で、addSpinButtonメソッドを実行しても、表示位置は変わりません。
import '@grapecity/inputman/CSS/gc.inputman-js.css';
import './styles.css';
import { InputMan } from '@grapecity/inputman';
import products from './data';
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
var spinButtonPositions = [
InputMan.SpinButtonAlignment.RightSide,
InputMan.SpinButtonAlignment.LeftSide
];
var dropDownButtonPositions = [
InputMan.DropDownButtonAlignment.RightSide,
InputMan.DropDownButtonAlignment.LeftSide
];
const update = () => {
let container = document.getElementById('container');
container.innerHTML = '';
let gcComboBox = new InputMan.GcComboBox(container, {
items: products,
showSpinButton: document.getElementById('showSpinButton').checked,
spinButtonPosition: spinButtonPositions[document.getElementById('spinButtonPosition').selectedIndex],
showDropDownButton: document.getElementById('showDropDownButton').checked,
dropDownButtonPosition: dropDownButtonPositions[document.getElementById('dropDownButtonPosition').selectedIndex]
});
gcComboBox.setSpinWheel(document.getElementById('setSpinWheel').checked);
}
update();
document.getElementById('spinButtonPosition').addEventListener('change', (e) => {
update();
});
document.getElementById('dropDownButtonPosition').addEventListener('change', (e) => {
update();
});
document.getElementById('showDropDownButton').addEventListener('change', (e) => {
update();
});
document.getElementById('showSpinButton').addEventListener('change', (e) => {
update();
});
document.getElementById('setSpinWheel').addEventListener('change', (e) => {
update();
});
<!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>
<div id="container"><select></select></div>
<table class="sample">
<tr>
<th>スピンボタン</th>
<td>
<label><input type="checkbox" id="showSpinButton" checked>スピンボタンを表示する</label>
</td>
</tr>
<tr>
<th>スピンボタンの位置</th>
<td>
<select id="spinButtonPosition">
<option>右</option>
<option>左</option>
</select>
</td>
</tr>
<tr>
<th>ドロップダウンボタン</th>
<td>
<label><input type="checkbox" id="showDropDownButton" checked>ドロップダウンボタンを表示する</label>
</td>
</tr>
<tr>
<th>ドロップダウンボタンの位置</th>
<td>
<select id="dropDownButtonPosition">
<option>右</option>
<option>左</option>
</select>
</td>
</tr>
<tr>
<th>マウスホイールでのスピン操作</th>
<td><label><input type="checkbox" checked id="setSpinWheel">有効にする</label></td>
</tr>
</table>
</body>
</html>
body {
min-height: 220px;
}
module.exports = [
'果汁100%オレンジ',
'果汁100%グレープ',
'果汁100%レモン',
'果汁100%ピーチ',
'コーヒーマイルド',
'コーヒービター'
];
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'
},
}
});