Adding a picture or video is the easy part. Making it load efficiently and understandable to every visitor is the real goal.
What You Need to Know
The video element places moving pictures on a page. Controls give viewers ordinary playback options, while a poster provides a preview image before playback. Files must be available at the paths you use.
In this example: build an accessible video player.
Try the Example
Take a look at the example. We’ll explain the important lines right below it.
<video controls preload="metadata" width="640" poster="images/lesson-preview.jpg">
<source src="media/lesson.mp4" type="video/mp4">
<track src="media/captions-en.vtt" kind="captions" srclang="en" label="English">
Video playback is unavailable.
</video>Let’s Read the Code
- <video>: The video element creates a video player and can include alternative formats.
- <source>: A source points to a media file or image choice with a type or other condition.
- controls: Controls asks the browser to provide its native audio or video player controls.
- preload: Preload hints how much media to fetch before playback.
Read the named elements and attributes together. They explain how the browser connects this feature to the rest of the page.
What Happens in the Browser?
The paths shown here refer to files in your own example project. Put real images and recordings in those locations before expecting them to load.
What if the resource is missing? Test the page with the media path temporarily broken. The surrounding text should still explain the important idea, and controls should remain understandable. This is especially important for slow connections and accessibility.
Your Turn
Replace the media filename with your own local recording and check playback, controls, and fallback content.
Common Beginner Mistakes
- Forgetting that captions are stored in a separate timed-text file, not generated by the video tag.
- Always check keyboard access, readable alternatives, and any missing files; a perfect player layout does not guarantee accessible content.
Key Takeaways
- The video element places moving pictures on a page.
- <video>: The video element creates a video player and can include alternative formats.
- If the resource cannot load, users still need enough text to understand what was meant to be there.