البدء مع React

تلقي هذه الصفحة نظرة شاملة على توثيق React والمصادر المرتبطة به.

تعدُّ React مكتبةٌ من مكتبات الجافاسكريبت المخصَّصة لبناء واجهات المستخدم. انتقل إلى الصفحة الرئيسية لتوثيق React أو إلى الدليل التطبيقي لمعرفة المزيد عنها.


جرب React

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

التجربة على الإنترنت

إن كنت مهتمًا بتجربة React والتعامل معها، يمكنك استخدام بيئة جاهزة لتجربة الشيفرة على الإنترنت. جرّب مثال “أهلًا بالعالم” (Hello World) على موقع CodePen أو موقع CodeSandbox أو موقع Glitch.

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

إضافة React إلى موقع ويب

يمكنك إضافة React الى صفحة HTML في دقيقة. يمكنك بعدئذٍ إمَّا أن توسِّع استعمال React تدريجيًّا، أو تقتصر باستعمالها على بضعة أدوات ذكية ديناميكية (dynamic widgets).

إنشاء تطبيق React جديد

عند بدء مشروع React, قد لا يزال خيار استعمال صفحة HTML بسيطة الوسوم <script>. خيارًا مفضَّلًا، إذ يأخذ دقيقةً واحدةً لإعداده!

في الوقت الذي يكبر فيه برنامجك، قد ترغب بإعداد وضبط والكثير من الأمور المتكاملة. هنالك سلاسل أدوات الجافاسكريبتعديدة نوصي باستعمالها في حالة التطبيقات الكبيرة. يمكن أن تعمل كل أداة من تلك الأدوات مع ضبط بسيطة أو حتى دون أي ضبط وتمكِّنك من الاستفادة من جميع ميزات بيئة عمل React الواسعة.

تعلم React

الأشخاص الذين يأتون إلى React هم ذوي خلفيات شتَّى وأساليب تعلُّم مختلفة. سواءً أكنت تفضل الأسلوب النظري، أم الأسلوب العملي، نأمل أن تجد في هذا القسم العون على رحلتك في تعلم React.

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

الأمثلة الأولى

الصفحة الرئيسية لتوثيق React بضعة أمثلة بسيطة عن React. حتى إن تعرف أي شيء عن React بعد، جرب تشغيل الأمثلة ثم تعديلها مع ملاحظة التغيير الذي سيحصل للمخرجات.

React للمبتدئين

إن كنت تشعر أن توثيق React يتدرج بالصعوبة بوتيرة أسرع مما تخيلتها، ألقِ نظرة على هذه المقالة عن React لصاحبها Tania Rascia. إنَّها تعرِّف أكثر المفاهيم أهميةً في React بالتفصيل وبطريقة سهلة ومبسَّطة تناسب المبتدئين. متى ما انتهيت منها، عد إلى التوثيق وأعطه فرصة جديدة.

React للمصممين

إن كنت قادمًا إلى React من بيئة تصميمة أخرى، هذا المرجع هو أفضل مكان يمكنك البدء منه.

مصادر حول الجافاسكريبت

يفترض توثيق React أنَّك تملك خبرة برمجية مسبقة بلغة الجافاسكريبت. لا يُطلَب منك أن تكون خبيرًا محنَّكًا ولكن من الصعب تعلم React و الجافاسكريبت في الوقت نفسه.

ننصح بالاطلاع على توثيق الجافاسكريبتوالإلمام بمعظمه للتحقق من وصولك للمستوى المطلوب. نعلم أنَّه قد يأخذ منك بعض الوقت، ولكن ذلك سيعزز تعلمك لـ React.

نصيحة

كلما شعرت بحيرة حول أي شيء مكتوب بلغة الجافاسكريبت ننصحك بالرجوع إلى التوثيق في موسوعة حسوب أو إلى المقالات المتعلقة بلغة JavaScript في أكاديمية حسوب. أضف إلى ذلك إلى أنَّ منديات دعم المجتمع و مجتمع حسوب IO مستعدون دائمًا لمساعدتك.

التعلم عبر التطبيق العملي

إن كنت تفضل أن تتعلم بالممارسة, ابدأ بالدليل التطبيقي أولًا. ستتعلم في هذا الدليل كيفيّة بناء لعبة إكس-أو (اسمها بالإنجليزيّة tic-tac-toe) باستخدام React. ربّما قد ترغب بتخطي هذا الدليل لأنّك لا تريد بناء الألعاب، ولكن أعطه فرصة. إنّ التقنيات التي ستتعلمها في هذا الدليل أساسيّة لبناء أي تطبيق React، وسيعطيك إتقانها فهمًا أعمق لمكتبة React.

تعلم المفاهيم خطوة بخطوة

إن كنت تفضل تعلم المفاهيم النظرية أولًا, [ فتوثيق React من البداية خطوة بخطوة](/docs/hello-world.html هو المكان الأمثل للبدء. كل فصل لاحق فيه يبني على المعرفة التي اكتسبتها في الفصل السابق، لذا لن يفوتك أي شيء إن بدأت قراءته من البداية وحتى النهاية بالترتيب.

أسلوب التفكير في React

غلب مستخدمي React يقدِّرون قراءة أسلوب التفكير في React بالشيء الثمين، إذ يشعرون في تلك اللحظة أنَّ React قد أصبحت كشربة ماءٍ بالنسبة لهم. تعدُّ تلك الصفحة أقدم مدخل إلى React ولا تزال إلى الآن على صلةٍ وثيقةٍ بأحدث إصدار من React.

قد يجد البعض أحيانًا أنَّ الكتب والفيديوهات الموفَّرَة من طرف ثالث أكثر نفعًا وفائدةً لهم من التوثيق الرسمي. إليك قائمة ببعض المراجع الأجنبية التي يوصى بها لتعلم React. وفرنا أيضًا دورة كاملة حول الجافاسكريبت و React تأخذك من الصفر وحتى الاحتراف وبلغة عربية من أكاديمية حسوب.

مفاهيم متقدمة

متى ما شعرت أنَّ المفاهيم الأساسية أصبحت سهلةً لك وبدأت بممارسة React وشعرت أنَّ نفسك تطلب المزيد، فأنت حينئذٍ بحاجة إلى الانتقال إلى مستوى متقدم. هذا القسم سيقدم لك ميزات متقدمة في React وقوية ولكن أقل استخدامًا مثل السياق و refs.

مرجع إلى الواجهة البرمجية

هذا القسم مفيد إن أردت تعلم المزيد من التفاصيل حول واجهة برمجية محددة في React. على سبيل المثال مرجع الواجهة البرمجية حول React.Component يمكن أن يزودك بتفاصيل أوسع حول كيفية عمل setState() وما هي أفضل توابع دورة الحياة المختلفة لاستعمالها معه.

المصطلحات والأسئلة الشائعة

يحوي قسم المصطلحات شرحًا مفصّلًا لأهم المصطلحات التي ستراها في توثيق React. هنالك أيضً قسمٌ مخصص يجاوب عن الأسئلة الشائعة حول مواضيع محدَّدة في React مثل استخدام AJAX مع React حالة المكوّن و بنية ملفات المشروع.

ابق على اطلاع

مدونة React هي المصدر الرسمي لنشر التحديثات من فريق React. سينشر أي شيء مهم بما في ذلك الملاحظات حول الإصدارات أو ملاحظات الإهمال في تلك المدونة أولًا.

يمكن أيضًا متابعتنا على حساب تويتر ‎@reactjs ولكن لن يفوتك أي شيء إن تابعت المدونة فقط.

لا يمكن الاكتفاء بمنشورات المدونة لمعرفة كل تفاصيل الإصدار الجديد من React؛ يمكنك العثور على معلومات مفصلة عن سجل التغييرات لكل إصدار في الملف CHANGELOG.md في مستودع React وكذلك في صفحة الإصدارات أيضًا.

توثيق الإصدار

يعكس هذا التوثيق أحدث إصدار مستقر من React. منذ الإصدار 16، يمكنك العثور على توثيق الإصدارات الأقدم في صفحة منفصلة. انتبه إلى أنَّ ذلك التوثيق للإصدارات القديمة قد بقي على حاله منذ تاريخ نشر الإصدار ولن يجري تحديثه.

أتفقد شيئًا آخر؟

إن كنت تبحث عن شيء آخر ولم تجده في التوثيق، أو إن وجدت بعض أجزاء هذا التوثيق مربكة، نرجو منك أن تخبرنا عن ذلك عبر فتح مشكلة (issue) في مستودع التوثيق على GitHub ع ذكر اقتراحاتك للتطوير. يمكنك أيضًا أن نتشر تغريدة بذلك على الحساب @reactjs. يسعدنا حقًا أن نسمع اقتراحتك!