HTML-ইন-ক্যানভাস আপডেট: আরও ভালো ওয়েব API-এর দিকে এগিয়ে যাওয়া

Chrome 150 ও 155 ভার্সনে HTML-ইন-Canvas API-তে বেশ কিছু পরিবর্তন করা হয়েছে। এইসব পরিবর্তন কমিউনিটি ও স্ট্যান্ডার্ড সংক্রান্ত মতামতের ভিত্তিতে করা হয়েছে, যার লক্ষ্য হল API-এর কার্যকারিতা উন্নত করা। এই ব্লগ পোস্টে পরিবর্তনগুলি এবং আপনি কীভাবে নিশ্চিত করতে পারেন যে আপনার প্রয়োগ সেগুলির সাথে আপ-টু-ডেট আছে তা বর্ণনা করে।

আপডেটের মধ্যে রয়েছে অ্যাট্রিবিউট ও পদ্ধতির নাম পরিবর্তন করা, এক্সপ্লিসিট টেক্সচার মেমরি প্রি-অ্যালোকেশন এবং DOM সিঙ্ক করার মডেল আপডেট করা। এছাড়াও, HTML-ইন-ক্যানভাস অরিজিন ট্রায়াল এখন বাড়ানো হয়েছে। কী কী পরিবর্তন হচ্ছে, কেন হচ্ছে এবং কীভাবে আপনার কোডবেস আপডেট করবেন, তা নিচে ব্যাখ্যা করা হল।

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-এ আরও কিছু পরিবর্তন করা হয়েছে। আমরা মেথডের নাম আপডেট করছি, যার জন্য এক্সপ্লিসিট টেক্সচার মেমরি প্রি-অ্যালোকেশন প্রয়োজন, জটিল DOM সাবট্রি সাপোর্ট করছি এবং DOM সিঙ্ক্রোনাইজেশন ডিকাপল করছি।

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-ইন-ক্যানভাসের জন্য WebGL-এ পরিবর্তনের তিনটি দিক রয়েছে:

  • পদ্ধতির নাম texElementImage2D থেকে পরিবর্তন করে texElementSubImage2D করা হয়েছে।`
  • মেথড সিগনেচার পরিবর্তন হয়; সবচেয়ে গুরুত্বপূর্ণ হল, এটি xoffset এবং yoffset আর্গুমেন্ট যোগ করে যাতে ঐচ্ছিকভাবে ডেস্টিনেশন টেক্সচারে অফসেট নির্দিষ্ট করার অনুমতি দেওয়া যায় যেখানে এলিমেন্ট আঁকা হবে।
  • এই পদ্ধতি আর ডেস্টিনেশন টেক্সচারের জন্য বাফার স্টোরেজ অটোমেটিক বরাদ্দ করে না; API ব্যবহার করার আগে স্টোরেজ স্পষ্টভাবে বরাদ্দ করতে হবে। এটি 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
);

ক্যানভাস অ্যাট্রিবিউট ও আঁকা যায় এমন চাইল্ড এলিমেন্ট

HTML রেন্ডার করার জন্য আপনি কীভাবে ক্যানভাস প্রস্তুত করবেন তা আমরা আপডেট করছি।

layoutsubtree-এর নাম পরিবর্তন করে content="drawable" করা হচ্ছে

HTML অ্যাট্রিবিউটের নামকরণ কনভেনশনের সাথে সামঞ্জস্যপূর্ণ করতে, <canvas> এলিমেন্টের বুলিয়ান layoutsubtree অ্যাট্রিবিউটের নাম পরিবর্তন করে content="drawable" করা হয়েছে (বিস্তারিত আলোচনার জন্য WICG সমস্যা #১৬৯ দেখুন)।

বংশধরদের জন্য drawable অ্যাট্রিবিউট

আগে, ক্যানভাসের শুধুমাত্র ডাইরেক্ট চিলড্রেন রেন্ডার করা হত। ফ্ল্যাটেনিং মার্ক-আপ ছাড়াই জটিল DOM হায়ারার্কি সাপোর্ট করতে, আপনি এখন স্বতন্ত্রভাবে আঁকতে চান এমন যেকোনও ডিসেন্ডেন্ট এলিমেন্টে স্পষ্টভাবে 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 ক্যানভাসে, ব্রাউজার অটোমেটিক DOM হিট-টেস্ট বাউন্ড এবং স্ক্রিন রিডার ফোকাস রিংকে আঁকা স্থানাঙ্কে সিঙ্ক করে। আপনি সব ম্যানুয়াল ট্রান্সফর্ম পাইপিং সরাতে পারবেন:

// 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 প্রসঙ্গে DOM সিঙ্ক করতে, একটি 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-ইন-ক্যানভাস ফিচার অফার করা চালিয়ে যেতে আপনার অরিজিন ট্রায়াল টোকেন রিনিউ করতে ভুলবেন না। আরও জানতে অরিজিন ট্রায়াল নিবন্ধ দেখুন।

আপনার মতামত জানান

WICG GitHub রিপোজিটরিতে সমস্যা ফাইল করে আপনার অ্যাপ্লিকেশনে এই আপডেটগুলি কীভাবে কাজ করে তা আমাদের জানান। HTML-in-Canvas সংক্রান্ত যেকোনও খবর সম্পর্কে আপ-টু-ডেট থাকতে ডেভেলপার নিউজলেটার-এ যোগ দিন।