الفرق بين المراجعتين لصفحة: «React/state and lifecycle»
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
||
سطر 318: | سطر 318: | ||
} | } | ||
</syntaxhighlight>يكون هذا الدمج ضئيلًا، لذلك لا يُؤثِّر تحديث حالة التعليقات this.setState({comments}) على حالة المنشورات أي this.state. | </syntaxhighlight>يكون هذا الدمج ضئيلًا، لذلك لا يُؤثِّر تحديث حالة التعليقات <code>this.setState({comments})</code> على حالة المنشورات أي <code>this.state.posts</code>، ولكنّه يستبدل حالة التعليقات <code>this.state.comments</code> بشكل كامل. | ||
== تتدفق البيانات للمستويات الأدنى == | == تتدفق البيانات للمستويات الأدنى == | ||
سطر 325: | سطر 325: | ||
هذا هو السبّب وراء تسمية الحالة بالمحليّة أو المُغلَّفة، فهي غير قابلة للوصول من قبل أي مُكوِّن آخر غير المُكوِّن الذي يملكها ويُعيّنها. | هذا هو السبّب وراء تسمية الحالة بالمحليّة أو المُغلَّفة، فهي غير قابلة للوصول من قبل أي مُكوِّن آخر غير المُكوِّن الذي يملكها ويُعيّنها. | ||
قد يختار المُكوِّن تمرير حالته كخاصيّات props إلى عناصره الأبناء في المستوى الأدنى: | قد يختار المُكوِّن تمرير حالته كخاصيّات <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]. | |||
يُدعى هذا عادةً بتدفق البيانات من المستوى الأعلى للأدنى (top-down) أو أحادي الاتجاه (unidirectional). حيث أي حالة يمتلكها مُكوِّن مُحدَّد، وأي بيانات أو واجهة مستخدم مُشتقَّة من تلك الحالة بإمكانها فقط التأثير على المُكوِّنات التي تحتها في شجرة المُكوِّنات. | |||
إن تخيّلت شجرة المُكوِّنات كشلّال من الخاصيّات، فكل حالة مُكوِّن تُشبِه مصدر إضافي للماء ينضم إليها في نقطة عشوائيّة ويتدفق معها للأسفل. | |||
ولنبرهن أنّ جميع المُكوِّنات معزولة حقًا، فبإمكاننا إنشاء المُكوِّن <code>App</code> الذي يُظهِر شجرة من مُكوِّنات <code><Clock></code>:<syntaxhighlight lang="javascript"> | |||
function App() { | |||
return ( | |||
<div> | |||
<Clock /> | |||
<Clock /> | |||
<Clock /> | |||
</div> | |||
); | |||
} | |||
ReactDOM.render( | |||
<App />, | |||
document.getElementById('root') | |||
); | |||
</syntaxhighlight>[http://codepen.io/gaearon/pen/vXdGmd?editors=0010 جرِّب المثال على موقع CodePen]. | |||
يُعيِّن كل مُكوِّن <code>Clock</code> عدّاده الخاص به ويُحدِّثه بشكل منفصل. | |||
في تطبيقات React عند استخدام مُكوِّن بداخل مُكوِّن آخ، فيُعتبَر المُكوِّن تفصيلًا تنفيذيًّا للمُكوِّن الآخر سواءً كان المُكوِّن يحتوي على حالة (stateful) أو بدون حالة (stateless) ويُمكِن أن يتغيّر عبر الوقت، بإمكانك استخدام المُكوِّنات بدون الحالة بداخل المُكوِّنات ذات الحالة وبالعكس أيضًا. | |||
== مصادر == | |||
* [https://reactjs.org/docs/state-and-lifecycle.html صفحة حالة ودورة حياة المكونات في توثيق React الرسمي]. | |||
[[تصنيف:React]] |
مراجعة 16:57، 11 يوليو 2018
سنتحدّث في هذا القسم حول مفهوم حالة ودورة حياة المُكوِّنات في 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
إلى أصناف بخمس خطوات:
- إنشاء صنف بنفس الاسم والذي يمتد (extends) إلى
React.Component
. - إضافة تابع فارغ وحيد لهذا الصنف اسمه
render()
. - نقل جسم الدالة إلى التّابع
render()
. - تبديل
props
إلىthis.props
في جسم التّابعrender()
. - حذف باقي تصريح الدالة الفارغ.
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.
تدق السّاعة الآن في كل ثانية.
فلنوجز بسرعة ما يجري ونذكر الترتيب الذي تُستدعى فيه التوابع:
- عندما يُمرَّر العنصر
<Clock />
إلىReactDOM.render()
تستدعي React الدالة البانية للمُكوِّنClock
. وبما أنّClock
يحتاج لإظهار الوقت الحالي سيُهيِّئthis.state
بكائن يتضمّن الوقت الحالي، ولاحقًا يُحدِّث هذه الحالة. - تستدعي بعدها React التّابع
render()
للمُكوِّنClock
، وهكذا تعلم React ما الذي ينبغي عرضه على الشاشة. تُحدِّث React بعد ذلك DOM ليُطابِق ناتجClock
. - عندما يُدخَل ناتج
Clock
إلى DOM، تستدعي React خُطاف دورة الحياةcomponentDidMount()
، وبداخله يسأل المُكوِّنClock
المتصفّح أن يُعيِّن عدّاد الوقت لاستدعاء التابعtick()
الخاص بالمُكوِّن مرّة كل ثانية. - يستدعي المتصفّح في كل ثانية التّابع
tick()
، وبداخل يُجدوِل المُكوِّنClock
تحديثًا لواجهة المستخدم عن طريق استدعاءsetState()
مع كائن يحوي على الوقت الحالي. وبفضل استدعاءsetState()
تعلم React أنّ الحالة تغيّرت وبذلك تستدعي التّابعrender()
مرّة أخرى ليعلم ما الذي ينبغي أن يكون على الشاشة، ستكونthis.state.date
في التابعrender()
مختلفة هذه المرّة، وبهذا يتضمّن الناتج الوقت المُحدَّث. تُحدِّث React وفق ذلك DOM. - إن أُزيل المُكوِّن
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) ويُمكِن أن يتغيّر عبر الوقت، بإمكانك استخدام المُكوِّنات بدون الحالة بداخل المُكوِّنات ذات الحالة وبالعكس أيضًا.