HTMLImageElement: naturalWidth-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die schreibgeschützte naturalWidth-Eigenschaft des HTMLImageElement-Interfaces gibt die intrinsische (natürliche), dichtekorrigierte Breite des Bildes in CSS-Pixeln zurück.
Das ist die Breite, die das Bild hat, wenn nichts seine Breite einschränkt; wenn Sie weder eine Breite für das Bild angeben noch das Bild in einen Container platzieren, der die Breite des Bildes einschränkt oder ausdrücklich festlegt, wird es in dieser Breite dargestellt.
Hinweis: Meistens ist die natürliche Breite die tatsächliche Breite des vom Server gesendeten Bildes. Dennoch können Browser ein Bild ändern, bevor es zum Renderer geschickt wird. Zum Beispiel verschlechtert Chrome die Auflösung von Bildern auf Geräten mit niedriger Leistung. In solchen Fällen berücksichtigt naturalWidth die Breite des Bildes, die durch solche Eingriffe des Browsers modifiziert wurde, als natürliche Breite und gibt diesen Wert zurück.
Wert
Ein ganzzahliger Wert, der die intrinsische Breite des Bildes in CSS-Pixeln angibt. Dies ist die Breite, in der das Bild natürlich gezeichnet wird, wenn keine Einschränkung oder ein bestimmter Wert für das Bild festgelegt ist. Diese natürliche Breite wird für die Pixeldichte des Geräts korrigiert, auf dem sie präsentiert wird, im Gegensatz zu width.
Wenn die intrinsische Breite nicht verfügbar ist – entweder weil das Bild keine intrinsische Breite angibt oder weil die Bilddaten nicht verfügbar sind, um diese Information zu erhalten, gibt naturalWidth 0 zurück.
Beispiele
Siehe HTMLImageElement.naturalHeight für Beispielcode, der ein Bild sowohl in seiner natürlichen "dichteangepassten" Größe als auch in seiner durch die CSS der Seite und andere Faktoren veränderten Größe anzeigt.
Spezifikationen
| Specification |
|---|
| HTML # dom-img-naturalwidth-dev |