logo by @sawaratsuki1004
React
v19.2
Learn
Reference
Community
Blog

Is this page useful?

On this page

  • Overview
  • محررك
  • ميزات محرر النصوص الموصى بها
  • الفحص
  • التنسيق

    GET STARTED

  • Quick Start
    • Tutorial: Tic-Tac-Toe
    • Thinking in React
  • Installation
    • Creating a React App
    • Build a React App from Scratch
    • Add React to an Existing Project
  • Setup
    • Editor Setup
    • Using TypeScript
    • React Developer Tools
  • React Compiler
    • Introduction
    • Installation
    • Incremental Adoption
    • Debugging and Troubleshooting
  • LEARN REACT

  • Describing the UI
    • Your First Component
    • Importing and Exporting Components
    • Writing Markup with JSX
    • JavaScript in JSX with Curly Braces
    • Passing Props to a Component
    • Conditional Rendering
    • Rendering Lists
    • Keeping Components Pure
    • Your UI as a Tree
  • Adding Interactivity
    • Responding to Events
    • State: A Component's Memory
    • Render and Commit
    • State as a Snapshot
    • Queueing a Series of State Updates
    • Updating Objects in State
    • Updating Arrays in State
  • Managing State
    • Reacting to Input with State
    • Choosing the State Structure
    • Sharing State Between Components
    • Preserving and Resetting State
    • Extracting State Logic into a Reducer
    • Passing Data Deeply with Context
    • Scaling Up with Reducer and Context
  • Escape Hatches
    • Referencing Values with Refs
    • Manipulating the DOM with Refs
    • Synchronizing with Effects
    • You Might Not Need an Effect
    • Lifecycle of Reactive Effects
    • Separating Events from Effects
    • Removing Effect Dependencies
    • Reusing Logic with Custom Hooks
Learn React
Setup

تجهيز محرر الأكواد

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

You will learn

  • ما هي المحررات الأكثر شيوعًا
  • كيفية تنسيق الكود تلقائيًا

محررك

VS Code هو أحد المحررات الأكثر استخدامًا اليوم. لديه معرض كبير من الإضافات، ويتكامل بشكل جيد مع الخدمات الشائعة مثل GitHub. يمكن إضافة معظم الميزات المدرجة فيه إلى VS Code كإضافات أيضًا، مما يجعله قابلًا للتكوين بشكل كبير!

محررات النصوص الشائعة الأخرى المستخدمة في مجتمع React تشمل:

  • WebStorm هو بيئة تطوير متكاملة مصممة خصيصًا لـ JavaScript.
  • Sublime Text لديه دعم لـ JSX و TypeScript، تمييز الصيغة وإكمال تلقائي مدمج.
  • Vim هو محرر نصوص قابل للتكوين بشكل كبير مصمم لجعل إنشاء وتغيير أي نوع من النصوص فعالًا للغاية. وهو مدرج كـ “vi” مع معظم أنظمة UNIX ومع Apple OS X.

ميزات محرر النصوص الموصى بها

قد تأتي بعض المحررات مع هذه الميزات مدمجة، ولكن قد تتطلب المحررات الأخرى تثبيت إضافةٍ. تحقق من الدعم الذي يوفره محررك المفضل لديك للتأكد!

الفحص

فحص الكود لاكتشاف الأخطاء في الكود أثناء الكتابة، مما يساعدك على إصلاحها في وقت مبكر. ESLint هو فاحص شائع ومفتوح المصدر لـ JavaScript.

  • قم بتثبيت ESLint مع التكوين الموصى به لـ React (تأكد من تثبيت Node!)
  • دمج ESLint في VSCode مع الإضافة الرسمية

تأكد من تمكين جميع قواعد eslint-plugin-react-hooks لمشروعك. إنها ضرورية وتكشف أكثر الأخطاء خطورة في وقت مبكر. يتضمن التكوين الموصى به eslint-config-react-app بالفعل هذه القواعد.

التنسيق

آخر شيء تريد القيام به عند مشاركة الكود مع مساهم آخر هو الدخول في مناقشة حول التباعد بالمسافة الكبيرة tab أم التباعد بالمسافة (tabs vs spaces)! لحسن الحظ، سيقوم Prettier بتنظيف الكود الخاص بك عن طريق إعادة تنسيقه ليتوافق مع قواعد مسبقة وقابلة للتكوين. قم بتشغيل Prettier، وسيتم تحويل جميع علامات التبويب إلى مسافات - وسيتم تغيير المسافة البادئة والاقتباسات وما إلى ذلك أيضًا ليتوافق مع التكوين. في الإعداد المثالي، سيتم تشغيل Prettier عند حفظ الملف، مما يجعل هذه التعديلات بسرعة بالنسبة لك.

يمكنك تثبيت إضافة Prettier في VSCode عن طريق اتباع هذه الخطوات:

  1. قم بتشغيل VS Code
  2. استخدم البحث السريع (اضغط على Ctrl/Cmd+P)
  3. الصق ext install esbenp.prettier-vscode
  4. اضغط على Enter

التنسيق عند الحفظ

في الواقع، يجب عليك تنسيق الكود في كل مرة تقوم فيها بحفظه. يحتوي VS Code على إعدادات لهذا الغرض!

  1. في VS Code، اضغط على CTRL/CMD + SHIFT + P.
  2. اكتب “settings”
  3. اضغط على Enter
  4. في شريط البحث، اكتب “format on save”
  5. تأكد من تحديد خيار “format on save”!

إذا كانت لديك قواعد تنسيق في إعدادات ESLint، فقد تتعارض مع Prettier. نوصي بتعطيل جميع قواعد التنسيق في إعدادات ESLint الخاصة بك باستخدام eslint-config-prettier بحيث يتم استخدام ESLint فقط للكشف عن الأخطاء المنطقية. إذا كنت ترغب في فرض تنسيق الملفات قبل دمج طلب سحب (Pull Request)، استخدم prettier --check للتكامل المستمر.

PreviousSetup
NextUsing TypeScript

Copyright © Meta Platforms, Inc
no uwu plz
uwu?
Logo by@sawaratsuki1004
Learn React
Quick Start
Installation
Describing the UI
Adding Interactivity
Managing State
Escape Hatches
API Reference
React APIs
React DOM APIs
Community
Code of Conduct
Meet the Team
Docs Contributors
Acknowledgements
More
Blog
React Native
Privacy
Terms