Sheet Modal Svelteコンポーネント
Sheet Modalは、Picker/Calendarのオーバーレイと同様の特殊なオーバーレイタイプです。このモーダルを使用すると、カスタムコンテンツを持つカスタムピッカーオーバーレイを作成できます。
Sheet Modal Svelteコンポーネントは、Sheet Modalコンポーネントを表します。
Sheet Modalコンポーネント
次のコンポーネントが含まれています。
Sheet
- シートモーダル要素
Sheet Modalプロパティ
プロパティ | タイプ | 説明 |
---|---|---|
<Sheet> プロパティ | ||
position | 文字列 | シートの位置。top またはbottom を指定できます。デフォルトはbottom です。 |
top | ブール値 | position="top" と同じです。 |
bottom | ブール値 | position="bottom" と同じです。 |
backdrop | ブール値 | 必要に応じて、追加のシートモーダルバックドロップをレンダリングできるようにします。 |
backdropEl | 文字列 オブジェクト | カスタムバックドロップ要素のHTML要素または文字列CSSセレクター |
backdropUnique | ブール値 | 有効にすると、このモーダル専用のユニークなバックドロップ要素が作成されます。 |
opened | ブール値 | Sheet Modalを開閉し、初期状態を設定できます。 |
closeByBackdropClick | ブール値 | 有効にすると、バックドロップをクリックしたときにシートが閉じます。デフォルトでは、同じアプリパラメータ値を継承します。 |
closeByOutsideClick | ブール値 | 有効にすると、シートの外側をクリックしたときにシートが閉じます。デフォルトでは、同じアプリパラメータ値を継承します。 |
closeOnEscape | ブール値 | 有効にすると、ESCキーを押したときにシートが閉じます。 |
swipeToClose | ブール値 | スワイプジェスチャーでシートを閉じることができるかどうか。 |
swipeToStep | ブール値 | 有効にすると、開いているシートを部分的に開いている状態と完全に開いている状態の2つの状態に分割できます。スワイプで制御できます。 |
swipeHandler | HTMLElement 文字列 | 渡されない場合、シート全体をスワイプして閉じることができます。スワイプターゲットとして使用されるHTML要素またはカスタム要素の文字列CSSセレクターを渡すことができます。(swipeToClose またはswipeToStep も有効にする必要があります) |
push | ブール値 | 有効にすると、開いているときに背後のビューをプッシュします。トップセーフエリアが配置されている場合にのみ機能します。Sheet要素にsheet-modal-push クラスを追加することによっても有効にできます。 |
breakpoints | number[] | swipeToStep の代わりに使用して、スワイプブレークポイントを有効にします。0が完全に閉じている状態、1が完全に開いている状態である0より大きく1より小さい数値の配列である必要があります。例:[0.33, 0.66] 、[0.5] など。 |
backdropBreakpoint | number | バックドロップが表示されるブレークポイントを定義します。0 (理想的にはbreakpoints 配列の最小値(最初の値))から1 (デフォルト0)の数値。 |
pushBreakpoint | number | 背後のビューをプッシュするブレークポイントを定義します(push を有効にする必要があります)。0 (理想的にはbreakpoints 配列の最小値(最初の値))から1 (デフォルト0)の数値。 |
animate | ブール値 | モーダルをアニメーション付きで開閉するかどうか。 |
containerEl | HTMLElement 文字列 | モーダルをマウントする要素(デフォルトはアプリのルート要素) |
Sheet Modalイベント
イベント | 説明 |
---|---|
<Sheet> イベント | |
sheetOpen | Sheet Modalが開くアニメーションを開始するとトリガーされます。 |
sheetOpened | Sheet Modalが開くアニメーションが完了するとトリガーされます。 |
sheetClose | Sheet Modalが閉じるアニメーションを開始するとトリガーされます。 |
sheetClosed | Sheet Modalが閉じるアニメーションが完了するとトリガーされます。 |
sheetStepOpen | シートのスワイプステップを開いたり展開したりするとトリガーされます。 |
sheetStepClose | シートのスワイプステップを閉じたり折りたたんだりするとトリガーされます。 |
sheetStepProgress | シートのスワイプステップがステップを開いている状態と閉じている状態の間でトリガーされます。第2引数として、ステップオープン進捗数値(0 から1 )を受け取ります。 |
sheetBreakpoint | シートのブレークポイントが変更されるとトリガーされます。第2引数として、現在のブレークポイント(0 から1 )を受け取ります。 |
Sheet Modalスロット
<Sheet>
コンポーネントには、カスタム要素用の追加スロットがあります。
default
- 要素はスクロール可能な<div class="sheet-modal-inner">
要素の子として挿入されます。static
-default
と同じです。fixed
- 要素はスクロール可能な<div class="sheet-modal-inner">
要素の前に挿入されます。
<Sheet>
<span slot="fixed">Fixed slot</span>
<span slot="static">Static slot</span>
<span>Default slot</span>
</Sheet>
レンダリング先
<div class="sheet-modal">
<span>Fixed slot</span>
<div class="sheet-modal-inner">
<span>Default slot</span>
<span>Static slot</span>
</div>
</div>
Sheet Modalを開閉する
Sheet Modalの状態を制御し、開閉できます。
- Sheet Modal API を使用して
opened
プロパティにtrue
またはfalse
を渡すことによって- 関連する
sheetOpen
プロパティを持つリンクまたはボタンをクリックすることによって(開くため)そしてそれを閉じるためにsheetClose
プロパティを使用することによって
Sheet Modalインスタンスへのアクセス
.instance()
コンポーネントのメソッドを呼び出すことで、初期化されたSheet Modalインスタンスにアクセスできます。例:
<Sheet bind:this={component}>...</Sheet>
<script>
let component;
// to get instance in some method
component.instance()
</script>
例
sheet-modal.svelte
<script>
import {
f7,
Page,
Navbar,
Sheet,
PageContent,
Toolbar,
BlockTitle,
Block,
Button,
Link,
List,
ListItem,
} from 'framework7-svelte';
let sheetOpened = false;
let dynamicSheet;
function toggleSwipeStep() {
f7.sheet.stepToggle('.demo-sheet-swipe-to-step');
}
function createSheet() {
const $ = f7.$;
// Create sheet modal
if (!dynamicSheet) {
dynamicSheet = f7.sheet.create({
content: `
<div class="sheet-modal sheet-modal-bottom">
<div class="toolbar">
<div class="toolbar-inner justify-content-flex-end">
<a class="link sheet-close">Close</a>
</div>
</div>
<div class="sheet-modal-inner">
<div class="page-content">
<div class="block">
<p>This sheet modal 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(),
});
}
// Close inline sheet
if ($('.demo-sheet.modal-in').length > 0) f7.sheet.close('.demo-sheet');
// Open it
dynamicSheet.open();
}
function onPageBeforeOut() {
// Close opened sheets on page out
f7.sheet.close();
}
function onPageBeforeRemove() {
// Destroy sheet modal when page removed
if (dynamicSheet) dynamicSheet.destroy();
}
</script>
<Page {onPageBeforeOut} {onPageBeforeRemove}>
<Navbar title="Sheet Modal" />
<Block strongIos outlineIos>
<p>
Sheet Modals slide up from the bottom of the screen to reveal more content. Such modals allow
to create custom overlays with custom content.
</p>
<p class="grid grid-cols-2 grid-gap">
<Button fill sheetOpen=".demo-sheet">Open Sheet</Button>
<Button fill onClick={createSheet}>Dynamic Sheet</Button>
</p>
<p>
<Button fill sheetOpen=".demo-sheet-top">Top Sheet</Button>
</p>
<p>
<Button fill onClick={() => (sheetOpened = true)}>Open Via Prop Change</Button>
</p>
</Block>
<BlockTitle>Push View</BlockTitle>
<Block strongIos outlineIos>
<p>
Sheet can push view behind on open. By default it has effect only when `safe-area-inset-top`
is more than zero (iOS fullscreen webapp or iOS cordova app)
</p>
<p>
<Button fill sheetOpen=".demo-sheet-push">Sheet Push</Button>
</p>
</Block>
<BlockTitle>Swipeable Sheet</BlockTitle>
<Block strongIos outlineIos>
<p>
Sheet modal can be closed with swipe to top (for top Sheet) or bottom (for default Bottom
sheet):
</p>
<p>
<Button fill sheetOpen=".demo-sheet-swipe-to-close">Swipe To Close</Button>
</p>
<p>Also there is swipe-step that can be set on Sheet modal to expand it with swipe:</p>
<p>
<Button fill sheetOpen=".demo-sheet-swipe-to-step">Swipe To Step</Button>
</p>
<p>In addition to "swipe step" there is a support for position breakpoints (multiple steps):</p>
<p>
<Button fill sheetOpen=".demo-sheet-breakpoints">Breakpoints</Button>
</p>
</Block>
<Sheet class="demo-sheet" opened={sheetOpened} onSheetClosed={() => (sheetOpened = false)}>
<Toolbar>
<div class="left" />
<div class="right">
<Link sheetClose>Close</Link>
</div>
</Toolbar>
<PageContent>
<Block>
<p>
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quae ducimus dolorum ipsa
aliquid accusamus perferendis laboriosam delectus numquam minima animi, libero illo in
tempora harum sequi corporis alias ex adipisci.
</p>
<p>
Sunt magni enim saepe quasi aspernatur delectus consectetur fugiat necessitatibus qui sed,
similique quis facere tempora, laudantium quae expedita ea, aperiam dolores. Aut deserunt
soluta alias magnam. Consequatur, nisi, enim.
</p>
<p>
Eaque maiores ducimus, impedit unde culpa qui, explicabo accusamus, non vero corporis
voluptatibus similique odit ab. Quaerat quasi consectetur quidem libero? Repudiandae
adipisci vel voluptatum, autem libero minus dignissimos repellat.
</p>
<p>
Iusto, est corrupti! Totam minus voluptas natus esse possimus nobis, delectus veniam
expedita sapiente ut cum reprehenderit aliquid odio amet praesentium vero temporibus
obcaecati beatae aspernatur incidunt, perferendis voluptates doloribus?
</p>
<p>
Illum id laborum tempore, doloribus culpa labore ex iusto odit. Quibusdam consequuntur
totam nam obcaecati, enim cumque nobis, accusamus, quos voluptates, voluptatibus sapiente
repellendus nesciunt praesentium velit ipsa illo iusto.
</p>
</Block>
</PageContent>
</Sheet>
<Sheet top class="demo-sheet-top">
<Toolbar bottom>
<div class="left" />
<div class="right">
<Link sheetClose>Close</Link>
</div>
</Toolbar>
<PageContent>
<Block>
<p>
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quae ducimus dolorum ipsa
aliquid accusamus perferendis laboriosam delectus numquam minima animi, libero illo in
tempora harum sequi corporis alias ex adipisci.
</p>
<p>
Sunt magni enim saepe quasi aspernatur delectus consectetur fugiat necessitatibus qui sed,
similique quis facere tempora, laudantium quae expedita ea, aperiam dolores. Aut deserunt
soluta alias magnam. Consequatur, nisi, enim.
</p>
<p>
Eaque maiores ducimus, impedit unde culpa qui, explicabo accusamus, non vero corporis
voluptatibus similique odit ab. Quaerat quasi consectetur quidem libero? Repudiandae
adipisci vel voluptatum, autem libero minus dignissimos repellat.
</p>
<p>
Iusto, est corrupti! Totam minus voluptas natus esse possimus nobis, delectus veniam
expedita sapiente ut cum reprehenderit aliquid odio amet praesentium vero temporibus
obcaecati beatae aspernatur incidunt, perferendis voluptates doloribus?
</p>
<p>
Illum id laborum tempore, doloribus culpa labore ex iusto odit. Quibusdam consequuntur
totam nam obcaecati, enim cumque nobis, accusamus, quos voluptates, voluptatibus sapiente
repellendus nesciunt praesentium velit ipsa illo iusto.
</p>
</Block>
</PageContent>
</Sheet>
<Sheet class="demo-sheet-push" push>
<Toolbar>
<div class="left" />
<div class="right">
<Link sheetClose>Close</Link>
</div>
</Toolbar>
<PageContent>
<Block>
<p>
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quae ducimus dolorum ipsa
aliquid accusamus perferendis laboriosam delectus numquam minima animi, libero illo in
tempora harum sequi corporis alias ex adipisci.
</p>
<p>
Sunt magni enim saepe quasi aspernatur delectus consectetur fugiat necessitatibus qui sed,
similique quis facere tempora, laudantium quae expedita ea, aperiam dolores. Aut deserunt
soluta alias magnam. Consequatur, nisi, enim.
</p>
<p>
Eaque maiores ducimus, impedit unde culpa qui, explicabo accusamus, non vero corporis
voluptatibus similique odit ab. Quaerat quasi consectetur quidem libero? Repudiandae
adipisci vel voluptatum, autem libero minus dignissimos repellat.
</p>
<p>
Iusto, est corrupti! Totam minus voluptas natus esse possimus nobis, delectus veniam
expedita sapiente ut cum reprehenderit aliquid odio amet praesentium vero temporibus
obcaecati beatae aspernatur incidunt, perferendis voluptates doloribus?
</p>
<p>
Illum id laborum tempore, doloribus culpa labore ex iusto odit. Quibusdam consequuntur
totam nam obcaecati, enim cumque nobis, accusamus, quos voluptates, voluptatibus sapiente
repellendus nesciunt praesentium velit ipsa illo iusto.
</p>
</Block>
</PageContent>
</Sheet>
<Sheet class="demo-sheet-swipe-to-close" style="height: auto" swipeToClose push backdrop>
<div class="swipe-handler" />
<PageContent>
<BlockTitle large>Hello!</BlockTitle>
<Block>
<p>
Eaque maiores ducimus, impedit unde culpa qui, explicabo accusamus, non vero corporis
voluptatibus similique odit ab. Quaerat quasi consectetur quidem libero? Repudiandae
adipisci vel voluptatum, autem libero minus dignissimos repellat.
</p>
<p>
Iusto, est corrupti! Totam minus voluptas natus esse possimus nobis, delectus veniam
expedita sapiente ut cum reprehenderit aliquid odio amet praesentium vero temporibus
obcaecati beatae aspernatur incidunt, perferendis voluptates doloribus?
</p>
</Block>
</PageContent>
</Sheet>
<Sheet
class="demo-sheet-swipe-to-step"
style="height: auto"
swipeToClose
swipeToStep
push
backdrop
>
<div class="swipe-handler" on:click={() => toggleSwipeStep()} />
<div class="sheet-modal-swipe-step">
<div class="display-flex padding justify-content-space-between align-items-center">
<div style="font-size: 18px"><b>Total:</b></div>
<div style="font-size: 22px"><b>$500</b></div>
</div>
<div class="padding-horizontal padding-bottom">
<Button large fill>Make Payment</Button>
<div class="margin-top text-align-center">Swipe up for more details</div>
</div>
</div>
<BlockTitle medium class="margin-top">Your order:</BlockTitle>
<List>
<ListItem title="Item 1"><b slot="after">$200</b></ListItem>
<ListItem title="Item 2"><b slot="after">$180</b></ListItem>
<ListItem title="Delivery"><b slot="after">$120</b></ListItem>
</List>
</Sheet>
<Sheet
class="demo-sheet-breakpoints"
style="height: auto"
swipeToClose
breakpoints={[0.33, 0.66]}
backdrop
backdropBreakpoint={0.66}
push
pushBreakpoint={0.66}
>
<div class="swipe-handler" style="background-color: transparent;" />
<div style="display: flex; align-items: center; justify-content: center; height: 20vh;">
Section 1
</div>
<div style="display: flex; align-items: center; justify-content: center; height: 20vh;">
Section 2
</div>
<div style="display: flex; align-items: center; justify-content: center; height: 20vh;">
Section 3
</div>
</Sheet>
</Page>