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

مقدمة إلى JSX

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

These new documentation pages teach modern React and include live examples:

فلننظر إلى تعريف هذا المتغير:

const element = <h1>Hello, world!</h1>;

إنّ الصّياغة الغريبة السّابقة التي تحتوي على وسم هي ليست سلسلة نصيّة ولا حتى HTML.

تُدعى الصّياغة السّابقة JSX وهي عبارة عن امتداد لصياغة JavaScript، نوصي باستخدامها مع React لوصف المظهر الذي ينبغي أن تكون عليه واجهة المستخدم. قد تُذكِّرك JSX بلغات القوالب، ولكنها تمتلك قوة JavaScript الكاملة.

تُنتِج JSX عناصر React. سنستعرض إظهار هذه العناصر في DOM في القسم التالي. سنتحدّث في الفقرات التالية عن أساسيّات JSX الضرورية للبدء.

لماذا JSX؟

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

بدلًا من الفصل بين التقنيات عن طريق وضع اللغة الترميزيّة (markup) والمنطق في ملفّات منفصلة، تفصل React بين المهام عبر وحدات مرتبطة بإحكام تدعى المكونات “components” والتي تحتوي على كليهما معًا. سنعود للحديث عن المكونات في القسم الخاص بها, ولكن إن لم تكن مرتاحًا لوضع اللغة الترميزيّة ضمن JS فاطلع على هذه المناقشة التي قد تقنعك بعكس ذلك.

لا تشترط React استخدام JSX، ولكن يجدها الغالبيّة كمساعدة بصريّة عند التعامل مع واجهة المستخدم بداخل شيفرة JavaScript، فهي تسمح لمكتبة React بأن تُظهِر المزيد من الأخطاء المفيدة والرسائل التحذيريّة.

تضمين التعابير في JSX

نُعرِّف في المثال التالي متغيّرًا يُدعى name ونستخدمه بداخل JSX عن طريق تغليفه بين قوسين:

const name = 'Josh Perez';const element = <h1>Hello, {name}</h1>;

بإمكانك وضع أي تعبير صحيح في JavaScript داخل القوسين في JSX، على سبيل المثال 2 + 2، user.firstName، أو formatName(user) جميعها تعابير JavaScript صحيحة.

نُضمِّن في المثال التالي نتيجة استدعاء دالة JavaScript، وهي formatName(user)، بداخل عنصر <h1>.

function formatName(user) {
  return user.firstName + ' ' + user.lastName;
}

const user = {
  firstName: 'Harper',
  lastName: 'Perez'
};

const element = (
  <h1>
    Hello, {formatName(user)}!  </h1>
);

Try it on CodePen

فصلنا JSX عبر عدّة أسطر لتسهيل القراءة، نُوصي أيضًا عند فعل هذا بتغليفها بين قوسين لتجنّب هفوات الإدخال التلقائي للفاصلة المنقوطة.

JSX هي عبارة عن تعبير أيضًا

بعد انتهاء مرحلة تصريف الشيفرة (compilation)، تُصبِح تعابير JSX استدعاءات لدوال JavaScript اعتياديّة وتُقيَّم إلى كائنات JavaScript.

يعني هذا أنّك تستطيع استخدام JSX بداخل جمل if الشرطيّة وحلقات for، بتعيينها إلى متغيّرات، وقبولها كوسائط، وإعادتها من الدوال:

function getGreeting(user) {
  if (user) {
    return <h1>Hello, {formatName(user)}!</h1>;  }
  return <h1>Hello, Stranger.</h1>;}

تحديد خاصيّات Attributes” HTML” عن طريق JSX

بإمكانك استخدام علامتي الاقتباس لتحديد قيم ثابتة نصيّة لخاصيّات HTML:

const element = <a href="https://www.reactjs.org"> link </a>;

بإمكانك أيضًا استخدام الأقواس لتضمين تعبير JavaScript بداخل خاصيّة HTML:

const element = <img src={user.avatarUrl}></img>;

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

تحذيرa:

لمّا كانت JSX أقرب إلى JavaScript من HTML، فتستخدم React DOM طريقة تسمية خاصيّات الكائنات camelCase بدلًا من أسماء خاصيّات HTML

على سبيل المثال، الخاصيّة class تُصبِح className في JSX، و tabindex تُصبِح tabIndex.

تحديد العناصر الأبناء باستخدام JSX

إن كان العنصر من عناصر HTML الفارغة فبإمكانك إغلاقه مباشرةً باستخدام />، كما في XML:

const element = <img src={user.avatarUrl} />;

يُمكِن لعناصر JSX أن تحتوي على عناصر أبناء:

const element = (
  <div>
    <h1>Hello!</h1>
    <h2>Good to see you here.</h2>
  </div>
);

تمنع JSX هجمات الحقن

من الآمن تضمين مُدخلات المستخدم في JSX:

const title = response.potentiallyMaliciousInput;
// This is safe:
const element = <h1>{title}</h1>;

حيث أنّ React DOM تُهرِّب (escape) أي قيم مُضمَّنة افتراضيًّا في JSX قبل عرضها، وبهذا تضمن أنّه لن يكون بإمكانك حقن أي شيء غير مكتوب بشكل صريح في تطبيقك. تُحوَّل أي قيمة إلى سلسلة نصيّة قبل عرضها، والذي يُساعِد على منع هجمات cross-site-scripting) XSS)

تمثل الكائنات في JSX

يُترجِم Babel صياغة JSX إلى استدعاءات للتابع React.createElement() لذلك يكون المثالان التاليان متطابقين:

const element = (
  <h1 className="greeting">
    Hello, world!
  </h1>
);
const element = React.createElement(
  'h1',
  {className: 'greeting'},
  'Hello, world!'
);

يُنفِّذ التّابع React.createElement() بعض الاختبارات ليُساعدك على كتابة شيفرة خالية من الأخطاء، ولكنّه بشكل أساسي يُنشِئ كائنًا مُشابِهًا لما يلي:

// Note: this structure is simplified
const element = {
  type: 'h1',
  props: {
    className: 'greeting',
    children: 'Hello, world!'
  }
};

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

سيتم تغطية تصيير عناصر React إلى DOM في القسم التالي..

ملاحظة:

نوصي باستخدام تعريف لغة Babel إلى المُحرِّر الذي تستخدمه بحيث يتعرَّف على صياغة شيفرة JSX و ES6 ويُظهرها بالألوان المناسبة.

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