About HTML5 Audio and Video
If you embed audio or video in your website, you should use HTML5.
HTML5 is the next major version of HTML, the primary standard that determines how web content interacts with browsers. HTML5 supports audio and video playback natively in the browser, without requiring a plug-in. With HTML5, you can add media to a webpage with just a line or two of code.
The HTML5 media elements provide simple fallback for browsers that still need to use plug-ins, so you can update your website to HTML5 today and still be compatible with older browsers.
<video> tags make it simple to add media to your website. Just include the
<video> element, use the
src attribute to identify the media source, and include the
<video src="mymovie.mp4" controls></video>
There are no plug-ins to install or configure. The audio or video downloads and plays in your webpage with built-in controls.
In Safari, the built-in video controls include a play/pause button, volume control, and a time scrubber. In Safari 5.0 and later on the desktop and on iOS 4.2 on the iPad, the controls also include a full-screen playback toggle on the lower right. The controls automatically fade out when the video is playing and fade in when the user hovers over the video or touches it.
If you want to provide your own media controller on the desktop or iPad, just leave out the
In Safari 5.1 and later, you can choose any HTML element and expand it to fill the screen, allowing you to use your own custom controls while playing video in full-screen mode.
At a Glance
Safari supports the
<audio> media elements on iOS 3.0 and later and in Safari 3.1 and later on the desktop (Mac OS X and Windows). Support for these media elements allows Safari and other HTML5-compliant browsers to play the indicated source media without using a plug-in.
Create the HTML5 Media Elements
To use HTML5 audio or video, start by creating an
<video> element, specifying a source URL for the media, and including the
<video src="http://example.com/path/mymovie.mp4" controls></video>
Add Optional Attributes
You can set additional attributes to tell Safari that the media should autoplay or loop, for example, or specify a video height and width. You set boolean attributes such as
autoplay by including or omitting them—no value is required.
controls autoplay height="480" width="640">
For more information, see “Working with Attributes.”
Provide Alternate Sources
Not all browsers can play all media sources. Some browsers are able to play MPEG-4 or MP3 files, while others play only files compressed using codecs such as Ogg Vorbis. Desktop computers can typically play media using a wider assortment of compressors than mobile devices. Safari supports streaming delivery using HTTP Live Streaming, while some other browsers support only HTTP download. To provide the best experience for everyone, you can provide multiple versions of your media. List the sources in order of preference using separate
<source> tags. The browser iterates through the list and plays the first source that it can.
You don’t have to rely on the file extension and delivery scheme to tell Safari about the media file. The
<source> tag accepts attributes for MIME type and codecs as well. For details, see “Providing Multiple Sources.”
Fall Back in Good Order
Browsers that don’t support HTML5 ignore the
<video> tags, and HTML5-savvy browsers ignore anything between the opening and closing tags except
<source> tags, so it’s easy to specify fallback behavior for older browsers. Just put the fallback HTML between the opening and closing
<video> tags (after any
<video src="mymovie.mov" controls>
<!-- fallback -->
<p>Your browser does not support HTML5 video.</p>
Your fallback can be an
<object> tag for a browser that needs a plug-in to play your media, a redirect to another page, or a simple error message telling the user what the problem is.
For more information, including examples of how to use a plug-in as a fallback, see “Specifying Fallback Behavior.”
For a complete list of methods, properties, and events that Safari supports, see HTMLMediaElement Class Reference, HTMLVideoElement Class Reference, and HTMLAudioElement Class Reference.
Display a progress indicator that shows how much of the media has downloaded—for an example, see “Using DOM Events to Monitor Load Progress.”
Load another audio or video when the current one finishes playing—for an example, see “Replacing a Media Source Sequentially.”
Slave multiple audio and/or video elements to a master controller to ensure your media elements are always synchronized—for an example, see “Syncing Multiple Media Elements Together.”
Set the Style with CSS3
You can also change the CSS properties of other parts of your webpage in response to media events. For example, you could darken the background and reduce the opacity of the rest of the page—effectively “dimming the lights”—when a movie is playing, or highlight the title of the currently-playing song in a playlist.
For more information, see “Changing Styles in Response to Media Events” and “Adding CSS Styles to Video.”
For code examples, see “Example: Setting Opacity,” “Adding a Mask,” “Adding a Reflection,” and “Rotating Video in 3D.”
Safari CSS Visual Effects Guide—How to use CSS transitions and effects in Safari.
Safari CSS Reference—Complete list of CSS properties, rules, and property functions supported in Safari, with syntax and usage.
Safari HTML Reference—The HTML elements and attributes supported by different Safari and WebKit applications.
WebKit DOM Programming Topics—How to get the most out of using DOM events in Safari.
iOS Human Interface Guidelines—User interface guidelines for designing webpages and web applications for Safari on iOS.
© 2012 Apple Inc. All Rights Reserved. (Last updated: 2012-12-13)