FullscreenWidget

This widget enlarges deck.gl to fill the full screen. Click the widget to enter or exit full screen.

JavaScript

import {Deck} from '@deck.gl/core';
import {FullscreenWidget} from '@deck.gl/widgets';
import '@deck.gl/widgets/stylesheet.css';

new Deck({
  widgets: [
    new FullscreenWidget({placement: 'top-left'})
  ]
});

TypeScript

import {Deck} from '@deck.gl/core';
import {FullscreenWidget} from '@deck.gl/widgets';
import '@deck.gl/widgets/stylesheet.css';

new Deck({
  widgets: [
    new FullscreenWidget({placement: 'top-left'})
  ]
});

React

import React from 'react';
import {DeckGL, FullscreenWidget} from '@deck.gl/react';
import '@deck.gl/widgets/stylesheet.css';

function App() {
  return (
    <DeckGL>
      <FullscreenWidget placement="top-left" />
    </DeckGL>
  );
}

Installation

npm install deck.gl
# or
npm install @deck.gl/core @deck.gl/widgets

import {FullscreenWidget, type FullscreenWidgetProps} from '@deck.gl/widgets';
import '@deck.gl/widgets/stylesheet.css';
new FullscreenWidget({} satisfies FullscreenWidgetProps);

To use pre-bundled scripts:

<script src="https://unpkg.com/deck.gl@^9.0.0/dist.min.js"></script>
<link href="https://unpkg.com/deck.gl@^9.0.0/dist/stylesheet.css" rel='stylesheet' />
<!-- or -->
<script src="https://unpkg.com/@deck.gl/core@^9.0.0/dist.min.js"></script>
<script src="https://unpkg.com/@deck.gl/widgets@^9.0.0/dist.min.js"></script>
<link href="https://unpkg.com/@deck.gl/widgets@^9.0.0/dist/stylesheet.css" rel='stylesheet' />

new deck.FullscreenWidget({});

Types

FullscreenWidgetProps

The FullscreenWidget accepts the generic WidgetProps and:

container (HTMLElement, optional)

• Default: undefined

A compatible DOM element which should be made full screen. By default, the map container element will be made full screen.

enterLabel (string, optional)

• Default: 'Enter Fullscreen'

Tooltip message displayed while hovering a mouse over the widget when out of fullscreen.

exitLabel (string, optional)

• Default: 'Exit Fullscreen'

Tooltip message displayed while hovering a mouse over the widget when fullscreen.

Styles

Learn more about how to replace icons in the styling guide.

Name	Type	Default
--icon-fullscreen-enter	SVG Data Url	Material Symbol Fullscreen
--icon-fullscreen-exit	SVG Data Url	Material Symbol Fullscreen Exit

Source

modules/widgets/src/fullscreen-widget.tsx