In Chrome 150 en 155 zijn verschillende wijzigingen aangebracht in de HTML-in-Canvas API. Deze wijzigingen zijn een reactie op feedback van de community en over standaarden, met als doel de ergonomie van de API te verbeteren. In deze blogpost worden de wijzigingen beschreven en hoe u ervoor kunt zorgen dat uw implementatie up-to-date is.
De updates omvatten de naamswijziging van kenmerken en methoden, de vereiste van expliciete voorafgaande toewijzing van textuurgeheugen en de update van DOM-synchronisatiemodellen. Daarnaast is de Origin Trial voor HTML-in-Canvas nu verlengd. Hieronder leggen we uit wat er verandert, waarom en hoe u uw codebase updatet.
Wijzigingen in Chrome 150
In Chrome 150 hebben we argumenthandtekeningen in WebGL en WebGPU gewijzigd om redundantie te elimineren en aan te sluiten bij moderne grafische conventies.
WebGL
We hebben overbodige argumenten (level, srcFormat, destType) verwijderd uit texElementImage2D
(ga naar de WebGL-discussie voor
meer informatie):
// Old implementation (Chrome < 150)
const level = 0;
const internalFormat = gl.RGBA;
const srcFormat = gl.RGBA;
const destType = gl.UNSIGNED_BYTE;
gl.texElementImage2D(
gl.TEXTURE_2D,
level,
internalFormat,
srcFormat,
destType,
element
);
// New implementation (from Chrome 150)
const internalFormat = gl.RGBA8;
gl.texElementImage2D(gl.TEXTURE_2D, internalFormat, element);
WebGPU
We hebben copyElementImageToTexture-parameters gestandaardiseerd in sourceDict- en
destDict-objecten (zie GPUWeb PR#6250):
// Old implementation (Chrome < 150)
GPUQueue.copyElementImageToTexture(
element,
width,
height,
{ texture: texture }
);
// New implementation (from Chrome 150)
const sourceDict = { source: element };
const destDict = {
destination: { texture: texture },
width: width,
height: height
};
GPUQueue.copyElementImageToTexture(sourceDict, destDict);
Wijzigingen in Chrome 155
Chrome 155 introduceert verdere verfijningen op basis van feedback van ontwikkelaars. We updaten de namen van methoden, vereisen expliciete voorafgaande toewijzing van textuurgeheugen, ondersteunen complexe DOM-substructuren en ontkoppelen DOM-synchronisatie.
WebGPU
De naam van de WebGPU-methode is gewijzigd van copyElementImageToTexture in drawElementImageToTexture. Naast de naamswijziging worden de parametercoördinaten uitgebreid (sourceX, sourceWidth) en worden de bestemmingsgrenzen gegroepeerd in een standaard size-object (GPUExtent3D):
// BEFORE (Chrome 150)
const sourceDict = {
source: myElement,
sx: 0,
sy: 0,
swidth: 100,
sheight: 100
};
const destDict = {
destination: { texture: myTexture },
width: 300,
height: 200
};
queue.copyElementImageToTexture(sourceDict, destDict);
// AFTER (Chrome 155+)
const sourceDict = {
source: myElement,
sourceX: 0,
sourceY: 0,
sourceWidth: 100,
sourceHeight: 100
};
const destDict = {
texture: myTexture,
size: { width: 300, height: 200 }
};
queue.drawElementImageToTexture(sourceDict, destDict);
WebGL
Er zijn 3 aspecten aan wijzigingen in WebGL voor HTML-in-Canvas:
- De naam van de methode verandert van
texElementImage2DintexElementSubImage2D.` - De methodehandtekening verandert. De belangrijkste wijziging is dat de argumenten
xoffsetenyoffsetworden toegevoegd om optioneel een offset te kunnen specificeren in de bestemmingstextuur waarin het element moet worden getekend. - De methode wijst niet meer automatisch bufferopslag toe voor de bestemmingstextuur. De opslag moet expliciet worden toegewezen voordat de API wordt gebruikt. Dit is vergelijkbaar met het gedrag van
texSubImage2D.
// 1. Capture natural layout size of the element
const elementImage = canvas.captureElementImage(element);
// 2. Pre-allocate texture backing once (or when element resizes)
gl.bindTexture(gl.TEXTURE_2D, texture);
gl.texImage2D(
gl.TEXTURE_2D,
0,
gl.RGBA8,
Math.ceil(elementImage.width),
Math.ceil(elementImage.height),
0,
gl.RGBA,
gl.UNSIGNED_BYTE,
null // null reserves VRAM without uploading pixels
);
// 3. Upload DOM into pre-allocated VRAM
gl.texElementSubImage2D(
gl.TEXTURE_2D,
0, // level
0, // xoffset
0, // yoffset
element // pass DOM element
);
Canvas-kenmerken en tekenbare onderliggende elementen
We updaten de manier waarop je je canvas voorbereidt om HTML te renderen.
Naam van layoutsubtree wijzigen in content="drawable"
In overeenstemming met de naamgevingsconventies voor HTML-kenmerken is de naam van het Booleaanse kenmerk layoutsubtree op het element <canvas> gewijzigd in content="drawable" (zie WICG-probleem 169 voor een gedetailleerde discussie).
Het kenmerk drawable voor afstammelingen
Eerder werden alleen directe onderliggende elementen van een canvas weergegeven. Als je complexe DOM-hiërarchieën wilt ondersteunen zonder de opmaak af te vlakken, kun je nu expliciet het kenmerk drawable toevoegen aan elk onderliggend element dat je onafhankelijk wilt tekenen:
<!-- BEFORE -->
<canvas layoutsubtree>
<div id="badge">
<h2>Player Stats</h2>
<button id="actionBtn">Equip</button>
</div>
</canvas>
<!-- AFTER (Chrome 155+) -->
<canvas content="drawable">
<!-- Subtree A (Body and heading) -->
<div id="badge" drawable>
<h2>Player Stats</h2>
<!-- Subtree B (Excluded from Subtree A; drawn and animated independently) -->
<button id="actionBtn" drawable>Equip</button>
</div>
</canvas>
Een element met drawable legt de hele substructuur vast, behalve geneste afstammelingen die ook drawable specificeren. Hierdoor kunnen bovenliggende containers en onderliggende elementen zoals knoppen worden geanimeerd en getekend in afzonderlijke tekenaanroepen.
Synchronisatie van hit-tests
Eerder moesten ontwikkelaars de retourwaarde van tekenmethoden vastleggen en deze doorsturen naar element.style.transform. De methode drawElementImage() retourneert nu void en synchronisatie is afhankelijk van de context.
2D-contexten: automatische synchronisatie
In 2D-canvas synchroniseert de browser automatisch de grenzen van de DOM-hit-test en de focusringen van de schermlezer met de getekende coördinaten. Je kunt alle handmatige transform-pipes verwijderen:
// BEFORE
const transform = ctx.drawElementImage(element, x, y);
element.style.transform = transform.toString();
// AFTER (Chrome 155+)
ctx.drawElementImage(element, x, y);
// No style update needed: position & hit-testing sync automatically
Als je geometrie handmatig wilt beheren in 2D, geef je { preserveElementGeometry: true } door aan drawElementImage() en pas je transformaties toe met canvas.updateElementGeometry().
3D-contexten: expliciet updateElementGeometry()
Als je DOM wilt synchroniseren in WebGL- of WebGPU-contexten, maak je een DOMMatrix-transformatie
en geef je deze door aan canvas.updateElementGeometry():
canvas.addEventListener('paint', () => {
// 1. Upload element snapshot to GPU texture
device.queue.drawElementImageToTexture({ source: element }, { texture });
// 2. Render 3D scene...
drawScene();
// 3. Construct transform matrix as needed
const canvasTransform = new DOMMatrix().translate(x, y);
// 4. Update DOM hit-testing and accessibility bounding boxes
canvas.updateElementGeometry(element, { canvasTransform });
});
Compatibiliteit tussen versies
Als je app gebruikers in meerdere Chrome-versies moet ondersteunen tijdens de overgangsperiode, controleer je of de geüpdatete methoden aanwezig zijn in de prototypes en pas je de implementatie hierop aan.
Zorg dat u de juiste kenmerken voor het element <canvas> instelt voor elke browserversie:
// ============================================================================
// Cross-version canvas markup
// ============================================================================
if (!canvas.hasAttribute('content') && !canvas.hasAttribute('layoutsubtree')) {
if ('content' in HTMLCanvasElement.prototype) {
// Chrome 155+ (New standardized attribute)
canvas.setAttribute('content', 'drawable');
} else {
// Chrome < 155 (Legacy boolean attribute)
canvas.setAttribute('layoutsubtree', '');
}
}
Voor 2D-context inspecteer je de retourwaarde van drawElementImage() en check je de kenmerken van het canvasprototype om beide versies te ondersteunen:
// ============================================================================
// Cross-version 2D drawing & synchronization
// ============================================================================
function draw2DElement(ctx, element, x, y) {
// Execute the 2D draw call
const result = ctx.drawElementImage(element, x, y);
if (result !== undefined && typeof result?.toString === 'function') {
// Chrome < 155: drawElementImage returned a DOMMatrix
// Requires manual transform piping to align DOM hit-test bounds:
element.style.transform = result.toString();
} else {
// Chrome 155+: drawElementImage returns void / undefined
// The browser automatically aligns DOM positioning, clicks, and a11y bounds!
// If you previously had element.style.transform logic here, clear it:
if (element.style.transform) {
element.style.transform = "";
}
}
}
Gebruik voor WebGPU de compatibele methodehandtekening en -naam:
// ============================================================================
// WebGPU cross-version support
// ============================================================================
if ('drawElementImageToTexture' in GPUQueue.prototype) {
// Chrome 155+ (Latest implementation)
queue.drawElementImageToTexture(
{ source: element, sourceX: 0, sourceY: 0, sourceWidth: w, sourceHeight: h },
{ texture: myTexture, size: { width: w, height: h } }
);
} else if (typeof queue.copyElementImageToTexture === "function") {
// Chrome 150 - 154: Try the Chrome 150+ dictionary signature first,
// then fall back to the Chrome < 150 signature
try {
queue.copyElementImageToTexture(
{ source: element },
{ destination: { texture: myTexture }, width: w, height: h }
);
} catch (err) {
// Chrome < 150
queue.copyElementImageToTexture(element, { texture: myTexture });
}
}
Controleer de browsercompatibiliteit voor WebGL:
// ============================================================================
// WebGL cross-version support
// ============================================================================
if ('texElementSubImage2D' in WebGL2RenderingContext.prototype) {
// Chrome 155+ (Explicit pre-allocation + sub-image)
gl.texElementSubImage2D(gl.TEXTURE_2D, 0, 0, 0, element);
} else if (gl.texElementImage2D && gl.texElementImage2D.length === 3) {
// Chrome 150-154 (3-argument signature)
gl.texElementImage2D(gl.TEXTURE_2D, gl.RGBA8, element);
} else if (gl.texElementImage2D) {
// Chrome < 150 (6-argument signature)
gl.texElementImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, element);
}
Origin Trial-extensie
De Origin Trial voor HTML-in-Canvas is verlengd tot en met Chrome 160. Verleng je origin trial-token om de functie HTML-in-Canvas aan je gebruikers te blijven aanbieden. Ga naar het artikel over Origin-proefperioden voor meer informatie.
Je feedback delen
Laat ons weten hoe deze updates werken in je apps door een probleem te melden in de WICG GitHub-repository. Meld je aan voor de ontwikkelaarsnieuwsbrief om op de hoogte te blijven van nieuws over HTML in Canvas.