Overview
There are multiple ways to place a video on the page including using the VideoPlayer and VideoPlayerYoutube components.
When to use
- VideoPlayer: Displays videos uploaded directly to Bynder with essential playback controls like play, pause, and volume.
- VideoPlayerYoutube: Embeds YouTube videos, leveraging YouTube’s native player and interface.
When not to use
- For animated GIFs: Use the Picture component to display animated GIFs, as they do not require the functionality provided by a video player.
Anatomy
- Video
- VideoPlayerButton
Variants & States
AspectRatio
VideoPlayer supports the following video aspect ratios
- 21 : 9
- 16 : 9
- 4 : 3
- 1 : 1
- 3 : 4
- 9 : 16
The default AspectRatio is 16 : 9.
Video Player in a Section
If you want to use the VideoPlayer and VideoPlayer-YouTube components, it is highly recommended to place them within the grid cols-1 span-2 gap/8/2 gap [1-1-1-1-1]. This layout ensures that the video size is well-controlled and displayed proportionally on the screen. Using this grid will help maintain a consistent and visually appealing layout for your video content.
Internationalization
For RTL languages, no additional adjustments are required. The control buttons for video does not require any changes.
Properties
| Name | Type | Values | Description |
|---|---|---|---|
| responsive | Boolean | truefalse |
Height is changing according to specified aspect ratio |
| aspectRatio | String | "" |
Sets the aspectRatio of the video. Default: 16 : 9 |
| noLazy | Boolean | truefalse |
Initializes video in advance |
| controls | Boolean | truefalse |
Shows play, pause and other video controls |
| loop | Boolean | truefalse |
Endlessly repeats video |
| muted | Boolean | truefalse |
Plays with no sound |
| autoplay | Boolean | truefalse |
Allows the video to start playing automatically |
Usage Guidelines
Content Guidelines
We use the video player to embed product explainers, tutorials, or promotional videos. We never rely on videos alone to explain important information. Key details also appear in text.
Voice and tone
We follow our general voice: simple, human, credible, like a knowledgeable friend.
- We include a title or descriptive text adjacent to the video.
- Titles reflect the video’s content or purpose.
- For titles, we use sentence case.
Accessibility
We always provide captions for people with hearing impairments, non-native speakers, and those in noisy environments.