CKTIS / JavaScript
Image — een afbeeldingselement maken
Image maakt een HTMLImageElement buiten de documentboom. Optionele argumenten stellen de afmetingen in, maar laden geen afbeelding en wijzigen de grootte van het bestand niet.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Image(); new Image(width); new Image(width, height)new Image() maakt een img-element van het type HTMLImageElement, net als document.createElement("img"). Het voegt het element niet toe aan het document. Image is een HTML-API die beschikbaar is in de Window-omgeving en maakt geen deel uit van ECMAScript; de aanwezigheid van Node 24 in een repository bewijst niet dat deze API beschikbaar is. Huidige browserengines ondersteunen deze constructor.
De optionele argumenten width en height stellen de bijbehorende afmetingsattributen in. Ze veranderen de afbeeldingsgegevens niet; CSS kan de uiteindelijke weergavegrootte beïnvloeden. naturalWidth en naturalHeight geven de voor dichtheid gecorrigeerde natuurlijke afmetingen in CSS-pixels aan; voordat de afbeelding beschikbaar is, zijn ze 0.
Het instellen van src start de asynchrone verwerking van de bron, ook buiten de documentboom. Verwerk voordat je de afbeelding weergeeft de gebeurtenissen load en error, of het vervullen en afwijzen van de decode()-promise. complete === true bewijst op zichzelf geen succes: dit geldt ook als er geen bron is of als er een fout is opgetreden. Stel bij het weergeven van de afbeelding een passende alt in.
Voorbeelden
const image = new Image(32, 16);
console.log(image instanceof HTMLImageElement);
console.log(image.width, image.height);
console.log(image.isConnected);
console.log(image.naturalWidth, image.naturalHeight);Resultaat
true 32 16 false 0 0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.