Programming Basics SQL HTML CSS JavaScript React Python C++ Java JavaFX Swing Problem Solving English English Conversations Computer Fundamentals Linux Learn Typing

Reactإنشاء مشروع

  • إنشاء مشروع React
  • تشغيل مشروع React
  • الملفات الإفتراضية في React
  • تعديل الصفحة الإفتراضية في React

إنشاء مشروع React

بدايةً، قبل إنشاء المشروع قم بتجهيز مجلد خاص في الحاسوب لكي تضع فيه مشاريعك، ثم افتح موجه الأوامر فيه.

لإنشاء مشروع React يمكننا استخدام الأمر create-react-app على النحو التالي.

مثال

npx create-react-app my-react-app 

عند تنفيذ الأمر السابق فإنه سيتم إنشاء مجلد إسمه my-react-app و من ثم تحميل المكتبات الأساسية التي يحتاجها من النت و سيتم تضمينها فيه بشكل تلقائي.

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

أثناء إنشاء المشروع قد تجد أن موجه الأوامر يطرح عليك بعض الأسئلة. فمثلاً أول مرة تقوم فيها بإنشاء مشروع جديد فإنه يخبرك بأنه بحاجة إلى تحميل بعض المكتبات من النت و يحتاج منك إدخال الحرف y للموافق على ذلك.

تشغيل مشروع React

لتتمكن من تشغيل المشروع، عليك التوجه إلى المجلد الذي يوجد فيه المشروع و من ثم يمكنك تشغيله.

الآن أدخل إلى المجلد my-react-app باستخدام الأمر cd على النحو التالي.

مثال

cd my-react-app

الآن يمكنك استخدام الأمر start على النحو التالي لتشغيل المشروع و فتحه في المتصفح.

مثال

npm start

النتيجة

تشغيل مشروع React
جرب الكود

ما حدث فعلياً عند تشغيل المشروع هو أن Nodejs قام بتحويله إلى صفحة ويب و من ثم قام باستضافتها و أتاح لنا الدخول إليها من خلال الرابط localhost:3000 و بالتالي يمكنك كتابة هذا الرابط بنفسك للدخول إلى هذه الصفحة إذا أغلقتها بالخطأ.

الملفات الإفتراضية في React

إذا فتحت مجلد المشروع بواسطة VSCode فإنه سيبدو كما يلي.

الملفات الإفتراضية في React


1- المجلد node_modules

هذا المجلد يوضع فيه جميع المكتبات التي يعتمدها المشروع بالإضافة إلى المكتبات التي قد تضاف فيه لاحقاً.


2- المجلد public

هذا المجلد يوضع فيه المحتوى الثابت ( Static Content ) المستخدم في المشروع كالصور، الأيقونات، ملفات الخطوط، ملفات نصية، ملفات جيسون، و حتى صفحات HTML جاهزة.

الصفحة الإفتراضية التي تظهر عند تشغيل المشروع موجودة في هذا المجلد بداخل ملف إسمه index.html.


3- المجلد src

هذا أهم مجلد في المشروع حيث يتم وضع كل الملفات الخاصة بالمكونات المستخدمة في المشروع.

من المجلدات الإفتراضية الموجودة فيه نذكر:

  • الملف index.js الذي يربط كل ملفات المشروع الرئيسية ببعضها مع تضمين مكتبات React.
  • الملف App.js الذي يمثل الحاوية الرئيسية لكل مكونات المشروع.
  • الملف App.css الذي يمكن وضع كود CSS يتم تطبيقه على الحاوية الرئيسية و أي مكوّن موضوع فيها.

4- الملف package.json

هذا الملف يحتوي على جميع أسماء و إصدارات المكتبات التي يستعملها المشروع و التي هي بالأساس موجودة في المجلد node_modules.

من خلال هذا الملف أيضاً يمكن التحكم ببعض الإعدادات المتعلقة بأوامر التشغيل، البناء، التجربة و إيقاف المشروع.


5- الملف README.md

هذا الملف مخصص ليوضع فيه شرح حول المشروع نفسه مما يساعد المطورين على معرفة كيفية استعماله و الإستفادة منه.

استعمال هذا الملف هو أمر اختياري و لكنه مفيد في حال كان سيتم مشاركة المشروع مع الغير لأنه متعارف عليه كأول ملف يجب الإطلاع عليه من أجل معرفة كيفية تشغيل المشروع.

تعديل الصفحة الإفتراضية في React

الصفحة التي تظهر لك عند تشغيل المشروع هي صفحة تم إعدادها بواسطة مطوري React و بالطبع يمكنك تعديل محتواها و وضع المحتوى الذي تريده أنت.

إفتح مجلد المشروع بواسطة VSCode و توجه إلى المجلد src ثم افتح الملف App.js.
بعدها قم بحذف كل الكود الموجود في هذا الملف و وضع الكود التالي بدلاً منه.

ملاحظة: لا تنسى حفظ الملف بالضغط على الزرين Ctrl + S حتى تحفظ التعديلات التي قمت بإجرائها.

مثال

/src/App.js
function App() {
  return (
    <div className="App">
      <h1>Hello World!</h1>
    </div>
  );
}

export default App;

النتيجة

محتوى الصفحة بعد تعديله
جرب الكود

بمجرد حفظ التعديلات التي تم إجراءها على ملفات المشروع فإن الصفحة ستتحدث بشكل تلقائي.