root.unmount

Author: AhmedBaset

src/content/reference/react-dom/client/hydrateRoot.md

@@ -85,3 +85,33 @@ root.render(<App />);
 
 ---
 
+### `root.unmount()` {/*root-unmount*/}
+
+استدعِ `root.unmount` لتدمير شجرة معروضة داخل جذر React.
+
+```js
+root.unmount();
+```
+
+عادةً، لن يستدعي تطبيق مبني كاملًا بـ React `root.unmount`.
+
+هذا يكون مفيدًا بشكل أساسي إذا كان عنصر جذر React الخاصة بك (أو أي من العناصر الأسلاف لها) قد يتم إزالتها من DOM بواسطة بعض الأكواد الأخرى. على سبيل المثال، تخيل أن لديك لوحة علامات jQuery تقوم بإزالة علامات غير نشطة من DOM. إذا تمت إزالة علامة ما، فإن كل ما بداخلها (بما في ذلك جذور React الداخلية) سيتم إزالته من DOM أيضًا. في هذه الحالة، تحتاج إلى إخبار React بأنه يجب "إيقاف" إدارة محتوى الجذر المزال عن طريق استدعاء `root.unmount`. وإلا، فإن المكونات الداخلية في الجذر المزال لن تعرف كيفية التنظيف وتحرير الموارد العامة مثل الاشتراكات.
+
+عند استدعاء `root.unmount`، سيتم إلغاء تثبيت جميع المكونات في الجذر" و"فصل" React عن عنصر DOM الجذر، بما في ذلك إزالة أي معالجات أحداث أو حالة في الشجرة.
+
+
+#### المعاملات {/*root-unmount-parameters*/}
+
+`root.unmount` لا تستقبل أي معاملات.
+
+
+#### العائدات {/*root-unmount-returns*/}
+
+تعيد `root.unmount`: `undefined`.
+
+#### ملاحظات {/*root-unmount-caveats*/}
+
+* استدعاء `root.unmount` سيلغي تثبيت جميع المكونات في الشجرة ويفصل React عن عنصر DOM الجذر.
+* بمجرد استدعاء `root.unmount`، لا يمكنك استدعاء `root.render` مرة أخرى على نفس الجذر. ستؤدي محاولة استدعاء `root.render` على جذر غير مثبتة إلى إطلاق خطأ "Cannot update an unmounted root". ومع ذلك، يمكنك إنشاء جذر جديد لنفس عنصر DOM بعد إلغاء تثبيت الجذر السابقة لذلك العنصر.
+
+---