import { Directive, ElementRef, EventEmitter, Input, OnDestroy, OnInit, Output, Renderer2, TemplateRef, ViewContainerRef } from '@angular/core'; import { PopoverConfig } from './popover.config'; import { ComponentLoader, ComponentLoaderFactory } from 'ngx-bootstrap/component-loader'; import { PopoverContainerComponent } from './popover-container.component'; import { PositioningService, AvailbleBSPositions } from 'ngx-bootstrap/positioning'; import { timer } from 'rxjs'; import { parseTriggers, Trigger } from 'ngx-bootstrap/utils'; let id = 0; /** * A lightweight, extensible directive for fancy popover creation. */ @Directive({selector: '[popover]', exportAs: 'bs-popover'}) export class PopoverDirective implements OnInit, OnDestroy { /** unique id popover - use for aria-describedby */ popoverId = id++; /** sets disable adaptive position */ @Input() adaptivePosition = true; @Input() boundariesElement?: ('viewport' | 'scrollParent' | 'window'); /** * Content to be displayed as popover. */ // eslint-disable-next-line @typescript-eslint/no-explicit-any @Input() popover?: string | TemplateRef; /** * Context to be used if popover is a template. */ // eslint-disable-next-line @typescript-eslint/no-explicit-any @Input() popoverContext: any; /** * Title of a popover. */ @Input() popoverTitle?: string; /** * Placement of a popover. Accepts: "top", "bottom", "left", "right" */ @Input() placement: AvailbleBSPositions = 'top'; /** * Close popover on outside click */ @Input() outsideClick = false; /** * Specifies events that should trigger. Supports a space separated list of * event names. */ @Input() triggers = 'click'; /** * A selector specifying the element the popover should be appended to. */ @Input() container?: string; /** * Css class for popover container */ @Input() containerClass = ''; /** * Returns whether or not the popover is currently being shown */ @Input() get isOpen(): boolean { return this._popover.isShown; } set isOpen(value: boolean) { if (value) { this.show(); } else { this.hide(); } } /** * Delay before showing the tooltip */ @Input() delay = 0; /** * Emits an event when the popover is shown */ @Output() onShown: EventEmitter; /** * Emits an event when the popover is hidden */ @Output() onHidden: EventEmitter; protected _popoverCancelShowFn?: () => void; protected _delayTimeoutId?: number; private _popover: ComponentLoader; private _isInited = false; private _ariaDescribedby?: string; constructor( _config: PopoverConfig, private _elementRef: ElementRef, private _renderer: Renderer2, _viewContainerRef: ViewContainerRef, cis: ComponentLoaderFactory, private _positionService: PositioningService ) { this._popover = cis .createLoader( _elementRef, _viewContainerRef, _renderer ) .provide({provide: PopoverConfig, useValue: _config}); Object.assign(this, _config); this.onShown = this._popover.onShown; this.onHidden = this._popover.onHidden; // fix: no focus on button on Mac OS #1795 if (typeof window !== 'undefined') { _elementRef.nativeElement.addEventListener('click', function () { try { _elementRef.nativeElement.focus(); } catch (err) { return; } }); } } /** * Set attribute aria-describedBy for element directive and * set id for the popover */ setAriaDescribedBy(): void { this._ariaDescribedby = this.isOpen ? `ngx-popover-${this.popoverId}` : void 0; if (this._ariaDescribedby) { if (this._popover.instance) { this._popover.instance.popoverId = this._ariaDescribedby; } this._renderer.setAttribute(this._elementRef.nativeElement, 'aria-describedby', this._ariaDescribedby); } else { this._renderer.removeAttribute(this._elementRef.nativeElement, 'aria-describedby'); } } /** * Opens an element’s popover. This is considered a “manual” triggering of * the popover. */ show(): void { if (this._popover.isShown || !this.popover || this._delayTimeoutId) { return; } this._positionService.setOptions({ modifiers: { flip: { enabled: this.adaptivePosition }, preventOverflow: { enabled: this.adaptivePosition, boundariesElement: this.boundariesElement || 'scrollParent' } } }); const showPopover = () => { if (this._delayTimeoutId) { this._delayTimeoutId = undefined; } this._popover .attach(PopoverContainerComponent) .to(this.container) .position({attachment: this.placement}) .show({ content: this.popover, context: this.popoverContext, placement: this.placement, title: this.popoverTitle, containerClass: this.containerClass }); if (!this.adaptivePosition && this._popover._componentRef) { this._positionService.calcPosition(); this._positionService.deletePositionElement(this._popover._componentRef.location); } this.isOpen = true; this.setAriaDescribedBy(); }; const cancelDelayedTooltipShowing = () => { if (this._popoverCancelShowFn) { this._popoverCancelShowFn(); } }; if (this.delay) { const _timer = timer(this.delay).subscribe(() => { showPopover(); cancelDelayedTooltipShowing(); }); if (this.triggers) { parseTriggers(this.triggers) .forEach((trigger: Trigger) => { if (!trigger.close) { return; } this._popoverCancelShowFn = this._renderer.listen( this._elementRef.nativeElement, trigger.close, () => { _timer.unsubscribe(); cancelDelayedTooltipShowing(); } ); }); } } else { showPopover(); } } /** * Closes an element’s popover. This is considered a “manual” triggering of * the popover. */ hide(): void { if (this._delayTimeoutId) { clearTimeout(this._delayTimeoutId); this._delayTimeoutId = undefined; } if (this.isOpen) { this._popover.hide(); this.setAriaDescribedBy(); this.isOpen = false; } } /** * Toggles an element’s popover. This is considered a “manual” triggering of * the popover. */ toggle(): void { if (this.isOpen) { return this.hide(); } this.show(); } ngOnInit(): void { // fix: seems there are an issue with `routerLinkActive` // which result in duplicated call ngOnInit without call to ngOnDestroy // read more: https://github.com/valor-software/ngx-bootstrap/issues/1885 if (this._isInited) { return; } this._isInited = true; this._popover.listen({ triggers: this.triggers, outsideClick: this.outsideClick, show: () => this.show(), hide: () => this.hide() }); } ngOnDestroy(): void { this._popover.dispose(); } }