From 4a4cdabe80a1b68ba7a88f0f15d9a17666fb5ae3 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Tue, 21 Jan 2020 06:00:52 +0200 Subject: [PATCH 01/30] translated the title --- content/docs/concurrent-mode-reference.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index bfc06e731..029a14505 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -1,6 +1,6 @@ --- id: concurrent-mode-reference -title: Concurrent Mode API Reference (Experimental) +title: مرجع واجهة برمجة التطبيقات للوضع المتزامن (تجريبي) permalink: docs/concurrent-mode-reference.html prev: concurrent-mode-adoption.html --- @@ -55,7 +55,7 @@ ReactDOM.createBlockingRoot(rootNode).render() Replaces `ReactDOM.render(, rootNode)` and enables [Blocking Mode](/docs/concurrent-mode-adoption.html#migration-step-blocking-mode). -Opting into Concurrent Mode introduces semantic changes to how React works. This means that you can't use Concurrent Mode in just a few components. Because of this, some apps may not be able to migrate directly to Concurrent Mode. +Opting into Concurrent Mode introduces semantic changes to how React works. This means that you can't use Concurrent Mode in just a few components. Because of this, some apps may not be able to migrate directly to Concurrent Mode. Blocking Mode only contains a small subset of Concurrent Mode features and is intended as an intermediary migration step for apps that are unable to migrate directly. @@ -102,7 +102,7 @@ When multiple components need to fetch data, this data may arrive in an unpredic `SuspenseList` takes two props: * **revealOrder (forwards, backwards, together)** defines the order in which the `SuspenseList` children should be revealed. * `together` reveals *all* of them when they're ready instead of one by one. -* **tail (collapsed, hidden)** dictates how unloaded items in a `SuspenseList` is shown. +* **tail (collapsed, hidden)** dictates how unloaded items in a `SuspenseList` is shown. * By default, `SuspenseList` will show all fallbacks in the list. * `collapsed` shows only the next fallback in the list. * `hidden` doesn't show any unloaded items. @@ -185,7 +185,7 @@ A good example of this is a text input. ```js function App() { const [text, setText] = useState("hello"); - const deferredText = useDeferredValue(text, { timeoutMs: 2000 }); + const deferredText = useDeferredValue(text, { timeoutMs: 2000 }); return (
From 006ebbcc282f5d6035a5b46cb558cb362a027025 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Wed, 11 Mar 2020 15:44:22 +0200 Subject: [PATCH 02/30] Translate page intro --- content/docs/concurrent-mode-reference.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 59ead8afb..1bb185366 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -14,11 +14,10 @@ prev: concurrent-mode-adoption.html
->Caution: +>الحذر: +>تصف هذه الصفحة **الميزات التجريبية التي [غير متوفرة بعد](/docs/concurrent-mode-approach.html) في إصدار ثابت**. لا تعتمد على تصميمات React التجريبية في تطبيقات الإنتاج. قد تتغير هذه الميزات بشكل كبير ودون سابق إنذار قبل أن تصبح جزءًا من React. > ->This page describes **experimental features that are [not yet available](/docs/concurrent-mode-adoption.html) in a stable release**. Don't rely on experimental builds of React in production apps. These features may change significantly and without a warning before they become a part of React. -> ->This documentation is aimed at early adopters and people who are curious. **If you're new to React, don't worry about these features** -- you don't need to learn them right now. +>تستهدف هذه الوثائق إلى التبني المبكر والأشخاص الفضوليين. **إذا كنت جديدًا في React، فلا تقلق بشأن هذه الميزات** -- لست بحاجة إلى تعلمها الآن.
From 5552f87559303c9888ed7a1fd40d3d89a33f3fa6 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Wed, 11 Mar 2020 16:04:13 +0200 Subject: [PATCH 03/30] Translate 'Enabling Concurrent Mode' --- content/docs/concurrent-mode-reference.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 1bb185366..4d860833c 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -21,11 +21,11 @@ prev: concurrent-mode-adoption.html
-This page is an API reference for the React [Concurrent Mode](/docs/concurrent-mode-intro.html). If you're looking for a guided introduction instead, check out [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html). +هذه الصفحة هي مرجع واجهة برمجة التطبيقات لـ React [الوضع المتزامن](/docs/concurrent-mode-intro.html). إذا كنت تبحث عن مقدمة موجهة بدلاً من ذلك، فتحقق من [أنماط واجهة المستخدم المتزامنة](/docs/concurrent-mode-patterns.html). -**Note: This is a Community Preview and not the final stable version. There will likely be future changes to these APIs. Use at your own risk!** +**ملاحظة: هذه هي معاينة المجتمع وليست الإصدار النهائي المستقر. من المحتمل أن تكون هناك تغييرات مستقبلية على واجهات برمجة التطبيقات تلك. استخدام على مسؤوليتك الخاصة!** -- [Enabling Concurrent Mode](#concurrent-mode) +- [تمكين الوضع المتزامن](#concurrent-mode) - [`createRoot`](#createroot) - [`createBlockingRoot`](#createblockingroot) - [Suspense](#suspense) @@ -34,7 +34,7 @@ This page is an API reference for the React [Concurrent Mode](/docs/concurrent-m - [`useTransition`](#usetransition) - [`useDeferredValue`](#usedeferredvalue) -## Enabling Concurrent Mode {#concurrent-mode} +## تمكين الوضع المتزامن {#concurrent-mode} ### `createRoot` {#createroot} @@ -42,9 +42,9 @@ This page is an API reference for the React [Concurrent Mode](/docs/concurrent-m ReactDOM.createRoot(rootNode).render(); ``` -Replaces `ReactDOM.render(, rootNode)` and enables Concurrent Mode. +استبدال `ReactDOM.render (, rootNode)` وتمكين الوضع المتزامن. -For more information on Concurrent Mode, check out the [Concurrent Mode documentation.](/docs/concurrent-mode-intro.html) +لمزيد من المعلومات حول الوضع المتزامن، راجع [وثائق الوضع المتزامن.](/docs/concurrent-mode-intro.html) ### `createBlockingRoot` {#createblockingroot} @@ -52,11 +52,11 @@ For more information on Concurrent Mode, check out the [Concurrent Mode document ReactDOM.createBlockingRoot(rootNode).render() ``` -Replaces `ReactDOM.render(, rootNode)` and enables [Blocking Mode](/docs/concurrent-mode-adoption.html#migration-step-blocking-mode). +يستبدل `ReactDOM.render(, rootNode)` و تمكين [وضع الحظر](/docs/concurrent-mode-adoption.html#migration-step-blocking-mode). -Opting into Concurrent Mode introduces semantic changes to how React works. This means that you can't use Concurrent Mode in just a few components. Because of this, some apps may not be able to migrate directly to Concurrent Mode. +يؤدي الاشتراك في الوضع المتزامن إلى إدخال تغييرات دلالية في كيفية عمل React. هذا يعني أنه لا يمكنك استخدام الوضع المتزامن في عدد قليل من المكونات. وبسبب هذا، قد لا تتمكن بعض التطبيقات من الترحيل مباشرة إلى الوضع المتزامن. -Blocking Mode only contains a small subset of Concurrent Mode features and is intended as an intermediary migration step for apps that are unable to migrate directly. +يحتوي وضع الحظر فقط على مجموعة فرعية صغيرة من ميزات الوضع المتزامن ويقصد به كخطوة ترحيل وسيطة للتطبيقات التي لا تستطيع الترحيل مباشرة. ## Suspense API {#suspense} From fe99c3bc22b4239e45a6643165a786e1360f0ee5 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Wed, 11 Mar 2020 16:17:49 +0200 Subject: [PATCH 04/30] Translate 'Suspense' API --- content/docs/concurrent-mode-reference.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 4d860833c..1b53bca6b 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -69,13 +69,13 @@ ReactDOM.createBlockingRoot(rootNode).render() ``` -`Suspense` lets your components "wait" for something before they can render, showing a fallback while waiting. +`Suspense` يتيح لمكوناتك "الانتظار" لشيء ما قبل أن تتمكن من التصيير، مع إظهار احتياطي أثناء الانتظار. -In this example, `ProfileDetails` is waiting for an asynchronous API call to fetch some data. While we wait for `ProfileDetails` and `ProfilePhoto`, we will show the `Loading...` fallback instead. It is important to note that until all children inside `` has loaded, we will continue to show the fallback. +في هذا المثال، ينتظر `ProfileDetails` اتصال API غير متزامن لجلب بعض البيانات. أثناء انتظار ` ProfileDetails` و `ProfilePhoto`، سنعرض الخيار `جاري التحميل ...` بدلاً من ذلك. من المهم ملاحظة أنه حتى يتم تحميل جميع الأطفال داخل ``، سنستمر في إظهار الاحتياط. -`Suspense` takes two props: -* **fallback** takes a loading indicator. The fallback is shown until all of the children of the `Suspense` component have finished rendering. -* **unstable_avoidThisFallback** takes a boolean. It tells React whether to "skip" revealing this boundary during the initial load. This API will likely be removed in a future release. +`Suspense` يأخذ two props: +* **fallback** يأخذ مؤشر تحميل. يظهر العرض الاحتياطي حتى الانتهاء من تصيير كافة مكون `Suspense`. +* **unstable_avoidThisFallback** يأخذ قيم منطقية. يخبر React ما إذا كان "تخطي" الكشف عن هذه الحدود أثناء التحميل الأولي. من المحتمل أن تتم إزالة واجهة برمجة التطبيقات هذه في إصدار مستقبلي. ### `` {#suspenselist} From 1dbd408fbceb185012aaaef5307cdec6a6217d27 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Wed, 11 Mar 2020 16:34:27 +0200 Subject: [PATCH 05/30] Translate 'SuspenseList' --- content/docs/concurrent-mode-reference.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 1b53bca6b..7410d7d86 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -94,19 +94,19 @@ ReactDOM.createBlockingRoot(rootNode).render() ``` -`SuspenseList` helps coordinate many components that can suspend by orchestrating the order in which these components are revealed to the user. +`SuspenseList` يساعد في تنسيق العديد من المكونات التي يمكن تعليقها من خلال تنسيق الترتيب الذي يتم من خلاله الكشف عن هذه المكونات للمستخدم. -When multiple components need to fetch data, this data may arrive in an unpredictable order. However, if you wrap these items in a `SuspenseList`, React will not show an item in the list until previous items have been displayed (this behavior is adjustable). +عندما تحتاج مكونات متعددة إلى جلب البيانات، قد تصل هذه البيانات بترتيب غير متوقع. ومع ذلك، إذا قمت بلف هذه العناصر في `SuspenseList`، فلن تظهر React عنصرًا في القائمة حتى يتم عرض العناصر السابقة (هذا السلوك قابل للتعديل). -`SuspenseList` takes two props: -* **revealOrder (forwards, backwards, together)** defines the order in which the `SuspenseList` children should be revealed. - * `together` reveals *all* of them when they're ready instead of one by one. -* **tail (collapsed, hidden)** dictates how unloaded items in a `SuspenseList` is shown. - * By default, `SuspenseList` will show all fallbacks in the list. - * `collapsed` shows only the next fallback in the list. - * `hidden` doesn't show any unloaded items. +`SuspenseList` يأخذ two props: +* **revealOrder (forwards, backwards, together)** يحدد الترتيب الذي فيه `SuspenseList` يجب الكشف عن الأطفال. + * `together` تكشف *الكل* عندما يكونوا على استعداد بدلاً من واحدة تلو الأخرى. +* **tail (collapsed, hidden)** يملي كيف يتم عرض العناصر التي تم تحميلها فى `SuspenseList`. + * بشكل افتراضي, `SuspenseList` سيظهر جميع الاحتياطيات في القائمة. + * `collapsed` يظهر فقط الاحتياطية التالية في القائمة. + * `hidden` لا تظهر أي عناصر غير محمل. -Note that `SuspenseList` only operates on the closest `Suspense` and `SuspenseList` components below it. It does not search for boundaries deeper than one level. However, it is possible to nest multiple `SuspenseList` components in each other to build grids. +لاحظ أن `SuspenseList` تعمل فقط على أقرب مكونات `Suspense` و مكونات `SuspenseList` تحتها. لا يبحث عن حدود أعمق من مستوى واحد. ومع ذلك، فمن الممكن تداخل مكونات `SuspenseList` متعددة في بعضها البعض لبناء شبكات. ### `useTransition` {#usetransition} From f74b7ee4236e6b1cc194fab44f9f3dff71e40ce0 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Wed, 11 Mar 2020 17:15:04 +0200 Subject: [PATCH 06/30] Translate 'useTransition' --- content/docs/concurrent-mode-reference.md | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 7410d7d86..4fbee7b61 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -116,13 +116,13 @@ const SUSPENSE_CONFIG = { timeoutMs: 2000 }; const [startTransition, isPending] = useTransition(SUSPENSE_CONFIG); ``` -`useTransition` allows components to avoid undesirable loading states by waiting for content to load before **transitioning to the next screen**. It also allows components to defer slower, data fetching updates until subsequent renders so that more crucial updates can be rendered immediately. +`useTransition` يسمح للمكونات بتجنب حالات التحميل غير المرغوب فيها من خلال انتظار تحميل المحتوى قبل **الانتقال إلى الشاشة التالية**. كما يسمح للمكونات بتأجيل التحديثات بشكل أبطأ، وجلب البيانات حتى يتم تقديمها لاحقًا بحيث يمكن تقديم تحديثات أكثر أهمية على الفور. -The `useTransition` hook returns two values in an array. -* `startTransition` is a function that takes a callback. We can use it to tell React which state we want to defer. -* `isPending` is a boolean. It's React's way of informing us whether we're waiting for the transition to finish. +يعرض الخطاف `useTransition` قيمتين في صفيف. +* `startTransition` is a function that takes a callback. يمكننا استخدامه لإخبار React بالحالة التي نريد تأجيلها. +* `isPending` is a boolean. إنها طريقة React لإعلامنا ما إذا كنا ننتظر انتهاء الانتقال. -**If some state update causes a component to suspend, that state update should be wrapped in a transition.** +**إذا تسبب تحديث الحالة في تعليق أحد المكونات، فيجب أن يتم تغليف تحديث الحالة هذا في مرحلة انتقالية.** ```js const SUSPENSE_CONFIG = { timeoutMs: 2000 }; @@ -152,11 +152,11 @@ function App() { } ``` -In this code, we've wrapped our data fetching with `startTransition`. This allows us to start fetching the profile data right away, while deferring the render of the next profile page and its associated `Spinner` for 2 seconds (the time shown in `timeoutMs`). +في هذه الشفرة، قمنا بلف جلب بياناتنا بـ `startTransition`. يتيح لنا ذلك البدء في جلب بيانات الملف الشخصي فورًا، مع تأجيل عرض صفحة الملف الشخصي التالية و `Spinner` المرتبط بها لمدة ثانيتين (الوقت الموضح في `timeoutMs` ). -The `isPending` boolean lets React know that our component is transitioning, so we are able to let the user know this by showing some loading text on the previous profile page. +تتيح القيمة المنطقية `isPending` لـ React معرفة أن المكون الخاص بنا يتحول، لذلك يمكننا إخبار المستخدم بذلك من خلال عرض بعض نص التحميل على صفحة الملف الشخصي السابقة. -**For an in-depth look at transitions, you can read [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html#transitions).** +**لإلقاء نظرة متعمقة على التحولات، يمكنك قراءة [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html#transitions).** #### useTransition Config {#usetransition-config} @@ -164,10 +164,9 @@ The `isPending` boolean lets React know that our component is transitioning, so const SUSPENSE_CONFIG = { timeoutMs: 2000 }; ``` -`useTransition` accepts an **optional Suspense Config** with a `timeoutMs`. This timeout (in milliseconds) tells React how long to wait before showing the next state (the new Profile Page in the above example). - -**Note: We recommend that you share Suspense Config between different modules.** +يقبل `useTransition` **Suspense Config اختياري** مع `timeoutMs`. هذه المهلة (بالمللي ثانية) تخبر React إلى متى الانتظار قبل عرض الحالة التالية (صفحة الملف الشخصي الجديدة في المثال أعلاه). +**ملاحظة: نوصيك بمشاركة Suspense Config بين الوحدات المختلفة.** ### `useDeferredValue` {#usedeferredvalue} From 97637c00937171ddcda39d07443724d5ae701cec Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Wed, 11 Mar 2020 17:26:18 +0200 Subject: [PATCH 07/30] Translate 'useDeferredValue' --- content/docs/concurrent-mode-reference.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 4fbee7b61..bf80ffb78 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -174,11 +174,11 @@ const SUSPENSE_CONFIG = { timeoutMs: 2000 }; const deferredValue = useDeferredValue(value, { timeoutMs: 2000 }); ``` -Returns a deferred version of the value that may "lag behind" it for at most `timeoutMs`. +لعرض نسخة مؤجلة من القيمة التي قد "تتخلف" عنها على الأكثر لـ `timeoutMs`. -This is commonly used to keep the interface responsive when you have something that renders immediately based on user input and something that needs to wait for a data fetch. +يُستخدم هذا بشكل شائع للحفاظ على استجابة الواجهة عندما يكون لديك شيء يتم تصييره فورًا بناءً على إدخال المستخدم وشيء يحتاج إلى انتظار جلب البيانات. -A good example of this is a text input. +مثال جيد على ذلك هو إدخال النص. ```js function App() { @@ -197,9 +197,9 @@ function App() { } ``` -This allows us to start showing the new text for the `input` immediately, which allows the webpage to feel responsive. Meanwhile, `MySlowList` "lags behind" for up to 2 seconds according to the `timeoutMs` before updating, allowing it to render with the current text in the background. +يتيح لنا ذلك البدء في عرض النص الجديد لـ `الإدخال` على الفور، مما يسمح لصفحة الويب بالشعور بالاستجابة. في هذه الأثناء، `MySlowList` "متخلفة" لمدة تصل إلى ثانيتين وفقًا لـ `timeoutMs` قبل التحديث، مما يتيح تصييرها مع النص الحالي في الخلفية. -**For an in-depth look at deferring values, you can read [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html#deferring-a-value).** +**لإلقاء نظرة متعمقة على تأجيل القيم، يمكنك قراءة [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html#deferring-a-value).** #### useDeferredValue Config {#usedeferredvalue-config} @@ -207,6 +207,6 @@ This allows us to start showing the new text for the `input` immediately, which const SUSPENSE_CONFIG = { timeoutMs: 2000 }; ``` -`useDeferredValue` accepts an **optional Suspense Config** with a `timeoutMs`. This timeout (in milliseconds) tells React how long the deferred value is allowed to lag behind. +يقبل `useDeferredValue` **Suspense Config اختياري** مع `timeoutMs`. هذه المهلة (بالمللي ثانية) تخبرنا React عن المدة التي يُسمح فيها بالقيمة المؤجلة بالتخلف. -React will always try to use a shorter lag when network and device allows it. +سيحاول React دائمًا استخدام تأخرًا أقصر عندما تسمح به الشبكة والجهاز. From 1b8f828f3855763802b2aa013f1ac6f656ebfc3b Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:13:00 +0200 Subject: [PATCH 08/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index bf80ffb78..740dad567 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -15,7 +15,7 @@ prev: concurrent-mode-adoption.html
>الحذر: ->تصف هذه الصفحة **الميزات التجريبية التي [غير متوفرة بعد](/docs/concurrent-mode-approach.html) في إصدار ثابت**. لا تعتمد على تصميمات React التجريبية في تطبيقات الإنتاج. قد تتغير هذه الميزات بشكل كبير ودون سابق إنذار قبل أن تصبح جزءًا من React. +>تصف هذه الصفحة **الميزات التجريبية التي [ليست متوفرة بعد](/docs/concurrent-mode-approach.html) في إصدار ثابت**. لا تعتمد على تصميمات React التجريبية في تطبيقات الإنتاج. قد تتغير هذه الميزات بشكل كبير ودون سابق إنذار قبل أن تصبح جزءًا من React. > >تستهدف هذه الوثائق إلى التبني المبكر والأشخاص الفضوليين. **إذا كنت جديدًا في React، فلا تقلق بشأن هذه الميزات** -- لست بحاجة إلى تعلمها الآن. From 5d08a250f343b998ebda0e95c30c93b8e271f107 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:13:15 +0200 Subject: [PATCH 09/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 740dad567..a4e739f6c 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -14,7 +14,7 @@ prev: concurrent-mode-adoption.html
->الحذر: +>تحذير: >تصف هذه الصفحة **الميزات التجريبية التي [ليست متوفرة بعد](/docs/concurrent-mode-approach.html) في إصدار ثابت**. لا تعتمد على تصميمات React التجريبية في تطبيقات الإنتاج. قد تتغير هذه الميزات بشكل كبير ودون سابق إنذار قبل أن تصبح جزءًا من React. > >تستهدف هذه الوثائق إلى التبني المبكر والأشخاص الفضوليين. **إذا كنت جديدًا في React، فلا تقلق بشأن هذه الميزات** -- لست بحاجة إلى تعلمها الآن. From 86c68407b7df9309b4d4ae9c6d6ccfa9e222601a Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:13:43 +0200 Subject: [PATCH 10/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index a4e739f6c..3c7f649de 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -17,7 +17,7 @@ prev: concurrent-mode-adoption.html >تحذير: >تصف هذه الصفحة **الميزات التجريبية التي [ليست متوفرة بعد](/docs/concurrent-mode-approach.html) في إصدار ثابت**. لا تعتمد على تصميمات React التجريبية في تطبيقات الإنتاج. قد تتغير هذه الميزات بشكل كبير ودون سابق إنذار قبل أن تصبح جزءًا من React. > ->تستهدف هذه الوثائق إلى التبني المبكر والأشخاص الفضوليين. **إذا كنت جديدًا في React، فلا تقلق بشأن هذه الميزات** -- لست بحاجة إلى تعلمها الآن. +>تستهدف هذه المستندات إلى المُتَبنّين المبكرين والأشخاص الفضوليين. **إذا كنت جديدًا في React، فلا تقلق بشأن هذه الميزات** -- لست بحاجة إلى تعلمها الآن.
From e5546045dc0f5bb0a53272c1d58299b171e540cb Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:14:17 +0200 Subject: [PATCH 11/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 3c7f649de..21f8ab6ba 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -42,7 +42,7 @@ prev: concurrent-mode-adoption.html ReactDOM.createRoot(rootNode).render(); ``` -استبدال `ReactDOM.render (, rootNode)` وتمكين الوضع المتزامن. +تستبدل `ReactDOM.render(, rootNode)` وتُمَكّن الوضع المتزامن. لمزيد من المعلومات حول الوضع المتزامن، راجع [وثائق الوضع المتزامن.](/docs/concurrent-mode-intro.html) From 3ef57e51b08c4713834d79010a0dc9516cd9e23f Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:14:44 +0200 Subject: [PATCH 12/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 21f8ab6ba..9e87a570f 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -44,7 +44,7 @@ ReactDOM.createRoot(rootNode).render(); تستبدل `ReactDOM.render(, rootNode)` وتُمَكّن الوضع المتزامن. -لمزيد من المعلومات حول الوضع المتزامن، راجع [وثائق الوضع المتزامن.](/docs/concurrent-mode-intro.html) +لمزيد من المعلومات حول الوضع المتزامن، راجع [مستندات الوضع المتزامن.](/docs/concurrent-mode-intro.html) ### `createBlockingRoot` {#createblockingroot} From 8e8edc3771aa30fe55bb83b500a7a7ace2847b2c Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:15:08 +0200 Subject: [PATCH 13/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 9e87a570f..aff69dbb5 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -54,7 +54,7 @@ ReactDOM.createBlockingRoot(rootNode).render() يستبدل `ReactDOM.render(, rootNode)` و تمكين [وضع الحظر](/docs/concurrent-mode-adoption.html#migration-step-blocking-mode). -يؤدي الاشتراك في الوضع المتزامن إلى إدخال تغييرات دلالية في كيفية عمل React. هذا يعني أنه لا يمكنك استخدام الوضع المتزامن في عدد قليل من المكونات. وبسبب هذا، قد لا تتمكن بعض التطبيقات من الترحيل مباشرة إلى الوضع المتزامن. +إختيار الوضع المتزامن إلى إدخال تغييرات دلالية في طريقة عمل React. هذا يعني أنه لا يمكنك استخدام الوضع المتزامن في جُزء من المكونات. وبسبب هذا، قد لا تتمكن بعض التطبيقات من الإنتقال مباشرة إلى استعمال الوضع المتزامن. يحتوي وضع الحظر فقط على مجموعة فرعية صغيرة من ميزات الوضع المتزامن ويقصد به كخطوة ترحيل وسيطة للتطبيقات التي لا تستطيع الترحيل مباشرة. From 838cee5e42e620cd54f4c1be9e2863163cd2f133 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:15:34 +0200 Subject: [PATCH 14/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index aff69dbb5..9491c47e9 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -52,7 +52,7 @@ ReactDOM.createRoot(rootNode).render(); ReactDOM.createBlockingRoot(rootNode).render() ``` -يستبدل `ReactDOM.render(, rootNode)` و تمكين [وضع الحظر](/docs/concurrent-mode-adoption.html#migration-step-blocking-mode). +يستبدل `ReactDOM.render(, rootNode)` و يُمَكّن [الوضع الإعتراضي](/docs/concurrent-mode-adoption.html#migration-step-blocking-mode). إختيار الوضع المتزامن إلى إدخال تغييرات دلالية في طريقة عمل React. هذا يعني أنه لا يمكنك استخدام الوضع المتزامن في جُزء من المكونات. وبسبب هذا، قد لا تتمكن بعض التطبيقات من الإنتقال مباشرة إلى استعمال الوضع المتزامن. From 97d5282240dff144df82e2f73a97da5d2834d2df Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:16:17 +0200 Subject: [PATCH 15/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 9491c47e9..d76e3ecfb 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -56,7 +56,7 @@ ReactDOM.createBlockingRoot(rootNode).render() إختيار الوضع المتزامن إلى إدخال تغييرات دلالية في طريقة عمل React. هذا يعني أنه لا يمكنك استخدام الوضع المتزامن في جُزء من المكونات. وبسبب هذا، قد لا تتمكن بعض التطبيقات من الإنتقال مباشرة إلى استعمال الوضع المتزامن. -يحتوي وضع الحظر فقط على مجموعة فرعية صغيرة من ميزات الوضع المتزامن ويقصد به كخطوة ترحيل وسيطة للتطبيقات التي لا تستطيع الترحيل مباشرة. +يحتوي الوضع الإعتراضي (blocking mode) فقط على مجموعة فرعية صغيرة من ميزات الوضع المتزامن ويقصد به كخطوة ترحيل وسيطة للتطبيقات التي لا تستطيع الترحيل مباشرة. ## Suspense API {#suspense} From 08aec01606f9c8c9b4927cf17ff13a7a3af9a31f Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:16:41 +0200 Subject: [PATCH 16/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index d76e3ecfb..8c6073aef 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -98,7 +98,7 @@ ReactDOM.createBlockingRoot(rootNode).render() عندما تحتاج مكونات متعددة إلى جلب البيانات، قد تصل هذه البيانات بترتيب غير متوقع. ومع ذلك، إذا قمت بلف هذه العناصر في `SuspenseList`، فلن تظهر React عنصرًا في القائمة حتى يتم عرض العناصر السابقة (هذا السلوك قابل للتعديل). -`SuspenseList` يأخذ two props: +`SuspenseList` يأخذ خاصيَتَيْن: * **revealOrder (forwards, backwards, together)** يحدد الترتيب الذي فيه `SuspenseList` يجب الكشف عن الأطفال. * `together` تكشف *الكل* عندما يكونوا على استعداد بدلاً من واحدة تلو الأخرى. * **tail (collapsed, hidden)** يملي كيف يتم عرض العناصر التي تم تحميلها فى `SuspenseList`. From cca68a432ee9d40479e25ca436adfeeeea99330c Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:16:59 +0200 Subject: [PATCH 17/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 8c6073aef..f95a36dd4 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -100,7 +100,7 @@ ReactDOM.createBlockingRoot(rootNode).render() `SuspenseList` يأخذ خاصيَتَيْن: * **revealOrder (forwards, backwards, together)** يحدد الترتيب الذي فيه `SuspenseList` يجب الكشف عن الأطفال. - * `together` تكشف *الكل* عندما يكونوا على استعداد بدلاً من واحدة تلو الأخرى. + * `together` تكشف *الكل* عندما يكونون على استعداد بدلاً من واحدة تِلوَ الأخرى. * **tail (collapsed, hidden)** يملي كيف يتم عرض العناصر التي تم تحميلها فى `SuspenseList`. * بشكل افتراضي, `SuspenseList` سيظهر جميع الاحتياطيات في القائمة. * `collapsed` يظهر فقط الاحتياطية التالية في القائمة. From 50e0183378da19b2b11cf7434eb741da9de94e84 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:17:14 +0200 Subject: [PATCH 18/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index f95a36dd4..13a612f39 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -119,7 +119,7 @@ const [startTransition, isPending] = useTransition(SUSPENSE_CONFIG); `useTransition` يسمح للمكونات بتجنب حالات التحميل غير المرغوب فيها من خلال انتظار تحميل المحتوى قبل **الانتقال إلى الشاشة التالية**. كما يسمح للمكونات بتأجيل التحديثات بشكل أبطأ، وجلب البيانات حتى يتم تقديمها لاحقًا بحيث يمكن تقديم تحديثات أكثر أهمية على الفور. يعرض الخطاف `useTransition` قيمتين في صفيف. -* `startTransition` is a function that takes a callback. يمكننا استخدامه لإخبار React بالحالة التي نريد تأجيلها. +* `startTransition` هي دالّة التي تأخذ callback. يمكننا استخدامه لإخبار React بالحالة التي نريد تأجيلها. * `isPending` is a boolean. إنها طريقة React لإعلامنا ما إذا كنا ننتظر انتهاء الانتقال. **إذا تسبب تحديث الحالة في تعليق أحد المكونات، فيجب أن يتم تغليف تحديث الحالة هذا في مرحلة انتقالية.** From e914ba1c519ddad0a5949f79a432060d3605c458 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:17:25 +0200 Subject: [PATCH 19/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 13a612f39..ab7a17482 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -154,7 +154,7 @@ function App() { في هذه الشفرة، قمنا بلف جلب بياناتنا بـ `startTransition`. يتيح لنا ذلك البدء في جلب بيانات الملف الشخصي فورًا، مع تأجيل عرض صفحة الملف الشخصي التالية و `Spinner` المرتبط بها لمدة ثانيتين (الوقت الموضح في `timeoutMs` ). -تتيح القيمة المنطقية `isPending` لـ React معرفة أن المكون الخاص بنا يتحول، لذلك يمكننا إخبار المستخدم بذلك من خلال عرض بعض نص التحميل على صفحة الملف الشخصي السابقة. +تتيح القيمة المنطقية `isPending` لـ React معرفة أن المكون الخاص بنا يتحول، لذلك يمكننا إخبار المستخدم بذلك من خلال عرض نص التحميل على صفحة الملف الشخصي السابقة. **لإلقاء نظرة متعمقة على التحولات، يمكنك قراءة [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html#transitions).** From 9cf76b7f1a584e1d19eba86cc92ea9389b15998e Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:17:37 +0200 Subject: [PATCH 20/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index ab7a17482..2d65af914 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -176,7 +176,7 @@ const deferredValue = useDeferredValue(value, { timeoutMs: 2000 }); لعرض نسخة مؤجلة من القيمة التي قد "تتخلف" عنها على الأكثر لـ `timeoutMs`. -يُستخدم هذا بشكل شائع للحفاظ على استجابة الواجهة عندما يكون لديك شيء يتم تصييره فورًا بناءً على إدخال المستخدم وشيء يحتاج إلى انتظار جلب البيانات. +يُستخدم هذا بشكل شائع للحفاظ على استجابة الواجهة عندما يكون لديك شيء يتم تصييره فورًا بناءً على مُدخلات المستخدم وشيء يحتاج إلى انتظار جلب البيانات. مثال جيد على ذلك هو إدخال النص. From b53de6b4d80a349f387c58632ac0101da5eeb376 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:17:49 +0200 Subject: [PATCH 21/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 2d65af914..6ad77aa58 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -209,4 +209,4 @@ const SUSPENSE_CONFIG = { timeoutMs: 2000 }; يقبل `useDeferredValue` **Suspense Config اختياري** مع `timeoutMs`. هذه المهلة (بالمللي ثانية) تخبرنا React عن المدة التي يُسمح فيها بالقيمة المؤجلة بالتخلف. -سيحاول React دائمًا استخدام تأخرًا أقصر عندما تسمح به الشبكة والجهاز. +سيحاول React دائمًا استخدام تأخرٍ أقصر عندما تسمح به الشبكة والجهاز. From 8bd75248f522e59affbaab487ab17fccc58b8200 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:18:04 +0200 Subject: [PATCH 22/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 6ad77aa58..ad5b23e97 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -120,7 +120,7 @@ const [startTransition, isPending] = useTransition(SUSPENSE_CONFIG); يعرض الخطاف `useTransition` قيمتين في صفيف. * `startTransition` هي دالّة التي تأخذ callback. يمكننا استخدامه لإخبار React بالحالة التي نريد تأجيلها. -* `isPending` is a boolean. إنها طريقة React لإعلامنا ما إذا كنا ننتظر انتهاء الانتقال. +* `isPending` هي boolean. إنها طريقة React لإعلامنا ما إذا كنا ننتظر انتهاء الانتقال. **إذا تسبب تحديث الحالة في تعليق أحد المكونات، فيجب أن يتم تغليف تحديث الحالة هذا في مرحلة انتقالية.** From 9c1ba7b9df0d11b2136d23f3e6816844d6cf29e3 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Sun, 19 Apr 2020 18:18:35 +0200 Subject: [PATCH 23/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Fortas Abdeldjalil --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index ad5b23e97..13260792d 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -118,7 +118,7 @@ const [startTransition, isPending] = useTransition(SUSPENSE_CONFIG); `useTransition` يسمح للمكونات بتجنب حالات التحميل غير المرغوب فيها من خلال انتظار تحميل المحتوى قبل **الانتقال إلى الشاشة التالية**. كما يسمح للمكونات بتأجيل التحديثات بشكل أبطأ، وجلب البيانات حتى يتم تقديمها لاحقًا بحيث يمكن تقديم تحديثات أكثر أهمية على الفور. -يعرض الخطاف `useTransition` قيمتين في صفيف. +يُعيد الخطاف `useTransition` قيمتين في مصفوفة. * `startTransition` هي دالّة التي تأخذ callback. يمكننا استخدامه لإخبار React بالحالة التي نريد تأجيلها. * `isPending` هي boolean. إنها طريقة React لإعلامنا ما إذا كنا ننتظر انتهاء الانتقال. From 45c5214f23db4a4689005c8bf663f357b96c342f Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Mon, 20 Apr 2020 03:23:16 +0200 Subject: [PATCH 24/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Aissaoui Ahmed --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 13260792d..a5b281ee0 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -152,7 +152,7 @@ function App() { } ``` -في هذه الشفرة، قمنا بلف جلب بياناتنا بـ `startTransition`. يتيح لنا ذلك البدء في جلب بيانات الملف الشخصي فورًا، مع تأجيل عرض صفحة الملف الشخصي التالية و `Spinner` المرتبط بها لمدة ثانيتين (الوقت الموضح في `timeoutMs` ). +في هذه الشفرة، قمنا بلف جلب بياناتنا بـ `startTransition`. يتيح لنا ذلك البدء في جلب بيانات الملف الشخصي فورًا، مع تأجيل عرض صفحة الملف الشخصي التالية و `Spinner` المرتبط بها لمدة ثانيتين (الوقت الموضح في `timeoutMs`). تتيح القيمة المنطقية `isPending` لـ React معرفة أن المكون الخاص بنا يتحول، لذلك يمكننا إخبار المستخدم بذلك من خلال عرض نص التحميل على صفحة الملف الشخصي السابقة. From 98d9bcc5550aca2a5ec52054449677813c81658d Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Mon, 20 Apr 2020 03:23:28 +0200 Subject: [PATCH 25/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Aissaoui Ahmed --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index a5b281ee0..93f7b06bc 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -156,7 +156,7 @@ function App() { تتيح القيمة المنطقية `isPending` لـ React معرفة أن المكون الخاص بنا يتحول، لذلك يمكننا إخبار المستخدم بذلك من خلال عرض نص التحميل على صفحة الملف الشخصي السابقة. -**لإلقاء نظرة متعمقة على التحولات، يمكنك قراءة [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html#transitions).** +**لإلقاء نظرة متعمقة على التحولات، يمكنك قراءة [أنماط و أساليب واجهة المستخدم](/docs/concurrent-mode-patterns.html#transitions).** #### useTransition Config {#usetransition-config} From 3f7badfecc4e186c849361c5a088ee7c028012b7 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Mon, 20 Apr 2020 03:23:39 +0200 Subject: [PATCH 26/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Aissaoui Ahmed --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 93f7b06bc..31028d1d9 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -164,7 +164,7 @@ function App() { const SUSPENSE_CONFIG = { timeoutMs: 2000 }; ``` -يقبل `useTransition` **Suspense Config اختياري** مع `timeoutMs`. هذه المهلة (بالمللي ثانية) تخبر React إلى متى الانتظار قبل عرض الحالة التالية (صفحة الملف الشخصي الجديدة في المثال أعلاه). +يقبل `useTransition` **Suspense Config اختياري** مع `timeoutMs`. هذه المهلة (بالمللي ثانية) تخبر React إلى متى الانتظار قبل عرض الحالة التالية (صفحة الملف الشخصي الجديدة في المثال أعلاه). **ملاحظة: نوصيك بمشاركة Suspense Config بين الوحدات المختلفة.** From ee3250e960cd8aa837ce1b47fed831db344dd7ca Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Mon, 20 Apr 2020 03:23:53 +0200 Subject: [PATCH 27/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Aissaoui Ahmed --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 31028d1d9..a07e97cd9 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -197,7 +197,7 @@ function App() { } ``` -يتيح لنا ذلك البدء في عرض النص الجديد لـ `الإدخال` على الفور، مما يسمح لصفحة الويب بالشعور بالاستجابة. في هذه الأثناء، `MySlowList` "متخلفة" لمدة تصل إلى ثانيتين وفقًا لـ `timeoutMs` قبل التحديث، مما يتيح تصييرها مع النص الحالي في الخلفية. +يتيح لنا ذلك البدء في عرض النص الجديد لـ `الإدخال` على الفور، مما يسمح لصفحة الويب بالشعور بالاستجابة. في هذه الأثناء، `MySlowList` "متخلفة" لمدة تصل إلى ثانيتين وفقًا لـ `timeoutMs` قبل التحديث، مما يتيح تصييرها مع النص الحالي في الخلفية. **لإلقاء نظرة متعمقة على تأجيل القيم، يمكنك قراءة [Concurrent UI Patterns](/docs/concurrent-mode-patterns.html#deferring-a-value).** From bda4938d53992b26b639a0ab20ac95102266b523 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Mon, 20 Apr 2020 03:24:02 +0200 Subject: [PATCH 28/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Aissaoui Ahmed --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index a07e97cd9..a2edfb375 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -207,6 +207,6 @@ function App() { const SUSPENSE_CONFIG = { timeoutMs: 2000 }; ``` -يقبل `useDeferredValue` **Suspense Config اختياري** مع `timeoutMs`. هذه المهلة (بالمللي ثانية) تخبرنا React عن المدة التي يُسمح فيها بالقيمة المؤجلة بالتخلف. +يقبل `useDeferredValue` **Suspense Config اختياري** مع `timeoutMs`. هذه المهلة (بالمللي ثانية) تخبرنا React عن المدة التي يُسمح فيها بالقيمة المؤجلة بالتخلف. سيحاول React دائمًا استخدام تأخرٍ أقصر عندما تسمح به الشبكة والجهاز. From 461adf0dc80fc6e6e83ce3852403c4c20fa21df3 Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Mon, 20 Apr 2020 03:24:13 +0200 Subject: [PATCH 29/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Aissaoui Ahmed --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index a2edfb375..22e0bd61b 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -73,7 +73,7 @@ ReactDOM.createBlockingRoot(rootNode).render() في هذا المثال، ينتظر `ProfileDetails` اتصال API غير متزامن لجلب بعض البيانات. أثناء انتظار ` ProfileDetails` و `ProfilePhoto`، سنعرض الخيار `جاري التحميل ...` بدلاً من ذلك. من المهم ملاحظة أنه حتى يتم تحميل جميع الأطفال داخل ``، سنستمر في إظهار الاحتياط. -`Suspense` يأخذ two props: +`Suspense` يأخذ اثنين props: * **fallback** يأخذ مؤشر تحميل. يظهر العرض الاحتياطي حتى الانتهاء من تصيير كافة مكون `Suspense`. * **unstable_avoidThisFallback** يأخذ قيم منطقية. يخبر React ما إذا كان "تخطي" الكشف عن هذه الحدود أثناء التحميل الأولي. من المحتمل أن تتم إزالة واجهة برمجة التطبيقات هذه في إصدار مستقبلي. From bcbce3a0098e333cbdaad43baceda292e56d7ffb Mon Sep 17 00:00:00 2001 From: Mohamed Abdel Nasser Date: Mon, 20 Apr 2020 03:24:22 +0200 Subject: [PATCH 30/30] Update content/docs/concurrent-mode-reference.md Co-Authored-By: Aissaoui Ahmed --- content/docs/concurrent-mode-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/concurrent-mode-reference.md b/content/docs/concurrent-mode-reference.md index 22e0bd61b..c5cfd3c1e 100644 --- a/content/docs/concurrent-mode-reference.md +++ b/content/docs/concurrent-mode-reference.md @@ -98,7 +98,7 @@ ReactDOM.createBlockingRoot(rootNode).render() عندما تحتاج مكونات متعددة إلى جلب البيانات، قد تصل هذه البيانات بترتيب غير متوقع. ومع ذلك، إذا قمت بلف هذه العناصر في `SuspenseList`، فلن تظهر React عنصرًا في القائمة حتى يتم عرض العناصر السابقة (هذا السلوك قابل للتعديل). -`SuspenseList` يأخذ خاصيَتَيْن: +`SuspenseList` يأخذ اثنين props: * **revealOrder (forwards, backwards, together)** يحدد الترتيب الذي فيه `SuspenseList` يجب الكشف عن الأطفال. * `together` تكشف *الكل* عندما يكونون على استعداد بدلاً من واحدة تِلوَ الأخرى. * **tail (collapsed, hidden)** يملي كيف يتم عرض العناصر التي تم تحميلها فى `SuspenseList`.