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.
![]() |
DOM Information
Inheritance Hierarchy
Members
The media object has these types of members:
Events
The media object has these events.
| Event | Description |
|---|---|
| abort |
Fires when the user aborts the download. |
| blur |
Fires when the object loses the input focus. |
| change |
Fires when the contents of the object or selection have changed. |
| drag |
Fires on the source object continuously during a drag operation. |
| dragend |
Fires on the source object when the user releases the mouse at the close of a drag operation. |
| dragenter |
Fires on the target element when the user drags the object to a valid drop target. |
| dragleave |
Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation. |
| dragover |
Fires on the target element continuously while the user drags the object over a valid drop target. |
| drop |
Fires on the target object when the mouse button is released during a drag-and-drop operation. |
| error |
Fires when an error occurs during object loading. |
| focus |
Fires when the object receives focus. |
| input |
Occurs when the text content of an element is changed through the user interface. |
| load |
Fires immediately after the client loads the object. |
| onselect |
Fires when the current selection changes. |
| reset |
Fires when the user resets a form. |
| scroll |
Fires when the user repositions the scroll box in the scroll bar on the object. |
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 |
|---|---|
|
Returns an AudioTrackList object with the audio tracks for a given video element. | |
|
Gets or sets a value that indicates whether to start playing the media automatically. | |
|
Gets a collection of buffered time ranges. | |
|
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). | |
|
Gets the address or URL of the current media resource (video,audio) that is selected by IHTMLMediaElement. | |
|
Gets or sets the current playback position, in seconds. | |
|
Gets or sets the default playback rate when the user is not using fast foward or reverse for a video or audio resource. | |
|
Gets the duration, in seconds, of the current media resource, a | |
|
Gets information about whether the playback has ended or not. | |
|
Gets an IHTMLMediaError object representing the current error state of the media element. | |
|
Gets the earliest possible position, in seconds, that the playback can begin. | |
|
Retrieves the local name of the fully qualified XML declaration for a node. | |
|
Gets or sets a flag that specifies whether playback should restart after it completes. | |
|
Specifies the purpose of the audio or video media, such as background audio or alerts. | |
|
Specifies the output device id that the audio will be sent to. | |
|
Gets or sets whether the DLNA PlayTo device is available. | |
|
Gets or sets the primary DLNA PlayTo device. | |
|
Gets the source associated with the media element for use by the PlayToManager. | |
|
Specifies whether or not to enable low-latency playback on the media element. | |
|
Gets or sets a flag that indicates whether the audio (either audio or the audio track on video media) is muted. | |
|
Retrieves the namespace URI of the fully qualified XML declaration for a node. | |
|
Gets the current network activity for the element. | |
|
Gets a flag that specifies whether playback is paused. | |
|
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. | |
|
Gets TimeRanges for the current media resource that has been played. | |
|
Retrieves the local name of the fully qualified XML declaration for a node. | |
|
Gets or sets a hint to how much buffering is advisable for a media resource, even if autoplay is not specified. | |
|
Returns a TimeRanges object that represents the ranges of the current media resource that can be seeked. | |
|
Gets a flag that indicates whether the the client is currently moving to a new playback position in the media resource. | |
|
The address or URL of the a media resource (video, audio) that is to be considered. | |
|
Sets or retrieves the text content of an object and any child objects. | |
|
Gets or sets the volume level for audio portions of the media element. |
Standards information
- HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 4.8.10
See also
Build date: 11/28/2012
