Skip to content

Video controls

Custom HTML5 video functionality must be accessible and intuitive

Version:
0.1.0
Status:
Draft

Introduction

Video is an important consideration for a broadcasting company. The BBC presents web-based video in a variety of different ways. Sometimes the video is embedded in a fully-featured player, and in other cases just a couple of basic controls are present. The purpose of this documentation is to set out the recommended interaction design for custom video controls.

Baseline

Before enhancing a video instance with custom controls, there are a few fundamental considerations. Here is a code example, with notes to follow.

<video controls>
  <source src="path/to/video.webm" type="video/webm">
  <source src="path/to/video.mp4" type="video/mp4">
  <track label="English" kind="subtitles" srclang="en" src="path/to/captions.vtt" default>
  <p>
    Your browser doesn't support HTML5 video.
    <a href="path/to/video.mp4" download>Download</a> the video instead.
  </p>
</video>
  1. <video>: The standard video element is used.
  2. mp4: A well-supported video format is included (optionally with alternative formats via <source> elements).
  3. controls: Controls are activated via the controls Boolean.
  4. download: An option to download the video is provided for browsers not supporting HTML5 video.
  5. kind="subtitles": Videos with dialogue need captions, provided in <track> elements. In the following examples, only a single English captions track is provided, but additional languages should be supported where possible.

If your video has dialog and you are using custom controls, do one of the following:

  • Display captions by default
  • Provide custom controls to access captions
  • Provide an option to switch back to using native controls (which will include captions functionality)

Enhancement

Custom controls should be added progressively. Until JavaScript is run, the <video> should take controls to provide the native controls, and any custom controls should be hidden with hidden:

<div class="gel-video__container" role="group">
  <video controls>
    <source src="path/to/video.webm" type="video/webm">
    <source src="path/to/video.mp4" type="video/mp4">
    <p>
      Your browser doesn't support HTML5 video.
      <a href="path/to/video.mp4" download>Download</a> the video instead.
    </p>
  </video>
  <div class="gel-video__controls" hidden>
    <!-- custom controls here -->
  </div>
</div>

The JavaScript to switch to the enhanced/custom version is trivial:

// Where `video` represents the <video> node
// and `customControls` the custom controls container
video.controls = false;
customControls.hidden = false;

Toggle buttons

Many of the controls for video playback, including Play and Mute, are simple toggle buttons switching the user between active and inactive states. It is important these controls:

  1. Are native <button> elements
  2. Take the type="button" attribution
  3. Modify their label depending on state

In regards to (3), toggle buttons often have a persistent label and communicate state via aria-pressed (true or false). However, video player controls should be easy to activate by voice, so their labels must be consistent with their iconography. For example, for the play button:

  • Paused state → shows the familiar triangle-shaped icon → "play"
  • Playing state → shows the familiar two-vertical-lines icon → "pause"

In the reference implementation, an active class is appended to the parent button in its active state. This is used as a styling hook to toggle between the two text labels and their icons. In the following example, class="gel-video-button-play-off is hidden with display: none and is not available to assistive technologies. The calculated accessible name[2] is "Pause".

<button class="gel-video__play-button active" type="button">
  <span class="gel-video__button-off">
    <span class="gel-sr">Play</span>
    <svg><!-- play icon --></svg>
  </span>
  <span class="gel-video__button-on">
    <span class="gel-sr">Pause</span>
    <svg><!-- pause icon --></svg>
  </span>
</button>

The text labels are included as <span>s and hidden visually using the gel-sr class.

/*
Visually hide an element, but leave it available for screen readers 
 */
.gel-sr {
    border: 0;
    clip: rect(0 0 0 0);
    height: 1px;
    margin: -1px;
    overflow: hidden;
    padding: 0;
    position: absolute;
    white-space: nowrap;
    width: 1px;
}

Icons

Icons for custom controls should be taken from the standard GEL Iconography set. They must take aria-hidden="true" and focusable="false"[3] to ensure they are not available to assistive technologies or focusable by keyboard.

<svg class="gel-icon gel-icon--text" focusable="false" aria-hidden="true">
  <use xlink:href="pth/to#gel-icon-play"></use>
</svg>

The timeline

Also known as the 'scrub' or progress bar. It has two purposes:

  1. To indicate the current progress of the video
  2. To allow the user to select a point along this timeline

The timeline must, therefore, be keyboard and screen reader accessible. The type="range" input is a robust solution.

<label for="timeline" class="gel-video__scrub-container">
  <span class="gel-sr">Timeline</span>
  <input type="range" id="timeline" min="0" max="95.2" value="14.7" />
</label>

Note min, max, and value, which determine the range and the current play position. These values are in seconds. The max and value values map to the <video>'s duration and currentTime properties.

To make these values more readable non-visually, they are rounded up into whole numbers and converted into minutes and seconds to be represented by the aria-valuemin, aria-valuemax, and aria-valuenow properties.

<label for="timeline" class="gel-video__scrub-container">
  <span class="gel-sr">Timeline</span>
  <input type="range" id="timeline" min="0" aria-valuemin="0 seconds" max="95.2" aria-valuemax="1 minutes and 35 seconds" value="14.7" aria-valuenow="0 minutes and 14 seconds" />
</label>

The layout will differ depending on the context and number of simultaneous controls that are implemented. It is, however, recommended the controls are sufficiently large enough to be targeted by mouse and touch, and they carry clear focus styles.

.gel-video__container button:focus {
  outline: 2px solid $gel-color--tundora;
}

The timeline

The type="range" input (for the timeline) requires a number of proprietary styles to have a custom appearance[4].

Many of the custom styles are not visible where Windows High Contrast Mode is active, so we reinstate the user agent styles in an @media block:

@media (-ms-high-contrast: active) {
  .gel-video__timeline-container input[type=range],
  .gel-video__timeline-container input[type=range]::-webkit-slider-runnable-track,
  .gel-video__timeline-container input[type=range]::-webkit-slider-thumb,
  .gel-video__timeline-container input[type=range]:focus::-webkit-slider-runnable-track,
  .gel-video__timeline-container input[type=range]::-webkit-slider-thumb,
  .gel-video__timeline-container input[type=range]:focus::-webkit-slider-runnable-track,
  .gel-video__timeline-container input[type=range]::-moz-range-track,
  .gel-video__timeline-container input[type=range]::-moz-range-thumb {
    all: initial;
  }
}

Standard range input styles are visible, and in high contrast (white on black)

The controls container

In the reference implementation, the controls container uses Flexbox to distribute the controls along a horizontal axis. The timeline container takes flex: auto[5] to take up any space not taken by surrounding buttons. This makes the control bar responsive and tolerant of different functionality complexity.

.gel-video__timeline-container {
  flex: auto;
}

Autoplay

Setting video or audio to autoplay by default will cause disruption and confusion to users with a variety of impairments, particularly those who depend on being able to hear their assistive technology when content first loads. Other vulnerable populations, those with emotional or mental health issues for example, can be affected when forced to consume intrusive video or audio embedded alongside text-based content too. And you should consider situational limitations that users may experience, which can be exacerbated by anxiety conditions: someone sitting in a crowded but quiet place may be distressed at having their device suddenly and unexpectedly playing music or sounds. This is why the BBC Accessibility Guidelines[6] tell us to make autoplay an opt in feature, do not enable it by default.

But even in cases where autoplay has been opted-in to by the user, it is imperative the video is muted by default. This is important since screen reader users depend on being able to hear the voice output of their software to navigate, and this should not be 'talked over' by any video. They are unlikely to know where this uninvited noise is coming from, and it may take them some time to locate the video to mute it. Some browsers handle this for users already[7], but not all. In which case, we need to set the muted state on the loadedmetadata event (when the video has been appended to the DOM):

video.addEventListener('loadedmetadata', function () {
  if (video.autoplay) {
    video.muted = true;
  }
});

Finally, a pause/stop/mute button must be made obvious and immediately accessible to give the user control over the content. And you must make the option to opt out of autoplay obvious too, for cases where a user has accidentally or unintentionally enabled it.

Play and mute buttons

Any play button must switch its label and iconography according to the play state (see Recommended markup for information on labeling and accessible SVGs).

In the reference implementation, both the Play and Mute buttons take an active class in their active state, to use as a styling hook (this is used to show/hide the appropriate icon and accessible label).

In the Play button's case, the button must be switched into an inactive state upon the video ending (otherwise the button's appearance will be out of sync' for successive plays of the video):

self.playButton = function (button, video) {
  button.addEventListener('click', function () {
    video.paused || video.ended ? video.play() : video.pause();
    button.classList.toggle('active');
  });

  video.addEventListener('ended', function () {
    button.classList.remove('active');
  });
}

The timeline

As stated in Recommended markup, the timeline must represent the current state of progress and allow the user to 'scrub' and relocate themselves within the video's duration.

The first part is achieved by linking the input's value to the video's currentTime property within successive 'timeupdate' events:

video.addEventListener('timeupdate', function () {
  range.value = video.currentTime;
  range.setAttribute('aria-valuenow', getMins(video.currentTime));
});

Note that aria-valuenow must be updated too, translating the cryptic value of the input for screen reader users. The getMins function converts the value into minutes and seconds:

var getMins = function (secs) {
  let mins = Math.floor(secs / 60);
  let remainder = secs - mins * 60;
  return mins + ' minutes and ' + Math.round(remainder) + ' seconds';
}

Searching/scrubbing is accommodated by listening on 'input':

range.addEventListener('input', function () {
  video.currentTime = range.value;
});

The keyboard user is able to focus the input and use the arrow keys to 'scrub' right and left in increments.

Reference implementation

Simple card play/pause

This minimal implementation reveals the mute button while the video is playing.

The 2001 BBC2 Ident

Do you remember the radio controlled car?

Play, mute, and scrub

Open in new window

This topic does not yet have any related research available.

Further reading, elsewhere on the Web


  1. Using the group role — MDN, https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_group_role ↩︎

  2. What is an accessible name? — Paciello Group blog, https://developer.paciellogroup.com/blog/2017/04/what-is-an-accessible-name/ ↩︎

  3. IE focus bugs with focusable elements — Simply Accessible, https://simplyaccessible.com/article/7-solutions-svgs/#acc-heading-4 ↩︎

  4. Styling Cross-browser compatibe range inputs — CSS Tricks, https://css-tricks.com/styling-cross-browser-compatible-range-inputs-css/ ↩︎

  5. Flex — CSS Tricks, https://css-tricks.com/almanac/properties/f/flex/ ↩︎

  6. BBC Mobile Accessibility Guidelines: Autoplay, https://www.bbc.co.uk/guidelines/futuremedia/accessibility/mobile/audio-and-video/autoplay ↩︎

  7. Autoplay Policy Changes — Google Developers, https://developers.google.com/web/updates/2017/09/autoplay-policy-changes ↩︎

Copyright © 2019 BBC. This content is published under the Open Government Licence, unless otherwise noted.

Got a minute?

We'd love to know what you think of our website.

Go to survey