ডিক্লেরেটিভ আংশিক আপডেট

প্রকাশিত: ১৯ মে, ২০২৬, শেষবার আপডেট করা হয়েছে: ৮ সেপ্টেম্বর, ২০২৬

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

HTML, তার সমস্ত অগ্রগতি সত্ত্বেও, এখনও উপর থেকে নিচে ফ্যাশনে ক্রমানুসারে ডেলিভার করা হয়, কন্টেন্ট কখন প্রস্তুত হয় বা ব্যবহারকারী কখন এটি ব্যবহার করেন তার প্রতি সামান্য মনোযোগ দিয়ে। CSS আপনাকে কন্টেন্টের ক্রম পরিবর্তন করতে দেয়, তবে প্রায়শই অ্যাক্সেসিবিলিটির উপর উল্লেখযোগ্য পার্শ্বপ্রতিক্রিয়া সহ। JavaScript আপনাকে বিভিন্ন API-এর মাধ্যমে DOM ম্যানিপুলেট করতে দেয় যাতে আপনি কিছুটা হলেও এই সীমাবদ্ধতা থেকে মুক্ত হতে পারেন, তবে এর জন্য প্রায়শই ভার্বোস সিনট্যাক্স বা HTML-এ প্লাগ করার জন্য DOM ট্রি তৈরি করার প্রয়োজন হয়।

ওয়েবের জন্য পারফর্ম্যান্স অত্যন্ত গুরুত্বপূর্ণ, কারণ এই মাধ্যমের প্রকৃতি হল ক্লায়েন্ট-সার্ভার। তবে, HTML-এর এই ইন-অর্ডার প্রকৃতি এড়ানোর জন্য প্রায়শই সাবঅপ্টিমাল পছন্দ করা হয়, যা পারফর্ম্যান্সকে ধীর করে দেয়। এর মধ্যে পুরো পৃষ্ঠা রেডি হওয়া পর্যন্ত অপেক্ষা করা বা অ্যাসিঙ্ক্রোনাস পদ্ধতিতে কম্পোনেন্ট ডেলিভার করার জন্য ভারী ফ্রেমওয়ার্ক ব্যবহার করা অন্তর্ভুক্ত। জাভাস্ক্রিপ্ট ফ্রেমওয়ার্কের জনপ্রিয়তা থেকে বোঝা যায় যে ওয়েব ডেভেলপাররা ওয়েবের উৎপত্তির সময়কার অনমনীয় ডকুমেন্ট মেন্টাল মডেলের চেয়ে কম্পোনেন্ট-ভিত্তিক মডেল বেশি পছন্দ করেন।

Chrome টিম এই সমস্যাটি বিবেচনা করছে এবং ডিক্লারেটিভ আংশিক আপডেট নামে ওয়েব প্ল্যাটফর্মে নতুন সংযোজন ডেভেলপ করছে।

প্রথম দুটি নতুন API সেট, HTML ডকুমেন্টেই আউট-অফ-অর্ডার হোক বা নতুন JavaScript API ব্যবহার করে আগে থেকে থাকা ডকুমেন্টে ডায়নামিকভাবে HTML যোগ করার সহজ উপায়ের মাধ্যমে হোক, কম লিনিয়ার ফ্যাশনে HTML ডেলিভার করা সহজ করে তোলে। এমনকি যেসব ব্রাউজারে এখনও এই নতুন API কাজ করে না, সেখানেও আপনি যাতে এখনই এগুলি ব্যবহার করতে পারেন, তার জন্য পলিফিল উপলভ্য আছে।

আউট-অফ-অর্ডার স্ট্রিমিং

Browser Support

  • Chrome: 150.
  • Edge: 150.
  • Firefox: not supported.
  • Safari: not supported.

Source

প্রথম সেট পরিবর্তন হল নতুন আউট-অফ-অর্ডার স্ট্রিমিং API যা প্রসেসিং নির্দেশাবলী প্লেসহোল্ডার এবং for অ্যাট্রিবিউট সহ <template> HTML এলিমেন্ট ব্যবহার করে। যেমন:

<div>
  <?marker name="placeholder">
</div>

...

<template for="placeholder">
  Here is some <em>HTML content</em>!
</template>

XML-এ প্রসেসিং সংক্রান্ত নির্দেশাবলী অনেকদিন ধরেই আছে, তবে HTML-এ এগুলিকে কমেন্ট হিসেবে বিবেচনা করা হয় এবং উপেক্ষা করা হয়। এই নতুন API সেই পদ্ধতিতে পরিবর্তন করে এবং HTML-এ প্রসেসিং সংক্রান্ত নির্দেশাবলী নিয়ে আসে। যেমন, ব্রাউজার যখন <?marker name="placeholder"> প্রসেসিং নির্দেশ দেখে, তখন এটি সরাসরি কিছু করে না—আগের মতোই—তবে পরে এটি রেফারেন্স করা যেতে পারে।

for অ্যাট্রিবিউট সহ <template> এলিমেন্ট, name অ্যাট্রিবিউট সহ সংশ্লিষ্ট প্রসেসিং নির্দেশাবলী খোঁজে এবং কন্টেন্ট পরিবর্তন করে। এই ক্ষেত্রে, পার্স করার পরে, DOM নিম্নলিখিত হিসেবে শেষ হয় (কিছু হোয়াইটস্পেস পার্থক্য উপেক্ষা করে):

<div>
  Here is some <em>HTML content</em>!
</div>

পরিবর্তনের জন্য <?marker> অ্যাট্রিবিউটের পাশাপাশি, <?start> এবং <?end> রেঞ্জ মার্কারও আছে যা টেমপ্লেট প্রসেস করার আগে সাময়িক প্লেসহোল্ডার কন্টেন্ট দেখানোর অনুমতি দেয়:

<div>
  <?start name="another-placeholder">
  Loading…
  <?end>
</div>

...

<template for="another-placeholder">
  Here is some <em>HTML content</em>!
</template>

এই ক্ষেত্রে, <template> না দেখা পর্যন্ত Loading… স্ট্রিং দেখানো হয় এবং তারপর নতুন কন্টেন্ট দিয়ে এটি পরিবর্তন করা হয়।

একাধিক আপডেট করার অনুমতি দিতে টেমপ্লেটে প্রসেসিং সংক্রান্ত নির্দেশাবলী অন্তর্ভুক্ত করাও সম্ভব:

<ul id="results">
  <?start name="results">
  Loading…
  <?end>
</ul>

...

<template for="results">
  <li>Result One</li>
  <?marker name="results">
</template>

...

<template for="results">
  <li>Result Two</li>
  <?marker name="results">
</template>

...

পার্স ও প্রসেস করার পরে এটি নিম্নলিখিত HTML-এ শেষ হয়:

<ul id="results">
  <li>Result One</li>
  <li>Result Two</li>
  <?marker name="results">
</ul>

শেষে প্রসেসিং সংক্রান্ত চূড়ান্ত নির্দেশাবলী সহ, যদি পরে ডকুমেন্টে আরও <template for="results"> প্লেসহোল্ডার যোগ করা হয়।

স্ট্যান্ডার্ড HTML এলিমেন্টের পরিবর্তে প্রসেসিং নির্দেশাবলী কেন?

যারা প্রথমবার এই API ব্যবহার করছেন তাদের জন্য এটি একটি সাধারণ প্রশ্ন, যেখানে <slot> বা এমনকি <template> এলিমেন্ট ব্যবহার করার সাজেশন দেওয়া হয়। এই প্রস্তাবের প্রাথমিক ভার্সন স্ট্যান্ডার্ড HTML এলিমেন্টের সাথে কাজ করেছে, তবে ডিজাইনটি পুনরাবৃত্তি করার সাথে সাথে প্রসেসিং নির্দেশাবলী পরিবর্তন করা হয়েছে। প্রসেসিং সংক্রান্ত নির্দেশাবলী DOM-কে প্রভাবিত না করেই প্যাচিং করার অনুমতি দেয়। এটি <head>-এ ব্যবহার করার অনুমতি দেয়—উদাহরণস্বরূপ, <title> আপডেটের জন্য—অথবা এমনকি <table>-এর মতো অন্যান্য এলিমেন্টের মধ্যেও (উদাহরণস্বরূপ, ঐচ্ছিক অতিরিক্ত সারি যোগ করতে)।

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

ডেমো

এই ভিডিওতে, স্ট্রিমিং HTML সহ একটি বেসিক ফটো অ্যালবাম অ্যাপ্লিকেশন প্রয়োগ করা হয়েছে:

আউট-অফ-অর্ডার স্ট্রিমিং সহ ফটো অ্যালবাম ডেমো (সোর্স)

প্রাথমিক লেআউটের পরে স্ট্যাটাস ও ফটো, দুটিই HTML-এ স্ট্রিম করা হয়।

যেসব ক্ষেত্রে ব্যবহার করা যাবে

স্ট্রিমিং HTML-এর সাথে যুক্ত করা হলে এই আউট-অফ-অর্ডার প্যাচিং HTML-এর অনেক ব্যবহারিক ক্ষেত্র রয়েছে:

  • দ্বীপের স্থাপত্য। Astro-এর মতো ফ্রেমওয়ার্কের মাধ্যমে জনপ্রিয় হওয়া একটি সাধারণ প্যাটার্ন হল আইল্যান্ড আর্কিটেকচার যেখানে স্ট্যাটিক HTML-এর উপরে কম্পোনেন্টগুলি স্বাধীনভাবে হাইড্রেট করা হয়। <template for> API, স্ট্যাটিক কন্টেন্টকে HTML-এ সরাসরি একই পদ্ধতিতে ম্যানেজ করার সুবিধা দেয়। আরও ইন্টার‍্যাক্টিভ আইল্যান্ড বা কম্পোনেন্ট ম্যানেজ করার জন্য জাভাস্ক্রিপ্ট ফ্রেমওয়ার্কও এটি ব্যবহার করতে পারে।
  • কন্টেন্ট রেডি হয়ে গেলে ডেলিভার করুন। এই আইল্যান্ড আর্কিটেকচারের জন্য, কন্টেন্ট রেডি হয়ে গেলেই স্ট্রিম করা যায়, অতিরিক্ত প্রসেসিংয়ের প্রয়োজন হয় এমন কন্টেন্টের জন্য অপেক্ষা করতে হয় না—যেমন, ডেটাবেস লুকআপ। অনেক প্ল্যাটফর্ম HTML স্ট্রিমিংয়ের অনুমতি দিলেও, HTML-এর ইন-অর্ডার প্রকৃতির অর্থ হল কন্টেন্ট প্রায়ই আটকে রাখা হয় অথবা জটিল JavaScript DOM ম্যানিপুলেশনের সাহায্য নেওয়া হয়। এখন আপনি অপেক্ষা করার সময় স্ট্যাটিক কন্টেন্ট ডেলিভার করতে পারবেন এবং তারপরে HTML স্ট্রিমের শেষে আরও ব্যয়বহুল এবং পরিবর্তনশীল কন্টেন্ট প্লাগ-ইন করতে পারবেন।
  • পৃষ্ঠা লোড হওয়ার পারফর্ম্যান্সের জন্য HTML-কে সবচেয়ে ভালো ক্রমে ডেলিভার করা যেতে পারে। আরও এক ধাপ এগিয়ে, অর্ডার রেডি হয়ে গেলেও আপনি সেটি পরিবর্তন করতে পারবেন। যেমন, মেগা মেনু হল একটি সাধারণ নেভিগেশন ফিচার যাতে প্রচুর HTML থাকে যা পৃষ্ঠাটি ইন্টার‍্যাক্টিভ না হওয়া পর্যন্ত ব্যবহারকারী দেখতে পাবেন না। HTML-এর এই বড় অংশটি HTML ডকুমেন্টে পরে ডেলিভার করা যেতে পারে যাতে প্রাথমিক পৃষ্ঠা লোড করার জন্য প্রয়োজনীয় আরও গুরুত্বপূর্ণ HTML-কে অগ্রাধিকার দেওয়া যায়। HTML-এর ক্ষেত্রে ক্রম আর কোনও বাধা নয়।

এগুলি হল কিছু ব্যবহারের উদাহরণ এবং ডেভেলপাররা এই নতুন API কীসের জন্য ব্যবহার করেন তা দেখার জন্য আমরা উৎসুক।

বিধিনিষেধ ও সূক্ষ্মতা

API-তে কিছু বিধিনিষেধ ও সূক্ষ্মতা রয়েছে যেগুলি সম্পর্কে সচেতন থাকতে হবে:

  • নিরাপত্তার কারণে <template for> শুধুমাত্র একই পেরেন্ট এলিমেন্টের মধ্যে প্রসেসিং সংক্রান্ত নির্দেশাবলী আপডেট করতে পারে। <body> এলিমেন্টে সরাসরি <template for> যোগ করলে, এটি সম্পূর্ণ ডকুমেন্ট (<head> সহ) অ্যাক্সেস করতে পারবে।
  • <?end> প্রসেসিং সংক্রান্ত নির্দেশ ঐচ্ছিক এবং এটি না থাকলে, <?start> এলিমেন্ট এবং কন্টেনিং এলিমেন্টের শেষের মধ্যে থাকা কন্টেন্ট পরিবর্তন করা হবে।
  • <template for> স্ট্রিমিং শুরু হওয়ার পরে প্রসেসিং সংক্রান্ত নির্দেশাবলী সরিয়ে দিলে, নতুন কন্টেন্ট পুরনো লোকেশনে স্ট্রিমিং হতে থাকবে এবং এর ফলে অপ্রত্যাশিত ফলাফল হতে পারে।
  • মনে রাখবেন, setHTML বা innerHTML প্রপার্টির মতো কোনও পদ্ধতির মাধ্যমে ডায়নামিকভাবে <template for> যোগ করার সময়, টেমপ্লেট পার্স করার সময় সেটির "পেরেন্ট" হল একটি ইন্টারমিডিয়েট ডকুমেন্ট ফ্র্যাগমেন্ট। এর অর্থ হল, এইসব পদ্ধতিতে HTML যোগ করলে তা আগে থেকে থাকা DOM-এ কোনও পরিবর্তন করতে পারে না এবং ফ্র্যাগমেন্টের মধ্যে "ইন প্লেস" প্যাচিং হয়। তবে, streamHTMLUnsafe (সংক্ষেপে কভার করা হয়েছে) এর মতো পদ্ধতি ব্যবহার করে স্ট্রিম করার সময়, কোনও মধ্যবর্তী ফ্র্যাগমেন্ট থাকে না, তাই টেমপ্লেটগুলি বিদ্যমান কন্টেন্ট প্রতিস্থাপন করতে পারে।

স্ট্যান্ডার্ডাইজেশন স্ট্যাটাস

<template for> অ্যাট্রিবিউট হল HTML স্ট্যান্ডার্ডের অংশ কিন্তু এখনও সব ব্রাউজারে কাজ করে না।

ভবিষ্যতে সম্ভাব্য সংযোজন

ভবিষ্যতে যোগ করা হতে পারে এমন কিছু সম্ভাব্য ফিচার যা বিবেচনাধীন রয়েছে:

  • ক্লায়েন্ট সাইড অন্তর্ভুক্ত। যেমন, <template for="footer" src="/partials/footer.html">, অথবা <template src="/partials/footer.html"> প্যাচ না করেও। আরও জানতে ব্যাখ্যা দেখুন। এটি chrome://flags/#enable-experimental-web-platform-features ফ্ল্যাগের পিছনে উপলভ্য।
  • পরিবর্তন হবে না এমন কন্টেন্ট ওভাররাইট করা আটকানো। কন্টেন্ট রিভিশন নম্বর বা ভার্সনিংয়ের মাধ্যমে এটি করা যেতে পারে। এটি কন্টেন্ট রিসেট করার পরিবর্তে রুট পরিবর্তন বা অন্যান্য আপডেটের মধ্যে স্টেট বজায় রাখতে সাহায্য করবে।
  • প্যাচ করার সময় স্যানিটাইজ করা। যেমন, <template for=icon safe><svg id="from-untrusted-source">...</svg></template>

পলিফিল

Chrome টিম একটি template-for-polyfill রিলিজ করেছে যা npm-এ উপলভ্য যাতে সাইটগুলি এই নতুন কার্যকারিতা এখনই ব্যবহার করতে পারে, এমনকি এটি অন্যান্য ব্রাউজারে আসার আগেই।

এতে কিছু সীমাবদ্ধতা আছে, কারণ এটি সরাসরি ব্রাউজারের HTML পার্সার আপডেট করতে পারে না, তবে সবচেয়ে সাধারণ ব্যবহারের ক্ষেত্রে এটি কভার করা হয়। সাইটগুলি এখনও অন্যান্য ব্রাউজারে পরীক্ষা করা উচিত।

HTML ইনসার্ট ও স্ট্রিমিংয়ের নতুন পদ্ধতি

সব কন্টেন্ট HTML হিসেবে ডেলিভার করা যায় না। এই ক্ষেত্রে Chrome-এর করা কাজের দ্বিতীয় অংশের লক্ষ্য হল জাভাস্ক্রিপ্টের মাধ্যমে কন্টেন্ট আপডেট করা আরও সহজ করা।

জাভাস্ক্রিপ্ট ব্যবহার করে আগে থেকে থাকা ডকুমেন্টে ডায়নামিকভাবে HTML ইনজেক্ট করার একাধিক উপায় আগে থেকেই আছে:

  • setHTML
  • setHTMLUnsafe
  • innerHTML ও outerHTML
  • createContextualFragment
  • insertAdjacentHTML

তবে, এগুলি সব সামান্য আলাদাভাবে কাজ করে এবং এদের মধ্যে সূক্ষ্ম পার্থক্য রয়েছে যা ডেভেলপাররা সবসময় বিবেচনা নাও করতে পারেন:

  • নতুন কন্টেন্ট কি ওভাররাইট বা অ্যাপেন্ড করে?
  • তারা কি সম্ভাব্য বিপজ্জনক HTML স্যানিটাইজ করে—যেমন, <script> ট্যাগ এড়িয়ে গিয়ে?
  • না হলে, <script>-এর কি রান করা উচিত?
  • বিশ্বস্ত প্রকার-এর সাথে এগুলি কীভাবে কাজ করে?

খুব কম ডেভেলপারই সততার সাথে সেইসব API দেখতে এবং আত্মবিশ্বাসের সাথে সেগুলির প্রত্যেকটির জন্য সেইসব প্রশ্নের উত্তর দিতে পারেন।

একটি বড় সীমাবদ্ধতা হল যে এগুলি শুধুমাত্র আগে থেকে জানা HTML-এর সম্পূর্ণ সেটের জন্য ব্যবহার করা যেতে পারে, যখন HTML স্ট্রিম করার অনুমতি দেওয়ার জন্য কল করা হয়। ব্যবহারিক দিক থেকে এর অর্থ হল, আপনাকে সম্পূর্ণ কন্টেন্ট যোগ করার আগে সেটি ডাউনলোড করতে হবে, যদিও HTML-এর অন্যতম শক্তিশালী দিক হল কন্টেন্ট সাথে সাথে স্ট্রিম করার ক্ষমতা। পে-লোড স্প্লিট করে বা document.write-এর মতো হ্যাকি, বাতিল করা পদ্ধতি ব্যবহার করে সীমিতভাবে এই সমস্যার সমাধান করা যেতে পারে, তবে এর ফলে নিজস্ব সমস্যা তৈরি হয়।

স্ট্যাটিক ও স্ট্রিমিং API-এর নতুন সেট

Browser Support

  • Chrome: behind a flag.
  • Edge: behind a flag.
  • Firefox: not supported.
  • Safari: not supported.

Chrome নতুন API-এর একটি স্যুট এবং আগে থেকে থাকা setHTML ও setHTMLUnsafe-এর এক্সটেনশনের উপর কাজ করেছে যা এটি পরিষ্কার করে, এর পাশাপাশি স্ট্রিমিং কার্যকারিতা চালু করে।

chrome://flags/#enable-experimental-web-platform-features ফ্ল্যাগ ব্যবহার করে Chrome 148 থেকে ডেভেলপার টেস্টিংয়ের জন্য এগুলি প্রস্তুত এবং Chrome 155-এ লঞ্চ করার পরিকল্পনা করা হয়েছে।

আগে থেকে থাকা HTML-এর আগে বা পরে কন্টেন্ট যোগ করার পদ্ধতির পাশাপাশি সেট বা পরিবর্তন করার পদ্ধতিও রয়েছে। প্রতিটি পদ্ধতির স্ট্রিম সমতুল্য আছে:

অ্যাকশন স্থির স্ট্রিমিং
এলিমেন্টের HTML কন্টেন্ট সেট করুন setHTML(html, options); streamHTML(options);
এই HTML দিয়ে সম্পূর্ণ এলিমেন্ট পরিবর্তন করুন replaceWithHTML(html, options); streamReplaceWithHTML(options);
এলিমেন্টের আগে HTML যোগ করুন beforeHTML(html, options); streamBeforeHTML(options);
এলিমেন্টের প্রথম চাইল্ড হিসেবে HTML যোগ করুন prependHTML(html, options); streamPrependHTML(options);
এলিমেন্টের শেষ চাইল্ড হিসেবে HTML যোগ করুন appendHTML(html, options); streamAppendHTML(options);
এলিমেন্টের পরে HTML যোগ করুন afterHTML(html, options); streamAfterHTML(options);
ইনসার্ট ও স্ট্রিমিংয়ের নতুন পদ্ধতি

এছাড়াও, Unsafeটি ভার্সন আছে যা শীঘ্রই কভার করা হবে। যদিও মনে হতে পারে যে এগুলি অনেক বেশি—বিশেষ করে যখন আপনি Unsafe-এর সমতুল্য যোগ করেন)—নামকরণের সামঞ্জস্যপূর্ণ কনভেনশন প্রতিটি কী করে তা আরও স্পষ্ট করে তোলে, যা আগে উল্লেখ করা সম্পর্কহীন পদ্ধতির তুলনায় অনেক বেশি।

স্ট্যাটিক ভার্সনগুলি DOM স্ট্রিং আর্গুমেন্ট হিসেবে নতুন HTML নেয়, এর সাথে ঐচ্ছিক বিকল্পগুলিও থাকে:

const newHTML = "<p>This is a new paragraph</p>";
const contentElement = document.querySelector('#content-to-update');

contentElement.setHTML(newHTML);

স্ট্রিমিং ভার্সন Streams API-এর সাথে কাজ করে, যেমন getWriter()-এর সাথে:

const contentElement = document.querySelector('#content-to-update');
const writer = contentElement.streamHTMLUnsafe().getWriter();

// Example stream of updating content
while (true) {
  await writer.write(`<p>${++i}</p>`);
  await new Promise((resolve) => setTimeout(resolve, 1000));
}

writer.close();

অথবা, পাইপ চেইন ব্যবহার করে ফেচ রেসপন্স থেকে:

const contentElement = document.querySelector('#content-to-update');
const response = await fetch('/api/content.html');

response.body
  .pipeThrough(new TextDecoderStream())
  .pipeTo(contentElement.streamHTMLUnsafe());

textStream() কনভেনিয়েন্স পদ্ধতি

Browser Support

  • Chrome: 151.
  • Edge: 151.
  • Firefox: not supported.
  • Safari: not supported.

Source

এছাড়াও, একটি textStream সুবিধাজনক পদ্ধতি যোগ করা হয়েছে, যেখানে আপনি মধ্যবর্তী TextDecoderStream() ধাপ ছাড়াই সরাসরি স্ট্রিম করতে পারবেন:

const contentElement = document.querySelector('#content-to-update');
const response = await fetch('/api/content.html');

response.textStream().pipeTo(contentElement.streamHTMLUnsafe());

options

options আর্গুমেন্ট আপনাকে একটি কাস্টম sanitizer নির্দিষ্ট করতে দেয় যা ডিফল্টভাবে default হয় যার অর্থ ডিফল্ট স্যানিটাইজার কনফিগারেশন। এটি এইভাবে ব্যবহার করা হয়:

const newHTML = '<p>This is a new paragraph</p>';
const contentElement = document.querySelector('#content-to-update');

// Only allows basic formatting
const basicFormattingSanitzer = new Sanitizer({ elements: ['em', 'i', 'b', 'strong'] });

contentElement.setHTML(newHTML, {sanitizer: basicFormattingSanitzer});

"অসুরক্ষিত" পদ্ধতি

এছাড়াও, প্রতিটি API-এর "অসুরক্ষিত" ভার্সন আছে:

অ্যাকশন স্থির স্ট্রিমিং
এলিমেন্টের HTML কন্টেন্ট সেট করুন setHTMLUnsafe(html,options); streamHTMLUnsafe(options);
এই HTML দিয়ে সম্পূর্ণ এলিমেন্ট পরিবর্তন করুন replaceWithHTMLUnsafe(html, options); streamReplaceWithHTMLUnsafe(options);
এলিমেন্টের আগে HTML যোগ করুন beforeHTMLUnsafe(html, options); streamBeforeHTMLUnsafe(options);
এলিমেন্টের প্রথম চাইল্ড হিসেবে HTML যোগ করুন prependHTMLUnsafe(html, options); streamPrependHTMLUnsafe(options);
এলিমেন্টের শেষ চাইল্ড হিসেবে HTML যোগ করুন appendHTMLUnsafe(html, options); streamAppendHTMLUnsafe(options);
এলিমেন্টের পরে HTML যোগ করুন afterHTMLUnsafe(html, options); streamAfterHTMLUnsafe(options);
"অসুরক্ষিত" ইনসার্ট ও স্ট্রিমিং পদ্ধতি

এই "অসুরক্ষিত" পদ্ধতি ডিফল্ট হিসেবে স্যানিটাইজার বন্ধ করে দেয় এবং আপনি চাইলে কাস্টম স্যানিটাইজার নির্দিষ্ট করতে পারেন। এছাড়াও, এইসব পদ্ধতি স্ক্রিপ্টকে ঐচ্ছিক runScripts বিকল্পের সাথে রান করার অনুমতি দেয়—যা ডিফল্ট হিসেবে false-এ সেট করা থাকে।

setHTML-এর মতো, setHTMLUnsafe হল একটি বিদ্যমান পদ্ধতি, তবে runScripts বিকল্প প্যারামিটারটি এতে যোগ করা হয়েছে যাতে এটি স্ক্রিপ্ট এক্সিকিউশনের সাথে ব্যবহার করা যায়:

const newHTML = `<p>This is a new paragraph</p>
                 <script src=script.js></script>`;
const contentElement = document.querySelector('#content-to-update');

contentElement.setHTMLUnsafe(newHTML, {runScripts: true});

এই পদ্ধতিতে "অসুরক্ষিত" শব্দ ব্যবহার করার উদ্দেশ্য হল ডেভেলপারদের সম্ভাব্য ঝুঁকি সম্পর্কে মনে করিয়ে দেওয়া এবং তারা কীভাবে স্ক্রিপ্ট স্যানিটাইজ বা সীমাবদ্ধ করতে পারেন তা জানানো, এই পদ্ধতি ব্যবহার করা উচিত নয় তা বলা নয়।

ইনপুট কতটা বিশ্বস্ত তার উপর নির্ভর করে এটি কতটা "অসুরক্ষিত"। Unsafe স্ট্যাটিক পদ্ধতিগুলি DOM স্ট্রিং বা TrustedHTML-এর সাথে html আর্গুমেন্ট হিসেবে কাজ করে এবং স্যানিটাইজার ব্যবহার করার অনুমতিও দেয়। যদিও runScript-এর ক্ষেত্রে স্ক্রিপ্টকে অনুমতি দেওয়াই হল মূল উদ্দেশ্য, তাই ডিফল্ট হিসেবে কোনও স্যানিটাইজার ব্যবহার করা হয় না।

যেসব ক্ষেত্রে ব্যবহার করা যাবে

এই নতুন API-এর সাহায্যে ডেভেলপাররা সহজেই আগে থেকে থাকা পৃষ্ঠায় HTML যোগ করতে পারবেন, একই ধরনের নাম ও বিকল্প সহ নতুন API যোগ করতে পারবেন। স্ট্রিমিং API-এর পারফর্ম্যান্সের সুবিধা হল, প্ল্যাটফর্মে সব নতুন কন্টেন্ট উপলভ্য না হওয়া পর্যন্ত অপেক্ষা করতে হয় না।

ব্যবহারিক ক্ষেত্রের মধ্যে এগুলি অন্তর্ভুক্ত:

  • সিঙ্গেল পেজ অ্যাপে বড় কন্টেন্ট আপডেটের ডায়নামিক স্ট্রিমিং। আগে যেমন উল্লেখ করা হয়েছে, বর্তমান SPA আর্কিটেকচারের একটি বড় অসুবিধা হল যে এটি প্রাথমিক HTML লোডের স্ট্রিমিং প্রকৃতি থেকে উপকৃত হয় না—এখন পর্যন্ত!
  • HTML ফুটারের মতো সাধারণ কন্টেন্ট যোগ করা। জাভাস্ক্রিপ্ট API ব্যবহার করলে, আপনি আংশিক ডেটা নিয়ে এসে তা পেজে যোগ করতে পারবেন। এর ফলে, পাঠানো প্রতিটি পেজে ডেটা রিপিট করার পরিবর্তে ক্যাশিংয়ের সুবিধা পাওয়া যায়। তবে, জাভাস্ক্রিপ্টের উপর নির্ভর করে রান করার কারণে, এটি শুধুমাত্র এমন কন্টেন্টের জন্য ব্যবহার করা উচিত যা প্রাথমিক লোডে দৃশ্যমান হবে না।

আবারও বলছি, এগুলি মাত্র কয়েকটি উদাহরণ এবং আপনারা কী কী নিয়ে আসেন তা দেখার জন্য আমরা অধীর আগ্রহে অপেক্ষা করছি!

বিধিনিষেধ ও সূক্ষ্মতা

এইসব নতুন API-তে কিছু বিধিনিষেধ ও সূক্ষ্মতাও অন্তর্ভুক্ত আছে যেগুলি সম্পর্কে সচেতন থাকতে হবে:

  • Trusted Types API-এর সাথে স্ট্রিমিং ইন্টিগ্রেট করার জন্য নতুন createParserOptions পদ্ধতি ব্যবহার করতে হবে, যা যেকোনও HTML সেটিং অপারেশনে স্যানিটাইজার ইনজেক্ট করার অনুমতি দেয়। বিশ্বস্ত ধরনের ইন্টিগ্রেশন সম্পর্কে আরও বিশদ বিবরণের জন্য ব্যাখ্যাকারী দেখুন
  • <template for>-এর মতো, স্ট্রিম করা হচ্ছে এমন এলিমেন্ট সরানো হলে, অপ্রত্যাশিত ফলাফল বা স্ট্রিম সংক্রান্ত সমস্যা হতে পারে।
  • streamHTMLUnsafe অনেক উপায়ে মূল পার্সারের মতো কাজ করে, যার মধ্যে রয়েছে <template for> নির্দেশাবলী মূল ডকুমেন্টে যোগ করার সাথে সাথে প্রসেস করা এবং স্ট্রিমের শেষ পর্যন্ত defer স্ক্রিপ্ট স্থগিত রাখা।

স্ট্যান্ডার্ডাইজেশন স্ট্যাটাস

নতুন ইনসার্শন ও স্ট্রিমিং পদ্ধতি HTML স্ট্যান্ডার্ডে যোগ করার প্রসেস চলছে, তবে এখনও সব ব্রাউজারে কাজ করে না।

পলিফিল

Chrome টিম একটি html-setters-polyfill রিলিজ করেছে যা npm-এ উপলভ্য যাতে সাইটগুলি এই নতুন কার্যকারিতা এখনই ব্যবহার করতে পারে, এমনকি এটি অন্যান্য ব্রাউজারে আসার আগেই।

মনে রাখবেন যে এই পলিফিল স্ট্রিম করে না, পরিবর্তে বাফার করে এবং সম্পূর্ণ হলে প্রয়োগ করে। এটি কার্যকারিতার চেয়ে API শেপের জন্য বেশি পলিফিল।

এছাড়াও, নিরাপদ কন্টেন্টের সেটিং setHTML এবং Sanitizer API-এর উপর নির্ভর করে যা Safari-তে কাজ করে না।

এই দুটি একসাথে ব্যবহার করুন

এই দুটি আলাদা API হলেও, এদের একত্রিত করে ব্যবহার করলে আসল ক্ষমতা বোঝা যায়। HTML-এ নতুন <template for> এলিমেন্ট স্ট্রিম করার মাধ্যমে, আপনি DOM-এ আলাদা জাভাস্ক্রিপ্ট রেফারেন্স সহ প্রতিটি এলিমেন্টকে সরাসরি টার্গেট না করেই কন্টেন্টের বিভিন্ন অংশ ডাইনামিকভাবে আপডেট করতে পারবেন।

প্রসেসিং সংক্রান্ত নির্দেশাবলী সহ একটি আউটলাইন পৃষ্ঠা লোড করে এবং তারপরে সেই প্রসেসিং সংক্রান্ত নির্দেশাবলীতে স্লট করার জন্য HTML-এর নিচে প্রতিটি নতুন পৃষ্ঠার টেমপ্লেট স্ট্রিম করে একটি বেসিক SPA-স্টাইল পৃষ্ঠা লোড করা যেতে পারে।

নিঃসন্দেহে এই দুটি API-এর আরও সম্ভাবনা এবং ব্যবহারের ক্ষেত্র রয়েছে, তাই আমাদের (সীমিত!) কল্পনা আপনাকে আটকে রাখতে দেবেন না। আংশিক আপডেট ম্যানেজ করার প্রসেস আরও সহজ করে তোলার মাধ্যমে আপনি বয়লার-প্লেট কোড কমানো, আপডেট করার প্রসেস আরও সহজ করা এবং ওয়েবের জন্য নতুন সম্ভাবনা আনলক করতে পারবেন!

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