jQuery Mobile ポップアップ
ポップアップは非常に人気のあるダイアログで、ページの上にオーバーレイ表示できます。
ポップアップは、テキスト、画像、地図、その他のコンテンツを表示するために使用できます。
ポップアップを作成するには、<a> 要素と <div> 要素を使用する必要があります。<a> 要素に data-rel="popup" 属性を追加し、<div> 要素に data-role="popup" 属性を追加します。次に、<div> に id を指定し、<a> の href の値を <div> で指定した id に設定します。<div> の中身がポップアップに表示されるコンテンツです。
注意:<div> ポップアップとクリックする <a> リンクは同じページになければなりません。
例
<div data-role="popup" id="myPopup">
<p>これは簡単なポップアップです</p>
</div>
試してみる »
ポップアップにパディングとマージンを追加する必要がある場合は、<div> に "ui-content" クラスを追加します。
ポップアップを閉じる
デフォルトでは、ポップアップの外側をクリックするか、"Esc" キーを押すとポップアップを閉じることができます。ポップアップの外側をクリックして閉じたくない場合は、data-dismissible="false" 属性を追加できます(推奨されません)。ポップアップに閉じるボタンを追加することもできます。ボタンには data-rel="back" 属性を使用し、スタイルでボタンの位置を制御します。
| 説明 | 例 |
|---|---|
| 右側の閉じるボタン | 試してみる |
| 左側の閉じるボタン | 試してみる |
| data-dismissible 属性を使用 | 試してみる |
ポップアップの位置指定
デフォルトでは、ポップアップはクリックした要素の上に直接表示されます。ポップアップの位置を制御する必要がある場合は、ポップアップを開くためにクリックされるリンクに data-position-to 属性を使用できます。
ポップアップの位置を制御する3つの方法:
| 属性値 | 説明 |
|---|---|
| data-position-to="window" | ポップアップがウィンドウの中央に表示されます。 |
| data-position-to="#myId" | ポップアップが指定された #id 要素の上に表示されます。 |
| data-position-to="origin" | デフォルト。ポップアップはクリックした要素の上に表示されます。 |
例
<a href="#myPopup2" data-rel="popup" class="ui-btn" data-position-to="#demo">id="demo"</a>
<a href="#myPopup3" data-rel="popup" class="ui-btn" data-position-to="origin">Origin</a>
試してみる »
トランジション
デフォルトでは、ポップアップにトランジション効果はありません。必要に応じて、data-transition="value" 属性を使用してトランジション効果を追加できます(jQuery Mobile トランジション):
すべてのトランジション効果の例
試してみる »
ポップアップの矢印
ポップアップの矢印を追加する必要がある場合は、data-arrow 属性を使用し、値を "l" (左)、"t" (上)、"r" (右) もしくは "b" (下) に指定します:
例
<div data-role="popup" id="myPopup" class="ui-content" data-arrow="l">
<p>左の矢印の方向。</p>
</div>
試してみる »
ポップアップダイアログ
ポップアップを標準的なダイアログ(ヘッダー、コンテンツ、フッターのマークアップ)にすることができます:
例
<div data-role="popup" id="myPopupDialog">
<div data-role="header"><h1>ヘッダーテキスト..</h1></div>
<div data-role="main" class="ui-content"><p>いくつかのテキスト..</p><a href="#">いくつかのリンク..</a>
<div data-role="footer"><h1>フッターテキスト..</h1></div>
</div>
試してみる »
画像ポップアップ
ポップアップに画像を表示できます:例
<img src="/wp-content/uploads/2015/10/サンプル.jpeg" alt="サンプル" style="width:200px;"></a>
<div data-role="popup" id="myPopup">
<img src="/wp-content/uploads/2015/10/サンプル.jpeg" style="width:800px;height:400px;" alt="サンプル">
</div>
試してみる »
ポップアップの背景オーバーレイ
data-overlay-theme 属性を使用して、ポップアップの後ろに背景色を追加できます。
デフォルトでは、オーバーレイの背景色は透明です。data-overlay-theme="a" を使用すると明るい背景、data-overlay-theme="b" を使用すると暗いオーバーレイ背景を追加できます:
例
<div data-role="popup" id="myPopup" data-overlay-theme="b">
<p>私の後ろに暗い背景があります。</p>
</div>
試してみる »
一般的に、画像ポップアップでは背景オーバーレイがよく使用されます:
例
<img src="/wp-content/uploads/2015/10/サンプル.jpeg" alt="サンプル" style="width:200px;"></a>
<div data-role="popup" id="myPopup" data-overlay-theme="b">
<img src="/wp-content/uploads/2015/10/サンプル.jpeg" style="width:800px;height:400px;" alt="サンプル">
</div>
試してみる »
注意:次の章では、ポップアップでフォームを使用する方法について学びます。
その他の拡張