@equinor/fusion-framework-module-event v4.1.1
@equinor/fusion-framework-module-event
This package is meant for dispatching events between modules (siblings) and cross instances (parent|adjunct)
Base on the native node/web js event system, but the dispatcher is
async
for easier handling ofcancelable
events.NOTE that creating a
cancelable
event without awaiting resolution, will not respect thepreventDefault
behavior!
Configuration
const configurator = (config) => {
/** disable propagation of all events */
delete config.event.onBubble
/** pre-handle all events before dispatch */
config.event.onDispatch = (e: FrameworkEvent) => {
if(!allow_event(e)){
e.preventDefault();
}
}
}
Declaring events
import { ModuleEvent } from '@equinor/fusion-framework-module-event';
/** declare event type for code completion */
declare module '@equinor/fusion-framework-module-event' {
interface ModuleEventMap {
'someEvent': FrameworkEvent<FrameworkEventInit<MyDataObject, MySource>>;
}
}
Custom events
import { ModuleEvent } from '@equinor/fusion-framework-module-event';
type CustomFrameworkEventInit = FrameworkEventInit<MyDataObject, MySource>;
class MyCustomEvent extends FrameworkEvent<CustomFrameworkEventInit, 'myCustomEvent'> {
constructor(init: CustomFrameworkEventInit) { /** logic */ }
}
/** declare event type for code completion */
declare module '@equinor/fusion-framework-module-event' {
interface ModuleEventMap {
'myCustomEvent': MyCustomEvent;
}
}
Usage
Handle a single event type
const teardown = modules.event.addEventListener('someEvent', (event) => console.log(event));
// remove event listener
teardown();
Dispatch event
// simple
const event = await modules.event.dispatchEvent(
'myEvent',
{
detail: 'some detail',
canBubble: false,
cancelable: true
}
);
// alternative
const event = new MyCustomFrameworkEvent(
'myCustomEvent',
{
detail: 'some detail',
canBubble: false,
cancelable: true
}
);
await modules.event.dispatchEvent(myEvent);
if(!event.defaultPrevent){
doSomeAction();
}
Subscribe to all events
note that when subscribing to events, it does not allow side-effects, like
preventDefault
andstopPropagation
const subscription = modules.event.subscribe(console.log); subscription.add( modules.event.subscribe({ next: (event) => console.log(event), error: (err) => console.error(err), complete: () => 'event provider disposed' }) ); // when unmount subscription.unsubscribe();
2 months ago
2 months ago
3 months ago
5 months ago
8 months ago
8 months ago
9 months ago
8 months ago
9 months ago
1 year ago
1 year ago
12 months ago
1 year ago
11 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
1 year ago
2 years ago
1 year ago
2 years ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago