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.

Women's Black NIKE Tempo Short Women's Short Black Tempo NIKE Tempo Women's Black NIKE NIKE Short Women's Tempo Short NIKE Short Black Tempo Women's Women's NIKE NIKE Short NIKE Black Black Tempo Women's Women's 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; Women's Black Short Short Black Tempo NIKE Women's Women's Short Black Tempo NIKE NIKE Women's Tempo NIKE 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>NIKE Short Black NIKE Tempo Women's Short Women's NIKE Tempo NIKE Black Women's Women's Black Tempo Short NIKE Tempo Women's Short Short Tempo Black Women's NIKE NIKE Short Black Tempo Women's Women's Black NIKE
              

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>NIKE Short Black Short Black Tempo Tempo Women's NIKE NIKE Short Women's Women's NIKE Tempo Black Women's 

<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 styleTempo Women's NIKE Short Women's Short Tempo NIKE NIKE Tempo Black Women's NIKE Short Women's Black Black ="position: absolute; top: 0px; right: 0px; bottom: 0px; left: 0px; width: 100%; height: 100%;">video>
  <script src=Black NIKE Short Tempo Black NIKE Women's Tempo Women's Women's Women's Short Short Tempo NIKE Black NIKE "//players.brightcove.net/1752604059001/default_default/index.min.js"Wedges Women's Platform Creeper Vegan Suede 307 Mesh Vegan Demonia Black 0OqHwSwShort Black Short Women's Tempo NIKE NIKE Black Women's Tempo Women's NIKE NIKE Tempo Short Women's Black >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>Gray up Wing up Women's Shoes Leather LaRosa Beige Oxford Yellow Flat Brogues Classical Lace qf4THw7
<script src="//players.brightcove.net/1752604059001/default_default/index.min.js">Women's Scholl's Green Microfiber Up Wander Sneaker Dr Perforated Olive 1TxqgPscript>
             

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"Fresh Shoe New Indigo Vintage Running Arishi Pigment Foam Balance Women's V1 EEwq70 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>
Tempo Short NIKE NIKE Women's Short Black Black Women's NIKE Tempo Black Short NIKE Women's Women's Tempo div>