From 410afc565ea8e7344bcfd2f3748f5403dc0ccc2f Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 14:29:28 +0330
Subject: [PATCH 01/22] =?UTF-8?q?Modify=20"=D8=A8=D8=B1=D8=B1=D8=B3=DB=8C?=
 =?UTF-8?q?=20=D8=A7=D8=AC=D9=85=D8=A7=D9=84=DB=8C"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 content/docs/reference-react-dom.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index f440ef7ed..5fc50f153 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -8,9 +8,10 @@ permalink: docs/react-dom.html
 
 If you load React from a `<script>` tag, these top-level APIs are available on the `ReactDOM` global. If you use ES6 with npm, you can write `import ReactDOM from 'react-dom'`. If you use ES5 with npm, you can write `var ReactDOM = require('react-dom')`.
 
-## Overview {#overview}
+## بررسی اجمالی {#overview}
 
-The `react-dom` package provides DOM-specific methods that can be used at the top level of your app and as an escape hatch to get outside of the React model if you need to. Most of your components should not need to use this module.
+بسته `react-dom` روش هایی خاص برای مدیریت و کار با پرونده را فراهم می کند که می تواند در بالاترین سطح برنامه ها استفاده شود و به عنوان یک راه برای جلوگیری از استفاده از ماژول `React` است.
+بیشتر اجزای برنامه شما نیازی به استفاده از این ماژول ندارد.
 
 - [`render()`](#render)
 - [`hydrate()`](#hydrate)
@@ -18,7 +19,7 @@ The `react-dom` package provides DOM-specific methods that can be used at the to
 - [`findDOMNode()`](#finddomnode)
 - [`createPortal()`](#createportal)
 
-### Browser Support {#browser-support}
+### پشتیبانی مرورگر {#browser-support}
 
 React supports all popular browsers, including Internet Explorer 9 and above, although [some polyfills are required](/docs/javascript-environment-requirements.html) for older browsers such as IE 9 and IE 10.
 

From f1d7484f839f4f35ceb035874691dfc7ca6b3e1e Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 14:36:46 +0330
Subject: [PATCH 02/22] Modify "Browser Support"

---
 content/docs/reference-react-dom.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 5fc50f153..0a02d44a0 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -21,15 +21,14 @@ If you load React from a `<script>` tag, these top-level APIs are available on t
 
 ### پشتیبانی مرورگر {#browser-support}
 
-React supports all popular browsers, including Internet Explorer 9 and above, although [some polyfills are required](/docs/javascript-environment-requirements.html) for older browsers such as IE 9 and IE 10.
+ری اکت از کلیه مرورگرهای محبوب، از جمله Internet Explorer 9 و بالاتر پشتیبانی می کند، اگرچه [چند پیش نیاز دارد] (/ اسناد / javascript-Environment-Requires.html) تا برای مرورگرهای قدیمی مانند IE 9 و IE 10 به خوبی عمل کند.
 
-> Note
+> نکته
 >
-> We don't support older browsers that don't support ES5 methods, but you may find that your apps do work in older browsers if polyfills such as [es5-shim and es5-sham](https://github.com/es-shims/es5-shim) are included in the page. You're on your own if you choose to take this path.
+> ما از مرورگرهای قدیمی كه از روشهای ES5 پشتیبانی نمی كنند پشتیبانی نمی كنیم، اما شما ممكن است متوجه شوید که در صورتی که برنامه شما شامل پیش نیاز هایی مانند [es5-shim و es5-sham](https://github.com/es-shims/es5-shim) باشد برنامه های شما در مرورگرهای قدیمی نیز به خوبی كار کند. اگر تصمیم دارید این را انتخاب کنید، مسئولیت آن با خودتان است.
 
-* * *
 
-## Reference {#reference}
+## ارجاع {#reference}
 
 ### `render()` {#render}
 

From 626655a57de09c2a7df8d8fce193744303d1cac8 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 14:42:18 +0330
Subject: [PATCH 03/22] Modify "createportal"

---
 content/docs/reference-react-dom.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 0a02d44a0..f7a425195 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -21,7 +21,7 @@ If you load React from a `<script>` tag, these top-level APIs are available on t
 
 ### پشتیبانی مرورگر {#browser-support}
 
-ری اکت از کلیه مرورگرهای محبوب، از جمله Internet Explorer 9 و بالاتر پشتیبانی می کند، اگرچه [چند پیش نیاز دارد] (/ اسناد / javascript-Environment-Requires.html) تا برای مرورگرهای قدیمی مانند IE 9 و IE 10 به خوبی عمل کند.
+ری اکت از کلیه مرورگرهای محبوب، از جمله Internet Explorer 9 و بالاتر پشتیبانی می کند، اگرچه [چند پیش نیاز دارد](/docs/javascript-Environment-Requires.html) تا برای مرورگرهای قدیمی مانند IE 9 و IE 10 به خوبی عمل کند.
 
 > نکته
 >
@@ -42,7 +42,7 @@ If the React element was previously rendered into `container`, this will perform
 
 If the optional callback is provided, it will be executed after the component is rendered or updated.
 
-> Note:
+> نکته:
 >
 > `ReactDOM.render()` controls the contents of the container node you pass in. Any existing DOM elements inside are replaced when first called. Later calls use React’s DOM diffing algorithm for efficient updates.
 >
@@ -111,4 +111,4 @@ When a component renders to `null` or `false`, `findDOMNode` returns `null`. Whe
 ReactDOM.createPortal(child, container)
 ```
 
-Creates a portal. Portals provide a way to [render children into a DOM node that exists outside the hierarchy of the DOM component](/docs/portals.html).
+ایجاد یک پرتال. پورتال ها راهی برای [دادن اجزای فرزند به گره DOM که در خارج از سلسله مراتب از مؤلفه DOM وجود دارد ارائه می دهد](/docs/portalals.html).

From ce35f9b5f8ae247e69d88cb65ac4efdb14a27621 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 14:45:13 +0330
Subject: [PATCH 04/22] Modify description of file

---
 content/docs/reference-react-dom.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index f7a425195..b52365733 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -6,7 +6,8 @@ category: Reference
 permalink: docs/react-dom.html
 ---
 
-If you load React from a `<script>` tag, these top-level APIs are available on the `ReactDOM` global. If you use ES6 with npm, you can write `import ReactDOM from 'react-dom'`. If you use ES5 with npm, you can write `var ReactDOM = require('react-dom')`.
+
+اگر React را با استفاده از `<script>" بارگیری می کنید، این API های سطح بالا در همه جا بر روی "ReactDOM" در دسترس هستند. اگر از ES6 با npm استفاده می کنید، می توانید `import ReactDOM from 'react-dom'` را وارد کنید. اگر از ES5 با npm استفاده می کنید نیز `var ReactDOM = require('react-dom')` را بنویسید.
 
 ## بررسی اجمالی {#overview}
 

From 4891f94da42f93aac0c18db695ae1d6e75a33f03 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 14:46:08 +0330
Subject: [PATCH 05/22] Improve description of file

---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index b52365733..c30c2e0f9 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -7,7 +7,7 @@ permalink: docs/react-dom.html
 ---
 
 
-اگر React را با استفاده از `<script>" بارگیری می کنید، این API های سطح بالا در همه جا بر روی "ReactDOM" در دسترس هستند. اگر از ES6 با npm استفاده می کنید، می توانید `import ReactDOM from 'react-dom'` را وارد کنید. اگر از ES5 با npm استفاده می کنید نیز `var ReactDOM = require('react-dom')` را بنویسید.
+اگر React را با استفاده از `<script>` بارگیری می کنید، این API های سطح بالا در همه جا بر روی **ReactDOM** در دسترس هستند. اگر از ES6 با npm استفاده می کنید، می توانید `import ReactDOM from 'react-dom'` را وارد کنید. اگر از ES5 با npm استفاده می کنید نیز `var ReactDOM = require('react-dom')` را بنویسید.
 
 ## بررسی اجمالی {#overview}
 

From fa0547672d9d9e806e21564a595b334f7b8250ce Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 14:53:56 +0330
Subject: [PATCH 06/22] Modify "render"

---
 content/docs/reference-react-dom.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index c30c2e0f9..72237f88f 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -37,11 +37,12 @@ permalink: docs/react-dom.html
 ReactDOM.render(element, container[, callback])
 ```
 
-Render a React element into the DOM in the supplied `container` and return a [reference](/docs/more-about-refs.html) to the component (or returns `null` for [stateless components](/docs/components-and-props.html#function-and-class-components)).
+یک عنصر React را به DOM در ظرف قرار دهید و یک [مرجع](/docs/more-about-refs.html) به مؤلفه (یا برگشت مقدار `null` برای [اجزای بی تاب](/docs/components-and-props.html#function-and-class-components)) بازگردانی کنید.
 
-If the React element was previously rendered into `container`, this will perform an update on it and only mutate the DOM as necessary to reflect the latest React element.
+اگر عنصر React قبلاً در ظرف قرار داده شده باشد، این یک به روزرسانی را روی آن انجام می دهد و فقط در صورت لزوم DOM را تغییر می دهد تا آخرین عنصر React را منعکس کند.
 
-If the optional callback is provided, it will be executed after the component is rendered or updated.
+اگر مقدار پاسخ که یک مقدار اختیاری است را ارائه داده باشید، پس از ارائه یا به روزرسانی مؤلفه، اجرا خواهد شد.
+ 
 
 > نکته:
 >

From 720ae027c4232e465a76e8e857f23e762ba71195 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:09:33 +0330
Subject: [PATCH 07/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 43 +++++++++++++++++++----------
 1 file changed, 28 insertions(+), 15 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 72237f88f..e3b421fcb 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -6,13 +6,15 @@ category: Reference
 permalink: docs/react-dom.html
 ---
 
-
+<p dir="rtl">
 اگر React را با استفاده از `<script>` بارگیری می کنید، این API های سطح بالا در همه جا بر روی **ReactDOM** در دسترس هستند. اگر از ES6 با npm استفاده می کنید، می توانید `import ReactDOM from 'react-dom'` را وارد کنید. اگر از ES5 با npm استفاده می کنید نیز `var ReactDOM = require('react-dom')` را بنویسید.
-
-## بررسی اجمالی {#overview}
-
+</p>
+  
+<h2 dir="rtl">بررسی اجمالی {#overview}</h2>
+<p dir="rtl">
 بسته `react-dom` روش هایی خاص برای مدیریت و کار با پرونده را فراهم می کند که می تواند در بالاترین سطح برنامه ها استفاده شود و به عنوان یک راه برای جلوگیری از استفاده از ماژول `React` است.
 بیشتر اجزای برنامه شما نیازی به استفاده از این ماژول ندارد.
+</p>
 
 - [`render()`](#render)
 - [`hydrate()`](#hydrate)
@@ -20,23 +22,23 @@ permalink: docs/react-dom.html
 - [`findDOMNode()`](#finddomnode)
 - [`createPortal()`](#createportal)
 
-### پشتیبانی مرورگر {#browser-support}
-
+<h3 dir="rtl">پشتیبانی مرورگر {#browser-support}</h3>
+<p dir="rtl">
 ری اکت از کلیه مرورگرهای محبوب، از جمله Internet Explorer 9 و بالاتر پشتیبانی می کند، اگرچه [چند پیش نیاز دارد](/docs/javascript-Environment-Requires.html) تا برای مرورگرهای قدیمی مانند IE 9 و IE 10 به خوبی عمل کند.
 
 > نکته
 >
 > ما از مرورگرهای قدیمی كه از روشهای ES5 پشتیبانی نمی كنند پشتیبانی نمی كنیم، اما شما ممكن است متوجه شوید که در صورتی که برنامه شما شامل پیش نیاز هایی مانند [es5-shim و es5-sham](https://github.com/es-shims/es5-shim) باشد برنامه های شما در مرورگرهای قدیمی نیز به خوبی كار کند. اگر تصمیم دارید این را انتخاب کنید، مسئولیت آن با خودتان است.
+</p>
 
+<h2 dir="rtl">ارجاع {#reference}</h2>
 
-## ارجاع {#reference}
-
-### `render()` {#render}
+<h3 dir="rtl">`render()` {#render}</h3>
 
 ```javascript
 ReactDOM.render(element, container[, callback])
 ```
-
+<p dir="rtl">
 یک عنصر React را به DOM در ظرف قرار دهید و یک [مرجع](/docs/more-about-refs.html) به مؤلفه (یا برگشت مقدار `null` برای [اجزای بی تاب](/docs/components-and-props.html#function-and-class-components)) بازگردانی کنید.
 
 اگر عنصر React قبلاً در ظرف قرار داده شده باشد، این یک به روزرسانی را روی آن انجام می دهد و فقط در صورت لزوم DOM را تغییر می دهد تا آخرین عنصر React را منعکس کند.
@@ -55,15 +57,17 @@ ReactDOM.render(element, container[, callback])
 > [callback ref](/docs/more-about-refs.html#the-ref-callback-attribute) to the root element.
 >
 > Using `ReactDOM.render()` to hydrate a server-rendered container is deprecated and will be removed in React 17. Use [`hydrate()`](#hydrate) instead.
+</p>
 
 * * *
 
-### `hydrate()` {#hydrate}
+<h3 dir="rtl">`hydrate()` {#hydrate}</h3>
 
 ```javascript
 ReactDOM.hydrate(element, container[, callback])
 ```
 
+<p dir="rtl">
 Same as [`render()`](#render), but is used to hydrate a container whose HTML contents were rendered by [`ReactDOMServer`](/docs/react-dom-server.html). React will attempt to attach event listeners to the existing markup.
 
 React expects that the rendered content is identical between the server and the client. It can patch up differences in text content, but you should treat mismatches as bugs and fix them. In development mode, React warns about mismatches during hydration. There are no guarantees that attribute differences will be patched up in case of mismatches. This is important for performance reasons because in most apps, mismatches are rare, and so validating all markup would be prohibitively expensive.
@@ -73,28 +77,34 @@ If a single element's attribute or text content is unavoidably different between
 If you intentionally need to render something different on the server and the client, you can do a two-pass rendering. Components that render something different on the client can read a state variable like `this.state.isClient`, which you can set to `true` in `componentDidMount()`. This way the initial render pass will render the same content as the server, avoiding mismatches, but an additional pass will happen synchronously right after hydration. Note that this approach will make your components slower because they have to render twice, so use it with caution.
 
 Remember to be mindful of user experience on slow connections. The JavaScript code may load significantly later than the initial HTML render, so if you render something different in the client-only pass, the transition can be jarring. However, if executed well, it may be beneficial to render a "shell" of the application on the server, and only show some of the extra widgets on the client. To learn how to do this without getting the markup mismatch issues, refer to the explanation in the previous paragraph.
+</p>
 
 * * *
 
-### `unmountComponentAtNode()` {#unmountcomponentatnode}
+<h3 dir="rtl">`unmountComponentAtNode()` {#unmountcomponentatnode}</h3>
 
 ```javascript
 ReactDOM.unmountComponentAtNode(container)
 ```
 
+<p dir="rtl">
 Remove a mounted React component from the DOM and clean up its event handlers and state. If no component was mounted in the container, calling this function does nothing. Returns `true` if a component was unmounted and `false` if there was no component to unmount.
+</p>
 
 * * *
 
-### `findDOMNode()` {#finddomnode}
-
+<h3 dir="rtl">`findDOMNode()` {#finddomnode}</h3>
+<p dir="rtl">
 > Note:
 >
 > `findDOMNode` is an escape hatch used to access the underlying DOM node. In most cases, use of this escape hatch is discouraged because it pierces the component abstraction. [It has been deprecated in `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
+</p>
 
 ```javascript
 ReactDOM.findDOMNode(component)
 ```
+
+<p dir="rtl">
 If this component has been mounted into the DOM, this returns the corresponding native browser DOM element. This method is useful for reading values out of the DOM, such as form field values and performing DOM measurements. **In most cases, you can attach a ref to the DOM node and avoid using `findDOMNode` at all.**
 
 When a component renders to `null` or `false`, `findDOMNode` returns `null`. When a component renders to a string, `findDOMNode` returns a text DOM node containing that value. As of React 16, a component may return a fragment with multiple children, in which case `findDOMNode` will return the DOM node corresponding to the first non-empty child.
@@ -104,13 +114,16 @@ When a component renders to `null` or `false`, `findDOMNode` returns `null`. Whe
 > `findDOMNode` only works on mounted components (that is, components that have been placed in the DOM). If you try to call this on a component that has not been mounted yet (like calling `findDOMNode()` in `render()` on a component that has yet to be created) an exception will be thrown.
 >
 > `findDOMNode` cannot be used on function components.
+</p>
 
 * * *
 
-### `createPortal()` {#createportal}
+<h3 dir="rtl">`createPortal()` {#createportal}</h3>
 
 ```javascript
 ReactDOM.createPortal(child, container)
 ```
 
+<p dir="rtl">
 ایجاد یک پرتال. پورتال ها راهی برای [دادن اجزای فرزند به گره DOM که در خارج از سلسله مراتب از مؤلفه DOM وجود دارد ارائه می دهد](/docs/portalals.html).
+</p>

From 712b51529b9151f40d32f36a3aaac5e941c89558 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:19:02 +0330
Subject: [PATCH 08/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index e3b421fcb..f5cd4aaf8 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -95,9 +95,10 @@ Remove a mounted React component from the DOM and clean up its event handlers an
 
 <h3 dir="rtl">`findDOMNode()` {#finddomnode}</h3>
 <p dir="rtl">
-> Note:
->
-> `findDOMNode` is an escape hatch used to access the underlying DOM node. In most cases, use of this escape hatch is discouraged because it pierces the component abstraction. [It has been deprecated in `StrictMode`.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
+
+> توجه داشته باشید:
+> 
+> متد findDOMNode یک دریچه فرار است که برای دسترسی به گره DOM استفاده می شود. در بیشتر موارد، استفاده از این دریچه فرار از آن منع می شود زیرا انتزاع مؤلفه را سوراخ می کند. [این در "StrictMode" منسوخ شده است.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
 </p>
 
 ```javascript

From 570da5f8c8dbf3ffcbf510eec192eeae91562bf5 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:20:51 +0330
Subject: [PATCH 09/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index f5cd4aaf8..a47260a2e 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -106,7 +106,7 @@ ReactDOM.findDOMNode(component)
 ```
 
 <p dir="rtl">
-If this component has been mounted into the DOM, this returns the corresponding native browser DOM element. This method is useful for reading values out of the DOM, such as form field values and performing DOM measurements. **In most cases, you can attach a ref to the DOM node and avoid using `findDOMNode` at all.**
+اگر این مؤلفه در DOM نصب شده باشد ، این عنصر DOM مرورگر بومی را برمی گرداند. این روش برای خواندن مقادیر خارج از DOM مانند مقادیر شکل فرم و انجام اندازه گیری DOM مفید است. **در بیشتر موارد، شما می توانید یک گره به DOM متصل کنید و از استفاده از "findDOMNode" خودداری کنید.**
 
 When a component renders to `null` or `false`, `findDOMNode` returns `null`. When a component renders to a string, `findDOMNode` returns a text DOM node containing that value. As of React 16, a component may return a fragment with multiple children, in which case `findDOMNode` will return the DOM node corresponding to the first non-empty child.
 

From 25020fbdfd2049cd380524ce32611d6a006d0889 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:25:22 +0330
Subject: [PATCH 10/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index a47260a2e..0fb733233 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -108,9 +108,10 @@ ReactDOM.findDOMNode(component)
 <p dir="rtl">
 اگر این مؤلفه در DOM نصب شده باشد ، این عنصر DOM مرورگر بومی را برمی گرداند. این روش برای خواندن مقادیر خارج از DOM مانند مقادیر شکل فرم و انجام اندازه گیری DOM مفید است. **در بیشتر موارد، شما می توانید یک گره به DOM متصل کنید و از استفاده از "findDOMNode" خودداری کنید.**
 
-When a component renders to `null` or `false`, `findDOMNode` returns `null`. When a component renders to a string, `findDOMNode` returns a text DOM node containing that value. As of React 16, a component may return a fragment with multiple children, in which case `findDOMNode` will return the DOM node corresponding to the first non-empty child.
+هنگامی که یک جزء را بصورت "null" یا "false"و findDOMNode ظاهر می شود و `null` را برمی گرداند. وقتی یک جزء به عنوان یک رشته ظاهر می شود `findDOMNode` یک عنصر متنی را که شامل متن است برمیگرداند.
+همانطور که از React 16، یک مؤلفه می تواند قطعه ای را به همراه چند فرزند برگرداند، در این صورت "findDOMNode" گره DOM را که مربوط به اولین فرزند غیر خالی است، باز می گرداند.
 
-> Note:
+> نکته:
 >
 > `findDOMNode` only works on mounted components (that is, components that have been placed in the DOM). If you try to call this on a component that has not been mounted yet (like calling `findDOMNode()` in `render()` on a component that has yet to be created) an exception will be thrown.
 >

From 6af0311c77ccb5e9690947636b133870ef872869 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:34:55 +0330
Subject: [PATCH 11/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 0fb733233..e543e3524 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -88,7 +88,7 @@ ReactDOM.unmountComponentAtNode(container)
 ```
 
 <p dir="rtl">
-Remove a mounted React component from the DOM and clean up its event handlers and state. If no component was mounted in the container, calling this function does nothing. Returns `true` if a component was unmounted and `false` if there was no component to unmount.
+یک مؤلفه React نصب شده را از DOM جدا کرده و بررسی کننده رویداد و وضعیت آن را تمیز کنید. اگر هیچ مؤلفه ای در ظرف نصب نشده باشد، فراخوانی این عملکرد هیچ کاری نمی کند. این عملکرد مقدار صحیح را برمیگرداند اگر مؤلفه برچیده شود و در صورت عدم وجود مؤلفه ای مقدار "نادرست" را می گرداند.
 </p>
 
 * * *

From 4cbaa50ae1505c05060718d91ae84b7614c5e46c Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:39:12 +0330
Subject: [PATCH 12/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index e543e3524..7ab9bfbd2 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -70,7 +70,7 @@ ReactDOM.hydrate(element, container[, callback])
 <p dir="rtl">
 Same as [`render()`](#render), but is used to hydrate a container whose HTML contents were rendered by [`ReactDOMServer`](/docs/react-dom-server.html). React will attempt to attach event listeners to the existing markup.
 
-React expects that the rendered content is identical between the server and the client. It can patch up differences in text content, but you should treat mismatches as bugs and fix them. In development mode, React warns about mismatches during hydration. There are no guarantees that attribute differences will be patched up in case of mismatches. This is important for performance reasons because in most apps, mismatches are rare, and so validating all markup would be prohibitively expensive.
+ری اکت انتظار دارد که محتوای ارائه شده بین سرور و کلاینت یکسان باشد. این می تواند اختلافات در متن را برطرف کند، اما باید ناسازگاری ها را با اشکال در نظر بگیرید و آنها را برطرف کنید. در حالت توسعه، React در مورد عدم تطابق هشدار می دهد. هیچ تضمینی وجود ندارد که اختلاف ویژگی ها در صورت عدم تطابق در آنها برطرف شود. این امر به دلایل عملکرد بسیار مهم است زیرا در اکثر برنامه ها، عدم تطابق نادر است، بنابراین اعتبار و اهمیت دادن به همه نشانه گذاری ها بسیار گران قیمت است.
 
 If a single element's attribute or text content is unavoidably different between the server and the client (for example, a timestamp), you may silence the warning by adding `suppressHydrationWarning={true}` to the element. It only works one level deep, and is intended to be an escape hatch. Don't overuse it. Unless it's text content, React still won't attempt to patch it up, so it may remain inconsistent until future updates.
 

From 74f468ccc76b83b69172917cec84d392228d9221 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:43:42 +0330
Subject: [PATCH 13/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 7ab9bfbd2..e2ab9ae32 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -72,7 +72,7 @@ Same as [`render()`](#render), but is used to hydrate a container whose HTML con
 
 ری اکت انتظار دارد که محتوای ارائه شده بین سرور و کلاینت یکسان باشد. این می تواند اختلافات در متن را برطرف کند، اما باید ناسازگاری ها را با اشکال در نظر بگیرید و آنها را برطرف کنید. در حالت توسعه، React در مورد عدم تطابق هشدار می دهد. هیچ تضمینی وجود ندارد که اختلاف ویژگی ها در صورت عدم تطابق در آنها برطرف شود. این امر به دلایل عملکرد بسیار مهم است زیرا در اکثر برنامه ها، عدم تطابق نادر است، بنابراین اعتبار و اهمیت دادن به همه نشانه گذاری ها بسیار گران قیمت است.
 
-If a single element's attribute or text content is unavoidably different between the server and the client (for example, a timestamp), you may silence the warning by adding `suppressHydrationWarning={true}` to the element. It only works one level deep, and is intended to be an escape hatch. Don't overuse it. Unless it's text content, React still won't attempt to patch it up, so it may remain inconsistent until future updates.
+اگر ویژگی و عنصر متن یک عنصر به طور اجتناب ناپذیری بین سرور و مشتری متفاوت باشد (برای مثال ، یک timestamp)، شما می توانید با اضافه کردن "suppressHydrationWarning = {true" به این عنصر هشدار را ساکت کنید. این درنظر گرفته شده است که یک دریچه فرار باشد. بیش از حد از آن استفاده نکنید. اگر محتوای متن نباشد، React تلاش نخواهد کرد تا آنرا پیکربندی کند، بنابراین ممکن است تا به روزرسانیهای بعدی متناقض بماند.
 
 If you intentionally need to render something different on the server and the client, you can do a two-pass rendering. Components that render something different on the client can read a state variable like `this.state.isClient`, which you can set to `true` in `componentDidMount()`. This way the initial render pass will render the same content as the server, avoiding mismatches, but an additional pass will happen synchronously right after hydration. Note that this approach will make your components slower because they have to render twice, so use it with caution.
 

From 29fb65961c424178d6b7be39af59a1866a449a1b Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:48:27 +0330
Subject: [PATCH 14/22] Update reference-react-dom.md

---
 content/docs/reference-react-dom.md | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index e2ab9ae32..7b8b11f48 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -47,16 +47,13 @@ ReactDOM.render(element, container[, callback])
  
 
 > نکته:
+> `ReactDOM.render()` محتوای نود container که به داخل آن می‌فرستید را کنترل می کند. هنگامی که برای اولین بار فراخوانی می‌شود هر المنتی که داخلش باشد جایگزین می‌شود. ولی در سایر فراخوانی‌ها برای بهینه بودن به‌روزرسانی از الگوریتم اختلاف‌یاب React استفاده می‌شود (React’s DOM diffing algorithm).
 >
-> `ReactDOM.render()` controls the contents of the container node you pass in. Any existing DOM elements inside are replaced when first called. Later calls use React’s DOM diffing algorithm for efficient updates.
+> `ReactDOM.render()` نود اصلی را تغییر نمیدهد (فقط بچه‌های container را تغییر می‌دهد). شاید ممکن باشد که کامپوننتی را درون نودی که قبلا وجود داشته وارد کرد بدون اینکه نیاز به بازنویسی نودهای زیر شاخه(children) باشد.
 >
-> `ReactDOM.render()` does not modify the container node (only modifies the children of the container). It may be possible to insert a component to an existing DOM node without overwriting the existing children.
+> `ReactDOM.render()` در حال حاضر یک ارجاع از ریشه بدل(instance) `ReactComponent` برمی‌گرداند. با این حال با این حال استفاده از این مقدار برگشتی نوعی میراث است و باید از آن پرهیز شود زیرا در ورژن‌های آینده React شاید برخی کامپوننت‌ها در گاهی اوقات ناهمگام رندر شوند.اگر شما به مرجع بدل ریشه `ReactComponent` نیاز داشتید، بهترین راه حل آن است که یک [callback ref](/docs/more-about-refs.html#the-ref-callback-attribute) به ریشه المنت وصل کنید.
 >
-> `ReactDOM.render()` currently returns a reference to the root `ReactComponent` instance. However, using this return value is legacy
-> and should be avoided because future versions of React may render components asynchronously in some cases. If you need a reference to the root `ReactComponent` instance, the preferred solution is to attach a
-> [callback ref](/docs/more-about-refs.html#the-ref-callback-attribute) to the root element.
->
-> Using `ReactDOM.render()` to hydrate a server-rendered container is deprecated and will be removed in React 17. Use [`hydrate()`](#hydrate) instead.
+> استفاده از `ReactDOM.render()` برای hydrate کردن رندر شدن container سمت سرور منسوخ شده است و در ورژن ۱۷ React پاک خواهد شد. به جای آن از [`()hydrate`](#hydrate) استفاده کنید.
 </p>
 
 * * *
@@ -68,15 +65,16 @@ ReactDOM.hydrate(element, container[, callback])
 ```
 
 <p dir="rtl">
-Same as [`render()`](#render), but is used to hydrate a container whose HTML contents were rendered by [`ReactDOMServer`](/docs/react-dom-server.html). React will attempt to attach event listeners to the existing markup.
+مثل [`()render`](#render) است، ولی برای hydrate کردن یک container که محتوای HTML آن توسط [`ReactDOMServer`](/docs/react-dom-server.html) رنده شده است استفاده می‌شود. React تلاش می‌کند تا event listenerهایی به (markups)نشانه‌گذاری‌های موجود متصل کند.
 
 ری اکت انتظار دارد که محتوای ارائه شده بین سرور و کلاینت یکسان باشد. این می تواند اختلافات در متن را برطرف کند، اما باید ناسازگاری ها را با اشکال در نظر بگیرید و آنها را برطرف کنید. در حالت توسعه، React در مورد عدم تطابق هشدار می دهد. هیچ تضمینی وجود ندارد که اختلاف ویژگی ها در صورت عدم تطابق در آنها برطرف شود. این امر به دلایل عملکرد بسیار مهم است زیرا در اکثر برنامه ها، عدم تطابق نادر است، بنابراین اعتبار و اهمیت دادن به همه نشانه گذاری ها بسیار گران قیمت است.
 
 اگر ویژگی و عنصر متن یک عنصر به طور اجتناب ناپذیری بین سرور و مشتری متفاوت باشد (برای مثال ، یک timestamp)، شما می توانید با اضافه کردن "suppressHydrationWarning = {true" به این عنصر هشدار را ساکت کنید. این درنظر گرفته شده است که یک دریچه فرار باشد. بیش از حد از آن استفاده نکنید. اگر محتوای متن نباشد، React تلاش نخواهد کرد تا آنرا پیکربندی کند، بنابراین ممکن است تا به روزرسانیهای بعدی متناقض بماند.
 
-If you intentionally need to render something different on the server and the client, you can do a two-pass rendering. Components that render something different on the client can read a state variable like `this.state.isClient`, which you can set to `true` in `componentDidMount()`. This way the initial render pass will render the same content as the server, avoiding mismatches, but an additional pass will happen synchronously right after hydration. Note that this approach will make your components slower because they have to render twice, so use it with caution.
 
-Remember to be mindful of user experience on slow connections. The JavaScript code may load significantly later than the initial HTML render, so if you render something different in the client-only pass, the transition can be jarring. However, if executed well, it may be beneficial to render a "shell" of the application on the server, and only show some of the extra widgets on the client. To learn how to do this without getting the markup mismatch issues, refer to the explanation in the previous paragraph.
+اگر نیاز دارید تا از عمد چیز متفاوتی سمت سرور یا کاربر رندر کنید، می‌توانید از روش رندر کردن دو-گذری استفاده کنید. کامپوننت‌هایی که چیز متفاوتی سمت کاربر رندر می‌کنند می‌توانند stateای شبیه به `this.state.isClient` را بخوانند، که می‌توانید آن را در `componentDidMount()` برابر `true` قرار دهید. به این طریق در گذر اولیه رندر، همان محتوای سمت سرور رندر می‌شود، از عدم تطابق جلوگیری می‌شود، ولی یک گذر همگام درست بعد از hydration اتفاق می‌افتد. توجه کنید که در این روش کامپوننت‌های شما کم سرعت می‌شوند زیرا باید دوبار رندر شوند، پس با دقت استفاده کنید.
+
+نسبت به اتصال ضعیف کاربر توجه داشته باشید. کد JavaScript می‌تواند خیلی دیرتر از HTML اولیه رندر شود، پس اگر چیز متفاوتی در گذر فقط-کاربر رندر کنید، انتقال می‌تواند نامطلوب باشد. گرچه، اگر به خوبی اجرا شود، می‌تواند برای رندر شدن "shell" نرم‌افزار روی سرور مفید باشد، و فقط چند ابزارک سمت کاربر را نشان می‌دهد. برای اینکه بدانید این کار بدون اینکه درچار مشکل تطابق شوید چطور انجام می‌شود، به توضیحات پاراگراف قبلی مراجعه کنید.
 </p>
 
 * * *
@@ -113,9 +111,9 @@ ReactDOM.findDOMNode(component)
 
 > نکته:
 >
-> `findDOMNode` only works on mounted components (that is, components that have been placed in the DOM). If you try to call this on a component that has not been mounted yet (like calling `findDOMNode()` in `render()` on a component that has yet to be created) an exception will be thrown.
+> `findDOMNode` فقط روی کامپوننت‌هایی که mount شده اند کار می‌کنند (که آن کامپوننت در جای خود در DOM قرار گرفته است). اگر سعی کنید که آن را در کامپوننت فراخوانی کنید که هنوز در صفحه mount نشده است (مثل فراخوانی  `findDOMNode()` در `render()` روی کامپوننتی که هنوز ایجاد نشده است) به exception میخورید.
 >
-> `findDOMNode` cannot be used on function components.
+> `findDOMNode` در کامپوننت‌های تابعی کار نمی‌کند.
 </p>
 
 * * *

From 153dc619261889661ef2650de8ddf7f1b68d047f Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:50:15 +0330
Subject: [PATCH 15/22] Remove tag and replace to ##, ###, []()

---
 content/docs/reference-react-dom.md | 39 ++++++++++-------------------
 1 file changed, 13 insertions(+), 26 deletions(-)

diff --git a/content/docs/reference-react-dom.md b/content/docs/reference-react-dom.md
index 7b8b11f48..e37747fe8 100644
--- a/content/docs/reference-react-dom.md
+++ b/content/docs/reference-react-dom.md
@@ -6,15 +6,14 @@ category: Reference
 permalink: docs/react-dom.html
 ---
 
-<p dir="rtl">
 اگر React را با استفاده از `<script>` بارگیری می کنید، این API های سطح بالا در همه جا بر روی **ReactDOM** در دسترس هستند. اگر از ES6 با npm استفاده می کنید، می توانید `import ReactDOM from 'react-dom'` را وارد کنید. اگر از ES5 با npm استفاده می کنید نیز `var ReactDOM = require('react-dom')` را بنویسید.
-</p>
+
   
-<h2 dir="rtl">بررسی اجمالی {#overview}</h2>
-<p dir="rtl">
+## بررسی اجمالی {#overview}
+
 بسته `react-dom` روش هایی خاص برای مدیریت و کار با پرونده را فراهم می کند که می تواند در بالاترین سطح برنامه ها استفاده شود و به عنوان یک راه برای جلوگیری از استفاده از ماژول `React` است.
 بیشتر اجزای برنامه شما نیازی به استفاده از این ماژول ندارد.
-</p>
+
 
 - [`render()`](#render)
 - [`hydrate()`](#hydrate)
@@ -22,23 +21,22 @@ permalink: docs/react-dom.html
 - [`findDOMNode()`](#finddomnode)
 - [`createPortal()`](#createportal)
 
-<h3 dir="rtl">پشتیبانی مرورگر {#browser-support}</h3>
-<p dir="rtl">
+### پشتیبانی مرورگر {#browser-support}
+
 ری اکت از کلیه مرورگرهای محبوب، از جمله Internet Explorer 9 و بالاتر پشتیبانی می کند، اگرچه [چند پیش نیاز دارد](/docs/javascript-Environment-Requires.html) تا برای مرورگرهای قدیمی مانند IE 9 و IE 10 به خوبی عمل کند.
 
 > نکته
 >
 > ما از مرورگرهای قدیمی كه از روشهای ES5 پشتیبانی نمی كنند پشتیبانی نمی كنیم، اما شما ممكن است متوجه شوید که در صورتی که برنامه شما شامل پیش نیاز هایی مانند [es5-shim و es5-sham](https://github.com/es-shims/es5-shim) باشد برنامه های شما در مرورگرهای قدیمی نیز به خوبی كار کند. اگر تصمیم دارید این را انتخاب کنید، مسئولیت آن با خودتان است.
-</p>
 
-<h2 dir="rtl">ارجاع {#reference}</h2>
+## ارجاع {#reference}
 
-<h3 dir="rtl">`render()` {#render}</h3>
+### `render()` {#render}
 
 ```javascript
 ReactDOM.render(element, container[, callback])
 ```
-<p dir="rtl">
+
 یک عنصر React را به DOM در ظرف قرار دهید و یک [مرجع](/docs/more-about-refs.html) به مؤلفه (یا برگشت مقدار `null` برای [اجزای بی تاب](/docs/components-and-props.html#function-and-class-components)) بازگردانی کنید.
 
 اگر عنصر React قبلاً در ظرف قرار داده شده باشد، این یک به روزرسانی را روی آن انجام می دهد و فقط در صورت لزوم DOM را تغییر می دهد تا آخرین عنصر React را منعکس کند.
@@ -54,17 +52,15 @@ ReactDOM.render(element, container[, callback])
 > `ReactDOM.render()` در حال حاضر یک ارجاع از ریشه بدل(instance) `ReactComponent` برمی‌گرداند. با این حال با این حال استفاده از این مقدار برگشتی نوعی میراث است و باید از آن پرهیز شود زیرا در ورژن‌های آینده React شاید برخی کامپوننت‌ها در گاهی اوقات ناهمگام رندر شوند.اگر شما به مرجع بدل ریشه `ReactComponent` نیاز داشتید، بهترین راه حل آن است که یک [callback ref](/docs/more-about-refs.html#the-ref-callback-attribute) به ریشه المنت وصل کنید.
 >
 > استفاده از `ReactDOM.render()` برای hydrate کردن رندر شدن container سمت سرور منسوخ شده است و در ورژن ۱۷ React پاک خواهد شد. به جای آن از [`()hydrate`](#hydrate) استفاده کنید.
-</p>
 
 * * *
 
-<h3 dir="rtl">`hydrate()` {#hydrate}</h3>
+### `hydrate()` {#hydrate}
 
 ```javascript
 ReactDOM.hydrate(element, container[, callback])
 ```
 
-<p dir="rtl">
 مثل [`()render`](#render) است، ولی برای hydrate کردن یک container که محتوای HTML آن توسط [`ReactDOMServer`](/docs/react-dom-server.html) رنده شده است استفاده می‌شود. React تلاش می‌کند تا event listenerهایی به (markups)نشانه‌گذاری‌های موجود متصل کند.
 
 ری اکت انتظار دارد که محتوای ارائه شده بین سرور و کلاینت یکسان باشد. این می تواند اختلافات در متن را برطرف کند، اما باید ناسازگاری ها را با اشکال در نظر بگیرید و آنها را برطرف کنید. در حالت توسعه، React در مورد عدم تطابق هشدار می دهد. هیچ تضمینی وجود ندارد که اختلاف ویژگی ها در صورت عدم تطابق در آنها برطرف شود. این امر به دلایل عملکرد بسیار مهم است زیرا در اکثر برنامه ها، عدم تطابق نادر است، بنابراین اعتبار و اهمیت دادن به همه نشانه گذاری ها بسیار گران قیمت است.
@@ -75,35 +71,29 @@ ReactDOM.hydrate(element, container[, callback])
 اگر نیاز دارید تا از عمد چیز متفاوتی سمت سرور یا کاربر رندر کنید، می‌توانید از روش رندر کردن دو-گذری استفاده کنید. کامپوننت‌هایی که چیز متفاوتی سمت کاربر رندر می‌کنند می‌توانند stateای شبیه به `this.state.isClient` را بخوانند، که می‌توانید آن را در `componentDidMount()` برابر `true` قرار دهید. به این طریق در گذر اولیه رندر، همان محتوای سمت سرور رندر می‌شود، از عدم تطابق جلوگیری می‌شود، ولی یک گذر همگام درست بعد از hydration اتفاق می‌افتد. توجه کنید که در این روش کامپوننت‌های شما کم سرعت می‌شوند زیرا باید دوبار رندر شوند، پس با دقت استفاده کنید.
 
 نسبت به اتصال ضعیف کاربر توجه داشته باشید. کد JavaScript می‌تواند خیلی دیرتر از HTML اولیه رندر شود، پس اگر چیز متفاوتی در گذر فقط-کاربر رندر کنید، انتقال می‌تواند نامطلوب باشد. گرچه، اگر به خوبی اجرا شود، می‌تواند برای رندر شدن "shell" نرم‌افزار روی سرور مفید باشد، و فقط چند ابزارک سمت کاربر را نشان می‌دهد. برای اینکه بدانید این کار بدون اینکه درچار مشکل تطابق شوید چطور انجام می‌شود، به توضیحات پاراگراف قبلی مراجعه کنید.
-</p>
 
 * * *
 
-<h3 dir="rtl">`unmountComponentAtNode()` {#unmountcomponentatnode}</h3>
+### `unmountComponentAtNode()` {#unmountcomponentatnode}
 
 ```javascript
 ReactDOM.unmountComponentAtNode(container)
 ```
 
-<p dir="rtl">
 یک مؤلفه React نصب شده را از DOM جدا کرده و بررسی کننده رویداد و وضعیت آن را تمیز کنید. اگر هیچ مؤلفه ای در ظرف نصب نشده باشد، فراخوانی این عملکرد هیچ کاری نمی کند. این عملکرد مقدار صحیح را برمیگرداند اگر مؤلفه برچیده شود و در صورت عدم وجود مؤلفه ای مقدار "نادرست" را می گرداند.
-</p>
 
 * * *
 
-<h3 dir="rtl">`findDOMNode()` {#finddomnode}</h3>
-<p dir="rtl">
+### `findDOMNode()` {#finddomnode}
 
 > توجه داشته باشید:
 > 
 > متد findDOMNode یک دریچه فرار است که برای دسترسی به گره DOM استفاده می شود. در بیشتر موارد، استفاده از این دریچه فرار از آن منع می شود زیرا انتزاع مؤلفه را سوراخ می کند. [این در "StrictMode" منسوخ شده است.](/docs/strict-mode.html#warning-about-deprecated-finddomnode-usage)
-</p>
 
 ```javascript
 ReactDOM.findDOMNode(component)
 ```
 
-<p dir="rtl">
 اگر این مؤلفه در DOM نصب شده باشد ، این عنصر DOM مرورگر بومی را برمی گرداند. این روش برای خواندن مقادیر خارج از DOM مانند مقادیر شکل فرم و انجام اندازه گیری DOM مفید است. **در بیشتر موارد، شما می توانید یک گره به DOM متصل کنید و از استفاده از "findDOMNode" خودداری کنید.**
 
 هنگامی که یک جزء را بصورت "null" یا "false"و findDOMNode ظاهر می شود و `null` را برمی گرداند. وقتی یک جزء به عنوان یک رشته ظاهر می شود `findDOMNode` یک عنصر متنی را که شامل متن است برمیگرداند.
@@ -114,16 +104,13 @@ ReactDOM.findDOMNode(component)
 > `findDOMNode` فقط روی کامپوننت‌هایی که mount شده اند کار می‌کنند (که آن کامپوننت در جای خود در DOM قرار گرفته است). اگر سعی کنید که آن را در کامپوننت فراخوانی کنید که هنوز در صفحه mount نشده است (مثل فراخوانی  `findDOMNode()` در `render()` روی کامپوننتی که هنوز ایجاد نشده است) به exception میخورید.
 >
 > `findDOMNode` در کامپوننت‌های تابعی کار نمی‌کند.
-</p>
 
 * * *
 
-<h3 dir="rtl">`createPortal()` {#createportal}</h3>
+### `createPortal()` {#createportal}
 
 ```javascript
 ReactDOM.createPortal(child, container)
 ```
 
-<p dir="rtl">
 ایجاد یک پرتال. پورتال ها راهی برای [دادن اجزای فرزند به گره DOM که در خارج از سلسله مراتب از مؤلفه DOM وجود دارد ارائه می دهد](/docs/portalals.html).
-</p>

From 532bffa8d8921686d940c3020e00f256af16129d Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:54:11 +0330
Subject: [PATCH 16/22] Begin Translate to Persian

---
 content/docs/fragments.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/content/docs/fragments.md b/content/docs/fragments.md
index 33619db2f..a89e8b26b 100644
--- a/content/docs/fragments.md
+++ b/content/docs/fragments.md
@@ -115,7 +115,7 @@ You can use `<></>` the same way you'd use any other element except that it does
 
 ### Keyed Fragments {#keyed-fragments}
 
-Fragments declared with the explicit `<React.Fragment>` syntax may have keys. A use case for this is mapping a collection to an array of fragments -- for example, to create a description list:
+تکه های اعلام شده با نحوی صریح `<React.Fragment>` ممکن است دارای کلید باشند. مورد استفاده برای این کار ، نقشه برداری از مجموعه به مجموعه ای از قطعات است - برای مثال ، برای ایجاد یک لیست توضیحات:
 
 ```jsx
 function Glossary(props) {
@@ -135,6 +135,6 @@ function Glossary(props) {
 
 `key` is the only attribute that can be passed to `Fragment`. In the future, we may add support for additional attributes, such as event handlers.
 
-### Live Demo {#live-demo}
+### نسخه ی نمایشی زنده {#live-demo}
 
-You can try out the new JSX fragment syntax with this [CodePen](https://codepen.io/reactjs/pen/VrEbjE?editors=1000).
+می توانید با این [CodePen](https://codepen.io/reactjs/pen/VrEbjE?editors=1000) نحو جدید قطعه JSX را امتحان کنید.

From 454aaf6b239f12f5f0792b3eca0e650aa98fc7b0 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:56:32 +0330
Subject: [PATCH 17/22] Update fragments.md

---
 content/docs/fragments.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/content/docs/fragments.md b/content/docs/fragments.md
index a89e8b26b..9915966d9 100644
--- a/content/docs/fragments.md
+++ b/content/docs/fragments.md
@@ -4,8 +4,8 @@ title: Fragments
 permalink: docs/fragments.html
 ---
 
-A common pattern in React is for a component to return multiple elements. Fragments let you group a list of children without adding extra nodes to the DOM.
-
+یک الگوی رایج در React این است که یک مؤلفه بتواند عناصر مختلف را برگرداند. قطعات به شما امکان می دهد لیستی از فرزندان را بدون اضافه کردن گره های اضافی به DOM گروه بندی کنید.
+ 
 ```js
 render() {
   return (
@@ -18,11 +18,11 @@ render() {
 }
 ```
 
-There is also a new [short syntax](#short-syntax) for declaring them.
+همچنین یک [نحو کوتاه](#short-syntax) برای اعلام آنها وجود دارد.
 
-## Motivation {#motivation}
+## انگیزه {#motivation}
 
-A common pattern is for a component to return a list of children. Take this example React snippet:
+یک الگوی رایج برای این است که یک جزء بتواند لیستی از فرزندان را برگرداند. از این مثال نمونه React snippet بگیرید:
 
 ```jsx
 class Table extends React.Component {

From 71d3c1c6692660ba2ac1834587e284297699db7d Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 15:58:47 +0330
Subject: [PATCH 18/22] Update fragments.md

---
 content/docs/fragments.md | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/content/docs/fragments.md b/content/docs/fragments.md
index 9915966d9..140e0b9b3 100644
--- a/content/docs/fragments.md
+++ b/content/docs/fragments.md
@@ -53,9 +53,10 @@ class Columns extends React.Component {
 }
 ```
 
-results in a `<Table />` output of:
+منجر به خروجی `<Table />` در:
 
 ```jsx
+
 <table>
   <tr>
     <div>
@@ -66,9 +67,9 @@ results in a `<Table />` output of:
 </table>
 ```
 
-Fragments solve this problem.
+قطعات این مشکل را حل می کنند.
 
-## Usage {#usage}
+## طریقه استفاده {#usage}
 
 ```jsx{4,7}
 class Columns extends React.Component {
@@ -83,7 +84,7 @@ class Columns extends React.Component {
 }
 ```
 
-which results in a correct `<Table />` output of:
+که منجر به خروجی صحیح `<Table />` در:
 
 ```jsx
 <table>
@@ -94,10 +95,10 @@ which results in a correct `<Table />` output of:
 </table>
 ```
 
-### Short Syntax {#short-syntax}
-
-There is a new, shorter syntax you can use for declaring fragments. It looks like empty tags:
+### نحو کوتاه {#short-syntax}
 
+یک نحو جدید و کوتاه تر وجود دارد که می توانید برای اعلام قطعات استفاده کنید. این شبیه به برچسب های خالی است:
+ 
 ```jsx{4,7}
 class Columns extends React.Component {
   render() {
@@ -113,7 +114,7 @@ class Columns extends React.Component {
 
 You can use `<></>` the same way you'd use any other element except that it doesn't support keys or attributes.
 
-### Keyed Fragments {#keyed-fragments}
+### قطعات اصلی {#keyed-fragments}
 
 تکه های اعلام شده با نحوی صریح `<React.Fragment>` ممکن است دارای کلید باشند. مورد استفاده برای این کار ، نقشه برداری از مجموعه به مجموعه ای از قطعات است - برای مثال ، برای ایجاد یک لیست توضیحات:
 

From 903fe79942c7cd4864c78a9f3d2c3c2b253d639b Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 16:03:29 +0330
Subject: [PATCH 19/22] Update fragments.md

---
 content/docs/fragments.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/content/docs/fragments.md b/content/docs/fragments.md
index 140e0b9b3..1c08f989f 100644
--- a/content/docs/fragments.md
+++ b/content/docs/fragments.md
@@ -38,7 +38,8 @@ class Table extends React.Component {
 }
 ```
 
-`<Columns />` would need to return multiple `<td>` elements in order for the rendered HTML to be valid. If a parent div was used inside the `render()` of `<Columns />`, then the resulting HTML will be invalid.
+دستور `<Columns />` نیاز خواهد بود تا بتوانید چند `<td>` را برگردانید که در خروجی از لحاظ HTML معتبر باشند.
+اگر در بخش ارائه از `<Columns />` استفاده کنید, خروجی HTML نادرست خواهد بود.
 
 ```jsx
 class Columns extends React.Component {

From bd413a46d81e48d1217a7c1ab1b3b89f6ee421b7 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 16:27:50 +0330
Subject: [PATCH 20/22] Update fragments.md

---
 content/docs/fragments.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/content/docs/fragments.md b/content/docs/fragments.md
index 1c08f989f..0026c5a5e 100644
--- a/content/docs/fragments.md
+++ b/content/docs/fragments.md
@@ -113,7 +113,7 @@ class Columns extends React.Component {
 }
 ```
 
-You can use `<></>` the same way you'd use any other element except that it doesn't support keys or attributes.
+می توانید از `<></>` ها به همان روشی استفاده کنید که می توانید از هر عنصر دیگری استفاده کنید به جز اینکه از ویژگی ها پشتیبانی نمی کند.
 
 ### قطعات اصلی {#keyed-fragments}
 
@@ -135,7 +135,8 @@ function Glossary(props) {
 }
 ```
 
-`key` is the only attribute that can be passed to `Fragment`. In the future, we may add support for additional attributes, such as event handlers.
+"کلید" تنها صفتی است که می توان به Fragment منتقل کرد. در آینده، ما ممکن است از ویژگی های بیشتری بعدا پشتیبانی کنیم، مانند کنترل رویداد ها
+
 
 ### نسخه ی نمایشی زنده {#live-demo}
 

From f5eb0b37623cb012bbec27fd3eac8e5967d8ee57 Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 16:37:56 +0330
Subject: [PATCH 21/22] Create: Translate "forwarding-refs.md" to Persian

---
 content/docs/forwarding-refs.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/content/docs/forwarding-refs.md b/content/docs/forwarding-refs.md
index 3318d8499..ec49b928b 100644
--- a/content/docs/forwarding-refs.md
+++ b/content/docs/forwarding-refs.md
@@ -4,9 +4,9 @@ title: Forwarding Refs
 permalink: docs/forwarding-refs.html
 ---
 
-Ref forwarding is a technique for automatically passing a [ref](/docs/refs-and-the-dom.html) through a component to one of its children. This is typically not necessary for most components in the application. However, it can be useful for some kinds of components, especially in reusable component libraries. The most common scenarios are described below.
+حمل مرجع روشی برای انتقال خودکار [ref] (/docs/refs-and-the-dom.html) از طریق یک جزء به یکی از فرزندانش است. این به طور معمول برای بیشتر مؤلفه های برنامه ضروری نیست. با این حال، این می تواند برای برخی از انواع مؤلفه ها، به ویژه در کتابخانه های مؤلفه قابل استفاده مجدد، مفید باشد. متداول ترین موضوع ها در زیر توضیح داده شده است.
 
-## Forwarding refs to DOM components {#forwarding-refs-to-dom-components}
+## حمل جرمع به DOM کامپوننت {#forwarding-refs-to-dom-components}
 
 Consider a `FancyButton` component that renders the native `button` DOM element:
 `embed:forwarding-refs/fancy-button-simple.js`
@@ -31,13 +31,13 @@ Here is a step-by-step explanation of what happens in the above example:
 1. We forward this `ref` argument down to `<button ref={ref}>` by specifying it as a JSX attribute.
 1. When the ref is attached, `ref.current` will point to the `<button>` DOM node.
 
->Note
+>توجه
 >
 >The second `ref` argument only exists when you define a component with `React.forwardRef` call. Regular function or class components don't receive the `ref` argument, and ref is not available in props either.
 >
 >Ref forwarding is not limited to DOM components. You can forward refs to class component instances, too.
 
-## Note for component library maintainers {#note-for-component-library-maintainers}
+## نکته برای نگهدارنده های کتابخانه ها {#note-for-component-library-maintainers}
 
 **When you start using `forwardRef` in a component library, you should treat it as a breaking change and release a new major version of your library.** This is because your library likely has an observably different behavior (such as what refs get assigned to, and what types are exported), and this can break apps and other libraries that depend on the old behavior.
 

From 2aa36f5afcfe560471048c8a666f885383df75ef Mon Sep 17 00:00:00 2001
From: Max Base <Max@Asrez.com>
Date: Sat, 18 Jan 2020 16:42:01 +0330
Subject: [PATCH 22/22] Update forwarding-refs.md

---
 content/docs/forwarding-refs.md | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/content/docs/forwarding-refs.md b/content/docs/forwarding-refs.md
index ec49b928b..22ff28ed7 100644
--- a/content/docs/forwarding-refs.md
+++ b/content/docs/forwarding-refs.md
@@ -4,7 +4,7 @@ title: Forwarding Refs
 permalink: docs/forwarding-refs.html
 ---
 
-حمل مرجع روشی برای انتقال خودکار [ref] (/docs/refs-and-the-dom.html) از طریق یک جزء به یکی از فرزندانش است. این به طور معمول برای بیشتر مؤلفه های برنامه ضروری نیست. با این حال، این می تواند برای برخی از انواع مؤلفه ها، به ویژه در کتابخانه های مؤلفه قابل استفاده مجدد، مفید باشد. متداول ترین موضوع ها در زیر توضیح داده شده است.
+حمل مرجع روشی برای انتقال خودکار [ref](/docs/refs-and-the-dom.html) از طریق یک جزء به یکی از فرزندانش است. این به طور معمول برای بیشتر مؤلفه های برنامه ضروری نیست. با این حال، این می تواند برای برخی از انواع مؤلفه ها، به ویژه در کتابخانه های مؤلفه قابل استفاده مجدد، مفید باشد. متداول ترین موضوع ها در زیر توضیح داده شده است.
 
 ## حمل جرمع به DOM کامپوننت {#forwarding-refs-to-dom-components}
 
@@ -21,9 +21,10 @@ In the example below, `FancyButton` uses `React.forwardRef` to obtain the `ref`
 
 `embed:forwarding-refs/fancy-button-simple-ref.js`
 
-This way, components using `FancyButton` can get a ref to the underlying `button` DOM node and access it if necessary—just like if they used a DOM `button` directly.
+به این ترتیب ، اجزای با استفاده از "FancyButton" می توانند به قسمت زیر دکمه "گره" DOM مراجعه کنند و در صورت لزوم به آن دسترسی پیدا کنند - درست مثل اینکه مستقیماً از دکمه DOM استفاده می کردند.
 
-Here is a step-by-step explanation of what happens in the above example:
+
+در اینجا توضیح گام به گام آنچه در مثال بالا اتفاق می افتد آورده شده است:
 
 1. We create a [React ref](/docs/refs-and-the-dom.html) by calling `React.createRef` and assign it to a `ref` variable.
 1. We pass our `ref` down to `<FancyButton ref={ref}>` by specifying it as a JSX attribute.
@@ -59,18 +60,18 @@ This means that refs intended for our `FancyButton` component will actually be a
 Fortunately, we can explicitly forward refs to the inner `FancyButton` component using the `React.forwardRef` API. `React.forwardRef` accepts a render function that receives `props` and `ref` parameters and returns a React node. For example:
 `embed:forwarding-refs/log-props-after.js`
 
-## Displaying a custom name in DevTools {#displaying-a-custom-name-in-devtools}
+## نمایش نام سفارشی در DevTools {#displaying-a-custom-name-in-devtools}
 
 `React.forwardRef` accepts a render function. React DevTools uses this function to determine what to display for the ref forwarding component.
 
-For example, the following component will appear as "*ForwardRef*" in the DevTools:
-
+به عنوان مثال ، مؤلفه زیر به صورت "*ForwardRef*" در DevTools ظاهر می شود:
+ 
 `embed:forwarding-refs/wrapped-component.js`
 
-If you name the render function, DevTools will also include its name (e.g. "*ForwardRef(myFunction)*"):
+اگر تابع رندر را نامگذاری کنید ، DevTools نام آن را نیز شامل می شود (به عنوان مثال "*ForwardRef(myFunction)*"):
 
 `embed:forwarding-refs/wrapped-component-with-function-name.js`
 
-You can even set the function's `displayName` property to include the component you're wrapping:
+حتی می توانید نامی که برای توابع نمایش می دهد را تنظیم کنید تا نام مؤلفه ای که از آن بسته بندی شده است واضح باشد:
 
 `embed:forwarding-refs/customized-display-name.js`