مетод cloneNode() HTML DOM Element

تعریف و استفاده

مетод cloneNode() مетод یک کپی از نود ایجاد می‌کند و آن را بازمی‌گرداند.

مетод cloneNode() تمام ویژگی‌ها و مقادیر آن‌ها را کپی می‌کند.

اگر می‌خواهید فرزندان (زیرنودها) را نیز کپی کنید، پارامتر deep را تنظیم کنید به true.

بازگرداندن

برای بازگرداندن نود کپی شده به مستند، از این استفاده کنید:

مетод appendChild()

مетод insertBefore()

لطفاً به اینجا مراجعه کنید:

مетод adoptNode()

مетод importNode()

مетод createElement()

مетод createTextNode()

مثال

مثال 1

عنصر <li> را از "myList2" به "myList1" کپی کنید:

const node = document.getElementById("myList2").lastChild;
const clone = node.cloneNode(true);
document.getElementById("myList1").appendChild(clone);

قبل از کپی:

  • Coffee
  • Tea
  • Water
  • Milk

بعد از کپی:

  • Coffee
  • Tea
  • Milk
  • Water
  • Milk

آزمایش کنید

مثال 2

عنصر "demo" را کپی کنید، شامل ویژگی‌ها و فرزندان آن، و آن را به مستند اضافه کنید:

const node = document.getElementById("demo");
const clone = node.cloneNode(true);
document.body.appendChild(clone);

آزمایش کنید

قوانین

node.cloneNode(deep)

پارامتر

پارامتر توضیح
deep

اختیاری.

  • false - پیش‌فرض. فقط کپی نود و ویژگی‌های آن
  • true - کپی نود، ویژگی‌ها و فرزندان آن

مقدار بازگشتی

نوع توضیح
نود نودهایی که کپی شده‌اند.

پشتیبانی مرورگر

element.cloneNode() این یک ویژگی DOM Level 1 (1998) است.

همه مرورگرها به طور کامل از آن پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی 9-11 پشتیبانی پشتیبانی پشتیبانی پشتیبانی