Source media
Attribute
Example
Returns what media/device the specified file is optimized for:
x Output result:
Definition and Usage
The media
attribute sets or returns the value of the media
attribute in a <source>
element.
The media
attribute specifies the type of media resource (what media/device the file is optimized for).
Browsers use the media
attribute to determine if they can play the file. If they cannot, they may choose not to download the file.
Note: The <source>
element is new in HTML5.
Browser Support
All major browsers support the media
attribute.
Note: Almost all major browsers do not support the media
attribute.
Syntax
Return the media
attribute:
Set the media
attribute:
Note: This attribute can accept multiple values.
Possible Operators
Value | Description |
---|---|
and | Specifies an AND operator. |
not | Specifies a NOT operator. |
, | Specifies an OR operator. |
Devices
Value | Description |
---|---|
all | Default. Suitable for all devices. |
aural | Speech synthesizers. |
braille | Braille feedback devices. |
handheld | Handheld devices (small screen, limited bandwidth). |
projection | Projectors. |
Print preview mode/print pages. | |
screen | Computer screens. |
tty | Teletypes and similar media using a fixed-pitch character grid. |
tv | Television-type devices (low resolution, limited scrollability). |
Values
Value | Description |
---|---|
width | Specifies the width of the target display area. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (min-width:500px)" |
height | Specifies the height of the target display area. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (max-height:700px)" |
device-width | Specifies the width of the target display/paper. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (device-width:500px)" |
device-height | Specifies the height of the target display/paper. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (device-height:500px)" |
orientation | Specifies the orientation of the target display/paper. <br>Possible values: "portrait" or "landscape". <br>Example: media="all and (orientation: landscape)" |
aspect-ratio | Specifies the width/height ratio of the target display area. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (aspect-ratio:16/9)" |
device-aspect-ratio | Specifies the device-width/device-height ratio of the target display/paper. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (aspect-ratio:16/9)" |
color | Specifies the bits/color of the target display. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (color:3)" |
color-index | Specifies the number of colors the target display can handle. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (min-color-index:256)" |
monochrome | Specifies the bits/pixel in a monochrome frame buffer. <br>Can use "min-" and "max-" prefixes. <br>Example: media="screen and (monochrome:2)" |
resolution | Specifies the pixel density of the target display/paper (dpi or dpcm). <br>Can use "min-" and "max-" prefixes. <br>Example: media="print and (resolution:300dpi)" |
scan | Specifies the scanning method of tv displays. <br>Possible values: "progressive" and "interlace". <br>Example: media="tv and (scan:interlace)" |
grid | Specifies whether the output device is a grid or bitmap. <br>Possible values: "1" for grid, otherwise "0". <br>Example: media="handheld and (grid:1)" |
Technical Details
| Return Value: | A string, representing the type of media resource. | | --- | --- |
Related Articles
HTML Reference: HTML <source> media Attribute