The controls attribute in mave-player offers the ability to customize the visible controls. By specifying this attribute, developers can precisely control which playback controls are available to the end-users. This feature supports a range of options, including play/pause buttons, volume control, fullscreen toggle among others.
<mave-player
embed="{embed id}"
controls="play time seek volume rate airplay cast fullscreen"
></mave-player>When this attribute is not specified, we provide a standard set of controls.
| Label | Description |
|---|---|
| play | Starts the playback of the video from the current position. |
| time | Shows the exact point in time where the video is currently playing. |
| seek | Displays the current position in the video. |
| rate | Adjusts the speed at which the video plays back. |
| subtitles | Enables users to manage the display of subtitles or closed captions. |
| audiotracks | Shows the audio track selector so viewers can switch between available tracks. |
| volume | Adjusts the audio level of the video playback. |
| airplay | Shows the AirPlay button when the browser exposes native AirPlay support, primarily Safari on macOS and iOS. |
| cast | Shows the Cast button when the browser exposes compatible remote playback or Cast support. |
| chromecast | Alias for cast; use this token if that name is clearer in your code. |
| fullscreen | Expands the video player to fill the entire screen. |
Note: The
subtitlesandaudiotrackscomponent attributes still apply. Settingsubtitles="none"hides captions even if subtitles is listed here, andaudiotracks="off"suppresses the selector regardless of audiotracks. Use the attributes to force availability, and thecontrolslist to decide whether the corresponding buttons appear when they’re allowed.
Note: AirPlay and Cast are optional controls. Add them to the
controlslist when you want to offer them; they are hidden when the browser reports the native feature as unavailable. AirPlay is WebKit/Safari-specific; Cast support depends on the browser and available receivers.
