jQuery Mobile データ属性


jQuery データ属性

jQuery Mobile の使用HTML5 data-* 属性モバイルデバイス向けに、よりタッチフレンドリーで魅力的な外観を作成します。

以下のリファレンスリストでは、太字で表示されている値がデフォルト値です。


ボタン

1.4 以降で非推奨になりました。代わりにCSS クラスを使用してください。を持つdata-role="button"超リンク。button 要素、ツールバー内のリンク、input フィールドは、data-role="button" を追加しなくても自動的にボタンスタイルにレンダリングされます。

データ属性 值 説明
data-corners true | false ボタンの角を丸くするかどうかを指定します。
data-icon アイコンリファレンス ボタンのアイコンを指定します。デフォルトではアイコンはありません。
data-iconpos left | right | top | bottom | notext アイコンの位置を指定します。
data-iconshadow true | false ボタンのアイコンに影を付けるかどうかを指定します。
data-inline true | false ボタンをインラインにするかどうかを指定します。
data-mini true | false ボタンのサイズを小と通常のどちらにするかを指定します。
data-shadow true | false ボタンに影を付けるかどうかを指定します。
data-theme アルファベット (a-z) ボタンのテーマカラーを指定します。

lamp 複数のボタンをグループ化するには、data-role="controlgroup" 属性と data-type="horizontal|vertical" を備えたコンテナを使用して、ボタンを水平または垂直にグループ化するかどうかを指定します。


チェックボックス

type="checkbox" を持つtype="checkbox"ペアの label と input。これらは自動的にボタンスタイルにレンダリングされ、data-role は必要ありません。

データ属性 值 説明
data-mini true | false チェックボックスのサイズを小と通常のどちらにするかを指定します。
data-role none jQuery Mobile がチェックボックスをボタンスタイルにレンダリングしないようにします。
data-theme アルファベット (a-z) チェックボックスのテーマカラーを指定します。

lamp 複数のチェックボックスをグループ化するには、data-role="controlgroup" 属性と data-type="horizontal|vertical" を備えたコンテナを使用して、チェックボックスを水平または垂直にグループ化するかどうかを指定します。


折りたたみブロック

data-role="collapsible" を備えたdata-role="collapsible"コンテナ内の、任意の HTML マークアップが続く見出し要素。

データ属性 值 説明
data-collapsed true | false コンテンツを折りたたむか展開するかを指定します。
data-collapsed-icon アイコンリファレンス 折りたたみボタンのアイコンを指定します。デフォルトは "plus" です。
data-content-theme アルファベット (a-z) 折りたたみコンテンツのテーマカラーを指定します。折りたたみコンテンツに角丸を追加するかどうかを指定します。
data-expanded-icon アイコンリファレンス コンテンツ展開時の折りたたみボタンのアイコンを指定します。デフォルトは "minus" です。
data-iconpos left | right | top | bottom アイコンの位置を指定します。
data-inset true | false 折りたたみボタンを角丸と外側マージン付きでレンダリングするかどうかを指定します。
data-mini true | false 折りたたみボタンのサイズを小と通常のどちらにするかを指定します。
data-theme アルファベット (a-z) 折りたたみボタンのテーマカラーを指定します。


折りたたみセット

data-role="collapsibleset" を備えたdata-role="collapsible-set"コンテナ内の折りたたみコンテンツブロック。

データ属性 值 説明
data-collapsed-icon アイコンリファレンス 折りたたみボタンのアイコンを指定します。デフォルトは "plus" です。
data-content-theme アルファベット (a-z) 折りたたみボタンのテーマカラーを指定します。
data-expanded-icon アイコンリファレンス コンテンツ展開時の折りたたみボタンのアイコンを指定します。デフォルトは "minus" です。
data-iconpos left | right | top | bottom | notext アイコンの位置を指定します。
data-inset true | false 折りたたみブロックを角丸と外側マージン付きでレンダリングするかどうかを指定します。
data-mini true | false 折りたたみボタンのサイズを小と通常のどちらにするかを指定します。
data-theme アルファベット (a-z) 折りたたみセットのテーマカラーを指定します。


コンテンツ

1.4 で非推奨となり、1.5 以降はサポートされなくなりました。を使用したdata-role="content"コンテナ。

データ属性 值 説明
data-theme アルファベット (a-z) コンテンツのテーマカラーを指定します。


コントロールグループ

data-role="controlgroup" を備えたdata-role="controlgroup"<div> または <fieldset> コンテナ。単一タイプ(リンクベースのボタン、ラジオボタン、チェックボックス、select 要素)の複数のボタンスタイルの input をグループ化します。フォームのチェックボックスとラジオボタンをグループ化するには、data-role="fieldcontain" を備えた <div> 内で <fieldset> コンテナを使用してラベルのスタイルを改善することをお勧めします。

データ属性 值 説明
data-mini true | false コントロールグループのサイズを小と通常のどちらにするかを指定します。
data-type horizontal | vertical コントロールグループを水平または垂直のどちらで表示するかを指定します。


ダイアログ

data-role="dialog" を持つdata-role="dialog"コンテナ、またはdata-rel="dialog"data-rel="dialog" のリンク。

データ属性 值 説明
data-close-btn-text sometext ダイアログの閉じるボタンのテキストを指定します。
data-dom-cache true | false 各ページの jQuery DOM キャッシュをクリアするかどうかを指定します(true に設定した場合、DOM を自分で管理し、すべてのモバイルデバイスでテストする必要があります)。
data-overlay-theme アルファベット (a-z) ダイアログページのマスク(背景)色を指定します。
data-theme アルファベット (a-z) ダイアログページのテーマカラーを指定します。
data-title sometext ダイアログページのタイトルを指定します。


拡張

data-enhance="false" を持つdata-enhance="false" 或 data-ajax="false"コンテナ。

データ属性 值 説明
data-enhance true | false true(デフォルト)に設定すると、jQuery Mobile はページを自動的にレンダリングしてモバイルデバイスに適したものにします。false に設定すると、フレームワークはページをレンダリングしません。
data-ajax true | false ajax 経由でページを読み込むかどうかを指定します。

注意:data-enhance="false" は、jQuery Mobile の自動レンダリングを防ぐために、$.mobile.ignoreContentEnabled=true と一緒に使用する必要があります。

$.mobile.ignoreContentEnabled が true に設定されている場合、data-ajax="false" コンテナ内のリンクまたはフォーム要素はフレームワークのナビゲーション機能によって無視されます。


フィールドコンテナ

1.4 以降で非推奨となり、1.5 以降はサポートされません。class="ui-fieldcontain" が代替として使用されます。label/form 要素のペアを包み込み、data-role="fieldcontain" を備えたdata-role="fieldcontain"コンテナ。


固定ツールバー

data-role="header|footer" を備えdata-role="header" 或 data-role="footer"、かつdata-position="fixed"data-position="fixed" 属性を備えたコンテナ。

データ属性 值 説明
data-disable-page-zoom true | false ユーザーがページをズームできるかどうかを指定します。
data-fullscreen true | false ツールバーが常に上部または下部に固定されているかどうかを指定します。
data-tap-toggle true | false ユーザーがクリックでツールバーの表示/非表示を切り替えられるかどうかを指定します。
data-transition slide | fade | none クリック時のトグル効果を指定します。
data-update-page-padding true | false resize、transition、"updatelayout" イベント発生時にページ上部と下部のパディングを更新するかどうかを指定します(jQuery Mobile は "pageshow" イベント発生時には常にパディングを更新します)。
data-visible-on-page-show true | false 親ページ表示時のツールバーの表示/非表示を指定します。


フリップトグルスイッチ

data-role="flipswitch" を持つdata-role="slider"<select> 要素と 2 つの <option> 要素。

データ属性 值 説明
data-mini true | false スイッチのサイズを小と通常のどちらにするかを指定します。
data-role none jQuery Mobile がフリップスイッチをボタンスタイルにレンダリングしないようにします。
data-theme アルファベット (a-z) フリップスイッチのテーマカラーを指定します。
data-track-theme アルファベット (a-z) トラックのテーマカラーを指定します。


フッターバー

を持つdata-role="footer"コンテナ。

Data-属性 值 説明
data-id sometext 一意の ID を指定します。永続的なフッターバーには必須です。
data-position inline | fixed フッターバーがページコンテンツとインラインであるか、下部に固定されたままであるかを指定します。
data-fullscreen true | false フッターバーが下部に固定されているか、ページコンテンツの上にオーバーレイするかを指定します(表示範囲が大きくなります)。
data-theme スウォッチ (a-z) フッターバーのテーマカラーを指定します。デフォルトは "a" です。

注意:全画面配置を有効にするには、data-position="fixed" を使用し、その要素に data-fullscreen 属性を追加してください。


ヘッダーバー

を持つdata-role="header"コンテナ。

Data-属性 值 説明
data-id sometext 一意の ID を指定します。永続的なヘッダーバーには必須です。
data-position inline | fixed ヘッダーバーがページコンテンツとインラインであるか、上部に固定されたままであるかを指定します。
data-fullscreen true | false ヘッダーバーが上部に固定されているか、ページコンテンツの上にオーバーレイするかを指定します(表示範囲が大きくなります)。
data-theme スウォッチ (a-z) ヘッダーバーのテーマカラーを指定します。デフォルトは "a" です。

注意:全画面配置を有効にするには、data-position="fixed" を使用し、その要素に data-fullscreen 属性を追加してください。


リンク

すべてのリンク。data-role="button" を持つリンクやフォーム送信ボタンも含みます。

Data-属性 值 説明
data-ajax true | false ajax を使用してページを読み込み、ユーザーエクスペリエンスとインタラクションを向上させるかどうかを指定します。false に設定すると、jQuery Mobile は通常のページリクエストを実行します。
data-direction reverse 逆方向の遷移アニメーション(ページとダイアログのみに使用)
data-dom-cache true | false 各ページの jQuery DOM キャッシュをクリアするかどうかを指定します(true に設定する場合、DOM を自分で管理し、すべてのモバイルデバイスでテストする必要があります)。
data-prefetch true | false ユーザーがアクセスしたときに利用できるように、ページを事前に DOM に読み込むかどうかを指定します。
data-rel back | dialog | external | popup リンクの動作のオプションを指定します。Back - 履歴内の前のページに戻ります。Dialog - リンクをダイアログとして開き、履歴に保存しません。External - 別のドメインへのリンクに使用します。Popup - ポップアップウィンドウを開きます。
data-transition fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none あるページから次のページへの切り替え効果を指定します。私たちのjQuery Mobile ページ切り替えの章を参照してください。
data-position-to origin | jQuery selector | window ポップアップの位置を指定します。Origin - デフォルト。ポップアップを開いたリンク上に配置します。jQuery selector - 指定した要素上にポップアップを配置します。Window - ウィンドウ画面の中央にポップアップを配置します。


リスト

を持つdata-role="listview"の <ol> または <ul>。

Data-属性 值 説明
data-autodividers true | false リスト項目を自動的に区切るかどうかを指定します。
data-count-theme スウォッチ (a-z) カウントバブルのテーマカラーを指定します。
data-divider-theme スウォッチ (a-z) リスト区切りのテーマカラーを指定します。
data-filter true | false リストに検索ボックスを追加するかどうかを指定します。
data-filter-placeholder sometext バージョン 1.4 以降で非推奨です。代わりに HTML の placeholder 属性を使用してください。検索ボックス内のテキストを指定します。デフォルトは "Filter items..." です。
data-filter-theme スウォッチ (a-z) 検索フィルタのテーマカラーを指定します。
data-icon アイコンリファレンス リストのアイコンを指定します。
data-inset true | false リストを角丸で外側の余白付きでレンダリングするかどうかを指定します。
data-split-icon アイコンリファレンス 分割ボタンのアイコンを指定します。デフォルトは "arrow-r" です。
data-split-theme スウォッチ (a-z) 分割ボタンのテーマカラーを指定します。
data-theme スウォッチ (a-z) リストのテーマカラーを指定します。


リスト項目

を持つdata-role="listview"の <ol> または <ul> 内の <li>。

Data-属性 值 説明
data-filtertext sometext 要素をフィルタリングするときに検索するテキストを指定します。実際のリスト項目テキストではなく、このテキストがフィルタリング対象となります。
data-icon アイコンリファレンス リスト項目のアイコンを指定します。
data-role list-divider リスト項目の区切りを指定します。
data-theme スウォッチ (a-z) リスト項目のテーマカラーを指定します。

注意:data-icon 属性は、リンクを持つリスト項目にのみ作用します。


ナビゲーションバー

を持つdata-role="navbar"コンテナ内の <li> 要素。

Data-属性 值 説明
data-icon アイコンリファレンス リスト項目のアイコンを指定します。
data-iconpos left | right | top | bottom | notext アイコンの位置を指定します。

lamp ナビゲーションバーは親コンテナからテーマスウォッチを継承します。ナビゲーションバーに data-theme 属性を設定することはできません。ナビゲーションバー内の各リンクに個別に data-theme 属性を設定することはできます。


ページ

を持つdata-role="page"コンテナ。

Data-属性 值 説明
data-add-back-btn true | false 戻るボタンを自動的に追加します(ヘッダーバーのみ)。
data-back-btn-text sometext 戻るボタンのテキストを指定します。
data-back-btn-theme スウォッチ (a-z) 戻るボタンのテーマカラーを指定します。
data-close-btn-text スウォッチ (a-z) ダイアログの閉じるボタンのテキストを指定します。
data-dom-cache true | false 各ページの jQuery DOM キャッシュをクリアするかどうかを指定します(true に設定する場合、DOM を自分で管理し、すべてのモバイルデバイスでテストする必要があります)。
data-overlay-theme スウォッチ (a-z) ダイアログページのマスク(背景)の色を指定します。
data-theme スウォッチ (a-z) ページのテーマカラーを指定します。
data-title sometext ページタイトルを指定します。
data-url url ページのリクエストに使用された URL ではなく、URL の値を更新します。


ポップアップ

を持つdata-role="popup"コンテナ。

Data-属性 值 説明
data-corners true | false ポップアップを角丸にするかどうかを指定します。
data-overlay-theme スウォッチ (a-z) ポップアップのマスク(背景)の色を指定します。デフォルトは透明な背景(なし)です。
data-shadow true | false ポップアップに影を付けるかどうかを指定します。
data-theme スウォッチ (a-z) ポップアップのテーマカラーを指定します。デフォルトは継承で、"none" はポップアップを透明にします。
data-tolerance 30, 15, 30, 15 ウィンドウの端(上 top、右 right、下 bottom、左 left)からの距離を指定します。

を持つdata-rel="popup"アンカー:

Data-属性 值 説明
data-position-to origin | jQuery selector | window >ポップアップの位置を指定します。Origin - デフォルト。ポップアップを開いたリンク上に配置します。jQuery selector - 指定した要素上にポップアップを配置します。Window - ウィンドウ画面の中央にポップアップを配置します。
data-rel popup ポップアップを開くために使用します。
data-transition fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none あるページから次のページへの切り替え効果を指定します。私たちのjQuery Mobile ページ切り替えの章を参照してください。


ラジオボタン

を持つtype="radio"ペアになった label と input。これらは自動的にボタンスタイルにレンダリングされ、data-role は必要ありません。

Data-属性 值 説明
data-mini true | false ボタンが小さいサイズか通常サイズかを指定します。
data-role none jQuery Mobile がラジオボタンのスタイルを拡張状態のボタンとしてレンダリングするのを防ぎ、要素を HTML ネイティブの状態で表示します。
data-theme スウォッチ (a-z) ラジオボタンのテーマカラーを指定します。

lamp 複数のラジオボタンをグループ化するには、data-role="controlgroup" 属性と data-type="horizontal|vertical" を持つコンテナを使用して、ラジオボタンを水平または垂直にグループ化するかどうかを指定します。


セレクト

すべての<select>要素。これらは自動的にボタンスタイルにレンダリングされ、data-role は必要ありません。

Data-属性 值 説明
data-icon アイコンリファレンス select 要素のアイコンを指定します。デフォルトは "arrow-d" です。
data-iconpos left | right | top | bottom | notext アイコンの位置を指定します。
data-inline true | false select 要素をインラインにするかどうかを指定します。
data-mini true | false select 要素を小さいサイズにするか通常サイズにするかを指定します。
data-native-menu true | false false に設定すると、jQuery 組み込みのカスタム選択メニューを使用します(選択メニューをすべてのモバイルデバイスで同じように表示したい場合は、この方法をお勧めします)。
data-overlay-theme スウォッチ (a-z) jQuery 組み込みのカスタム選択メニューのテーマカラーを指定します(data-native-menu="false" と一緒に使用します)。
data-placeholder true | false 非ネイティブの選択メニューの <option> 要素に設定できます。
data-role none jQuery Mobile が select 要素をボタンスタイルにレンダリングするのを防ぎます。
data-theme スウォッチ (a-z) select 要素のテーマカラーを指定します。

lamp 複数の select 要素を組み合わせるには、data-role="controlgroup" 属性と data-type="horizontal|vertical" を持つコンテナを使用して、select 要素を水平または垂直に組み合わせるかを指定します。


スライダー

付きtype="range"の入力ボックス。これらは自動的にボタンスタイルにレンダリングされ、date-role は必要ありません。

Data属性 值 説明
data-highlight true | false スライダートラックをハイライト表示するかどうかを指定します。
data-mini true | false スライダーを小さいサイズにするか通常サイズにするかを指定します。
data-role none jQuery Mobile がスライダーコントロールをボタンスタイルにレンダリングするのを防ぎます。
data-theme アルファベット (a-z) スライダーコントロール(入力ボックス、ハンドル、トラック)のテーマ色を指定します。
data-track-theme アルファベット (a-z) スライダートラックのテーマ色を指定します。


テキスト入力ボックス & テキストエリア

付きtype="text|search|etc."の input またはtextarea 要素。これらは自動的にボタンスタイルにレンダリングされ、date-role は必要ありません。

Data属性 值 説明
data-mini true | false 入力ボックスを小さいサイズにするか通常サイズにするかを指定します。
data-role none jQuery Mobile が入力ボックス/入力エリアをボタンスタイルにレンダリングするのを防ぎます。
data-theme アルファベット (a-z) 入力フィールドのテーマ色を指定します。


その他の拡張