We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

تصيير العناصر

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach how to write JSX and show it on an HTML page:

العناصر (Elements) هي أصغر الوحدات البنائية في التطبيقات المبنية باستخدام رياكت (React).

يصف العنصر الواحد ما تريد رؤيته على الشاشة:

const element = <h1>مرحباً بالعالم!</h1>;

على عكس عناصر الـ DOM للمتصفح, فإن عناصر رياكت (React) ما هي إلا كائنات بسيطة, ولا تتطلب الكثير لإنشاءها. حيث تتحمل الـ DOM لـ رياكت (React) مسؤولية تحديث الـ DOM لمماثلتها مع عناصر الرياكت (React).

ملاحظة:

من الممكن الخلط بين العناصر وأحد المفاهيم المعروفة “المكونات”. سنقوم بتقديم المكونات في [القسم التالي] (/docs/components-and-props.html). تصنع المكونات من العناصر, ونشجعك على الإطلاع على هذا القسم قبل القفز إلى مواضيع أخرى.

تصيير عنصر واحد إلى الـ DOM

دعنا نفترض أن هنالك عنصر div في مكان ما في ملف الـ HTML خاصتك:

<div id="root"></div>

نطلق على هذا العنصر اسم عقدة DOM “الجذر” وذلك لأن كل ما تحتويها سيتم التحكم به من قبل رياكت DOM.

تتألف التطبيقات المبنية باستخدام رياكت في العادة, من عقدة DOM جذر وحيدة. أما إن كنت تقوم بعمل التكامل لـرياكت إلى تطبيق موجود مسبقاً, من الممكن أن يتوفر لديك أي عدد ترغب به من عقد DOM الجذر.

لتصيير عنصر رياكت إلى عقدة DOM جذر وحيدة, مررهما معاَ إلى ReactDOM.render():

const root = ReactDOM.createRoot(
  document.getElementById('root')
);
const element = <h1>Hello, world</h1>;
root.render(element);

Try it on CodePen

يعرض هذا المثال عند تنفيذه “مرحباً بالعالم”.

تحديث العنصر المصير

عناصر رياكت غير قابلة للتغيير immutable. عند انشائك عنصراَ, فإنه حينها لا يكون بإمكانك تغيير عناصره الأبناء أو صفاته. العنصر يشبه إطار الفيلم الواحد في كونه يمثل واجهة المستخدم خلال فترة معينة من الزمان.

وبهذا القدر البسيط من المعرفة التي امتلكناها لحد الآن, فإن الطريقة الوحيدة لتحديث واجهة المستخدم تتم من خلال إنشاء عنصر جديد, ومن ثم تمريره إلى ReactDOM.render().

خذ على سبيل المثال هذه الساعة الداقة:

const root = ReactDOM.createRoot(
  document.getElementById('root')
);

function tick() {
  const element = (
    <div>
      <h1>Hello, world!</h1>
      <h2>It is {new Date().toLocaleTimeString()}.</h2>
    </div>
  );
  root.render(element);}

setInterval(tick, 1000);

Try it on CodePen

حيث تقوم بمناداة root.render() كل ثانية من خلال رد النداء setInterval().

ملاحظة:

عملياً, معظم التطبيقات المبنية مع رياكت تقوم بنداء ReactDOM.render() مرة واحدة فقط. في القسم التالي سنعرف أكثر عن كم الشيفرة التي يتم تغليفها إلى مكوًن صنف.

نقترح عليك بألا تتخطى أية من المواضيع, لأنها تبني على بعضها البعض.

يحدث رياكت واجهة المستخدم فقط عندما تدعو الحاجة لذلك

يقارن ReactDOM العنصر وأبنائه مع سابقه, ويقوم يتطبيق تحديثات DOM الضرورية لتحويل الـ DOM إلى الحالة المرغوب بها.

تستطيع تأكيد ذلك من خلال تفحص المثال الأخير باستخدام أدوات المتصفح:

DOM inspector showing granular updates

بالرغم من أننا ننشئ عنصراً يصف شجرة واجهة المستخدم بأكملها عند كل دقة ساعة, فإن ما يتم تحديثه بواسطة ReactDOM ما هو إلا عقدة النص التي تغيرت محتوياتها.

بحسب خبرتنا, التفكير بالكيفية التي ستبدو عليها واجهة المستخدم في أي لحظة من الزمان بدل التفكير بآلية تغييرها بمرور الوقت يقضي على العديد من الأخطاء البرمجية bugs.

Is this page useful?تحرير هذه الصفحة