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
Standards information
- HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 4.8.10
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
Referenceaudiovideo
Attributions
Microsoft Developer Network: [Windows Internet Explorer API reference Article]