誰もが知っている iPod のぐりぐりスクロールできてポチポチクリックできるアレです。とりあえず、動作デモを見てもらった方が早いと思います。jQuery のプラグインとして実装されており、ホイールの画像を用意するだけで、簡単にクリック ホイール コントローラを模倣することができます。
使い方
動作デモのソースコードを参照いただくのが一番わかり易いと思います。ホイールの画像を用意して、clickwheelメソッドで初期化してください。指定できるパラメータは以下の通りです。
jQuery(document).ready(function () {
var value = 0;
jQuery('#wheel').clickwheel({
click: function (e, dr) {
jQuery('#click').eq(0).html('click ' + dr);
},
scrollstart: function () {
value = 0;
},
scroll: function (e, dt) {
value += dt;
jQuery('#scroll').eq(0).html('scroll ' + value);
},
scrollend: function () {
alert (value);
}
});
});
width
ホイール画像の横サイズを明示的に指定します。指定がない場合、標準ではホイール画像のサイズが自動的に使われます。
height
ホイール画像の縦サイズを明示的に指定します。指定がない場合、標準ではホイール画像のサイズが自動的に使われます。
rw
ホイール画像の外周の半径を明示的に指定します。指定がない場合、標準ではホイール画像の短辺の50%です。
rc
ホイール画像の内周の半径を明示的に指定します。指定がない場合、標準ではホイール画像の短辺の20%です。
click
ホイールがクリックされた時に呼び出されるコールバック関数を指定します。第1引数にeventオブジェクト、第2引数に押されたボタンの識別番号が入ります。識別番号は、中心のボタンが5、下が2、左が4、上が8、右が6、それ以外のホイール部分が0、ホイール外が-1です(テンキーを見てください) 指定がない場合、何もしません。
scrollstart
ホイールのスクロールが開始された時に呼び出されるコールバック関数を指定します。 指定がない場合、何もしません。
scroll
ホイールがスクロールする度に呼び出されるコールバック関数を指定します。 指定がない場合、何もしません。
scrollend
ホイールのスクロールが完了した時に呼び出されるコールバック関数を指定します。 指定がない場合、何もしません。
動作環境など
- Mozilla Firefox 3.5、Microsoft Internet Explorer 6.0 で動作確認
- jQuery 1.4.2 以上
- ライセンスは jQuery に準じ、MIT または GPL Version 2 とします