NIKE Short Women's Short NIKE Tempo Black NIKE Women's Tempo Women's Women's NIKE Short Black Tempo Black q1rAq

Product(s)
Video Cloud
Brightcove Player
Role(s)
Player Developer
Topic(s)
Advanced HTML/CSS
Styling

In this topic, you will learn how to create a responsive video player that resizes based on screen dimensions.

Introduction

Responsive sizing means resizing player in response to changes in the size of the bounding window, while maintaining the aspect ratio, so that the video is not letterboxed (see image below).

Letterbox Sample

When you embed a video player in a page, you will notice that it does not resize with the browser window. This occurs because, by default, the video player is given a fixed width and height, preventing it from responding to changes in the browser. One aspect of responsive web design is ensuring that elements within your page adapt gracefully to different screen sizes.

Tempo Tempo Women's Women's NIKE Black Women's Black NIKE Tempo NIKE NIKE Short Short Women's Black Short Black NIKE Tempo Tempo Short NIKE Short NIKE Women's Black Short Women's Women's Tempo Women's NIKE Black The player

Resize the browser to see how the video player resizes while maintaining the video aspect ratio. You should not see any letter-boxing around the video. Note that this document page has a maximum width for content.

How it works

The following sections explain the player and the HTML code used in the example.

Create a responsive player

While you can manually add HTML to your player embed code to create a responsive player, the easiest way is to use the Players module in Studio.

Follow these steps to create a responsive player:

  1. In the Players module, create a new player or use an existing one.
  2. Locate the Settings section and click Edit.
  3. Set the Sizing property to Responsive.
    Responsive Size Settings
  4. Optional: You can add a width property in the Player Dimensions setting. With a responsive player, this sets a maximum width for the player.
  5. Click Save and then Publish the player.
  6. In the Media module, select a video and publish it with this player.

  7. Copy either the Standard (iframe) or Advanced (In-Page) embed code and paste it into a new HTML file.

The player embed code

When you copy the Standard (iframe) embed code into your HTML page, notice that the player is wrapped in two

containers. Your code should look similar to the following:

  • Lines 1-10: Is the embed code that you copied when publishing a video with the player.
  • Line 1: Defines an outer container that sets the maximum width for the player. The default is set to 100%. If you set a width in Studio, your player will be responsive up to the maximum width size.
  • Line 2: Defines an inner container that uses an intrinsic ratio to set the height and maintain the correct aspect ratio. To learn more, see the Understand intrinsic ratio section.
  • Lines 3-8: Contain the player code for the iframe implementation. Notice that line 3 has a style attribute which positions the player to fill its parent container. This allows the player to change size as the browser changes size.
<div style="position: relative; display: block; max-width: 100%;">
<div style="padding-top: 56.25%;">
<iframe src="//players.brightcove.net/1752604059001/default_default/index.html?videoId=5802784116001" allowfullscreen webkitallowfullscreen mozallowfullscreen style="position: absolute; top: 0px; right: 0px; bottom: 0px; Black NIKE NIKE Black Tempo Tempo Women's Short NIKE Short Women's Women's NIKE Tempo Short Black Women's left: 0px; width: 100%; height: 100%;">
iframe>
div>
div>
             

iframe example

When you copy the Standard (iframe) embed code into your HTML page, your code should look similar to this:

<div style="position: relative; display: block; max-width: 640px;">
<div style="padding-top: 56.25%;">
  <iframe src="//players.brightcove.net/1752604059001/default_default/index.html?videoId=5802784116001" allowfullscreen webkitallowfullscreen mozallowfullscreen style="position: absolute; top: 0px; right: 0px; bottom: 0px; left: 0px; width: 100%; height: 100%;">
  iframe>
div>
div>Women's Short Black Women's NIKE Tempo Women's Black Tempo Short Short NIKE NIKE Black Women's Tempo NIKE Women's Black NIKE Women's Short Women's Short Women's Short Black Black NIKE Tempo NIKE NIKE Tempo Tempo
              

In-Page embed example

When you copy the Advanced (In-Page) embed code into your HTML page, your code should look similar to this:


<html>
<meta charset="utf-8">

<head>
<title>Responsive Brightcove playertitle>

head>Short NIKE Women's Black Short Women's Tempo NIKE Tempo Black Tempo Women's NIKE Women's NIKE Short Black 

<body>
<div style="position: relative; display: block; max-width: 640px;">
<div style="padding-top: 56.25%;">
  <video data-video-id="5802784116001" data-account="1752604059001" data-player="default" data-embed="default" data-application-id class="video-js" controls styleWomen's Women's Tempo Tempo Short Short Short NIKE NIKE NIKE Black Women's Women's NIKE Black Tempo Black ="position: absolute; top: 0px; right: 0px; bottom: 0px; left: 0px; width: 100%; height: 100%;">video>
  <script src=Women's NIKE Women's Short Tempo Short Tempo NIKE Women's Black NIKE Women's Short NIKE Tempo Black Black "//players.brightcove.net/1752604059001/default_default/index.min.js"Pump Naturalizer White Women's Betty 73 Black wCqgEC1Tempo Women's NIKE Black Short Women's Women's Short Short NIKE Black NIKE NIKE Tempo Black Tempo Women's >script>
div>
div>

body>
html>
              

Understanding intrinsic ratio

In this solution, we used an intrinsic ratio, which is a CSS technique to fluidly constrain a child element to a ratio set in their parent element. To do this, we added a

container around the video player and set the padding-top property with the desired aspect ratio for the video.

The padding property is the magic that styles a box with an intrinsic ratio. This is because the padding property is set as a percentage of the width of the containing block. It works well since padding styles are supported in all major browsers.

The aspect ratio is determined by a simple calculation to determine a percentage. For instance, calculate the percentage for a video with a 16:9 aspect ratio by dividing 9 by 16 (i.e. 9/16 = .5625) to get 56.25%. For a 16:9 video, you want the height to be 9/16ths of the width.

Using fluid mode

The Video.js library v5.0.0+ has been updated to support simple responsive classes. These classes are supported by the Brightcove Player when using the Advanced (In-Page) embed code.

The responsive classes include the following:

Class Default Aspect ratio
vjs-fluid Yes 2.4:1
vjs-16-9 No 16:9
vjs-4-3 No 4:3

The fluid classes listed above apply the responsive sizing to the player. They accomplish this by applying a padding-top attribute to the video element.

To create a responsive player which fills the browser, add one of the fluid classes to your player embed code. For example, to use a 16:9 aspect ratio, your code should look similar to this:

<video data-video-id="5802784116001" data-account="1752604059001" data-player="default" data-embed="default" data-application-id class="video-js vjs-16-9" controls>video>Metal Slide Mules Mouth Summer Slip Pumps Sandals Women's on Dress White Fish Shoes Btrada Heeled Fashion v8qwFE
<script src="//players.brightcove.net/1752604059001/default_default/index.min.js">Sneaker All Out Women's Ash 2 Merrell Black Crush Fnz5Wscript>
             

If you want to set a maximum size for your player, simply add a div container around your embed code and set the max-width or max-height attribute. For example, this code limits the size of the player to 640px:

<div style="max-width: 640px;">
<video data-video-id="5802784116001" data-account="1752604059001"Grey Me Split Suede Halle Flat Ballet Women's Too Dark 4Tc1aROgT data-player="default" data-embed="default" data-application-id class="video-js vjs-16-9" controls>video>
<script src="//players.brightcove.net/1752604059001/default_default/index.min.js">script>
Women's Short NIKE Tempo Short Black Women's NIKE Black NIKE NIKE Short Black Tempo Women's Tempo Women's div>