This page is Not Ready

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

media


Summary

Presents audio or video data to the user. The media element provides the audio and video objects which are used to play sound and video content.


Overview Table

DOM Interface
HTMLElement


Standards information


Members

The media object has these types of members:

  • [#events Events]
  • [#methods Methods]
  • [#properties Properties]


Events

The media object has these events.

Event Description
onabort Fires when the user aborts the download.
onblur Fires when the object loses the input focus.
onchange Fires when the contents of the object or selection have changed.
ondrag Fires on the source object continuously during a drag operation.
ondragend Fires on the source object when the user releases the mouse at the close of a drag operation.
ondragenter Fires on the target element when the user drags the object to a valid drop target.
ondragleave Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.
ondragover Fires on the target element continuously while the user drags the object over a valid drop target.
ondrop Fires on the target object when the mouse button is released during a drag-and-drop operation.
onerror Fires when an error occurs during object loading.
onfocus Fires when the object receives focus.
oninput Occurs when the text content of an element is changed through the user interface.
onload Fires immediately after the client loads the object.
onreset Fires when the user resets a form.
onscroll Fires when the user repositions the scroll box in the scroll bar on the object.
onselect Fires when the current selection changes.

Methods

The media object has these methods.

Method Description
canPlayType Returns a string that specifies whether the client can play a given media resource type.
compareDocumentPosition Compares the position of two nodes in a document.
getAttributeNodeNS Gets an attribute object that matches the specified namespace and name.
getAttributeNS Gets the value of the specified attribute within the specified namespace.
getElementsByClassName Gets a collection of objects that are based on the value of the CLASS attribute.
getElementsByTagNameNS Gets a collection of objects that are based on the specified element names within a specified namespace.
hasAttributeNS Determines whether an attribute that has the specified namespace and name exists.
isDefaultNamespace Indicates whether or not a namespace is the default namespace for a document.
isEqualNode Determines if two nodes are equal.
isSameNode Determines if two node references refer to the same node.
isSupported Returns a value indicating whether or not the object supports a specific DOM standard.
load Resets the IHTMLMediaElement and loads a new media resource.
lookupNamespaceURI Gets the URI of the namespace associated with a namespace prefix, if any.
lookupPrefix Gets the namespace prefix associated with a URI, if any.
msClearEffects Clears all effects from the media pipeline.
msInsertAudioEffect Inserts the specified audio effect into media pipeline.
msMatchesSelector Determines whether an object matches the specified selector.
msSetMediaProtectionManager Specifies the media protection manager for a given media pipeline.
pause Pauses the current playback and sets paused to TRUE.
play Loads and starts playback of a media resource.
removeAttributeNS Removes the specified attribute from the object.
setAttributeNodeNS Sets an attribute object as part of the object.
setAttributeNS Sets the value of the specified attribute within the specified namespace.

Properties

The media object has these properties.

Property Description
audioTracks Returns an AudioTrackList object with the audio tracks for a given video element.
autobuffer The autobuffer element is not supported by Internet Explorer 9. Use the preload element instead.

This property is not supported for Metro style apps using JavaScript

autoplay Gets or sets a value that indicates whether to start playing the media automatically.
buffered Gets a collection of buffered time ranges.
controls Gets or sets a flag that indicates whether the client provides a set of controls for the media (in case the developer does not include controls for the player).
currentSrc Gets the address or URL of the current media resource (video,audio) that is selected by IHTMLMediaElement.
currentTime Gets or sets the current playback position, in seconds.
defaultPlaybackRate Gets or sets the default playback rate when the user is not using fast foward or reverse for a video or audio resource.
duration Gets the duration, in seconds, of the current media resource, a NaN value if duration is not available, or Infinity if the media resource is streaming.
ended Gets information about whether the playback has ended or not.
error Gets an IHTMLMediaError object representing the current error state of the media element.
initialTime Gets the earliest possible position, in seconds, that the playback can begin.
localName Retrieves the local name of the fully qualified XML declaration for a node.
loop Gets or sets a flag that specifies whether playback should restart after it completes.
msAudioCategory Specifies the purpose of the audio or video media, such as background audio or alerts.
msAudioDeviceType Specifies the output device id that the audio will be sent to.
msPlayToDisabled Gets or sets whether the DLNA PlayTo device is available.
msPlayToPrimary Gets or sets the primary DLNA PlayTo device.
msPlayToSource Gets the source associated with the media element for use by the PlayToManager.
msRealTime Specifies whether or not to enable low-latency playback on the media element.
muted Gets or sets a flag that indicates whether the audio (either audio or the audio track on video media) is muted.
namespaceURI Retrieves the namespace URI of the fully qualified XML declaration for a node.
networkState Gets the current network activity for the element.
paused Gets a flag that specifies whether playback is paused.
playbackRate Gets or sets the current speed for the media resource to play. This speed is expressed as a multiple of the normal speed of the media resource.
played Gets TimeRanges for the current media resource that has been played.
prefix Retrieves the local name of the fully qualified XML declaration for a node.
preload Gets or sets a hint to how much buffering is advisable for a media resource, even if autoplay is not specified.
seekable Returns a TimeRanges object that represents the ranges of the current media resource that can be seeked.
seeking Gets a flag that indicates whether the the client is currently moving to a new playback position in the media resource.
src The address or URL of the a media resource (video, audio) that is to be considered.
textContent Sets or retrieves the text content of an object and any child objects.
volume Gets or sets the volume level for audio portions of the media element.


See also

Related pages

  • Reference
  • audio
  • video

Attributions