← All resources
The toolkit · Resource guide

Constrain a responsive video

Keep a video player within its container using a predictable frame.

Visit website (opens in a new tab)
Understand the tool

Overview

Keep a video player within its container using a predictable frame.

The example below is an original, minimal illustration of the referenced web-platform feature. Read the official reference and adapt it before using it in a real project.

Best for

  • Understanding constrain a responsive video.
  • Trying the pattern in an isolated page.
  • Adapting the example to an existing website.

Key features

  • Video aspect ratio
  • Responsive sizing
  • Native controls
A practical walkthrough

Getting started

  1. Read the example and reference. Identify the selectors, files or values that belong to your project.

  2. Try it in isolation. Use a disposable test page and adapt the example values.

  3. Verify before reuse. Check keyboard behavior, responsive layout and relevant browser support.

Things to know

  • These examples are learning material, not a drop-in application.
  • Replace example filenames, selectors and routes as needed.
  • Test changes on staging and escape data for the context where it is used.

Code example

Original illustrative example. Adapt filenames and selectors, and test on staging before reuse.

<video class="project-video" controls preload="metadata" poster="poster.jpg">
<source src="project.mp4" type="video/mp4">
<track kind="captions" src="captions.vtt" srclang="en" label="English" default>
</video>
<style>.project-video { display: block; width: 100%; aspect-ratio: 16 / 9; object-fit: contain; }</style>

Useful alongside this

Accessibility

Text

Visual

Orientation

Accessibility settings