This is a plugin that only has a peer dependency to piral-core
. What piral-modals
brings to the table is a set of Pilet API extensions that can be used with piral
or piral-core
to easily trigger the display of modal dialogs from pilets.
Documentation
The following functions are brought to the Pilet API.
registerModal()
Adds a modal dialog definition to the app shell. Can be called from any pilet using the specified name.
unregisterModal()
Removes a modal dialog definition from the app shell.
showModal()
Shows the modal dialog registered with the provided name.
Does not open in case no modal dialog using the provided name is available (i.e., registered in the app shell).
Usage
For authors of pilets
You can use the showModal
function from the Pilet API to show a modal dialog registered by any pilet. In case of a naming conflict the dialogs from the current pilet are preferred.
Example use:
import { PiletApi } from '<name-of-piral-instance>';
export function setup(piral: PiletApi) {
piral.showModal('my-modal', {
someValue: 42,
});
}
You can use the registerModal
function from the Pilet API to add a new modal dialog in the app shell.
Example use:
import { PiletApi } from '<name-of-piral-instance>';
import { MyModal } from './MyModal';
export function setup(piral: PiletApi) {
piral.registerModal('my-modal', MyModal);
}
You can use the unregisterModal
function from the Pilet API to remove a previously added modal dialog from the app shell.
Example use:
import { PiletApi } from '<name-of-piral-instance>';
export function setup(piral: PiletApi) {
piral.unregisterModal('my-modal');
}
Setup and Bootstrapping
For Piral instance developers
The provided library only brings API extensions for pilets to a Piral instance.
For the setup of the library itself you'll need to import createModalsApi
from the piral-modals
package.
import { createModalsApi } from 'piral-modals';
The integration looks like:
const instance = createInstance({
extendApi: [createModalsApi()],
});
Via the options the globally available dialogs
can be defined.
For example:
const instance = createInstance({
extendApi: [createModalsApi({
dialogs: [
{
name: 'userinfo',
component: UserInfoModal,
},
],
})],
});
License
Piral is released using the MIT license. For more information see the license file.