セレクトメニュー

セレクトメニューは、ネイティブな select 要素から派生したものですが、実際の select 要素は見た目から消え、完全に新しいjQuery Mobileによって生成された使い勝手のインターフェースに置き換わります。置換されるコントロールはARIA互換となっており、デスクトップ上ではキーボードによる操作にも対応しています。セレクトメニューに設定可能な属性についてはdata属性リファレンスを参照してください。

セレクトボタンがクリックされると、OSのネイティブなセレクトメニューが開きます。メニューが選択されると、選択された値にボタンが切り替わります。

このセレクトウィジェットを作成するには、まず option 要素を抱えた通常の select 要素を記述します。そして label 要素の for 属性に select のIDを指定して、セマンティックに結び付けます。もしページレイアウト的な理由からラベルを表示したくない場合、ラベルを隠すことも可能です。しかしセマンティックな、そしてアクセシビリティの観点から、かならずラベルを作成するようにしまし>ょう。

フレームワークは全ての select 要素を見つけて、自動的にこのカスタムメニューに置き換えます。この自動初期化を止めるには select 要素に data-role=“none” 属性を指定します。



このコードにより、基本的なセレクトメニューがつくられます。デフォルトでセレクトメニューは親要素の横幅いっぱいのサイズになりますので、ラベルは別の行に表示されます。

これらをコンテナ要素で囲み、そこに data-role=“fieldcontain” 属性を指定することで、見た目を制御することも可能です。

このセレクトメニューは次のように表示されます。

こちらは、非常に長い選択肢の例です。

縦方向にグループ化されたセレクトメニュー

グループ化されたセレクトメニューをつくるには、まず select 要素と対応する label を用意します。そして labelfor 属性を、対応する select 要素の id と一致させます。

ラベル( label )は各セレクトメニューに使われているため、ここではセレクトメニュー群を囲む fieldset の中に legend を置くことをお勧めします。

最後に fieldsetdiv で囲み data-role=“controlgroup” 属性を指定することで、グループ化できます。

Date of Birth:
Date of Birth:

横方向にグループ化されたセレクトメニュー

セレクトメニューは、複数を集めてグループ化することも可能です。横方向にグループ化するには fieldset に data-type=“horizontal” 属性を指定します。セレクトメニューを表示させるボタンの横幅は、現在選択されているオプションの文字列長によるので注意してください。また、ブラウザが display: inline-block; という指定をサポートしていない場合、前項にあるような縦方向のグループになります。

Date of Birth:

セレクトメニュープラグインの呼び出し

セレクトメニューは data-role 属性の指定を必要とせず、自動的に初期化されます。しかし、もし他のjQueryプラグイン同様に手動で特定の要素に textinput プラグインを適用したい場合、次のようにします。

$('select').selectmenu();

テーマ設定

jQuery Mobileのボタンで使うことの出来る data 属性は、全てセレクトメニューでも利用可能です。次のサンプルでは、テーマとアイコンを設定しています。

セレクト要素に data-overlay-theme 属性を追加することも可能です。これは、ダイアログベースのカスタムセレクトメニュー表示時のオーバーレイや、小さなカスタムメニューの外枠線に使われる指定です。デフォルトで、この値はスウォッチAになっています。

このセレクトメニューを更に拡張して、フレームワークはカスタムメニューを作成することも行います。これにより、OSネイティブの選択メニューではなく独自スタイルのセレクトメニューを使うことが可能です。カスタムメニューは disable オプションと複数選択(どちらもモバイルOSがネイティブに実装しているはずであるが、いずれも上手く動作しない)をサポートしています。また、プレースホルダーをエレガントに実装し、更にはAndroidなど特定のプラットフォームでは実装されていない optgroup もサポートします。

オプション

セレクトメニュープラグインは、次のオプションを持っています。

corners boolean

default: true

ここにtrueを設定した場合、テーマで設定された角の丸みが適用されます。このオプションは、次のようなdata属性でも設定可能です: data-corners="false"

$('select').selectmenu({ corners: "false" });
icon string

default: "arrow-down"

ボタンに表示するアイコンを アイコンセット から指定します。この>オプションは、次のようなdata属性でも指定可能です: data-icon="star"

$('select').selectmenu({ icon: "star" });
iconpos string

default: "right"

ボタン上のアイコン位置を指定します。指定可能な値は、left, right, none, notextのいずれかです。notextを指定すると、テキスト表示の無>いアイコンだけのボタンになります。このオプションは、次のようなdata属性でも指定可能です: data-iconpos="left"

$('select').selectmenu({ iconpos: "left" });
iconshadow boolean

default: true

ここにtrueを設定した場合、ボタンのアイコンにテーマで設定された影がつけられます。このオプションは、次のようなdata属性でも設定可能です: data-iconshadow="false"

$('select').selectmenu({ iconshadow: "false" });
initSelector CSS selector string

default: "select:not(:jqmData(role='slider'))"

ここには、フォームボタンとして自動初期化する対象をあらわすセレクタ(要素やdata-roleなど)を定義します。この記述は mobileinit イベン>トで行います。

$( document ).bind( "mobileinit", function(){
        $.mobile.selectmenu.prototype.options.initSelector = ".myselect";
});
inline boolean

default: null (false)

ここに true がセットされると、セレクトボタンはテキストにあわせた横幅のインラインボタンのような動作になります。初期値は null(false) なので、セレクトボタンは横幅いっぱいになっています。この設定はdata属性でも可能です: data-inline="true"

$('select').selectmenu({ inline: "true" });
nativeMenu boolean

default: true

ここに true がセットされると、カスタムスタイルになるはずのセレクトメニューをクリックした場合でも、ネイティブなセレクトメニューが使われるようになります。これはパフォーマンス的には最良です。ここに false が指定されれば、ネイティブメニューではなくカスタムセレクトメニューが使われます。この設定はdata属性でも可能です: data-native-menu="false"

$('select').selectmenu({ nativeMenu: "false" });
shadow boolean

default: true

ここにtrueを設定した場合、ボタンが影付きになります。このオプションは、次のようなdata属性でも設定可能です: data-shadow="false"

$('select').selectmenu({ shadow: "false" });
theme string

default: null, inherited from parent

>ウィジェットの色(スウォッチ)を指定します。テーマで定義されたスウォッチをあらわすaからzまでのアルファベットが指定できます。デフォルトでは、個別に設定されない場合、親要素のスウォッチ指定を引き継ぐようになっています。このオプションは、次のようなdata属性でも設定可能です: data-theme="a"

$('select').selectmenu({ theme: "a" });

メソッド

セレクトメニュープラグインは、次のようなメソッドを持っています。

close 開いているセレクトメニューを閉じる。
$('select').selectmenu('close');                     
enable 使用不可状態のセレクトメニューを、使用可能にする。
$('select').selectmenu('enable');                    
disable セレクトメニューを使用不可状態にする。
$('select').selectmenu('disable');                   
open 閉じているセレクトメニューを開く。
$('select').selectmenu('open');                      
refresh カスタムスタイルに値の更新を通知する。
ネイティブな select 要素が更新された場合、それを反映するために refresh メソッドを実行する必要があります。もしセレクト内にある幾つかのオプションの状態が実際に表示されているものとは異なった場合、カスタムメニューを再構築しましょう。
//refresh value                      
$('select').selectmenu('refresh');
//refresh and force rebuild
$('select').selectmenu('refresh', true); 

イベント

jQuery Mobileによる仮想的なイベント、もしくは change, focus, blur などのような標準的なJavaScriptのイベントにバインドできます。

$(".mySelect").bind( "change", function(event, ui) {
  ...
});

セレクトメニュープラグインは、次のようなメソッドを持っています。

create セレクトメニューが生成された際に発生します。
$( ".selector" ).selectmenu({
   create: function(event, ui) { ... }
});