Simple modal system for Svelte
npm install svelte-modal-system
<!-- App.svelte -->
<script>
import { openModal } from 'svelte-modal-system';
import MyModalComponent from 'MyModalComponent.svelte';
function openNewModal() {
const modalRef = openModal(MyModalComponent, { width: '200px', height: '400px' }, { name: 'my modal name property' });
modalRef.onClose((result?: any) => {
console.log("Modal was closed and here's the result:", result);
});
}
</script>
<button on:click="{openNewModal}">Open modal</button>
<!-- MyModalCompnent.svelte -->
<script>
export let name = '';
</script>
<div>{name}</div>
To open a modal window, use openModal(component: any, modalOptions?: ModalOptions, componentProps?: any)
function, provide it a component to render inside the modal, some options (if you want to change anything beyond the defaults) and an object of component properties that will be passed to the component, rendered inside the modal.
Notes:
body
All of these are optional.
| Option | Type | Default value | Description |
|-------------------------|---------|---------------|---------------------------------------------------------------------------------------------------------------------------|
| width | string | 600px | Any value that css property width
supports (50%, fit-content, auto, 100vw, etc.) |
| height | string | 500px | Any value that css property height
supports (50%, fit-content, auto, 100vh, etc.) |
| customWindowClass | string | Escape
|
| closeOnOutsideClick | boolean | true | Whether to allow closing the modal by clicking outside it. |
You can easily provide the properties for your modal component by passing in an object to openModal
function.
const componentProps = {
propName1: 'propValue1',
propName2: 'propValue2',
propName3: { ... },
propName4: 20,
};
openModal(component, modalOptions, componentProps);
Sometimes you would like to know when the modal is closed and do something at that specific moment. For that, openModal()
function returns an instance of a ModalRef
which has a method onClose
where you can provide a callback to call when the modal closes. When the modal closes, you can optionally get some values from it. By default, when the modal closes it doesn't return anything. More often than not, a modal has a button that closes that modal. To enable such a scenario, this modal system provides a function closeActiveModal()
that closes the opened modal. You can also provide a value to be sent to the onClose callback when you call this function.
<!-- MyModalCompnent.svelte -->
<script>
import { closeActiveModal } from 'svelte-modal-system';
let value = '';
function submit() {
closeActiveModal(value);
}
</script>
<input type="text" bind:value>
<button on:click="{submit}">Submit</button>
š¤ Vidmantas Luneckas
Contributions, issues and feature requests are welcome!
Feel free to check issues page. You can also take a look at the contributing guide.
Give a āļø if this project helped you!
Copyright Ā© 2021 Vidmantas Luneckas.
This project is MIT licensed.
This README was generated with ā¤ļø by readme-md-generator