Buttons

Fullscreen Button

This component is used to enter and exit fullscreen.

# Usage

The <vds-fullscreen-button> component will toggle the fullscreen state of media as it's pressed by dispatching a media-enter-fullscreen-request, and media-exit-fullscreen-request event to the media controller.

          
1
2
3
4
		    

# Fullscreen Target

By default, the <vds-fullscreen-button> component will fire a request to enter fullscreen on the current media (i.e., <vds-media>). The request handler will naturally fallback to the current media provider if the native Fullscreen API is not available.

You can specify that you only want to display the provider in fullscreen and not the entire media like so:

# Styling

You can override the default styles with CSS like so:

        vds-fullscreen-button {
  color: pink;
  transition: opacity 0.2s ease-in;
}

/* Apply styles when media is fullscreened. */
vds-fullscreen-button[fullscreen] {
}

/* Apply styles when media is _not_ fullscreened. */
vds-fullscreen-button:not([fullscreen]) {
}

/* Style default icons. */
vds-fullscreen-button [slot='enter'] {
}
vds-fullscreen-button [slot='exit'] {
}

      

# Custom Icons

Here's an example containing a custom enter and exit icon: