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
على النحو التالي لتشغيل المشروع و فتحه في المتصفح.
ما حدث فعلياً عند تشغيل المشروع هو أن Nodejs قام بتحويله إلى صفحة ويب و من ثم قام باستضافتها و أتاح لنا الدخول إليها من خلال الرابط localhost:3000 و بالتالي يمكنك كتابة هذا الرابط بنفسك للدخول إلى هذه الصفحة إذا أغلقتها بالخطأ.
الملفات الإفتراضية في React
إذا فتحت مجلد المشروع بواسطة VSCode فإنه سيبدو كما يلي.
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 حتى تحفظ التعديلات التي قمت بإجرائها.
مثال
function App() { return ( <div className="App"> <h1>Hello World!</h1> </div> ); } export default App;
النتيجة
بمجرد حفظ التعديلات التي تم إجراءها على ملفات المشروع فإن الصفحة ستتحدث بشكل تلقائي.