HTMLImageElement.decoding

HTMLImageElement 接口的 decoding 属性用于告诉浏览器使用何种方式解析图像数据。

Syntax

refStr = imgElem.decoding;
imgElem.decoding = refStr;

Values

使用 DOMString 表示解码方式。可使用以下值：

  • sync: 同步解码图像，保证与其他内容一起显示。
  • async: 异步解码图像，加快显示其他内容。
  • auto: 默认模式，表示不偏好解码模式。由浏览器决定哪种方式更适合用户。

Usage notes

decoding 属性使您可以控制是否允许浏览器尝试异步加载图像。如果这样做会引起问题，您可指定值为 sync 禁止异步加载。异步加载对 <img> 元素很有用，对屏幕外的图像对象可能会更有用。

Examples

var img = new Image();
img.decoding = 'sync';
img.src = 'img/logo.png';

Specifications

Specification
HTML Standard
# dom-img-decoding

Browser compatibility

BCD tables only load in the browser