Skip to content

Both copy text to your clipboard — Build with AI copies a setup prompt to paste into Claude Code, Cursor, Codex or Copilot; Copy page as Markdown copies this page to paste into a chat. How it works

FullscreenControl ​

Defined in: src/ui/control/fullscreen_control.ts:40

A FullscreenControl control contains a button for toggling the map in and out of fullscreen mode. When requestFullscreen is not supported, fullscreen is handled via CSS properties. The map's cooperativeGestures option is temporarily disabled while the map is in fullscreen mode, and is restored when the map exist fullscreen mode.

Param ​

the full screen control options

Example ​

ts
map.addControl(new FullscreenControl({container: document.querySelector('body')}));

See ​

View a fullscreen map

Events ​

Event fullscreenstart of type Event will be fired when fullscreen mode has started.

Event fullscreenend of type Event will be fired when fullscreen mode has ended.

Extends ​

Implements ​

Constructors ​

Constructor ​

new FullscreenControl(options: FullscreenControlOptions): FullscreenControl

Defined in: src/ui/control/fullscreen_control.ts:52

Parameters ​

ParameterTypeDescription
optionsFullscreenControlOptionsthe control's options

Returns ​

FullscreenControl

Overrides ​

Evented.constructor

Methods ​

listens() ​

listens(type: string): boolean

Defined in: src/util/evented.ts:165

Returns a true if this instance of Evented or any forwardeed instances of Evented have a listener for the specified type.

Parameters ​

ParameterTypeDescription
typestringThe event type

Returns ​

boolean

true if there is at least one registered listener for specified event type, false otherwise

Inherited from ​

Evented.listens


off() ​

off(type: string, listener: Listener): FullscreenControl

Defined in: src/util/evented.ts:90

Removes a previously registered event listener.

Parameters ​

ParameterTypeDescription
typestringThe event type to remove listeners for.
listenerListenerThe listener function to remove.

Returns ​

FullscreenControl

Inherited from ​

Evented.off


on() ​

on(type: string, listener: Listener): Subscription

Defined in: src/util/evented.ts:73

Adds a listener to a specified event type.

Parameters ​

ParameterTypeDescription
typestringThe event type to add a listen for.
listenerListenerThe function to be called when the event is fired. The listener function is called with the data object passed to fire, extended with target and type properties.

Returns ​

Subscription

Inherited from ​

Evented.on


onAdd() ​

onAdd(map: Map): HTMLElement

Defined in: src/ui/control/fullscreen_control.ts:76

Register a control on the map and give it a chance to register event listeners and resources. This method is called by Map#addControl internally.

Parameters ​

ParameterTypeDescription
mapMapthe Map this control will be added to

Returns ​

HTMLElement

The control's container element. This should be created by the control and returned by onAdd without being attached to the DOM: the map will insert the control's element into the DOM as necessary.

Implementation of ​

IControl.onAdd


once() ​

once(type: string, listener?: Listener): Promise<any> | FullscreenControl

Defined in: src/util/evented.ts:106

Adds a listener that will be called only once to a specified event type.

The listener will be called first time the event fires after the listener is registered.

Parameters ​

ParameterTypeDescription
typestringThe event type to listen for.
listener?ListenerThe function to be called when the event is fired the first time.

Returns ​

Promise<any> | FullscreenControl

this or a promise if a listener is not provided

Inherited from ​

Evented.once


onRemove() ​

onRemove(): void

Defined in: src/ui/control/fullscreen_control.ts:85

Unregister a control on the map and give it a chance to detach event listeners and resources. This method is called by Map#removeControl internally.

Returns ​

void

Implementation of ​

IControl.onRemove


setEventedParent() ​

setEventedParent(parent?: Evented, data?: any): FullscreenControl

Defined in: src/util/evented.ts:176

Bubble all events fired by this instance of Evented to this parent instance of Evented.

Parameters ​

ParameterType
parent?Evented
data?any

Returns ​

FullscreenControl

Inherited from ​

Evented.setEventedParent