2023-04-06 16:56:41 +00:00
|
|
|
// import { PartialObserver, Subject, Subscription } from 'rxjs';
|
2023-03-31 12:54:15 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Use in components with the `@Output` directive to emit custom events
|
|
|
|
* synchronously or asynchronously, and register handlers for those events
|
|
|
|
* by subscribing to an instance.
|
|
|
|
*
|
|
|
|
* @usageNotes
|
|
|
|
*
|
|
|
|
* Extends
|
|
|
|
* [RxJS `Subject`](https://rxjs.dev/api/index/class/Subject)
|
|
|
|
* for Angular by adding the `emit()` method.
|
|
|
|
*
|
|
|
|
* In the following example, a component defines two output properties
|
|
|
|
* that create event emitters. When the title is clicked, the emitter
|
|
|
|
* emits an open or close event to toggle the current visibility state.
|
|
|
|
*
|
|
|
|
* ```html
|
|
|
|
* @Component({
|
|
|
|
* selector: 'zippy',
|
|
|
|
* template: `
|
|
|
|
* <div class="zippy">
|
|
|
|
* <div (click)="toggle()">Toggle</div>
|
|
|
|
* <div [hidden]="!visible">
|
|
|
|
* <ng-content></ng-content>
|
|
|
|
* </div>
|
|
|
|
* </div>`})
|
|
|
|
* export class Zippy {
|
|
|
|
* visible: boolean = true;
|
|
|
|
* @Output() open: EventEmitter<any> = new EventEmitter();
|
|
|
|
* @Output() close: EventEmitter<any> = new EventEmitter();
|
|
|
|
*
|
|
|
|
* toggle() {
|
|
|
|
* this.visible = !this.visible;
|
|
|
|
* if (this.visible) {
|
|
|
|
* this.open.emit(null);
|
|
|
|
* } else {
|
|
|
|
* this.close.emit(null);
|
|
|
|
* }
|
|
|
|
* }
|
|
|
|
* }
|
|
|
|
* ```
|
|
|
|
*
|
|
|
|
* Access the event object with the `$event` argument passed to the output event
|
|
|
|
* handler:
|
|
|
|
*
|
|
|
|
* ```html
|
|
|
|
* <zippy (open)="onOpen($event)" (close)="onClose($event)"></zippy>
|
|
|
|
* ```
|
|
|
|
*
|
|
|
|
* @see [Observables in Angular](guide/observables-in-angular)
|
|
|
|
* @publicApi
|
|
|
|
*/
|
2023-04-06 16:56:41 +00:00
|
|
|
// export interface EventEmitter<T> extends Subject<T> {
|
|
|
|
// /**
|
|
|
|
// * @internal
|
|
|
|
// */
|
|
|
|
// __isAsync: boolean;
|
|
|
|
|
|
|
|
// /**
|
|
|
|
// * Creates an instance of this class that can
|
|
|
|
// * deliver events synchronously or asynchronously.
|
|
|
|
// *
|
|
|
|
// * @param [isAsync=false] When true, deliver events asynchronously.
|
|
|
|
// *
|
|
|
|
// */
|
|
|
|
// new(isAsync?: boolean): EventEmitter<T>;
|
|
|
|
|
|
|
|
// /**
|
|
|
|
// * Emits an event containing a given value.
|
|
|
|
// * @param value The value to emit.
|
|
|
|
// */
|
|
|
|
// emit(value?: T): void;
|
|
|
|
|
|
|
|
// /**
|
|
|
|
// * Registers handlers for events emitted by this instance.
|
|
|
|
// * @param next When supplied, a custom handler for emitted events.
|
|
|
|
// * @param error When supplied, a custom handler for an error notification from this emitter.
|
|
|
|
// * @param complete When supplied, a custom handler for a completion notification from this
|
|
|
|
// * emitter.
|
|
|
|
// */
|
|
|
|
// subscribe(next?: (value: T) => void, error?: (error: any) => void, complete?: () => void):
|
|
|
|
// Subscription;
|
|
|
|
// /**
|
|
|
|
// * Registers handlers for events emitted by this instance.
|
|
|
|
// * @param observerOrNext When supplied, a custom handler for emitted events, or an observer
|
|
|
|
// * object.
|
|
|
|
// * @param error When supplied, a custom handler for an error notification from this emitter.
|
|
|
|
// * @param complete When supplied, a custom handler for a completion notification from this
|
|
|
|
// * emitter.
|
|
|
|
// */
|
|
|
|
// subscribe(observerOrNext?: any, error?: any, complete?: any): Subscription;
|
|
|
|
// }
|
|
|
|
|
|
|
|
// class EventEmitter_ extends Subject<any> {
|
|
|
|
// __isAsync: boolean; // tslint:disable-line
|
|
|
|
|
|
|
|
// constructor(isAsync: boolean = false) {
|
|
|
|
// super();
|
|
|
|
// this.__isAsync = isAsync;
|
|
|
|
// }
|
|
|
|
|
|
|
|
// emit(value?: any) {
|
|
|
|
// super.next(value);
|
|
|
|
// }
|
|
|
|
|
|
|
|
// override subscribe(observerOrNext?: any, error?: any, complete?: any): Subscription {
|
|
|
|
// let nextFn = observerOrNext;
|
|
|
|
// let errorFn = error || (() => null);
|
|
|
|
// let completeFn = complete;
|
|
|
|
|
|
|
|
// if (observerOrNext && typeof observerOrNext === 'object') {
|
|
|
|
// const observer = observerOrNext as PartialObserver<unknown>;
|
|
|
|
// nextFn = observer.next?.bind(observer);
|
|
|
|
// errorFn = observer.error?.bind(observer);
|
|
|
|
// completeFn = observer.complete?.bind(observer);
|
|
|
|
// }
|
|
|
|
|
|
|
|
// if (this.__isAsync) {
|
|
|
|
// errorFn = _wrapInTimeout(errorFn);
|
|
|
|
|
|
|
|
// if (nextFn) {
|
|
|
|
// nextFn = _wrapInTimeout(nextFn);
|
|
|
|
// }
|
|
|
|
|
|
|
|
// if (completeFn) {
|
|
|
|
// completeFn = _wrapInTimeout(completeFn);
|
|
|
|
// }
|
|
|
|
// }
|
|
|
|
|
|
|
|
// const sink = super.subscribe({next: nextFn, error: errorFn, complete: completeFn});
|
|
|
|
|
|
|
|
// if (observerOrNext instanceof Subscription) {
|
|
|
|
// observerOrNext.add(sink);
|
|
|
|
// }
|
|
|
|
|
|
|
|
// return sink;
|
|
|
|
// }
|
|
|
|
// }
|
|
|
|
|
|
|
|
// function _wrapInTimeout(fn: (value: unknown) => any) {
|
|
|
|
// return (value: unknown) => {
|
|
|
|
// setTimeout(fn, undefined, value);
|
|
|
|
// };
|
|
|
|
// }
|
|
|
|
|
|
|
|
// /**
|
|
|
|
// * @publicApi
|
|
|
|
// */
|
|
|
|
// export const EventEmitter: {
|
|
|
|
// new (isAsync?: boolean): EventEmitter<any>; new<T>(isAsync?: boolean): EventEmitter<T>;
|
|
|
|
// readonly prototype: EventEmitter<any>;
|
|
|
|
// } = EventEmitter_ as any;
|
|
|
|
|
|
|
|
export interface Listener<T> {
|
|
|
|
(event: T): any;
|
2023-03-31 12:54:15 +00:00
|
|
|
}
|
|
|
|
|
2023-04-06 16:56:41 +00:00
|
|
|
export interface Disposable {
|
|
|
|
dispose();
|
2023-03-31 12:54:15 +00:00
|
|
|
}
|
|
|
|
|
2023-04-06 16:56:41 +00:00
|
|
|
/** passes through events as they happen. You will not get events from before you start listening */
|
|
|
|
export class EventEmitter<T> {
|
|
|
|
private listeners: Listener<T>[] = [];
|
|
|
|
private listenersOncer: Listener<T>[] = [];
|
|
|
|
|
2023-07-17 17:13:30 +00:00
|
|
|
public on = (listener: Listener<T>): Disposable => {
|
2023-04-06 16:56:41 +00:00
|
|
|
this.listeners.push(listener);
|
|
|
|
return {
|
|
|
|
dispose: () => this.off(listener),
|
|
|
|
};
|
|
|
|
};
|
|
|
|
|
2023-07-17 17:13:30 +00:00
|
|
|
public once = (listener: Listener<T>): void => {
|
2023-04-06 16:56:41 +00:00
|
|
|
this.listenersOncer.push(listener);
|
|
|
|
};
|
|
|
|
|
2023-07-17 17:13:30 +00:00
|
|
|
public off = (listener: Listener<T>) => {
|
2023-04-06 16:56:41 +00:00
|
|
|
var callbackIndex = this.listeners.indexOf(listener);
|
|
|
|
if (callbackIndex > -1) this.listeners.splice(callbackIndex, 1);
|
|
|
|
};
|
|
|
|
|
2023-07-17 17:13:30 +00:00
|
|
|
public emit = (event: T) => {
|
2023-04-06 16:56:41 +00:00
|
|
|
/** Update any general listeners */
|
|
|
|
this.listeners.forEach((listener) => listener(event));
|
|
|
|
|
|
|
|
/** Clear the `once` queue */
|
|
|
|
if (this.listenersOncer.length > 0) {
|
|
|
|
const toCall = this.listenersOncer;
|
|
|
|
this.listenersOncer = [];
|
|
|
|
toCall.forEach((listener) => listener(event));
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2023-07-17 17:13:30 +00:00
|
|
|
public pipe = (te: EventEmitter<T>): Disposable => {
|
2023-04-06 16:56:41 +00:00
|
|
|
return this.on((e) => te.emit(e));
|
|
|
|
};
|
2023-03-31 12:54:15 +00:00
|
|
|
}
|