DasHTMLSourceElement-Interface bietet spezielle Eigenschaften (jenseits der regulärenHTMLElement-Objektschnittstelle, die es ebenfalls durch Vererbung zur Verfügung hat) zur Manipulation von<source>-Elementen.

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil,HTMLElement.

HTMLSourceElement.height

Eine Zahl, die das HTML-Attributheight widerspiegelt und die Höhe der Bildressource in CSS-Pixel angibt. Die Eigenschaft hat nur eine Bedeutung, wenn das übergeordnete Element des aktuellen<source>-Elements ein<picture>-Element ist.

HTMLSourceElement.media

Ein String, der das HTML-Attributmedia widerspiegelt und den beabsichtigten Medientyp der Ressource enthält.

HTMLSourceElement.sizes

Ein String, der Bildgrößen zwischen Breakpoints darstellt

HTMLSourceElement.src

Ein String, der das HTML-Attributsrc widerspiegelt und die URL für die Medienressource enthält. DieHTMLSourceElement.src-Eigenschaft hat nur eine Bedeutung, wenn das zugehörige<source>-Element in einem Medienelement verschachtelt ist, das ein<video> oder ein<audio>-Element ist. Es hat keine Bedeutung und wird ignoriert, wenn es in einem<picture>-Element verschachtelt ist.

Hinweis:Wenn diesrc-Eigenschaft aktualisiert wird (zusammen mit allen Geschwistern), sollte dieload-Methode des übergeordnetenHTMLMediaElement aufgerufen werden, da<source>-Elemente nicht automatisch neu gescannt werden.

HTMLSourceElement.srcset

Ein String, der das HTML-Attributsrcset widerspiegelt und eine Liste von Kandidatenbildern enthält, getrennt durch ein Komma (',', U+002C COMMA). Ein Kandidatenbild ist eine URL, gefolgt von einem'w' mit der Breite der Bilder oder einem'x' gefolgt von der Pixeldichte.

HTMLSourceElement.type

Ein String, der das HTML-Attributtype widerspiegelt und den Typ der Medienressource enthält.

HTMLSourceElement.width

Eine Zahl, die das HTML-Attributwidth widerspiegelt und die Breite der Bildressource in CSS-Pixeln angibt. Die Eigenschaft hat nur eine Bedeutung, wenn das übergeordnete Element des aktuellen<source>-Elements ein<picture>-Element ist.

Instanzmethoden

Keine spezifische Methode; erbt Methoden von seinem Elternteil,HTMLElement.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Das HTML-Element, das diese Schnittstelle implementiert:<source>.
• Die HTML-DOM-APIs der Elemente, die ein<source>-Element enthalten können:HTMLVideoElement,HTMLAudioElement,HTMLPictureElement.