カレンダーコントロールの基本的な操作方法について解説します。
ナビゲーションとスクロール
カレンダーコントロールでは、setShowNavigatorメソッドの設定によって3種類のナビゲータを利用できます。ナビゲータの表示位置は、setNavigatorOrientationメソッドで設定でき、表示されている年や月を自由に切り替えられます。
カレンダーコントロールに用意されているscrollYearとscrollMonthの各メソッドは、指定した年数または月数だけカレンダーをスクロールします。setShowNavigatorメソッドをCalendarNavigators.Noneに設定して、これらのメソッドを活用することで、独自のナビゲーションを実現できます。
これらのナビゲータまたはメソッドを使ってカレンダーをスクロールしたときには、onScrolledイベントが発生します。年に応じて変化する休日などを設定するときに使用します。また、onScrolledイベントの後にはonFocusDateChangedクライアントイベントが発生します。
次のサンプルコードは、スクロール型のナビゲータを設定する方法を示します。
カレンダータイプの切り替え
カレンダーは、日付を選択するMonthDayカレンダー(月-日カレンダー)と月を選択するYearMonthカレンダー(年-月カレンダー)の2つのタイプがあり、カレンダーの対応はsetCalendarTypeメソッドで設定します。既定値はMonthDayカレンダーです。
また、実行時には、ズームイン/スームアウトの2つのボタンによって、カレンダーのタイプを切り替えることができます。ズームボタンを表示するには、setShowZoomButtonメソッドをtrueに設定する必要があります。ズームボタンは、setShowNavigatorメソッドで設定されるナビゲータ上にボタンアイコンが表示されます。
次のサンプルコードは、YearMonthカレンダーを表示する方法を示します。
なお、タッチデバイスの使用時には、カレンダータイプはピンチやストレッチ操作により切り替えることができます。詳細については「カレンダーのタッチ操作」を参照してください。
キーボード操作
カレンダーコントロールでは、以下のキーボード操作が可能です。
キー
説明
[←]
フォーカスが前の日に戻ります。
[→]
フォーカスが次の日に進みます。
[↑]
フォーカスが1週間前に戻ります。
[↓]
フォーカスが1週間先に進みます。
[Home]
フォーカスがその週の最初の日に戻ります。
[End]
フォーカスがその週の最後の日に進みます。
[Ctrl]+[Home]
フォーカスが表示されている月の最初の日に戻ります。
[Ctrl]+[End]
フォーカスが表示されている月の最後の日に進みます。
[PageUp]
フォーカスが1か月前に戻ります。
[PageDown]
フォーカスが1か月先に進みます。
[Ctrl]+[PageUp]
フォーカスが1年前に戻ります。
[Ctrl]+[PageDown]
フォーカスが1年先に進みます。
[Space]または[Enter]
日付を選択します。
月ナビゲータのスキップ月数
scrollRateプロパティを利用して、月ナビゲータのスキップボタンクリック時に移動する月の数を設定することができます。
import '@mescius/inputman/CSS/gc.inputman-js.css';
import { InputMan } from '@mescius/inputman';
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
const gcCalendar = new InputMan.GcCalendar(document.getElementById('gcCalendar'));
document.getElementById('setShowNavigator').addEventListener('change', (e) => {
gcCalendar.setShowNavigator(calendarNavigators[e.target.selectedIndex]);
});
document.getElementById('setNavigatorOrientation').addEventListener('change', (e) => {
gcCalendar.setNavigatorOrientation(navigatorOrientations[e.target.selectedIndex]);
});
document.getElementById('setShowZoomButton').addEventListener('change', (e) => {
gcCalendar.setShowZoomButton(e.target.checked);
});
document.getElementById('skipMonth').addEventListener('change', (e) => {
gcCalendar.scrollRate = Number(e.target.value);
});
const calendarNavigators = [
InputMan.CalendarNavigators.None,
InputMan.CalendarNavigators.Buttons,
InputMan.CalendarNavigators.ScrollBar,
InputMan.CalendarNavigators.Outlook
];
const navigatorOrientations = [
InputMan.NavigatorOrientation.Top,
InputMan.NavigatorOrientation.Bottom,
InputMan.NavigatorOrientation.Left,
InputMan.NavigatorOrientation.Right
];
<!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>
<div id="gcCalendar"></div>
<table class="sample">
<tr>
<th>ナビゲータ</th>
<td>
種類:
<select id="setShowNavigator">
<option>なし</option>
<option>ボタンスタイル</option>
<option>スクロールバースタイル</option>
<option selected>Outlookスタイル</option>
</select><br>
位置:
<select id="setNavigatorOrientation">
<option>上</option>
<option>下</option>
<option>左</option>
<option selected>右</option>
</select><br>
<label><input type="checkbox" checked id="setShowZoomButton">ズームボタンを表示する</label><br>
月ナビケータで移動する月数:<input type="number" id="skipMonth" min ="1" max="11" value="1" >
</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: {
'@mescius/inputman': 'npm:@mescius/inputman/index.js',
'@mescius/inputman/CSS': 'npm:@mescius/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'
},
}
});