ポップアップ React コンポーネント
ポップアップは、アプリのメインコンテンツ上に表示される、任意のHTMLコンテンツを含むポップアップウィンドウです。ポップアップは、他のすべてのオーバーレイと同様に、いわゆる「一時ビュー」の一部です。
ポップアップ React コンポーネントは、ポップアップコンポーネントを表します。
ポップアップコンポーネント
以下のコンポーネントが含まれています
Popup
- ポップアップ要素
ポップアップのプロパティ
プロパティ | タイプ | 説明 |
---|---|---|
<Popup> プロパティ | ||
tabletFullscreen | boolean | タブレットでポップアップをフルスクリーンで表示するかどうかを定義します |
opened | boolean | boolean |
ポップアップを開閉し、初期状態を設定できます | boolean | backdrop |
boolean | ポップアップの背景(背後にある暗い半透明レイヤー)を有効にします。デフォルトでは、同じアプリパラメータ値(`true`)を継承します backdropEl | string |
object | boolean | カスタム背景要素のHTML要素または文字列CSSセレクター |
backdropUnique | boolean | boolean |
有効にすると、このモーダル専用の固有の背景要素が作成されます | boolean | closeByBackdropClick |
boolean | boolean | 有効にすると、背景をクリックするとポップアップが閉じます。デフォルトでは、同じアプリパラメータ値(`true`)を継承します |
closeOnEscape | boolean ポップアップの背景(背後にある暗い半透明レイヤー)を有効にします。デフォルトでは、同じアプリパラメータ値(`true`)を継承します | boolean |
有効にすると、ESCキーボードキーを押すとポップアップが閉じます | animate ポップアップの背景(背後にある暗い半透明レイヤー)を有効にします。デフォルトでは、同じアプリパラメータ値(`true`)を継承します | boolean |
ポップアップをアニメーションで開閉するかどうか。 `.open()`および`.close()`メソッドで上書きできます。デフォルトでは、同じアプリパラメータ値(`true`)を継承します | boolean | swipeToClose |
boolean | 'to-top' | 'to-bottom' | animate ポップアップの背景(背後にある暗い半透明レイヤー)を有効にします。デフォルトでは、同じアプリパラメータ値(`true`)を継承します | スワイプジェスチャーでポップアップを閉じることができるかどうか。 `true`の場合、ポップアップを上下にスワイプして閉じることができます。 `to-top`(文字列)の場合、上にスワイプすることによってのみポップアップを閉じることができます。 `to-bottom`(文字列)の場合、下にスワイプすることによってのみポップアップを閉じることができます。 |
swipeHandler
HTMLElement | 説明 |
---|---|
渡されない場合、ポップアップ全体をスワイプして閉じることができます。スワイプターゲットとして使用されるカスタム要素のHTML要素または文字列CSSセレクターをここに渡すことができます。 (`swipeToClose`も有効にする必要があります) | |
push | boolean |
有効にすると、開いたときにビューが後ろにプッシュされます。 上部の安全な領域が設定されている場合にのみ機能します。 Popup要素に `popup-push`クラスを追加することによっても有効にできます。 | containerEl |
any | モーダルをマウントする要素(デフォルトはアプリのルート要素) |
ポップアップイベント | イベント |
<Popup> イベント | popupOpen |
ポップアップが開くアニメーションを開始するときにイベントがトリガーされます | popupOpened |
ポップアップが開くアニメーションを完了した後にイベントがトリガーされます | popupClose |
ポップアップが閉じるアニメーションを開始するときにイベントがトリガーされます | popupClosed |
ポップアップが閉じるアニメーションを完了した後にイベントがトリガーされます
popupSwipeStart
- スワイプして閉じるインタラクションの開始時にイベントがトリガーされます(ユーザーがポップアップのドラッグを開始したとき)
- popupSwipeMove
- スワイプして閉じる移動インタラクションでイベントがトリガーされます
popupSwipeEnd
スワイプして閉じるリリースでイベントがトリガーされます
import React, { useRef, useState } from 'react';
import {
Navbar,
Page,
Popup,
BlockTitle,
Block,
NavRight,
Link,
Button,
View,
f7,
} from 'framework7-react';
export default () => {
const [popupOpened, setPopupOpened] = useState(false);
const popup = useRef(null);
const createPopup = () => {
// Create popup
if (!popup.current) {
popup.current = f7.popup.create({
content: `
<div class="popup">
<div class="page">
<div class="navbar">
<div class="navbar-inner">
<div class="navbar-bg"></div>
<div class="title">Dynamic Popup</div>
<div class="right"><a class="link popup-close">Close</a></div>
</div>
</div>
<div class="page-content">
<div class="block">
<p>This popup was created dynamically</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse faucibus mauris leo, eu bibendum neque congue non. Ut leo mauris, eleifend eu commodo a, egestas ac urna. Maecenas in lacus faucibus, viverra ipsum pulvinar, molestie arcu. Etiam lacinia venenatis dignissim. Suspendisse non nisl semper tellus malesuada suscipit eu et eros. Nulla eu enim quis quam elementum vulputate. Mauris ornare consequat nunc viverra pellentesque. Aenean semper eu massa sit amet aliquam. Integer et neque sed libero mollis elementum at vitae ligula. Vestibulum pharetra sed libero sed porttitor. Suspendisse a faucibus lectus.</p>
</div>
</div>
</div>
</div>
`.trim(),
});
}
// Open it
popup.current.open();
};
const onPageBeforeRemove = () => {
// Destroy popup when page removed
if (popup.current) popup.current.destroy();
};
return (
<Page onPageBeforeRemove={onPageBeforeRemove}>
<Navbar title="Popup"></Navbar>
<Block strongIos outlineIos>
<p>
Popup is a modal window with any HTML content that pops up over App's main content. Popup
as all other overlays is part of so called "Temporary Views".
</p>
<p>
<Button fill popupOpen=".demo-popup">
Open Popup
</Button>
</p>
<p>
<Button fill onClick={() => setPopupOpened(true)}>
Open Via Prop Change
</Button>
</p>
<p>
<Button fill onClick={createPopup}>
Create Dynamic Popup
</Button>
</p>
</Block>
<BlockTitle>Swipe To Close</BlockTitle>
<Block strongIos outlineIos>
<p>Popup can be closed with swipe to top or bottom:</p>
<p>
<Button fill popupOpen=".demo-popup-swipe">
Swipe To Close
</Button>
</p>
<p>
Or it can be closed with swipe on special swipe handler and, for example, only to bottom:
</p>
<p>
<Button fill popupOpen=".demo-popup-swipe-handler">
With Swipe Handler
</Button>
</p>
</Block>
<BlockTitle>Push View</BlockTitle>
<Block strongIos outlineIos>
<p>
Popup can push view behind. By default has effect only when `safe-area-inset-top` is more
than zero (iOS fullscreen webapp or iOS cordova app)
</p>
<p>
<Button fill popupOpen=".demo-popup-push">
Popup Push
</Button>
</p>
</Block>
<Popup
className="demo-popup"
opened={popupOpened}
onPopupClosed={() => setPopupOpened(false)}
>
<Page>
<Navbar title="Popup Title">
<NavRight>
<Link popupClose>Close</Link>
</NavRight>
</Navbar>
<Block>
<p>
Here comes popup. You can put here anything, even independent view with its own
navigation. Also not, that by default popup looks a bit different on iPhone/iPod and
iPad, on iPhone it is fullscreen.
</p>
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse faucibus mauris
leo, eu bibendum neque congue non. Ut leo mauris, eleifend eu commodo a, egestas ac
urna. Maecenas in lacus faucibus, viverra ipsum pulvinar, molestie arcu. Etiam lacinia
venenatis dignissim. Suspendisse non nisl semper tellus malesuada suscipit eu et eros.
Nulla eu enim quis quam elementum vulputate. Mauris ornare consequat nunc viverra
pellentesque. Aenean semper eu massa sit amet aliquam. Integer et neque sed libero
mollis elementum at vitae ligula. Vestibulum pharetra sed libero sed porttitor.
Suspendisse a faucibus lectus.
</p>
<p>
Duis ut mauris sollicitudin, venenatis nisi sed, luctus ligula. Phasellus blandit nisl
ut lorem semper pharetra. Nullam tortor nibh, suscipit in consequat vel, feugiat sed
quam. Nam risus libero, auctor vel tristique ac, malesuada ut ante. Sed molestie, est
in eleifend sagittis, leo tortor ullamcorper erat, at vulputate eros sapien nec
libero. Mauris dapibus laoreet nibh quis bibendum. Fusce dolor sem, suscipit in
iaculis id, pharetra at urna. Pellentesque tempor congue massa quis faucibus.
Vestibulum nunc eros, convallis blandit dui sit amet, gravida adipiscing libero.
</p>
</Block>
</Page>
</Popup>
<Popup push className="demo-popup-push">
<View>
<Page>
<Navbar title="Push Popup" large transparent>
<NavRight>
<Link popupClose>Close</Link>
</NavRight>
</Navbar>
<Block>
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse faucibus mauris
leo, eu bibendum neque congue non. Ut leo mauris, eleifend eu commodo a, egestas ac
urna. Maecenas in lacus faucibus, viverra ipsum pulvinar, molestie arcu. Etiam
lacinia venenatis dignissim. Suspendisse non nisl semper tellus malesuada suscipit
eu et eros. Nulla eu enim quis quam elementum vulputate. Mauris ornare consequat
nunc viverra pellentesque. Aenean semper eu massa sit amet aliquam. Integer et neque
sed libero mollis elementum at vitae ligula. Vestibulum pharetra sed libero sed
porttitor. Suspendisse a faucibus lectus.
</p>
<p>
Duis ut mauris sollicitudin, venenatis nisi sed, luctus ligula. Phasellus blandit
nisl ut lorem semper pharetra. Nullam tortor nibh, suscipit in consequat vel,
feugiat sed quam. Nam risus libero, auctor vel tristique ac, malesuada ut ante. Sed
molestie, est in eleifend sagittis, leo tortor ullamcorper erat, at vulputate eros
sapien nec libero. Mauris dapibus laoreet nibh quis bibendum. Fusce dolor sem,
suscipit in iaculis id, pharetra at urna. Pellentesque tempor congue massa quis
faucibus. Vestibulum nunc eros, convallis blandit dui sit amet, gravida adipiscing
libero.
</p>
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse faucibus mauris
leo, eu bibendum neque congue non. Ut leo mauris, eleifend eu commodo a, egestas ac
urna. Maecenas in lacus faucibus, viverra ipsum pulvinar, molestie arcu. Etiam
lacinia venenatis dignissim. Suspendisse non nisl semper tellus malesuada suscipit
eu et eros. Nulla eu enim quis quam elementum vulputate. Mauris ornare consequat
nunc viverra pellentesque. Aenean semper eu massa sit amet aliquam. Integer et neque
sed libero mollis elementum at vitae ligula. Vestibulum pharetra sed libero sed
porttitor. Suspendisse a faucibus lectus.
</p>
</Block>
</Page>
</View>
</Popup>
<Popup className="demo-popup-swipe" swipeToClose>
<Page>
<Navbar title="Swipe To Close">
<NavRight>
<Link popupClose>Close</Link>
</NavRight>
</Navbar>
<div
style={{ height: '100%' }}
className="display-flex justify-content-center align-items-center"
>
<p>Swipe me up or down</p>
</div>
</Page>
</Popup>
<Popup
className="demo-popup-swipe-handler"
swipeToClose="to-bottom"
swipeHandler=".swipe-handler"
>
<Page>
<div slot="fixed" className="swipe-handler"></div>
<BlockTitle large>Hello!</BlockTitle>
<Block strongIos outlineIos>
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse faucibus mauris
leo, eu bibendum neque congue non. Ut leo mauris, eleifend eu commodo a, egestas ac
urna. Maecenas in lacus faucibus, viverra ipsum pulvinar, molestie arcu. Etiam lacinia
venenatis dignissim. Suspendisse non nisl semper tellus malesuada suscipit eu et eros.
Nulla eu enim quis quam elementum vulputate. Mauris ornare consequat nunc viverra
pellentesque. Aenean semper eu massa sit amet aliquam. Integer et neque sed libero
mollis elementum at vitae ligula. Vestibulum pharetra sed libero sed porttitor.
Suspendisse a faucibus lectus.
</p>
<p>
Duis ut mauris sollicitudin, venenatis nisi sed, luctus ligula. Phasellus blandit nisl
ut lorem semper pharetra. Nullam tortor nibh, suscipit in consequat vel, feugiat sed
quam. Nam risus libero, auctor vel tristique ac, malesuada ut ante. Sed molestie, est
in eleifend sagittis, leo tortor ullamcorper erat, at vulputate eros sapien nec
libero. Mauris dapibus laoreet nibh quis bibendum. Fusce dolor sem, suscipit in
iaculis id, pharetra at urna. Pellentesque tempor congue massa quis faucibus.
Vestibulum nunc eros, convallis blandit dui sit amet, gravida adipiscing libero.
</p>
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse faucibus mauris
leo, eu bibendum neque congue non. Ut leo mauris, eleifend eu commodo a, egestas ac
urna. Maecenas in lacus faucibus, viverra ipsum pulvinar, molestie arcu. Etiam lacinia
venenatis dignissim. Suspendisse non nisl semper tellus malesuada suscipit eu et eros.
Nulla eu enim quis quam elementum vulputate. Mauris ornare consequat nunc viverra
pellentesque. Aenean semper eu massa sit amet aliquam. Integer et neque sed libero
mollis elementum at vitae ligula. Vestibulum pharetra sed libero sed porttitor.
Suspendisse a faucibus lectus.
</p>
<p>
Duis ut mauris sollicitudin, venenatis nisi sed, luctus ligula. Phasellus blandit nisl
ut lorem semper pharetra. Nullam tortor nibh, suscipit in consequat vel, feugiat sed
quam. Nam risus libero, auctor vel tristique ac, malesuada ut ante. Sed molestie, est
in eleifend sagittis, leo tortor ullamcorper erat, at vulputate eros sapien nec
libero. Mauris dapibus laoreet nibh quis bibendum. Fusce dolor sem, suscipit in
iaculis id, pharetra at urna. Pellentesque tempor congue massa quis faucibus.
Vestibulum nunc eros, convallis blandit dui sit amet, gravida adipiscing libero.
</p>
</Block>
</Page>
</Popup>
</Page>
);
};
ポップアップAPIを使用する
`true`または`false`をその`opened`プロパティに渡すことにより