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