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) | ボタンのテーマカラーを指定します。 |
| 複数のボタンをグループ化するには、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) | チェックボックスのテーマカラーを指定します。 |
| 複数のチェックボックスをグループ化するには、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 | アイコンの位置を指定します。 |
| ナビゲーションバーは親コンテナからテーマスウォッチを継承します。ナビゲーションバーに 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) | ラジオボタンのテーマカラーを指定します。 |
| 複数のラジオボタンをグループ化するには、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 要素のテーマカラーを指定します。 |
| 複数の 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) | 入力フィールドのテーマ色を指定します。 |
その他の拡張