Class MaplibreTerradrawControl

Maplibre GL Terra Draw Control

Hierarchy (View Summary)

MaplibreTerradrawControl
- MaplibreMeasureControl
- MaplibreValhallaControl

Implements

IControl

Constructors

constructor

new MaplibreTerradrawControl(
options?: TerradrawControlOptions,
): MaplibreTerradrawControl
Constructor
Parameters
- Optionaloptions: TerradrawControlOptions
  Plugin control options
Returns MaplibreTerradrawControl
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:97

Properties

`Protected`_cssPrefix

_cssPrefix: string = ''

`Protected`_isExpanded

_isExpanded: boolean = false

`Protected` `Optional`controlContainer

controlContainer?: HTMLElement

`Protected`defaultMode

defaultMode: string = 'render'

`Protected`events

events: { [key: string]: [(event: EventArgs) => void] } = {}

`Protected` `Optional`map

map?: Map$1

`Protected`modeButtons

modeButtons: { [key: string]: HTMLButtonElement } = {}

`Protected`options

options: TerradrawControlOptions = defaultControlOptions

`Protected` `Optional`terradraw

terradraw?: TerraDraw

Accessors

`Protected`cssPrefix

get cssPrefix(): string
CSS prefix for the control buttons. Default is empty string

Returns string
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:42

isExpanded

get isExpanded(): boolean
get the state of whether the control is expanded or collapsed

Returns boolean
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:34
set isExpanded(value: boolean): void
set the state of the control either expanded or collapsed. terradraw mode will be reset if the state is changed. either expanded or collapsed event is dispatched when changed
Parameters
- value: boolean
Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:51

Methods

activate

activate(): void
Activate Terra Draw to start drawing

Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:283

`Protected`addTerradrawButton

addTerradrawButton(mode: TerradrawMode): void
Add Terra Draw drawing mode button
Parameters
- mode: TerradrawMode
  Terra Draw mode name
Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:400

cleanStyle

cleanStyle(
    style: StyleSpecification,
    options?: {
        excludeTerraDrawLayers?: boolean;
        onlyTerraDrawLayers?: boolean;
    },
): StyleSpecification
clean maplibre style to filter only for terradraw related layers or without them. If options are not set, returns original style given to the function.

This can be useful incase users only want to get terradraw related layers or without it.

Usage: cleanStyle(map.getStyle, { excludeTerraDrawLayers: true}) cleanStyle(map.getStyle, { onlyTerraDrawLayers: true})
Parameters
- style: StyleSpecification
  maplibre style spec
- Optionaloptions: { excludeTerraDrawLayers?: boolean; onlyTerraDrawLayers?: boolean }
  - OptionalexcludeTerraDrawLayers?: boolean
    return maplibre style without terradraw layers and sources
  - OptionalonlyTerraDrawLayers?: boolean
    return maplibre style with only terradraw layers and sources
Returns StyleSpecification
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:519

`Protected`clearExtendedFeatures

clearExtendedFeatures(sourceIds: string[], ids?: FeatureId[]): void
Clear GeoJSON feature related to extended control such as measure and valhalla by TerraDraw feature ID
Parameters
- sourceIds: string[]
  the array of source ID to delete
- ids: FeatureId[] = undefined
  the array of feature ID. Optional, if undefined, delete all labels for source
Returns void
void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:610

deactivate

deactivate(): void
Deactivate Terra Draw to stop drawing

Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:293

`Protected`dispatchEvent

dispatchEvent(event: EventType, args?: { [key: string]: unknown }): void
Dispatch an event. Pass the current snapshot of features and mode
Parameters
- event: EventType
  event type
- Optionalargs: { [key: string]: unknown }
  additional arguments
Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:266

getDefaultPosition

getDefaultPosition(): ControlPosition
Get the default control position

Returns ControlPosition
default control position. Default is 'top-right'
Implementation of IControl.getDefaultPosition
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:116

getFeatures

getFeatures(
onlySelected?: boolean,
): { features: GeoJSONStoreFeatures[]; type: string }
get GeoJSON features
Parameters
- onlySelected: boolean = false
  If true, returns only selected features. Default is false.
Returns { features: GeoJSONStoreFeatures[]; type: string }
FeatureCollection in GeoJSON format
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:488

getTerraDrawInstance

getTerraDrawInstance(): TerraDraw
Get the Terra Draw instance. For the Terra Draw API, please refer to https://terradraw.io/#/api

Returns TerraDraw
Terra Draw instance with additional extensions for the plugin control
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:361

`Protected`handleDownload

handleDownload(): void
Download button click event handler

Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:534

`Protected`handleModeChange

handleModeChange(mode: string, target: TerraDraw): void
Handle mode change operations that should be executed after setMode is called
Parameters
- mode: string
  The active mode name
- target: TerraDraw
  The Terra Draw instance
Returns void
The result of the setMode operation
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:307

off

off(event: EventType, callback: (event: EventArgs) => void): void
Unregister an event for the plugin
Parameters
- event: EventType
  event type
- callback: (event: EventArgs) => void
Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:253

on

on(event: EventType, callback: (event: EventArgs) => void): void
Register an event for the plugin
Parameters
- event: EventType
  event type
- callback: (event: EventArgs) => void
Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:239

onAdd

onAdd(map: Map$1): HTMLElement
add the plugin control to maplibre
Parameters
- map: Map$1
  Maplibre Map object
Returns HTMLElement
HTML Element
Implementation of IControl.onAdd
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:126

onRemove

onRemove(): void
Remove the plugin control from maplibre

Returns void
void
Implementation of IControl.onRemove
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:223

resetActiveMode

resetActiveMode(): void
Reset active mode to back to render mode

Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:387

`Protected`syncButtonStates

syncButtonStates(mode: string): void
Synchronize button states with the current Terra Draw mode
Parameters
- mode: string
  The active mode name
Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:328

`Protected`toggleButtonsWhenNoFeature

toggleButtonsWhenNoFeature(): void
Toggle the state of buttons when there is no features

Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:549

`Protected`toggleDeleteSelectionButton

toggleDeleteSelectionButton(): void
Toggle the state of delete-select button

Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:573

`Protected`toggleEditor

toggleEditor(): void
Toggle editor control

Returns void
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:379

Class MaplibreTerradrawControl

Hierarchy (View Summary)

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns MaplibreTerradrawControl

Properties

Protected_cssPrefix

Protected_isExpanded

Protected OptionalcontrolContainer

ProtecteddefaultMode

Protectedevents

Protected Optionalmap

ProtectedmodeButtons

Protectedoptions

Protected Optionalterradraw

Accessors

ProtectedcssPrefix

Returns string

isExpanded

Returns boolean

Parameters

Returns void

Methods

activate

Returns void

ProtectedaddTerradrawButton

Parameters

Returns void

cleanStyle

Parameters

OptionalexcludeTerraDrawLayers?: boolean

OptionalonlyTerraDrawLayers?: boolean

Returns StyleSpecification

ProtectedclearExtendedFeatures

Parameters

Returns void

deactivate

Returns void

ProtecteddispatchEvent

Parameters

Returns void

getDefaultPosition

Returns ControlPosition

getFeatures

Parameters

Returns { features: GeoJSONStoreFeatures[]; type: string }

getTerraDrawInstance

Returns TerraDraw

ProtectedhandleDownload

Returns void

ProtectedhandleModeChange

Parameters

Returns void

off

Parameters

Returns void

on

Parameters

Returns void

onAdd

Parameters

Returns HTMLElement

onRemove

Returns void

resetActiveMode

Returns void

ProtectedsyncButtonStates

Parameters

Returns void

ProtectedtoggleButtonsWhenNoFeature

Returns void

ProtectedtoggleDeleteSelectionButton

Returns void

`Protected`_cssPrefix

`Protected`_isExpanded

`Protected` `Optional`controlContainer

`Protected`defaultMode

`Protected`events

`Protected` `Optional`map

`Protected`modeButtons

`Protected`options

`Protected` `Optional`terradraw

`Protected`cssPrefix

`Protected`addTerradrawButton

`Optional`excludeTerraDrawLayers?: boolean

`Optional`onlyTerraDrawLayers?: boolean

`Protected`clearExtendedFeatures

`Protected`dispatchEvent

`Protected`handleDownload

`Protected`handleModeChange

`Protected`syncButtonStates

`Protected`toggleButtonsWhenNoFeature

`Protected`toggleDeleteSelectionButton

`Protected`toggleEditor