HTML-in-Canvas से जुड़े अपडेट: बेहतर Web API की ओर बढ़ना

Chrome 150 और 155 में, HTML-in-Canvas API में कई बदलाव किए गए हैं. ये बदलाव, कम्यूनिटी और स्टैंडर्ड से मिले सुझावों के आधार पर किए गए थे. इनका मकसद, एपीआई को इस्तेमाल करने के अनुभव को बेहतर बनाना था. इस ब्लॉग पोस्ट में, इन बदलावों के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि कैसे यह पक्का किया जा सकता है कि आपका लागू किया गया तरीका, इन बदलावों के हिसाब से अप-टू-डेट हो.

इन बदलावों में, एट्रिब्यूट और तरीकों के नाम बदलना, टेक्सचर मेमोरी को पहले से तय करना, और डीओएम सिंक्रोनाइज़ेशन मॉडल को अपडेट करना शामिल है. इसके अलावा, HTML-in-Canvas का ऑरिजिन ट्रायल अब बढ़ा दिया गया है. यहां बताया गया है कि क्या-क्या बदलाव किए जा रहे हैं, ये बदलाव क्यों किए जा रहे हैं, और अपने कोड बेस को कैसे अपडेट किया जा सकता है.

Chrome 150 में होने वाले बदलाव

Chrome 150 में, हमने WebGL और WebGPU में आर्ग्युमेंट सिग्नेचर बदल दिए हैं, ताकि ग़ैर-ज़रूरी चीज़ों को हटाया जा सके और आधुनिक ग्राफ़िक्स कन्वेंशन के साथ अलाइन किया जा सके.

WebGL

हमने texElementImage2D से ग़ैर-ज़रूरी आर्ग्युमेंट (level, srcFormat, destType) हटा दिए हैं. ज़्यादा जानकारी के लिए, WebGL से जुड़ी चर्चा देखें:

// 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

हमने copyElementImageToTextureपैरामीटर को sourceDict और destDict ऑब्जेक्ट में स्टैंडर्डाइज़ किया है (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);

Chrome 155 में होने वाले बदलाव

Chrome 155 में, डेवलपर से मिले सुझावों के आधार पर और सुधार किए गए हैं. हम मेथड के नाम अपडेट कर रहे हैं. इसके लिए, टेक्सचर मेमोरी को पहले से तय करना ज़रूरी है. साथ ही, हम जटिल डीओएम सबट्री के साथ काम करने की सुविधा और डीओएम सिंक्रनाइज़ेशन को अलग करने की सुविधा भी जोड़ रहे हैं.

WebGPU

WebGPU के तरीके का नाम copyElementImageToTexture से बदलकर drawElementImageToTexture कर दिया गया है. नाम बदलने के साथ-साथ, पैरामीटर कोऑर्डिनेट को बड़ा किया गया है (sourceX, sourceWidth). साथ ही, डेस्टिनेशन बाउंड को स्टैंडर्ड size (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

HTML-in-Canvas के लिए WebGL में होने वाले बदलावों के तीन पहलू हैं:

  • तरीके का नाम texElementImage2D से बदलकर texElementSubImage2D हो जाता है.`
  • मेथड सिग्नेचर में बदलाव होता है. सबसे अहम बात यह है कि इसमें xoffset और yoffset आर्ग्युमेंट जोड़े जाते हैं. इससे, डेस्टिनेशन टेक्सचर में ऑफ़सेट की जानकारी देने की सुविधा मिलती है. इस ऑफ़सेट पर एलिमेंट को ड्रॉ किया जाता है.
  • यह तरीका, डेस्टिनेशन टेक्सचर के लिए बफ़र स्टोरेज को अपने-आप असाइन नहीं करता. एपीआई का इस्तेमाल करने से पहले, स्टोरेज को साफ़ तौर पर असाइन करना ज़रूरी है. यह 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
);

कैनवस एट्रिब्यूट और ड्रॉ किए जा सकने वाले चाइल्ड एलिमेंट

हम एचटीएमएल रेंडर करने के लिए, कैनवस तैयार करने के तरीके को अपडेट कर रहे हैं.

layoutsubtree का नाम बदलकर content="drawable" किया जा रहा है

एचटीएमएल एट्रिब्यूट के नाम रखने के नियमों के मुताबिक, <canvas> एलिमेंट पर बूलियन layoutsubtree एट्रिब्यूट का नाम बदलकर content="drawable" कर दिया गया है. ज़्यादा जानकारी के लिए, WICG समस्या #169 देखें.

डिसेंडेंट के लिए drawable एट्रिब्यूट

पहले, सिर्फ़ कैनवस के डायरेक्ट चाइल्ड रेंडर किए जाते थे. मार्कअप को फ़्लैट किए बिना, जटिल डीओएम हैरारकी को सपोर्ट करने के लिए, अब किसी भी डिसेंडेंट एलिमेंट में drawable एट्रिब्यूट को साफ़ तौर पर जोड़ा जा सकता है. इससे, उस एलिमेंट को अलग से ड्रॉ किया जा सकता है:

<!-- 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>

drawable वाला एलिमेंट, अपने पूरे सबट्री को कैप्चर करता है. हालांकि, यह नेस्ट किए गए उन डिसेंडेंट को कैप्चर नहीं करता जो drawable की जानकारी भी देते हैं. इससे पैरंट कंटेनर और बटन जैसे चाइल्ड एलिमेंट को ऐनिमेट किया जा सकता है. साथ ही, उन्हें अलग-अलग ड्रॉ कॉल में ड्रॉ किया जा सकता है.

हिट-टेस्टिंग सिंक्रनाइज़ेशन

पहले, डेवलपर को ड्रॉइंग के तरीकों से रिटर्न वैल्यू कैप्चर करनी पड़ती थी और उसे element.style.transform में भेजना पड़ता था. drawElementImage() मेथड अब void दिखाता है और सिंक्रनाइज़ेशन, कॉन्टेक्स्ट पर निर्भर करता है.

2D कॉन्टेक्स्ट: अपने-आप सिंक होने की सुविधा

2D कैनवस में, ब्राउज़र अपने-आप डीओएम हिट-टेस्ट बाउंड और स्क्रीन रीडर फ़ोकस रिंग को ड्रॉ किए गए निर्देशांकों के साथ सिंक करता है. मैन्युअल तरीके से जोड़े गए सभी ट्रांसफ़ॉर्म पाइपिंग को हटाने के लिए:

// 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

2D में ज्यामिति को मैन्युअल तरीके से मैनेज करने के लिए, { preserveElementGeometry: true } को drawElementImage() में पास करें और canvas.updateElementGeometry() का इस्तेमाल करके ट्रांसफ़ॉर्म लागू करें.

3D कॉन्टेक्स्ट: साफ़ तौर पर updateElementGeometry()

WebGL या WebGPU कॉन्टेक्स्ट में डीओएम को सिंक करने के लिए, DOMMatrix ट्रांसफ़ॉर्म बनाएं और उसे 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 });
});

अलग-अलग वर्शन के साथ काम करने की सुविधा

अगर आपके ऐप्लिकेशन को ट्रांज़िशन पीरियड के दौरान, Chrome के कई वर्शन पर उपयोगकर्ताओं को सहायता देनी है, तो उनके प्रोटोटाइप पर अपडेट किए गए तरीकों की मौजूदगी की जांच करें. साथ ही, अपने सेटअप को उसी हिसाब से अडजस्ट करें.

पक्का करें कि आपने हर ब्राउज़र वर्शन के लिए, सही <canvas> एलिमेंट एट्रिब्यूट सेट किए हों:

// ============================================================================
//  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', '');
  }
}

2D कॉन्टेक्स्ट के लिए, drawElementImage() की रिटर्न वैल्यू की जांच करें. साथ ही, दोनों वर्शन के साथ काम करने के लिए, कैनवस प्रोटोटाइप एट्रिब्यूट की जांच करें:

// ============================================================================
// 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 = "";
    }
  }
}

WebGPU के लिए, इसके साथ काम करने वाले तरीके के सिग्नेचर और नाम का इस्तेमाल करें:

// ============================================================================
// 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 });
  }
}

यह ज़रूर देखें कि 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);
}

ऑरिजिन ट्रायल एक्सटेंशन

HTML-in-Canvas का ऑरिजिन ट्रायल, Chrome 160 तक बढ़ा दिया गया है. अपने उपयोगकर्ताओं को HTML-in-Canvas की सुविधा उपलब्ध कराने के लिए, ऑरिजिन ट्रायल टोकन को रिन्यू करना न भूलें. ज़्यादा जानकारी के लिए, ऑरिजिन ट्रायल वाला लेख पढ़ें.

सुझाव/राय दें या शिकायत करें

WICG GitHub रिपॉज़िटरी में समस्या दर्ज करके, हमें बताएं कि ये अपडेट आपके ऐप्लिकेशन में कैसे काम करते हैं. HTML-in-Canvas से जुड़ी हर खबर से अप-टू-डेट रहने के लिए, डेवलपर न्यूज़लेटर के लिए साइन अप करें.