HTMLImageElement: width Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die width Eigenschaft des HTMLImageElement Interfaces gibt die Breite an, mit der ein Bild in CSS-Pixeln gezeichnet wird, wenn es auf einem visuellen Medium wie einem Bildschirm oder Drucker dargestellt wird. Andernfalls ist es die natürliche, pixeldichtekorrigierte Breite des Bildes.

Wert

Ein ganzzahliger Wert, der die Breite des Bildes angibt. Die Art und Weise, wie die Breite definiert wird, hängt davon ab, ob das Bild auf einem visuellen Medium dargestellt wird:

  • Wenn das Bild auf einem visuellen Medium dargestellt wird, wird die Breite in CSS-Pixeln angegeben.
  • Wenn das Bild nicht auf einem visuellen Medium dargestellt wird, wird seine Breite unter Verwendung der natürlichen (intrinsischen) Breite des Bildes dargestellt, angepasst an die Darstellungsdichte wie durch naturalWidth angegeben.

Beispiele

In diesem Beispiel werden zwei verschiedene Größen für ein Bild einer Uhr mithilfe des srcset-Attributs bereitgestellt. Eine ist 200px breit und die andere ist 400px breit. Das sizes-Attribut wird verwendet, um die Breite anzugeben, mit der das Bild bei gegebener Bildschirmbreite gezeichnet werden soll.

HTML

Für Viewports bis zu 400px Breite wird das Bild mit einer Breite von 200px gezeichnet. Andernfalls wird es mit 400px gezeichnet.

html
<p>Image width: <span class="size">?</span>px (resize to update)</p>
<img
  src="/en-US/docs/Web/HTML/Element/img/clock-demo-200px.png"
  alt="Clock"
  srcset="
    /en-US/docs/Web/HTML/Element/img/clock-demo-200px.png 200w,
    /en-US/docs/Web/HTML/Element/img/clock-demo-400px.png 400w
  "
  sizes="(max-width: 400px) 200px, 400px" />

JavaScript

JavaScript betrachtet die width Eigenschaft, um die aktuelle Breite des Bildes zu bestimmen. Dies wird in den Event-Handlern load und resize des Fensters durchgeführt, sodass immer die aktuellsten Breiteninformationen verfügbar sind.

js
const clockImage = document.querySelector("img");
let output = document.querySelector(".size");

const updateWidth = (event) => {
  output.innerText = clockImage.width;
};

window.addEventListener("load", updateWidth);
window.addEventListener("resize", updateWidth);

Ergebnis

Dieses Beispiel ist möglicherweise leichter auszuprobieren in its own window.

Spezifikationen

Specification
HTML Standard
# dom-img-width-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch