شرح الدالة createContext في React

-

ما هو createContext؟

createContext يسمح لك بإنشاء سياق (context) يمكن للمكونات توفيره أو قراءته.

كيفية الاستخدام

إنشاء السياق

تقوم بإنشاء السياق باستخدام createContext خارج أي مكون.

import { createContext } from 'react';

const ThemeContext = createContext('light');


المعاملات

  • defaultValue: القيمة الافتراضية التي تريد أن يكون للسياق عندما لا يوجد مزود سياق مطابق في الشجرة فوق المكون الذي يقرأ السياق. إذا لم يكن لديك أي قيمة افتراضية ذات معنى، يمكنك تحديد null.

العائدات

createContext يعيد كائن سياق. هذا الكائن لا يحمل أي معلومات بحد ذاته، بل يمثل السياق الذي تقرأه أو توفره المكونات الأخرى.


خصائص كائن السياق

  • SomeContext.Provider: يسمح لك بتوفير قيمة السياق للمكونات.
  • SomeContext.Consumer: طريقة بديلة ونادرًا ما تُستخدم لقراءة قيمة السياق.

استخدام SomeContext.Provider

لتحديد قيمة السياق لجميع المكونات داخل المزود:

import React, { useState } from 'react';
import { ThemeContext } from './ThemeContext';

function App() {
  const [theme, setTheme] = useState('light');

  return (
    <ThemeContext.Provider value={theme}>
      <Page />
    </ThemeContext.Provider>
  );
}


استخدام SomeContext.Consumer

قبل وجود useContext، كانت هناك طريقة قديمة لقراءة السياق:

import React from 'react';
import { ThemeContext } from './ThemeContext';

function Button() {
  return (
    <ThemeContext.Consumer>
      {theme => (
        <button className={theme} />
      )}
    </ThemeContext.Consumer>
  );
}


الطريقة الموصى بها باستخدام useContext

الطريقة الحديثة والمفضلة لقراءة السياق هي باستخدام useContext:

import React, { useContext } from 'react';
import { ThemeContext } from './ThemeContext';

function Button() {
  const theme = useContext(ThemeContext);
  return <button className={theme} />;
}


استيراد وتصدير السياق من ملف

يمكنك تنظيم الكود الخاص بك عن طريق استيراد وتصدير السياق من ملف منفصل:

// ThemeContext.js
import { createContext } from 'react';

const ThemeContext = createContext('light');
export default ThemeContext;


ثم يمكنك استيراده في الملفات الأخرى:

// App.js
import React, { useState } from 'react';
import ThemeContext from './ThemeContext';

function App() {
  const [theme, setTheme] = useState('light');

  return (
    <ThemeContext.Provider value={theme}>
      <Page />
    </ThemeContext.Provider>
  );
}






استخدام createContext

createContext يسمح للمكونات بتمرير المعلومات بعمق دون الحاجة إلى تمرير props بشكل صريح.

إنشاء السياق

قم باستدعاء createContext خارج أي مكونات لإنشاء سياق واحد أو أكثر.

import { createContext } from 'react';

const ThemeContext = createContext('light');
const AuthContext = createContext(null);


قراءة السياق باستخدام useContext

يمكن للمكونات قراءة السياق عن طريق تمريره إلى useContext:

import { useContext } from 'react';
import { ThemeContext, AuthContext } from './Contexts.js';

function Button() {
  const theme = useContext(ThemeContext);
  // ...
}

function Profile() {
  const currentUser = useContext(AuthContext);
  // ...
}


توفير قيم ديناميكية للسياق

السياق يكون مفيدًا لأنه يمكنك توفير قيم ديناميكية من مكوناتك:

import React, { useState } from 'react';
import { ThemeContext, AuthContext } from './Contexts.js';

function App() {
  const [theme, setTheme] = useState('dark');
  const [currentUser, setCurrentUser] = useState({ name: 'Taylor' });

  return (
    <ThemeContext.Provider value={theme}>
      <AuthContext.Provider value={currentUser}>
        <Page />
      </AuthContext.Provider>
    </ThemeContext.Provider>
  );
}


الآن، مكون Page وأي مكونات داخله، بغض النظر عن عمقها، ستتمكن من “رؤية” قيم السياق الممررة. إذا تغيرت قيم السياق الممررة، سيقوم React بإعادة تصيير المكونات التي تقرأ السياق أيضًا.



استيراد وتصدير السياق من ملف

غالبًا ما تحتاج المكونات في ملفات مختلفة إلى الوصول إلى نفس السياق. لهذا السبب، من الشائع إعلان السياقات في ملف منفصل. ثم يمكنك استخدام جملة export لجعل السياق متاحًا للملفات الأخرى:

// Contexts.js
import { createContext } from 'react';

export const ThemeContext = createContext('light');
export const AuthContext = createContext(null);


ثم يمكن للمكونات المعلنة في ملفات أخرى استخدام جملة import لقراءة أو توفير هذا السياق:

// Button.js
import { useContext } from 'react';
import { ThemeContext } from './Contexts.js';

function Button() {
  const theme = useContext(ThemeContext);
  // ...
}

// App.js
import { ThemeContext, AuthContext } from './Contexts.js';

function App() {
  // ...
  return (
    <ThemeContext.Provider value={theme}>
      <AuthContext.Provider value={currentUser}>
        <Page />
      </AuthContext.Provider>
    </ThemeContext.Provider>
  );
}


استكشاف الأخطاء وإصلاحها

لا أستطيع العثور على طريقة لتغيير قيمة السياق

الكود مثل هذا يحدد قيمة السياق الافتراضية:

const ThemeContext = createContext('light');


هذه القيمة لا تتغير أبدًا. يستخدم React هذه القيمة فقط كملاذ أخير إذا لم يتمكن من العثور على مزود مطابق أعلاه.

لتغيير السياق بمرور الوقت، أضف حالة (state) ولف المكونات في مزود سياق




المرجع :
https://react.dev/reference/react/createContext

تعليقات

إرسال تعليق

المشاركات الشائعة

ما هو JSX في React؟

-
  ما هو JSX في React؟ JSX  (JavaScript XML) هو امتداد لصياغة JavaScript يسمح لك بكتابة عناصر شبيهة بـ HTML داخل JavaScript. يتم تحويل JSX إلى استدعاءات دوال JavaScript بواسطة أدوات مثل Babel، مما يجعل كتابة واجهات المستخدم أكثر سهولة ووضوحًا. كيفية استخدام JSX إليك مثال بسيط لاستخدام JSX: const element = <h1> مرحبًا، عالم! </h1> ; في هذا المثال،   element   هو عنصر React يتم إنشاؤه باستخدام صياغة JSX. يمكن تضمين تعابير JavaScript داخل JSX باستخدام الأقواس المعقوفة   {} : const name = 'علي' ; const element = <h1> مرحبًا، {name}! </h1> ; فوائد استخدام JSX وضوح الكود : يجعل الكود أكثر وضوحًا وسهولة في القراءة، حيث يمكنك رؤية هيكلية HTML مباشرة داخل JavaScript. قوة JavaScript : يمكنك استخدام تعابير JavaScript داخل JSX، مما يمنحك مرونة كبيرة في بناء واجهات المستخدم. أخطاء أقل : يساعدك JSX على اكتشاف الأخطاء في وقت مبكر بفضل الرسائل التحذيرية المفيدة التي يوفرها. امتداد الملفات: js أو jsx؟ .js : يمكن استخدام هذا الامتداد لملفات JavaScript ال...
قراءة المزيد

مثال بسيط يوضح كيفية استخدام createContext و useContext لتمرير البيانات بين المكونات في React

-
  الخطوات الأساسية إنشاء السياق  باستخدام  createContext . توفير قيمة السياق  باستخدام  Provider . قراءة قيمة السياق  باستخدام  useContext . مثال عملي 1. إنشاء السياق أولاً، نقوم بإنشاء سياق جديد باستخدام  createContext . // ThemeContext.js import { createContext } from 'react' ; export const ThemeContext = createContext( 'light' ); 2. توفير قيمة السياق نقوم بلف المكونات في  Provider  لتوفير قيمة السياق. // App.js import React, { useState } from 'react' ; import { ThemeContext } from './ThemeContext' ; import Page from './Page' ; function App () {   const [theme, setTheme] = useState( 'dark' );   const toggleTheme = () => {     setTheme(( prevTheme ) => (prevTheme === 'dark' ? 'light' : 'dark' ));   };   return (     <ThemeContext.Provider value= {{ theme, toggleTheme }}>       <Page />     </ThemeContext.Provider>   ); } expor...
قراءة المزيد

مثال لتمرير مصفوفة عن طريق useState

-
مثال بسيط باستخدام React و useState لتمرير مصفوفة من الفواكه وعرضها في قائمة. كما سيمكن المستخدم من إضافة عناصر جديدة إلى القائمة. import React, { useState } from 'react' ; function FruitList () {   // تعريف حالة الفواكه   const [fruits, setFruits] = useState([ 'تفاح' , 'موز' , 'برتقال' ]);   const [newFruit, setNewFruit] = useState( '' );   // دالة لإضافة فاكهة جديدة إلى القائمة   const addFruit = () => {     if (newFruit.trim() !== '' ) {       setFruits([...fruits, newFruit]);       setNewFruit( '' ); // إعادة تعيين الحقل النصي     }   };   return (     <div>       <h1> قائمة الفواكه </h1>       <ul>         {fruits.map((fruit, index) => (           <li key= {index} > {fruit} </li>         ))}       </ul>       ...
قراءة المزيد

إضافة الأنماط في React

-
في React، تحدد فئة CSS باستخدام  className . تعمل هذه الطريقة بنفس طريقة خاصية  class  في HTML: <img className= "avatar" /> ثم تكتب قواعد CSS الخاصة بها في ملف CSS منفصل: /* في ملف CSS الخاص بك */ .avatar {   border-radius: 50 %; }   React لا يحدد كيفية إضافة ملفات CSS. في أبسط الحالات، يمكنك إضافة وسم   <link>   إلى HTML الخاص بك. إذا كنت تستخدم أداة بناء أو إطار عمل، فاستشر وثائقها لتتعلم كيفية إضافة ملف CSS إلى مشروعك.
قراءة المزيد

المكونات (Components) في React

-
  المكونات (Components) في React المكونات  هي اللبنات الأساسية لأي تطبيق React. يمكن اعتبارها كقطع صغيرة من واجهة المستخدم التي يمكن إعادة استخدامها وتجميعها لإنشاء واجهات مستخدم معقدة. كيفية استخدام المكونات إنشاء مكون : يمكنك إنشاء مكون كدالة أو كصف. إليك مثال لمكون كدالة: function Welcome ( props ) {   return <h1> مرحبًا، {props.name} </h1> ; } استخدام المكون : يمكنك استخدام المكون داخل مكونات أخرى: function App () {   return (     <div>       <Welcome name="علي" />       <Welcome name="فاطمة" />     </div>   ); } فوائد المكونات إعادة الاستخدام : يمكنك استخدام نفس المكون في أماكن متعددة في تطبيقك، مما يقلل من تكرار الكود. التنظيم : تقسيم واجهة المستخدم إلى مكونات صغيرة يجعل الكود أكثر تنظيماً وسهولة في الصيانة. الاختبار : يمكن اختبار كل مكون بشكل مستقل، مما يسهل اكتشاف الأخطاء وإصلاحها. الأداء : React يقوم بتحديث الأجزاء الضرورية فقط من واجهة المستخدم، مما يحسن الأداء. ا...
قراءة المزيد

ما هي Props في React؟

-
  ما هي Props؟ Props  هي اختصار لكلمة “Properties” وهي وسيلة لتمرير البيانات من مكون إلى آخر في React. تُستخدم props لتمكين المكونات من الوصول إلى بيانات مخصصة وقيم ومعلومات أخرى. كيفية استخدام Props لتمرير props إلى مكون، تقوم ببساطة بإضافتها كسمات عند استدعاء المكون. على سبيل المثال: function Greeting ( props ) {   return <h1> Hello, {props.name}! </h1> ; } function App () {   return <Greeting name= "Alice" /> ; } في هذا المثال، يتم تمرير قيمة  name  إلى مكون  Greeting ، والذي يستخدمها لعرض رسالة ترحيب مخصصة. المشكلة التي حلتها Props قبل ظهور props، كان من الصعب إعادة استخدام المكونات بنفس الطريقة. كان يجب عليك كتابة نفس الشيفرة مرارًا وتكرارًا مع تغييرات طفيفة. Props حلت هذه المشكلة عن طريق تمكين المكونات من أن تكون ديناميكية وقابلة لإعادة الاستخدام بسهولة. هل الأفضل استخدام Props أو البيانات من ملف بيانات مستقل؟ يعتمد ذلك على الحالة: استخدام Props : إذا كانت البيانات التي تحتاجها المكونات تأتي من مكون رئيسي أو تحتاج إلى أن تك...
قراءة المزيد

هيكلة المشروع في React

-
  عند إنشاء مشروع React باستخدام   create-react-app ، ستحصل على هيكلية ملفات مشابهة للتالي: my-app/ ├── node_modules/ ├── public/ │   ├── index.html │   └── ... ├── src/ │   ├── App.css │   ├── App.js │   ├── App.test.js │   ├── index.css │   ├── index.js │   ├── logo.svg │   └── ... ├── .gitignore ├── package.json ├── README.md └── ... شرح الملفات والمجلدات: node_modules/ : يحتوي على جميع الحزم والتبعيات التي تم تثبيتها بواسطة npm. public/ : يحتوي على الملفات الثابتة مثل  index.html  وأي ملفات أخرى تحتاج إلى الوصول إليها مباشرة. index.html : هذا هو الملف الرئيسي الذي يتم تحميله عند فتح التطبيق في المتصفح. لا يُنصح بتعديله إلا إذا كنت تعرف ما تفعله. src/ : يحتوي على جميع ملفات المصدر لتطبيقك. App.js : هذا هو المكون الرئيسي لتطبيقك. يمكنك تعديل هذا الملف لإضافة مكونات جديدة أو تعديل المكونات الحالية. index.js : هذا هو نقطة الدخول لتطبيقك. يقوم بربط المكونات بـ  index.html . لا يُنصح بحذف هذا الملف. App.css  و...
قراءة المزيد

الأمر npx create-react-app my-app

-
  الأمر   npx create-react-app my-app   يُستخدم لإنشاء تطبيق React جديد بسهولة وسرعة. دعني أشرح لك الخطوات والمفهوم: npx : هذه أداة تأتي مع npm (مدير حزم Node.js) بدءًا من الإصدار 5.2. تتيح لك تشغيل حزم npm دون الحاجة إلى تثبيتها عالميًا على جهازك. create-react-app : هذه حزمة تُستخدم لإنشاء تطبيقات React مع إعدادات جاهزة. توفر لك بيئة تطوير متكاملة دون الحاجة إلى إعدادات معقدة. my-app : هذا هو اسم المجلد الذي سيتم إنشاء التطبيق داخله. يمكنك اختيار أي اسم تريده. كيفية الاستخدام: افتح سطر الأوامر (Terminal). اكتب الأمر التالي واضغط Enter: npx create-react-app my-app انتظر حتى يتم إنشاء المشروع. ستلاحظ أنه تم إنشاء مجلد جديد باسم  my-app   يحتوي على جميع الملفات الضرورية لتشغيل تطبيق React. ماذا يحدث بعد ذلك؟ سيتم إنشاء هيكلية مشروع جاهزة تحتوي على ملفات مثل  index.html  و App.js  و package.json . سيتم تثبيت جميع التبعيات اللازمة مثل React وReact-DOM. يمكنك بدء تشغيل التطبيق باستخدام الأمر: cd my-app npm start لماذا يُستخدم؟ سهولة البدء : لا تحتاج إل...
قراءة المزيد

10 أمثلة على استخدام props في React

-
  1. تمرير نص كـ Prop function Greeting ( props ) {   return <h1> Hello, {props.name}! </h1> ; } // استخدام المكون <Greeting name= "Alice" /> شرح:  هنا نمرر النص “Alice” كـ  prop  إلى مكون  Greeting  ليظهر النص “Hello, Alice!”. 2. تمرير عدد كـ Prop function Age ( props ) {   return <p> You are {props.age} years old. </p> ; } // استخدام المكون <Age age={ 25 } /> شرح:  نمرر العدد 25 كـ  prop  إلى مكون  Age  ليظهر النص “You are 25 years old.”. 3. تمرير كائن كـ Prop function User ( props ) {   return <p> {props.user.name} is {props.user.age} years old. </p> ; } // استخدام المكون <User user={{ name: 'Bob' , age: 30 }} /> شرح:  نمرر كائن يحتوي على اسم وعمر المستخدم كـ  prop  إلى مكون  User . 4. تمرير مصفوفة كـ Prop function ItemList ( props ) {   return (     <ul>       {props.items.map((item, index) =>...
قراءة المزيد

تطبيق توليد لون عشوائي للصفحة في React

-
import React from 'react' ; // استيراد مكتبة React import Title from '../Title' ; // استيراد مكون Title من ملف آخر // مكون RandomColor لتغيير ألوان الخلفية عند النقر على الأزرار export default function RandomColor () {   // دالة handleClick لتغيير لون الخلفية ولون الزر الذي تم النقر عليه   function handleClick ( e ) {     console .log(getRandomColo()); // طباعة اللون العشوائي في الكونسول     let body = document .querySelector( "body" ); // الحصول على عنصر الجسم في الصفحة     body.style.background = getRandomColo(); // تعيين لون الخلفية للجسم بلون عشوائي     e.target.style.background = getRandomColo(); // تعيين لون خلفية الزر الذي تم النقر عليه بلون عشوائي   }   // دالة getRandomColo لتوليد لون عشوائي   function getRandomColo () {     let letters = '0123456789ABCDEF' ; // حروف وأرقام اللون الست عشري     let color = "#" ; // بداية الكود اللوني     for ( let i = 0 ; i < 6 ; i++) ...
قراءة المزيد