HTMLImageElement.src

在此页

句法
范例
规范
浏览器兼容性
相关话题

HTMLImageElement property src , which reflects the HTML src attribute, specifies the image to display in the <img> 元素。

句法

htmlImageElement.src = newSource;
let src = htmlImageElement.src;

值

When providing only a single image, rather than a set of images from which the browser selects the best match for the viewport size and display pixel density, the src attribute is a USVString specifying the URL of the desired image. This can be set either within the HTML itself using the src content attribute, or programmatically by setting the element's src 特性。

若使用 srcset content attribute to provide multiple image options for different display pixel densities, the URL specified by the src attribute is used in one of two ways:

as a fallback for browsers that don't support srcset .
as an equivalent for specifying an image in srcset with the size multiplier 1x ; that is, the image specified by src is used on low-density screens (such as typical 72 DPI or 96 DPI displays).

Additionally, if you use src along with both sizes (or the corresponding sizes content attribute) and srcset in order to choose an image based on the viewport size, the src attribute is only used as a fallback for browsers that don't support sizes and srcset ; otherwise, it's not used at all.

范例

Specifying a single image

HTML

<img src="https://interactive-examples.mdn.mozilla.net/media/examples/grapefruit-slice-332-332.jpg"
     width="160"
     alt="Slices of grapefruit, looking yummy.">

结果

Using src with an image set

When using a set of images with the srcset 特性， src serves as either a fallback for older browsers, or as the 1x size of the image.

HTML

结果

Specifying a fallback for viewport-based selection

When using viewport-bases selection of an image from a srcset by also specifying the sizes 特性， src property serves as the fallback to be used on browsers that don't support viewport-based selection. Browsers that do support viewport-based selection will ignore src in this situation.

HTML

结果

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLImageElement.src' in that specification.	实时标准

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`src`	Chrome 1	Edge 12	Firefox Yes	IE ?	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android Yes	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持
兼容性未知 ?

元数据

最后修改： Feb 22, 2020

在此页

句法

值

范例

Specifying a single image

HTML

结果

Using src with an image set

HTML

结果

Specifying a fallback for viewport-based selection

HTML

结果

规范

浏览器兼容性

图例

相关话题