Sheet Modal Svelte Component
Sheet Modal is a special overlay type which is similar to Picker/Calendar’s overlay. Such modal allows to create custom picker overlays with custom content.
Sheet Modal Svelte component represents Sheet Modal component.
Sheet Modal Components
There are following components included:
Sheet
- sheet modal element
Sheet Modal Properties
Prop | Type | Description |
---|---|---|
<Sheet> properties | ||
position | string | Sheet position, can be top or bottom . By default is bottom |
top | boolean | Same as position=”top” |
bottom | boolean | Same as position=”bottom” |
backdrop | boolean | Enable to render additional sheet modal backdrop when required |
backdropEl | string object | HTML element or string CSS selector of custom backdrop element |
opened | boolean | Allows to open/close Sheet Modal and set its initial state |
closeByBackdropClick | boolean | When enabled, sheet will be closed on backdrop click. By default inherits same app parameter value |
closeByOutsideClick | boolean | When enabled, sheet will be closed on when click outside of it. By default inherits same app parameter value |
closeOnEscape | boolean | When enabled, sheet will be closed on ESC keyboard key press |
swipeToClose | boolean | Whether the Sheet can be closed with swipe gesture |
swipeToStep | boolean | When enabled it will be possible to split opened sheet into two states: partially opened and fully opened that can be controlled with swipe |
swipeHandler | HTMLElement string | If not passed, then whole Sheet can be swiped to close. You can pass here HTML element or string CSS selector of custom element that will be used as a swipe target. (swipeToClose or swipeToStep must be also enabled) |
push | boolean | When enabled it will push view behind on open. Works only when top safe area is in place. It can also be enabled by adding sheet-modal-push class to Sheet element. |
Sheet Modal Methods
<Sheet> methods | |
---|---|
.open(animate) | Open sheet modal |
.close(animate) | Close sheet modal |
Sheet Modal Events
Event | Description |
---|---|
<Sheet> events | |
sheetOpen | Event will be triggered when Sheet Modal starts its opening animation |
sheetOpened | Event will be triggered after Sheet Modal completes its opening animation |
sheetClose | Event will be triggered when Sheet Modal starts its closing animation |
sheetClosed | Event will be triggered after Sheet Modal completes its closing animation |
sheetStepOpen | Event will be triggered on Sheet swipe step open/expand |
sheetStepClose | Event will be triggered on Sheet swipe step close/collapse |
sheetStepProgress | Event will be triggered on Sheet swipe step between step opened and closed state. As event.detail it receives step open progress number (from 0 to 1 ) |
Open And Close Sheet Modal
You can control Sheet Modal state, open and closing it:
- using its Sheet Modal API
- by passing
true
orfalse
to itsopened
prop - by clicking on Link or Button with relevant
sheetOpen
property (to open it) andsheetClose
property to close it
Access To Sheet Modal Instance
You can access Sheet Modal initialized instance by calling .instance()
component’s method. For example:
<Sheet bind:this={component}>...</Sheet>
<script>
let component;
// to get instance in some method
component.instance()
</script>
Examples
<Page onPageBeforeOut={onPageBeforeOut} onPageBeforeRemove={onPageBeforeRemove}>
<Navbar title="Sheet Modal"></Navbar>
<Block>
<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>
<Button fill sheetOpen=".demo-sheet">Open Sheet</Button>
</p>
<p>
<Button fill onClick={createSheet}>Create Dynamic Sheet</Button>
</p>
<p>
<Button fill onClick={() => sheetOpened = true}>Open Via Prop Change</Button>
</p>
<p>
<Button fill sheetOpen=".demo-sheet-swipe-to-close">Swipe To Close</Button>
</p>
<p>
<Button fill sheetOpen=".demo-sheet-swipe-to-step">Swipe To Step</Button>
</p>
<p>
<Button fill sheetOpen=".demo-sheet-push">Sheet Push</Button>
</p>
</Block>
<Sheet class="demo-sheet" opened={sheetOpened} onSheetClosed={() => sheetOpened = false}>
<Toolbar>
<div class="left"></div>
<div class="right">
<Link sheetClose>Close</Link>
</div>
</Toolbar>
<!-- Scrollable sheet content -->
<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; --f7-sheet-bg-color: #fff"
swipeToClose
backdrop
>
<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; --f7-sheet-bg-color: #fff"
swipeToClose
swipeToStep
backdrop
>
<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 noHairlines>
<ListItem title="Item 1">
<b slot="after" class="text-color-black">$200</b>
</ListItem>
<ListItem title="Item 2">
<b slot="after" class="text-color-black">$180</b>
</ListItem>
<ListItem title="Delivery">
<b slot="after" class="text-color-black">$120</b>
</ListItem>
</List>
</Sheet>
<Sheet class="demo-sheet-push" push>
<Toolbar>
<div class="left"></div>
<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>
</Page>
<script>
import {f7, Page, Navbar, Block, Button, Sheet, Toolbar, Link, PageContent, BlockTitle, List, ListItem} from 'framework7-svelte';
let sheetOpened = false;
let sheet;
function createSheet() {
// Create sheet modal
if (!sheet) {
sheet = f7.sheet.create({
content: `
<div class="sheet-modal">
<div class="toolbar">
<div class="toolbar-inner justify-content-flex-end">
<a href="#" 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 (f7.$('.demo-sheet.modal-in').length > 0) f7.sheet.close('.demo-sheet');
// Open it
sheet.open();
}
function onPageBeforeOut() {
// Close opened sheets on page out
f7.sheet.close();
}
function onPageBeforeRemove() {
// Destroy sheet modal when page removed
if (sheet) sheet.destroy();
}
</script>
当前内容版权归 Framework7 或其关联方所有,如需对内容或内容相关联开源项目进行关注与资助,请访问 Framework7 .