Class __INTERNAL__MapLibreOverlay<T>

Generic PubSub class implementing the Publish-Subscribe pattern for event handling.

Type Parameters

  • T

    The type of the event payload.

Hierarchy (View Summary)

  • PubSub<T>
    • __INTERNAL__MapLibreOverlay

Implements

  • IControl

Constructors

constructor

Properties

core el layer? map? origin?

Accessors

signal

Methods

off on onAbort onAdd onRemove

Constructors

constructor

  • new __INTERNAL__MapLibreOverlay<T>(
        origin: undefined | Position,
        options?: Partial<
            {
                __EXPERIMENTAL_shadows?: ShadowsOptions;
                antialias?: boolean;
                attribution?: AttributionControlOptions;
                backgroundAlpha?: number;
                backgroundColor?: string;
                bearing?: number;
                center?: Position;
                environment?: EnvMapOptions;
                gl?: WebGLRenderingContext;
                imagePlacementOptions?: ImagePlacementOptions;
                map?: Map$1;
                mode?: "standalone"
                | "outdoors-interleaved"
                | "outdoors-overlay";
                naturalBearing?: number;
                occlusionEnabled?: boolean;
                onWebGLContextCreationError?: (event: Event) => void;
                onWebGLContextLost?: (event: Event) => void;
                onWebGLContextRestored?: (event: Event) => void;
                onWebGLRendererError?: (error: Error) => void;
                outdoorView: {
                    enabled: boolean;
                    headers?: { "x-mappedin-tiles-key": string };
                    lowDpi?: boolean;
                    style?: string;
                };
                outlines?: boolean
                | OutlinesOptions;
                pitch?: number;
                transformImageRequest?: TransformImageRequest;
                useCollisionWorker?: boolean;
                useStandaloneCamera?: boolean;
                useWorkers?: boolean;
                watermark?: WatermarkOptions;
                zoomLevel?: number;
            },
        >,
    ): __INTERNAL__MapLibreOverlay<T>

    Type Parameters

    • T

    Parameters

    • origin: undefined | Position
    • Optionaloptions: Partial<
          {
              __EXPERIMENTAL_shadows?: ShadowsOptions;
              antialias?: boolean;
              attribution?: AttributionControlOptions;
              backgroundAlpha?: number;
              backgroundColor?: string;
              bearing?: number;
              center?: Position;
              environment?: EnvMapOptions;
              gl?: WebGLRenderingContext;
              imagePlacementOptions?: ImagePlacementOptions;
              map?: Map$1;
              mode?: "standalone"
              | "outdoors-interleaved"
              | "outdoors-overlay";
              naturalBearing?: number;
              occlusionEnabled?: boolean;
              onWebGLContextCreationError?: (event: Event) => void;
              onWebGLContextLost?: (event: Event) => void;
              onWebGLContextRestored?: (event: Event) => void;
              onWebGLRendererError?: (error: Error) => void;
              outdoorView: {
                  enabled: boolean;
                  headers?: { "x-mappedin-tiles-key": string };
                  lowDpi?: boolean;
                  style?: string;
              };
              outlines?: boolean
              | OutlinesOptions;
              pitch?: number;
              transformImageRequest?: TransformImageRequest;
              useCollisionWorker?: boolean;
              useStandaloneCamera?: boolean;
              useWorkers?: boolean;
              watermark?: WatermarkOptions;
              zoomLevel?: number;
          },
      >

    Returns __INTERNAL__MapLibreOverlay<T>

Properties

core

core: __INTERNAL__RendererCore

el

el: HTMLDivElement

Optionallayer

layer?: CustomLayerInterface

Optionalmap

map?: Map$1

Optionalorigin

origin?: Position

Accessors

signal

  • get signal(): AbortSignal

    Returns the AbortSignal for this PubSub instance. Use this signal with APIs that support cancellation (fetch, addEventListener, etc.) When the PubSub is destroyed, the signal will be aborted and all listeners using it will be automatically removed.

    Returns AbortSignal

    Example

    // Automatically cleaned up when PubSub is destroyed
    pubsub.addEventListener(window, 'resize', handler, { signal: pubsub.signal });

Methods

off

  • off<EVENT_NAME extends string | number | symbol>(
        eventName: EVENT_NAME,
        fn: (
            payload: T[EVENT_NAME] extends { data: null }
                ? any[any]["data"]
                : T[EVENT_NAME],
        ) => void,
    ): void

    Unsubscribe a function previously subscribed with on

    Type Parameters

    • EVENT_NAME extends string | number | symbol

    Parameters

    • eventName: EVENT_NAME

      An event name to which the provided function was previously subscribed.

    • fn: (
          payload: T[EVENT_NAME] extends { data: null }
              ? any[any]["data"]
              : T[EVENT_NAME],
      ) => void

      A function that was previously passed to on. The function must have the same reference as the function that was subscribed.

    Returns void

    Example

    // Unsubscribe from the 'click' event
    const handler = (event) => {
    	console.log('Map was clicked', event);
    };
    map.off('click', handler);

on

  • on<EVENT_NAME extends string | number | symbol>(
        eventName: EVENT_NAME,
        fn: (
            payload: T[EVENT_NAME] extends { data: null }
                ? any[any]["data"]
                : T[EVENT_NAME],
        ) => void,
        options?: { signal?: AbortSignal },
    ): () => void

    Subscribe a function to an event.

    Type Parameters

    • EVENT_NAME extends string | number | symbol

    Parameters

    • eventName: EVENT_NAME

      An event name which, when fired, will call the provided function.

    • fn: (
          payload: T[EVENT_NAME] extends { data: null }
              ? any[any]["data"]
              : T[EVENT_NAME],
      ) => void

      A callback that gets called when the corresponding event is fired. The callback will get passed an argument with a type that's one of event payloads.

    • Optionaloptions: { signal?: AbortSignal }

      Optional options object. If a signal is provided, the subscription will be automatically cleaned up when that signal is aborted.

    Returns () => void

    A cleanup function that unsubscribes the event listener when called.

    Example

    // Subscribe to the 'click' event
    const handler = (event) => {
     const { coordinate } = event;
     const { latitude, longitude } = coordinate;
    	console.log(`Map was clicked at ${latitude}, ${longitude}`);
    };
    map.on('click', handler);

onAbort

  • onAbort<T extends (...args: any[]) => void>(fn: T): void

    Subscribe a function to be called when the signal is aborted.

    Type Parameters

    • T extends (...args: any[]) => void

    Parameters

    • fn: T

      The function to call when the signal is aborted.

    Returns void

onAdd

  • onAdd(map: Map$1): HTMLDivElement

    Called by MapLibre when this overlay is added to a map as an IControl.

    Parameters

    • map: Map$1

      The MapLibre map this overlay is being attached to.

    Returns HTMLDivElement

    The DOM element rendered by this overlay.

onRemove

  • onRemove(): void

    Called by MapLibre when this overlay is removed from a map. Detaches all map listeners, removes the custom layer, and destroys the underlying renderer.

    Returns void

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods