Back to Deck Gl

FullscreenWidget

docs/api-reference/widgets/fullscreen-widget.md

9.3.23.5 KB
Original Source

FullscreenWidget

import {FullscreenWidgetDemo} from '@site/src/doc-demos/widgets'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

<FullscreenWidgetDemo />

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

<Tabs groupId="language"> <TabItem value="js" label="JavaScript">
js
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'})
  ]
});
</TabItem> <TabItem value="ts" label="TypeScript">
ts
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'})
  ]
});
</TabItem> <TabItem value="react" label="React">
tsx
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>
  );
}
</TabItem> </Tabs>

Constructor

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

Types

FullscreenWidgetProps {#fullscreenwidgetprops}

The FullscreenWidget accepts the generic WidgetProps and:

container (HTMLElement, optional) {#container}

  • 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) {#enterlabel}

  • Default: 'Enter Fullscreen'

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

exitLabel (string, optional) {#exitlabel}

  • Default: 'Exit Fullscreen'

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

onFullscreenChange (Function, optional) {#onfullscreenchange}

ts
(fullscreen: boolean) => void
  • Default: () => {}

Callback when fullscreen state changes (via user click or browser fullscreen events).

Styles

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

NameTypeDefault
--icon-fullscreen-enterSVG Data UrlMaterial Symbol Fullscreen
--icon-fullscreen-exitSVG Data UrlMaterial Symbol Fullscreen Exit

Source

modules/widgets/src/fullscreen-widget.tsx