الفرق بين المراجعتين ل"React/state and lifecycle"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(تحديث)
 
(12 مراجعة متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:حالة ودورة حياة المكونات}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:حالة ودورة حياة المكونات في React}}</noinclude>
 
سنتحدّث في هذا القسم حول مفهوم حالة ودورة حياة المُكوِّنات في React، بإمكانك أن تجد من هنا [[React/react component|مرجعًا مُفصّلًا حول واجهة برمجة التطبيق (API) للمُكوِّنات]].
 
سنتحدّث في هذا القسم حول مفهوم حالة ودورة حياة المُكوِّنات في React، بإمكانك أن تجد من هنا [[React/react component|مرجعًا مُفصّلًا حول واجهة برمجة التطبيق (API) للمُكوِّنات]].
  
سطر 81: سطر 81:
 
== إضافة الحالة المحلية للصنف ==
 
== إضافة الحالة المحلية للصنف ==
 
سننقل التاريخ <code>date</code> من الخاصيّات <code>props</code> إلى الحالة في ثلاث خطوات:
 
سننقل التاريخ <code>date</code> من الخاصيّات <code>props</code> إلى الحالة في ثلاث خطوات:
# تبديل <code>this.props.date</code> بـ <code>this.state.date</code> في التّابع <code>render()‎</code>:
+
 
 +
'''أولًا:''' تبديل <code>this.props.date</code> بـ <code>this.state.date</code> في التّابع <code>render()‎</code>:<syntaxhighlight lang="javascript">
 
class Clock extends React.Component {
 
class Clock extends React.Component {
 +
  render() {
 +
    return (
 +
      <div>
 +
        <h1>أهلًا بالعالم!</h1>
 +
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
 +
      </div>
 +
    );
 +
  }
 +
}
 +
</syntaxhighlight>
  
 render() {
+
'''ثانيًا:''' إضافة [[JavaScript/class|دالة بانية للصنف (constructor)]] والتي تُعيِّن القيمة المبدئية <code>this.state</code>:
  
   return (
+
<syntaxhighlight lang="javascript">
 +
class Clock extends React.Component {
 +
  constructor(props) {
 +
    super(props);
 +
    this.state = {date: new Date()};
 +
  }
  
     <nowiki><div></nowiki>
+
  render() {
 +
    return (
 +
      <div>
 +
        <h1>أهلًا بالعالم!</h1>
 +
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
 +
      </div>
 +
    );
 +
  }
 +
}
  
       <nowiki><h1>أهلًا بالعالم!</h1></nowiki>
+
</syntaxhighlight>لاحظ كيف مرّرنا الخاصيّات <code>props</code> إلى الدالة البانية:<syntaxhighlight lang="javascript">
 +
constructor(props) {
 +
    super(props);
 +
    this.state = {date: new Date()};
 +
  }
  
       <nowiki><h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2></nowiki>
+
</syntaxhighlight>ينبغي لمُكوِّنات الأصناف أن تستدعي دومًا الدالة البانية مع الخاصيّات <code>props</code>.
  
     <nowiki></div></nowiki>
 
  
   );
+
'''ثالثًا:''' إزالة الخاصيّة <code>date</code> من العنصر ‎<code><Clock />‎</code>:<syntaxhighlight lang="javascript">
 +
ReactDOM.render(
 +
  <Clock />,
 +
  document.getElementById('root')
 +
);
  
 }
+
</syntaxhighlight>سنعيد لاحقًا إضافة شيفرة عداد الوقت إلى المُكوِّن نفسه.
  
}
+
تبدو النتيجة كما يلي:<syntaxhighlight lang="javascript">
# إضافة [[JavaScript/class|دالة بانية للصنف (constructor)]] والتي تُعيِّن القيمة المبدئية this.state:
 
 
class Clock extends React.Component {
 
class Clock extends React.Component {
 +
  constructor(props) {
 +
    super(props);
 +
    this.state = {date: new Date()};
 +
  }
  
 constructor(props) {
+
  render() {
 +
    return (
 +
      <div>
 +
        <h1>أهلًا بالعالم!</h1>
 +
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
 +
      </div>
 +
    );
 +
  }
 +
}
  
   super(props);
+
ReactDOM.render(
 +
  <Clock />,
 +
  document.getElementById('root')
 +
);
  
   this.state = {date: new Date()};
+
</syntaxhighlight>[http://codepen.io/gaearon/pen/KgQpJd?editors=0010 جرِّب المثال على موقع CodePen].
  
 }
+
سنجعل الآن المُكوِّن <code>Clock</code> يُعيِّن عدّاد الوقت الخاص به ويُحدِّث نفسه في كل ثانية.
  
 render() {
+
== إضافة توابع دورة الحياة إلى الصنف ==
 +
من المهم في التطبيقات التي تمتلك العديد من المُكوِّنات أن نُحرِّر الموارد المحجوزة من قبل هذه المُكوِّنات عند تدميرها.
  
   return (
+
نريد [[JavaScript/setInterval|تعيين عدّاد الوقت]] حالما يُصيَّر المُكوِّن <code>Clock</code> إلى DOM لأوّل مرّة، يُسمَّى هذا في React بالوصل (mounting). ونرغب أيضًا [[JavaScript/clearInterval|بمسح هذا العدّاد]] حالما يُزال DOM الناتج عن المُكوِّن <code>Clock</code>، يُسمَّى هذا في React بالفصل (unmounting).
  
     <nowiki><div></nowiki>
+
بإمكاننا التصريح عن توابع خاصّة في مُكوِّنات الأصناف لتنفيذ بعض الشيفرات عند وصل وفصل المُكوِّن:<syntaxhighlight lang="javascript">
 +
class Clock extends React.Component {
 +
  constructor(props) {
 +
    super(props);
 +
    this.state = {date: new Date()};
 +
  }
  
       <nowiki><h1>أهلًا بالعالم!</h1></nowiki>
+
  componentDidMount() {
  
       <nowiki><h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2></nowiki>
+
  }
  
     <nowiki></div></nowiki>
+
  componentWillUnmount() {
  
   );
+
  }
  
 }
+
  render() {
 +
    return (
 +
      <div>
 +
        <h1>أهلًا بالعالم!</h1>
 +
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
 +
      </div>
 +
    );
 +
  }
 +
}
 +
 
 +
</syntaxhighlight>تُدعى هذه التوابع بخُطافات دورة الحياة (lifecycle hooks).
 +
 
 +
يعمل الخُطاف <code>componentDidMount()‎</code> بعد تصيير ناتج المُكوِّن إلى DOM، لذلك هو مكان مُلائم لتعيين عداد الوقت:<syntaxhighlight lang="javascript">
 +
componentDidMount() {
 +
    this.timerID = setInterval(
 +
      () => this.tick(),
 +
      1000
 +
    );
 +
  }
 +
 
 +
</syntaxhighlight>لاحظ كيف حفظنا مُعرِّف عدّاد الوقت (timer ID) من خلال <code>this</code>.
  
}
+
لمّا كانت <code>this.props</code> يجري إعدادها عن طريق React نفسها و <code>this.state</code> تمتلك معنًى خاصًّا، فأنت حر بأن تضيف حقول إضافيّة يدويًّا إلى الصّنف إن احتجت تخزين شيء ما لا يُشارِك في تدفّق البيانات (مثل مُعرِّف عداد الوقت).
 +
 
 +
سننهي عدّاد الوقت في خُطاف دورة الحياة <code>componentWillUnmount()</code>‎:<syntaxhighlight lang="javascript">
 +
componentWillUnmount() {
 +
    clearInterval(this.timerID);
 +
  }
  
لاحظ كيف مرّرنا الخاصيّات props إلى الدالة البانية:
+
</syntaxhighlight>وأخيرًا سنضيف تابعًا يُدعى <code>tick()</code>‎ يُنفِّذه المُكوِّن <code>Clock</code> في كل ثانية. سيستخدم <code>this.setState()‎</code> لجدولة التحديثات إلى الحالة المحليّة للمُكوِّن:<syntaxhighlight lang="javascript">
 +
class Clock extends React.Component {
 +
  constructor(props) {
 +
    super(props);
 +
    this.state = {date: new Date()};
 +
  }
  
constructor(props) {
+
  componentDidMount() {
 +
    this.timerID = setInterval(
 +
      () => this.tick(),
 +
      1000
 +
    );
 +
  }
  
   super(props);
+
  componentWillUnmount() {
 +
    clearInterval(this.timerID);
 +
  }
  
   this.state = {date: new Date()};
+
  tick() {
 +
    this.setState({
 +
      date: new Date()
 +
    });
 +
  }
  
 }
+
  render() {
 +
    return (
 +
      <div>
 +
        <h1>أهلًا بالعالم</h1>
 +
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
 +
      </div>
 +
    );
 +
  }
 +
}
  
ينبغي لمُكوِّنات الأصناف أن تستدعي دومًا الدالة البانية مع الخاصيّات props.
 
# إزالة الخاصيّة date من العنصر ‎<Clock />‎:
 
 
ReactDOM.render(
 
ReactDOM.render(
 +
  <Clock />,
 +
  document.getElementById('root')
 +
);
  
 <Clock />,
+
</syntaxhighlight>[http://codepen.io/gaearon/pen/amqdNA?editors=0010 جرِّب المثال على موقع CodePen].
  
 document.getElementById('root')
+
تدق السّاعة الآن في كل ثانية.
  
);
+
فلنوجز بسرعة ما يجري ونذكر الترتيب الذي تُستدعى فيه التوابع:
 +
# عندما يُمرَّر العنصر ‎<code><Clock /></code>‎ إلى <code>ReactDOM.render()‎</code> تستدعي React الدالة البانية للمُكوِّن <code>Clock</code>. وبما أنّ <code>Clock</code> يحتاج لإظهار الوقت الحالي سيُهيِّئ <code>this.state</code> بكائن يتضمّن الوقت الحالي، ولاحقًا يُحدِّث هذه الحالة.
 +
# تستدعي بعدها React التّابع <code>render()</code>‎ للمُكوِّن <code>Clock</code>، وهكذا تعلم React ما الذي ينبغي عرضه على الشاشة. تُحدِّث React بعد ذلك DOM ليُطابِق ناتج <code>Clock</code>.
 +
# عندما يُدخَل ناتج <code>Clock</code> إلى DOM، تستدعي React خُطاف دورة الحياة <code>componentDidMount()‎</code>، وبداخله يسأل المُكوِّن <code>Clock</code> المتصفّح أن يُعيِّن عدّاد الوقت لاستدعاء التابع <code>tick()‎</code> الخاص بالمُكوِّن مرّة كل ثانية.
 +
# يستدعي المتصفّح في كل ثانية التّابع <code>tick()‎</code>، وبداخل يُجدوِل المُكوِّن <code>Clock</code> تحديثًا لواجهة المستخدم عن طريق استدعاء <code>setState()‎</code> مع كائن يحوي على الوقت الحالي. وبفضل استدعاء <code>setState()‎</code> تعلم React أنّ الحالة تغيّرت وبذلك تستدعي التّابع <code>render()‎</code> مرّة أخرى ليعلم ما الذي ينبغي أن يكون على الشاشة، ستكون <code>this.state.date</code> في التابع <code>render()‎</code> مختلفة هذه المرّة، وبهذا يتضمّن الناتج الوقت المُحدَّث. تُحدِّث React وفق ذلك DOM.
 +
# إن أُزيل المُكوِّن <code>Clock</code> من DOM تستدعي React خُطاف دورة الحياة <code>componentWillUnmount()‎</code> بحيث يتوقّف عدّاد الوقت.
  
سنعيد لاحقًا إضافة شيفرة عداد الوقت إلى المُكوِّن نفسه.
+
== استخدام الحالة بشكل صحيح ==
 +
هنالك ثلاثة أشياء ينبغي أن تعلمها حول <code>setState()</code>‎.
  
تبدو النتيجة كما يلي:
+
=== لا تعدل الحالة بشكل مباشر ===
 +
على سبيل المثال لن يُعيد المثال التالي تصيير المُكوِّن:<syntaxhighlight lang="javascript">
 +
// طريقة خاطئة
 +
this.state.comment = 'أهلًا';
 +
</syntaxhighlight>استخدم <code>setState()</code>‎ بدلًا من ذلك:<syntaxhighlight lang="javascript">
 +
// الطريقة الصحيحة
 +
this.setState({comment: 'أهلًا'});
  
class Clock extends React.Component {
+
</syntaxhighlight>المكان الوحيد الذي يُمكنك فيه تعيين <code>this.state</code> هو الدالة البانية.
  
 constructor(props) {
+
=== قد تكون تحديثات الحالة غير متزامنة ===
 +
قد تجمع React نداءات عديدة للتّابع <code>setState()</code>‎ في تحديث واحد من أجل تحسين الأداء.
  
   super(props);
+
بما أنّ <code>this.props</code> و <code>this.state</code>  قد تُحدَّث بشكل غير متزامن، فيجب ألّا تعتمد على قيمها لحساب الحالة التالية.
  
   this.state = {date: new Date()};
+
على سبيل المثال قد تفشل الشيفرة التالية بتحديث عدّاد الوقت:<syntaxhighlight lang="javascript">
 +
// طريقة خاطئة
 +
this.setState({
 +
  counter: this.state.counter + this.props.increment,
 +
});
  
 }
+
</syntaxhighlight>لإصلاح ذلك استخدم شكل آخر من <code>setState()</code>‎ يقبل دالة بدلًا من كائن، حيث تستقبل هذه الدالة الحالة السّابقة كوسيط أول لها، والخاصيّات <code>props</code> في وقت تطبيق التحديث كوسيطٍ ثانٍ لها:<syntaxhighlight lang="javascript">
 +
// الطريقة الصحيحة
 +
this.setState((prevState, props) => ({
 +
  counter: prevState.counter + props.increment
 +
}));
  
 render() {
+
</syntaxhighlight>استخدمنا [[JavaScript/Arrow Functions|الدوال السهمية]] في المثال السّابق، ولكنّها تعمل أيضًا مع الدوال الاعتياديّة:<syntaxhighlight lang="javascript">
 +
// الطريقة الصحيحة
 +
this.setState(function(prevState, props) {
 +
  return {
 +
    counter: prevState.counter + props.increment
 +
  };
 +
});
  
   return (
+
</syntaxhighlight>
  
     <nowiki><div></nowiki>
+
=== تدمج React تحديثات الحالة ===
 +
عندما تستدعي <code>setState()</code>‎، تدمج React الكائن الذي تُزوِّدها به مع الحالة الحاليّة.
  
       <nowiki><h1>أهلًا بالعالم!</h1></nowiki>
+
على سبيل المثال قد تحتوي حالتك على متغيّرات مستقلّة عديدة:<syntaxhighlight lang="javascript">
 +
constructor(props) {
 +
    super(props);
 +
    this.state = {
 +
      posts: [],
 +
      comments: []
 +
    };
 +
  }
  
       <nowiki><h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2></nowiki>
+
</syntaxhighlight>يُمكنِك بعد ذلك تحديثها بشكل مستقل باستدعاءات منفصلة للتابع <code>setState()</code>‎:<syntaxhighlight lang="javascript">
 +
componentDidMount() {
 +
    fetchPosts().then(response => {
 +
      this.setState({
 +
        posts: response.posts
 +
      });
 +
    });
  
     <nowiki></div></nowiki>
+
    fetchComments().then(response => {
 +
      this.setState({
 +
        comments: response.comments
 +
      });
 +
    });
 +
  }
  
   );
+
</syntaxhighlight>يكون هذا الدمج ضئيلًا، لذلك لا يُؤثِّر تحديث حالة التعليقات <code>this.setState({comments})</code>‎ على حالة المنشورات أي <code>this.state.posts</code>، ولكنّه يستبدل حالة التعليقات <code>this.state.comments</code> بشكل كامل.
  
 }
+
== تتدفق البيانات للمستويات الأدنى ==
 +
لا تعلم المُكوِّنات الآباء ولا حتى الأبناء إن كان مُكوِّن مُحدَّد لديه حالة أو بدون حالة، ولا يجب أن تُبالي إن كان مُعرَّفًا كدالة أو كصنف.
  
 +
هذا هو السبّب وراء تسمية الحالة بالمحليّة أو المُغلَّفة، فهي غير قابلة للوصول من قبل أي مُكوِّن آخر غير المُكوِّن الذي يملكها ويُعيّنها.
 +
 +
قد يختار المُكوِّن تمرير حالته كخاصيّات <code>props</code> إلى عناصره الأبناء في المستوى الأدنى:<syntaxhighlight lang="javascript">
 +
<h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
 +
</syntaxhighlight>يعمل هذا المثال مع المُكوِّنات المُعرَّفة من قبل المستخدم أيضًا:<syntaxhighlight lang="javascript">
 +
<FormattedDate date={this.state.date} />
 +
</syntaxhighlight>يستقبل المُكوِّن <code>FormattedDate</code> التاريخ <code>date</code> في خاصيّاته ولن يعلم ما إذا كان هذا التاريخ قد أتى عن طريق حالة المُكوِّن <code>Clock</code>، أو من خاصيّات <code>Clock</code>، أو كُتِب بشكل يدوي:<syntaxhighlight lang="javascript">
 +
function FormattedDate(props) {
 +
  return <h2>الساعة الآن {props.date.toLocaleTimeString()}.</h2>;
 
}
 
}
 +
</syntaxhighlight>[http://codepen.io/gaearon/pen/zKRqNB?editors=0010 جرِّب المثال على موقع CodePen].
  
ReactDOM.render(
+
يُدعى هذا عادةً بتدفق البيانات من المستوى الأعلى للأدنى (top-down) أو أحادي الاتجاه (unidirectional). حيث أي حالة يمتلكها مُكوِّن مُحدَّد، وأي بيانات أو واجهة مستخدم مُشتقَّة من تلك الحالة بإمكانها فقط التأثير على المُكوِّنات التي تحتها في شجرة المُكوِّنات.
  
 <Clock />,
+
إن تخيّلت شجرة المُكوِّنات كشلّال من الخاصيّات، فكل حالة مُكوِّن تُشبِه مصدر إضافي للماء ينضم إليها في نقطة عشوائيّة ويتدفق معها للأسفل.
  
 document.getElementById('root')
+
ولنبرهن أنّ جميع المُكوِّنات معزولة حقًا، فبإمكاننا إنشاء المُكوِّن <code>App</code> الذي يُظهِر شجرة من مُكوِّنات <code>‎<Clock></code>‎:<syntaxhighlight lang="javascript">
 +
function App() {
 +
  return (
 +
    <div>
 +
      <Clock />
 +
      <Clock />
 +
      <Clock />
 +
    </div>
 +
  );
 +
}
  
 +
ReactDOM.render(
 +
  <App />,
 +
  document.getElementById('root')
 
);
 
);
  
جرِّب المثال على موقع CodePen.
+
</syntaxhighlight>[http://codepen.io/gaearon/pen/vXdGmd?editors=0010 جرِّب المثال على موقع CodePen].
 +
 
 +
يُعيِّن كل مُكوِّن <code>Clock</code> عدّاده الخاص به ويُحدِّثه بشكل منفصل.
 +
 
 +
في تطبيقات React عند استخدام مُكوِّن بداخل مُكوِّن آخ، فيُعتبَر المُكوِّن تفصيلًا تنفيذيًّا للمُكوِّن الآخر سواءً كان المُكوِّن يحتوي على حالة (stateful) أو بدون حالة (stateless) ويُمكِن أن يتغيّر عبر الوقت، بإمكانك استخدام المُكوِّنات بدون الحالة بداخل المُكوِّنات ذات الحالة وبالعكس أيضًا.
 +
== انظر أيضًا ==
 +
* [[React/hello world|مثال أهلًا بالعالم في React]]
 +
* [[React/introducing jsx|مقدمة إلى JSX]]
 +
* [[React/rendering elements|تصيير العناصر]]
 +
* [[React/components and props|المكونات والخاصيات]]
 +
* [[React/handling events|معالجة الأحداث في React]]
 +
* [[React/conditional rendering|التصيير الشرطي]]
 +
* [[React/lists and keys|القوائم والمفاتيح]]
 +
* [[React/forms|الحقول]]
 +
* [[React/lifting state up|رفع الحالات المشتركة للمستوى الأعلى]]
 +
* [[React/composition vs inheritance|الفرق بين التركيب والوراثة في React]]
 +
* [[React/thinking in react|أسلوب التفكير في React]]
  
سنجعل الآن المُكوِّن Clock يُعيِّن عدّاد الوقت الخاص به ويُحدِّث نفسه في كل ثانية.
+
== مصادر ==
 +
* [https://reactjs.org/docs/state-and-lifecycle.html صفحة حالة ودورة حياة المكونات في توثيق React الرسمي].
 +
[[تصنيف:React]]
 +
[[تصنيف:React Main Concepts]]

المراجعة الحالية بتاريخ 12:25، 2 نوفمبر 2020

سنتحدّث في هذا القسم حول مفهوم حالة ودورة حياة المُكوِّنات في React، بإمكانك أن تجد من هنا مرجعًا مُفصّلًا حول واجهة برمجة التطبيق (API) للمُكوِّنات.

فلنتذكر مثال الساعة من قسم تصيير العناصر في React، تعلّمنا في ذلك القسم فقط طريقة واحدة لتحديث واجهة المستخدم عن طريق استدعاء التابع ReactDOM.render()‎ لتغيير الناتج:

function tick() {
  const element = (
    <div>
      <h1>أهلًا بالعالم!</h1>
      <h2>الساعة الآن {new Date().toLocaleTimeString()}.</h2>
    </div>
  );
  ReactDOM.render(
    element,
    document.getElementById('root')
  );
}

setInterval(tick, 1000);

جرِّب المثال على موقع CodePen.

سنتعلّم في هذا القسم كيف نجعل مُكوِّن الساعة Clock قابلًا لإعادة الاستخدام حقًّا مع تغليفه ضمن نفسه، حيث يُعيِّن عدّاد الوقت الخاص به ويُحدِّث نفسه في كل ثانية.

بإمكاننا البدء عن طريق تغليف شكل السّاعة:

function Clock(props) {
  return (
    <div>
      <h1>أهلًا بالعالم!</h1>
      <h2>الساعة الآن {props.date.toLocaleTimeString()}.</h2>
    </div>
  );
}

function tick() {
  ReactDOM.render(
    <Clock date={new Date()} />,
    document.getElementById('root')
  );
}

setInterval(tick, 1000);

جرِّب المثال على موقع CodePen.

ولكن على الرغم من ذلك يفتقد هذا المُكوِّن لمتطلب أساسي، وهو أنّ تعيين السّاعة لعدّاد الوقت وتحديثها لواجهة المستخدم في كل ثانية ينبغي أن يكون تفصيلًا داخليًّا خاصًّا بالمُكوِّن Clock.

نريد بشكل مثالي أن نكتب هذه الشيفرة مرة واحدة ونجعل المُكوِّن Clock يُحدِّث نفسه:

ReactDOM.render(
  <Clock />,
  document.getElementById('root')
);

لتنفيذ هذا نحتاج لإضافة حالة (state) إلى المُكوِّن Clock.

تُشبِه الحالة الخاصيّات props، ولكنّها خاصّة (private) ويتحكَّم فيها المُكوِّن.

أشرنا سابقًا في قسم المُكوِّنات والخاصيّات إلى أنّ المُكوِّنات المُعرَّفة كأصناف تمتلك ميزات إضافيّة، الحالة المحليّة (Local State) واحدة من هذه الميّزات فهي تتوفر فقط للأصناف.

تحويل الدالة إلى صنف

بإمكانك تحويل مُكوِّنات الدوال مثل Clock إلى أصناف بخمس خطوات:

  1. إنشاء صنف بنفس الاسم والذي يمتد (extends) إلى React.Component.
  2. إضافة تابع فارغ وحيد لهذا الصنف اسمه render()‎.
  3. نقل جسم الدالة إلى التّابع render()‎.
  4. تبديل props إلى this.props في جسم التّابع render()‎.
  5. حذف باقي تصريح الدالة الفارغ.
class Clock extends React.Component {
  render() {
    return (
      <div>
        <h1>أهلًا بالعالم!</h1>
        <h2>الساعة الآن {this.props.date.toLocaleTimeString()}.</h2>
      </div>
    );
  }
}

جرِّب المثال على موقع CodePen.

أصبح المُكوِّن Clock الآن مُعرَّفًا كصنف بدلًا من دالة.

سيُستدعى التّابع render()‎ في كل مرّة يحصل فيها تحديث، ولكن طالما أنّنا نُصيِّر (Render) العنصر ‎<Clock />‎ إلى نفس عقدة DOM، فستُستخدَم نسخة واحدة فقط من الصنف Clock، يسمح لنا هذا باستخدام ميزات إضافية مثل الحالة المحليّة ودورة حياة المُكوِّنات.

إضافة الحالة المحلية للصنف

سننقل التاريخ date من الخاصيّات props إلى الحالة في ثلاث خطوات:

أولًا: تبديل this.props.date بـ this.state.date في التّابع render()‎:

class Clock extends React.Component {
  render() {
    return (
      <div>
        <h1>أهلًا بالعالم!</h1>
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
      </div>
    );
  }
}

ثانيًا: إضافة دالة بانية للصنف (constructor) والتي تُعيِّن القيمة المبدئية this.state:

class Clock extends React.Component {
  constructor(props) {
    super(props);
    this.state = {date: new Date()};
  }

  render() {
    return (
      <div>
        <h1>أهلًا بالعالم!</h1>
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
      </div>
    );
  }
}

لاحظ كيف مرّرنا الخاصيّات props إلى الدالة البانية:

constructor(props) {
    super(props);
    this.state = {date: new Date()};
  }

ينبغي لمُكوِّنات الأصناف أن تستدعي دومًا الدالة البانية مع الخاصيّات props.


ثالثًا: إزالة الخاصيّة date من العنصر ‎<Clock />‎:

ReactDOM.render(
  <Clock />,
  document.getElementById('root')
);

سنعيد لاحقًا إضافة شيفرة عداد الوقت إلى المُكوِّن نفسه. تبدو النتيجة كما يلي:

class Clock extends React.Component {
  constructor(props) {
    super(props);
    this.state = {date: new Date()};
  }

  render() {
    return (
      <div>
        <h1>أهلًا بالعالم!</h1>
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
      </div>
    );
  }
}

ReactDOM.render(
  <Clock />,
  document.getElementById('root')
);

جرِّب المثال على موقع CodePen.

سنجعل الآن المُكوِّن Clock يُعيِّن عدّاد الوقت الخاص به ويُحدِّث نفسه في كل ثانية.

إضافة توابع دورة الحياة إلى الصنف

من المهم في التطبيقات التي تمتلك العديد من المُكوِّنات أن نُحرِّر الموارد المحجوزة من قبل هذه المُكوِّنات عند تدميرها.

نريد تعيين عدّاد الوقت حالما يُصيَّر المُكوِّن Clock إلى DOM لأوّل مرّة، يُسمَّى هذا في React بالوصل (mounting). ونرغب أيضًا بمسح هذا العدّاد حالما يُزال DOM الناتج عن المُكوِّن Clock، يُسمَّى هذا في React بالفصل (unmounting).

بإمكاننا التصريح عن توابع خاصّة في مُكوِّنات الأصناف لتنفيذ بعض الشيفرات عند وصل وفصل المُكوِّن:

class Clock extends React.Component {
  constructor(props) {
    super(props);
    this.state = {date: new Date()};
  }

  componentDidMount() {

  }

  componentWillUnmount() {

  }

  render() {
    return (
      <div>
        <h1>أهلًا بالعالم!</h1>
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
      </div>
    );
  }
}

تُدعى هذه التوابع بخُطافات دورة الحياة (lifecycle hooks). يعمل الخُطاف componentDidMount()‎ بعد تصيير ناتج المُكوِّن إلى DOM، لذلك هو مكان مُلائم لتعيين عداد الوقت:

componentDidMount() {
    this.timerID = setInterval(
      () => this.tick(),
      1000
    );
  }

لاحظ كيف حفظنا مُعرِّف عدّاد الوقت (timer ID) من خلال this.

لمّا كانت this.props يجري إعدادها عن طريق React نفسها و this.state تمتلك معنًى خاصًّا، فأنت حر بأن تضيف حقول إضافيّة يدويًّا إلى الصّنف إن احتجت تخزين شيء ما لا يُشارِك في تدفّق البيانات (مثل مُعرِّف عداد الوقت).

سننهي عدّاد الوقت في خُطاف دورة الحياة componentWillUnmount()‎:

componentWillUnmount() {
    clearInterval(this.timerID);
  }

وأخيرًا سنضيف تابعًا يُدعى tick()‎ يُنفِّذه المُكوِّن Clock في كل ثانية. سيستخدم this.setState()‎ لجدولة التحديثات إلى الحالة المحليّة للمُكوِّن:

class Clock extends React.Component {
  constructor(props) {
    super(props);
    this.state = {date: new Date()};
  }

  componentDidMount() {
    this.timerID = setInterval(
      () => this.tick(),
      1000
    );
  }

  componentWillUnmount() {
    clearInterval(this.timerID);
  }

  tick() {
    this.setState({
      date: new Date()
    });
  }

  render() {
    return (
      <div>
        <h1>أهلًا بالعالم</h1>
        <h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>
      </div>
    );
  }
}

ReactDOM.render(
  <Clock />,
  document.getElementById('root')
);

جرِّب المثال على موقع CodePen.

تدق السّاعة الآن في كل ثانية.

فلنوجز بسرعة ما يجري ونذكر الترتيب الذي تُستدعى فيه التوابع:

  1. عندما يُمرَّر العنصر ‎<Clock />‎ إلى ReactDOM.render()‎ تستدعي React الدالة البانية للمُكوِّن Clock. وبما أنّ Clock يحتاج لإظهار الوقت الحالي سيُهيِّئ this.state بكائن يتضمّن الوقت الحالي، ولاحقًا يُحدِّث هذه الحالة.
  2. تستدعي بعدها React التّابع render()‎ للمُكوِّن Clock، وهكذا تعلم React ما الذي ينبغي عرضه على الشاشة. تُحدِّث React بعد ذلك DOM ليُطابِق ناتج Clock.
  3. عندما يُدخَل ناتج Clock إلى DOM، تستدعي React خُطاف دورة الحياة componentDidMount()‎، وبداخله يسأل المُكوِّن Clock المتصفّح أن يُعيِّن عدّاد الوقت لاستدعاء التابع tick()‎ الخاص بالمُكوِّن مرّة كل ثانية.
  4. يستدعي المتصفّح في كل ثانية التّابع tick()‎، وبداخل يُجدوِل المُكوِّن Clock تحديثًا لواجهة المستخدم عن طريق استدعاء setState()‎ مع كائن يحوي على الوقت الحالي. وبفضل استدعاء setState()‎ تعلم React أنّ الحالة تغيّرت وبذلك تستدعي التّابع render()‎ مرّة أخرى ليعلم ما الذي ينبغي أن يكون على الشاشة، ستكون this.state.date في التابع render()‎ مختلفة هذه المرّة، وبهذا يتضمّن الناتج الوقت المُحدَّث. تُحدِّث React وفق ذلك DOM.
  5. إن أُزيل المُكوِّن Clock من DOM تستدعي React خُطاف دورة الحياة componentWillUnmount()‎ بحيث يتوقّف عدّاد الوقت.

استخدام الحالة بشكل صحيح

هنالك ثلاثة أشياء ينبغي أن تعلمها حول setState()‎.

لا تعدل الحالة بشكل مباشر

على سبيل المثال لن يُعيد المثال التالي تصيير المُكوِّن:

// طريقة خاطئة
this.state.comment = 'أهلًا';

استخدم setState()‎ بدلًا من ذلك:

// الطريقة الصحيحة
this.setState({comment: 'أهلًا'});

المكان الوحيد الذي يُمكنك فيه تعيين this.state هو الدالة البانية.

قد تكون تحديثات الحالة غير متزامنة

قد تجمع React نداءات عديدة للتّابع setState()‎ في تحديث واحد من أجل تحسين الأداء.

بما أنّ this.props و this.state  قد تُحدَّث بشكل غير متزامن، فيجب ألّا تعتمد على قيمها لحساب الحالة التالية.

على سبيل المثال قد تفشل الشيفرة التالية بتحديث عدّاد الوقت:

// طريقة خاطئة
this.setState({
  counter: this.state.counter + this.props.increment,
});

لإصلاح ذلك استخدم شكل آخر من setState()‎ يقبل دالة بدلًا من كائن، حيث تستقبل هذه الدالة الحالة السّابقة كوسيط أول لها، والخاصيّات props في وقت تطبيق التحديث كوسيطٍ ثانٍ لها:

// الطريقة الصحيحة
this.setState((prevState, props) => ({
  counter: prevState.counter + props.increment
}));

استخدمنا الدوال السهمية في المثال السّابق، ولكنّها تعمل أيضًا مع الدوال الاعتياديّة:

// الطريقة الصحيحة
this.setState(function(prevState, props) {
  return {
    counter: prevState.counter + props.increment
  };
});

تدمج React تحديثات الحالة

عندما تستدعي setState()‎، تدمج React الكائن الذي تُزوِّدها به مع الحالة الحاليّة.

على سبيل المثال قد تحتوي حالتك على متغيّرات مستقلّة عديدة:

constructor(props) {
    super(props);
    this.state = {
      posts: [],
      comments: []
    };
  }

يُمكنِك بعد ذلك تحديثها بشكل مستقل باستدعاءات منفصلة للتابع setState()‎:

componentDidMount() {
    fetchPosts().then(response => {
      this.setState({
        posts: response.posts
      });
    });

    fetchComments().then(response => {
      this.setState({
        comments: response.comments
      });
    });
  }

يكون هذا الدمج ضئيلًا، لذلك لا يُؤثِّر تحديث حالة التعليقات this.setState({comments})‎ على حالة المنشورات أي this.state.posts، ولكنّه يستبدل حالة التعليقات this.state.comments بشكل كامل.

تتدفق البيانات للمستويات الأدنى

لا تعلم المُكوِّنات الآباء ولا حتى الأبناء إن كان مُكوِّن مُحدَّد لديه حالة أو بدون حالة، ولا يجب أن تُبالي إن كان مُعرَّفًا كدالة أو كصنف.

هذا هو السبّب وراء تسمية الحالة بالمحليّة أو المُغلَّفة، فهي غير قابلة للوصول من قبل أي مُكوِّن آخر غير المُكوِّن الذي يملكها ويُعيّنها.

قد يختار المُكوِّن تمرير حالته كخاصيّات props إلى عناصره الأبناء في المستوى الأدنى:

<h2>الساعة الآن {this.state.date.toLocaleTimeString()}.</h2>

يعمل هذا المثال مع المُكوِّنات المُعرَّفة من قبل المستخدم أيضًا:

<FormattedDate date={this.state.date} />

يستقبل المُكوِّن FormattedDate التاريخ date في خاصيّاته ولن يعلم ما إذا كان هذا التاريخ قد أتى عن طريق حالة المُكوِّن Clock، أو من خاصيّات Clock، أو كُتِب بشكل يدوي:

function FormattedDate(props) {
  return <h2>الساعة الآن {props.date.toLocaleTimeString()}.</h2>;
}

جرِّب المثال على موقع CodePen.

يُدعى هذا عادةً بتدفق البيانات من المستوى الأعلى للأدنى (top-down) أو أحادي الاتجاه (unidirectional). حيث أي حالة يمتلكها مُكوِّن مُحدَّد، وأي بيانات أو واجهة مستخدم مُشتقَّة من تلك الحالة بإمكانها فقط التأثير على المُكوِّنات التي تحتها في شجرة المُكوِّنات.

إن تخيّلت شجرة المُكوِّنات كشلّال من الخاصيّات، فكل حالة مُكوِّن تُشبِه مصدر إضافي للماء ينضم إليها في نقطة عشوائيّة ويتدفق معها للأسفل.

ولنبرهن أنّ جميع المُكوِّنات معزولة حقًا، فبإمكاننا إنشاء المُكوِّن App الذي يُظهِر شجرة من مُكوِّنات ‎<Clock>‎:

function App() {
  return (
    <div>
      <Clock />
      <Clock />
      <Clock />
    </div>
  );
}

ReactDOM.render(
  <App />,
  document.getElementById('root')
);

جرِّب المثال على موقع CodePen.

يُعيِّن كل مُكوِّن Clock عدّاده الخاص به ويُحدِّثه بشكل منفصل.

في تطبيقات React عند استخدام مُكوِّن بداخل مُكوِّن آخ، فيُعتبَر المُكوِّن تفصيلًا تنفيذيًّا للمُكوِّن الآخر سواءً كان المُكوِّن يحتوي على حالة (stateful) أو بدون حالة (stateless) ويُمكِن أن يتغيّر عبر الوقت، بإمكانك استخدام المُكوِّنات بدون الحالة بداخل المُكوِّنات ذات الحالة وبالعكس أيضًا.

انظر أيضًا

مصادر