State: ذاكرة المكون

غالبًا ما تحتاج المكونات إلى تغيير ما يظهر على الشاشة نتيجة للتفاعل. الكتابة في النموذج يجب أن تحدّث حقل الإدخال، والنقر على “التالي” في عرض الصور المتتابع يجب أن يغير الصورة المعروضة، والنقر على “شراء” يجب أن يضع المنتج في سلة التسوق. تحتاج المكونات إلى “تذكر” الأشياء: قيمة الإدخال الحالية، الصورة الحالية، سلة التسوق. في React، هذا النوع من ذاكرة المكون المحددة يسمى state (حالة).

You will learn

كيفية إضافة متغير حالة باستخدام useState Hook
ما هو الزوج من القيم الذي يعيده useState Hook
كيفية إضافة أكثر من متغير حالة واحد
لماذا تسمى الحالة محلية

عندما لا يكون المتغير العادي كافيا

إليك مكونا يعرض صورة منحوتة. النقر على زر “Next” يجب أن يعرض المنحوتة التالية عن طريق تغيير index إلى 1 ثم 2 وهكذا. ومع ذلك هذا لن ينجح (يمكنك تجربته!):

import { sculptureList } from './data.js'; export default function Gallery() { let index = 0; function handleClick() { index = index + 1; } let sculpture = sculptureList[index]; return ( <> <button onClick={handleClick}> Next </button> <h2> <i>{sculpture.name} </i> by {sculpture.artist} </h2> <h3> ({index + 1} of {sculptureList.length}) </h3> <img src={sculpture.url} alt={sculpture.alt} /> <p> {sculpture.description} </p> </> ); }

معالج الحدث handleClick يحدّث متغيرًا محليًا، index. لكن شيئين يمنعان هذا التغيير من أن يكون مرئيًا:

المتغيرات المحلية لا تستمر بين عمليات التصيير. عندما يصيّر React هذا المكون للمرة الثانية، يصيّره من الصفر — لا يأخذ في الاعتبار أي تغييرات على المتغيرات المحلية.
التغييرات على المتغيرات المحلية لن تؤدي إلى تشغيل عمليات التصيير. React لا يدرك أنه بحاجة إلى تصيير المكون مرة أخرى مع البيانات الجديدة.

لتحديث مكون ببيانات جديدة، يجب أن يحدث شيئان:

الاحتفاظ بالبيانات بين عمليات التصيير.
تشغيل React لتصيير المكون بالبيانات الجديدة (إعادة التصيير).

الـ useState Hook يوفر هذين الشيئين:

متغير حالة للاحتفاظ بالبيانات بين عمليات التصيير.
دالة محدّث الحالة لتحديث المتغير وتشغيل React لتصيير المكون مرة أخرى.

إضافة متغير حالة

لإضافة متغير حالة، استورد useState من React في أعلى الملف:

import { useState } from 'react';

ثم، استبدل هذا السطر:

let index = 0;

بـ

const [index, setIndex] = useState(0);

index هو متغير حالة و setIndex هي دالة المُحدّث.

بناء [ و ] هنا يسمى array destructuring ويتيح لك قراءة القيم من array. الـ array الذي يرجعه useState يحتوي دائمًا على عنصرين بالضبط.

هذه هي كيفية عملهما معًا في handleClick:

function handleClick() {
  setIndex(index + 1);
}

الآن النقر على زر “Next” يبدّل المنحوتة الحالية:

import { useState } from 'react'; import { sculptureList } from './data.js'; export default function Gallery() { const [index, setIndex] = useState(0); function handleClick() { setIndex(index + 1); } let sculpture = sculptureList[index]; return ( <> <button onClick={handleClick}> Next </button> <h2> <i>{sculpture.name} </i> by {sculpture.artist} </h2> <h3> ({index + 1} of {sculptureList.length}) </h3> <img src={sculpture.url} alt={sculpture.alt} /> <p> {sculpture.description} </p> </> ); }

Meet your first Hook

In React, useState, as well as any other function starting with “use”, is called a Hook.

Hooks are special functions that are only available while React is rendering (which we’ll get into in more detail on the next page). They let you “hook into” different React features.

State is just one of those features, but you will meet the other Hooks later.

مأزق

Hooks—functions starting with use—can only be called at the top level of your components or your own Hooks. You can’t call Hooks inside conditions, loops, or other nested functions. Hooks are functions, but it’s helpful to think of them as unconditional declarations about your component’s needs. You “use” React features at the top of your component similar to how you “import” modules at the top of your file.

Anatomy of `useState`

When you call useState, you are telling React that you want this component to remember something:

const [index, setIndex] = useState(0);

In this case, you want React to remember index.

ملاحظة

The convention is to name this pair like const [something, setSomething]. You could name it anything you like, but conventions make things easier to understand across projects.

The only argument to useState is the initial value of your state variable. In this example, the index’s initial value is set to 0 with useState(0).

Every time your component renders, useState gives you an array containing two values:

The state variable (index) with the value you stored.
The state setter function (setIndex) which can update the state variable and trigger React to render the component again.

Here’s how that happens in action:

const [index, setIndex] = useState(0);

Your component renders the first time. Because you passed 0 to useState as the initial value for index, it will return [0, setIndex]. React remembers 0 is the latest state value.
You update the state. When a user clicks the button, it calls setIndex(index + 1). index is 0, so it’s setIndex(1). This tells React to remember index is 1 now and triggers another render.
Your component’s second render. React still sees useState(0), but because React remembers that you set index to 1, it returns [1, setIndex] instead.
وهكذا!

إعطاء مكون متغيرات حالة متعددة

يمكنك الحصول على أي عدد من متغيرات الحالة من أي نوع تريده في مكون واحد. هذا المكون لديه متغيرا حالة، رقم index و boolean showMore الذي يتم تبديله عند النقر على “Show details”:

import { useState } from 'react'; import { sculptureList } from './data.js'; export default function Gallery() { const [index, setIndex] = useState(0); const [showMore, setShowMore] = useState(false); function handleNextClick() { setIndex(index + 1); } function handleMoreClick() { setShowMore(!showMore); } let sculpture = sculptureList[index]; return ( <> <button onClick={handleNextClick}> Next </button> <h2> <i>{sculpture.name} </i> by {sculpture.artist} </h2> <h3> ({index + 1} of {sculptureList.length}) </h3> <button onClick={handleMoreClick}> {showMore ? 'Hide' : 'Show'} details </button> {showMore && <p>{sculpture.description}</p>} <img src={sculpture.url} alt={sculpture.alt} /> </> ); }

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

غوص عميق

كيف يعرف React أي حالة يعيد؟

ربما لاحظت أن استدعاء useState لا يتلقى أي معلومات حول أي متغير حالة يشير إليه. لا يوجد “معرّف” يتم تمريره إلى useState، فكيف يعرف أي من متغيرات الحالة يجب إرجاعه؟ هل يعتمد على بعض السحر مثل تحليل دوالك؟ الجواب لا.

بدلاً من ذلك، لتمكين بنيتهم الموجزة، تعتمد الـ Hooks على ترتيب استدعاء مستقر في كل عرض لنفس المكوّن. هذا يعمل بشكل جيد في الممارسة لأنه إذا اتبعت القاعدة أعلاه (“استدع الـ Hooks فقط في المستوى الأعلى”)، سيتم استدعاء الـ Hooks دائمًا بنفس الترتيب. بالإضافة إلى ذلك، إضافة linter تلتقط معظم الأخطاء.

داخليًا، يحتفظ React بمصفوفة من أزواج الحالة لكل مكوّن. كما يحتفظ بفهرس الزوج الحالي، والذي يتم تعيينه إلى 0 قبل العرض. في كل مرة تستدعي فيها useState، يعطيك React زوج الحالة التالي ويزيد الفهرس. يمكنك قراءة المزيد عن هذه الآلية في React Hooks: Not Magic, Just Arrays.

هذا المثال لا يستخدم React لكنه يعطيك فكرة عن كيفية عمل useState داخليًا:

ليس عليك فهم هذا لاستخدام React، لكن قد تجد هذا نموذجًا ذهنيًا مفيدًا.

الحالة معزولة وخاصة

الحالة محلية لنسخة المكون على الشاشة. بمعنى آخر، إذا صيّرت نفس المكون مرتين، فإن كل نسخة ستكون لديها حالة معزولة تمامًا! تغيير واحدة منها لن يؤثر على الأخرى.

في هذا المثال، يتم تصيير مكون Gallery من قبل مرتين بدون تغييرات على منطقه. جرب النقر على الأزرار داخل كل من المعارض. لاحظ أن حالتهما مستقلة:

import Gallery from './Gallery.js'; export default function Page() { return ( <div className="Page"> <Gallery /> <Gallery /> </div> ); }

هذا ما يجعل الحالة مختلفة عن المتغيرات العادية التي قد تعلن عنها في أعلى الوحدة النمطية (module) الخاصة بك. الحالة ليست مرتبطة باستدعاء دالة معينة أو مكان في الكود، بل هي “محلية” للمكان المحدد على الشاشة. لقد عرضت مكوّنين <Gallery />، لذلك يتم تخزين حالتهما بشكل منفصل.

لاحظ أيضًا كيف أن مكوّن Page لا “يعرف” أي شيء عن حالة Gallery أو حتى ما إذا كان لديه أي حالة. على عكس الـ props، الحالة خاصة تمامًا بالمكوّن الذي يعلن عنها. المكوّن الأب لا يمكنه تغييرها. هذا يتيح لك إضافة حالة إلى أي مكوّن أو إزالتها دون التأثير على باقي المكوّنات.

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

خلاصة

استخدم متغير حالة عندما يحتاج المكوّن إلى “تذكر” بعض المعلومات بين عمليات العرض (renders).
يتم الإعلان عن متغيرات الحالة بواسطة استدعاء الـ Hook المسمى useState.
الـ Hooks هي دوال خاصة تبدأ بكلمة use. تتيح لك “الارتباط” بميزات React مثل الحالة.
قد تذكرك الـ Hooks بعمليات الاستيراد: يجب استدعاؤها بشكل غير مشروط. استدعاء الـ Hooks، بما في ذلك useState، صالح فقط في المستوى الأعلى من مكوّن أو Hook آخر.
الـ Hook المسمى useState يُرجع زوجًا من القيم: الحالة الحالية والدالة لتحديثها.
يمكنك امتلاك أكثر من متغير حالة واحد. داخليًا، يطابقها React بناءً على ترتيبها.
الحالة خاصة بالمكوّن. إذا عرضته في مكانين، تحصل كل نسخة على حالتها الخاصة.

جرّب بعض التحديات

تحدي 1 من 4:
أكمل المعرض

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

بعد إصلاح الانهيار، أضف زر “Previous” يعرض المنحوتة السابقة. يجب ألا ينهار عند المنحوتة الأولى.

السابقالاستجابة للأحداث (Events)

التاليالتصيير والالتزام (Render and Commit)

تعلم React

إضافة التفاعلية (Interactivity)

State: ذاكرة المكون

You will learn

كيفية إضافة متغير حالة باستخدام useState Hook
ما هو الزوج من القيم الذي يعيده useState Hook
كيفية إضافة أكثر من متغير حالة واحد
لماذا تسمى الحالة محلية

عندما لا يكون المتغير العادي كافيا

Fork

import { sculptureList } from './data.js';

export default function Gallery() {
  let index = 0;

  function handleClick() {
    index = index + 1;
  }

  let sculpture = sculptureList[index];
  return (
    <>
      <button onClick={handleClick}>
        Next
      </button>
      <h2>
        <i>{sculpture.name} </i> 
        by {sculpture.artist}
      </h2>
      <h3>  
        ({index + 1} of {sculptureList.length})
      </h3>
      <img 
        src={sculpture.url} 
        alt={sculpture.alt}
      />
      <p>
        {sculpture.description}
      </p>
    </>
  );
}

معالج الحدث handleClick يحدّث متغيرًا محليًا، index. لكن شيئين يمنعان هذا التغيير من أن يكون مرئيًا:

المتغيرات المحلية لا تستمر بين عمليات التصيير. عندما يصيّر React هذا المكون للمرة الثانية، يصيّره من الصفر — لا يأخذ في الاعتبار أي تغييرات على المتغيرات المحلية.
التغييرات على المتغيرات المحلية لن تؤدي إلى تشغيل عمليات التصيير. React لا يدرك أنه بحاجة إلى تصيير المكون مرة أخرى مع البيانات الجديدة.

لتحديث مكون ببيانات جديدة، يجب أن يحدث شيئان:

الاحتفاظ بالبيانات بين عمليات التصيير.
تشغيل React لتصيير المكون بالبيانات الجديدة (إعادة التصيير).

الـ useState Hook يوفر هذين الشيئين:

متغير حالة للاحتفاظ بالبيانات بين عمليات التصيير.
دالة محدّث الحالة لتحديث المتغير وتشغيل React لتصيير المكون مرة أخرى.

إضافة متغير حالة

لإضافة متغير حالة، استورد useState من React في أعلى الملف:

import { useState } from 'react';

import { useState } from 'react';

ثم، استبدل هذا السطر:

let index = 0;

let index = 0;

بـ

const [index, setIndex] = useState(0);

const [index, setIndex] = useState(0);

index هو متغير حالة و setIndex هي دالة المُحدّث.

بناء [ و ] هنا يسمى array destructuring ويتيح لك قراءة القيم من array. الـ array الذي يرجعه useState يحتوي دائمًا على عنصرين بالضبط.

هذه هي كيفية عملهما معًا في handleClick:

function handleClick() {
  setIndex(index + 1);
}

function handleClick() {
  setIndex(index + 1);
}

الآن النقر على زر “Next” يبدّل المنحوتة الحالية:

Fork

import { useState } from 'react';
import { sculptureList } from './data.js';

export default function Gallery() {
  const [index, setIndex] = useState(0);

  function handleClick() {
    setIndex(index + 1);
  }

  let sculpture = sculptureList[index];
  return (
    <>
      <button onClick={handleClick}>
        Next
      </button>
      <h2>
        <i>{sculpture.name} </i> 
        by {sculpture.artist}
      </h2>
      <h3>  
        ({index + 1} of {sculptureList.length})
      </h3>
      <img 
        src={sculpture.url} 
        alt={sculpture.alt}
      />
      <p>
        {sculpture.description}
      </p>
    </>
  );
}

Meet your first Hook

In React, useState, as well as any other function starting with “use”, is called a Hook.

Hooks are special functions that are only available while React is rendering (which we’ll get into in more detail on the next page). They let you “hook into” different React features.

State is just one of those features, but you will meet the other Hooks later.

مأزق

Anatomy of `useState`

When you call useState, you are telling React that you want this component to remember something:

const [index, setIndex] = useState(0);

const [index, setIndex] = useState(0);

In this case, you want React to remember index.

ملاحظة

The convention is to name this pair like const [something, setSomething]. You could name it anything you like, but conventions make things easier to understand across projects.

The only argument to useState is the initial value of your state variable. In this example, the index’s initial value is set to 0 with useState(0).

Every time your component renders, useState gives you an array containing two values:

The state variable (index) with the value you stored.
The state setter function (setIndex) which can update the state variable and trigger React to render the component again.

Here’s how that happens in action:

const [index, setIndex] = useState(0);

const [index, setIndex] = useState(0);

Your component renders the first time. Because you passed 0 to useState as the initial value for index, it will return [0, setIndex]. React remembers 0 is the latest state value.
You update the state. When a user clicks the button, it calls setIndex(index + 1). index is 0, so it’s setIndex(1). This tells React to remember index is 1 now and triggers another render.
Your component’s second render. React still sees useState(0), but because React remembers that you set index to 1, it returns [1, setIndex] instead.
وهكذا!

إعطاء مكون متغيرات حالة متعددة

Fork

import { useState } from 'react';
import { sculptureList } from './data.js';

export default function Gallery() {
  const [index, setIndex] = useState(0);
  const [showMore, setShowMore] = useState(false);

  function handleNextClick() {
    setIndex(index + 1);
  }

  function handleMoreClick() {
    setShowMore(!showMore);
  }

  let sculpture = sculptureList[index];
  return (
    <>
      <button onClick={handleNextClick}>
        Next
      </button>
      <h2>
        <i>{sculpture.name} </i> 
        by {sculpture.artist}
      </h2>
      <h3>  
        ({index + 1} of {sculptureList.length})
      </h3>
      <button onClick={handleMoreClick}>
        {showMore ? 'Hide' : 'Show'} details
      </button>
      {showMore && <p>{sculpture.description}</p>}
      <img 
        src={sculpture.url} 
        alt={sculpture.alt}
      />
    </>
  );
}

غوص عميق

كيف يعرف React أي حالة يعيد؟

هذا المثال لا يستخدم React لكنه يعطيك فكرة عن كيفية عمل useState داخليًا:

Fork

let componentHooks = [];
let currentHookIndex = 0;

// How useState works inside React (simplified).
function useState(initialState) {
  let pair = componentHooks[currentHookIndex];
  if (pair) {
    // This is not the first render,
    // so the state pair already exists.
    // Return it and prepare for next Hook call.
    currentHookIndex++;
    return pair;
  }

  // This is the first time we're rendering,
  // so create a state pair and store it.
  pair = [initialState, setState];

  function setState(nextState) {
    // When the user requests a state change,
    // put the new value into the pair.
    pair[0] = nextState;
    updateDOM();
  }

  // Store the pair for future renders
  // and prepare for the next Hook call.
  componentHooks[currentHookIndex] = pair;
  currentHookIndex++;
  return pair;
}

function Gallery() {
  // Each useState() call will get the next pair.
  const [index, setIndex] = useState(0);
  const [showMore, setShowMore] = useState(false);

  function handleNextClick() {
    setIndex(index + 1);
  }

  function handleMoreClick() {
    setShowMore(!showMore);
  }

  let sculpture = sculptureList[index];
  // This example doesn't use React, so
  // return an output object instead of JSX.
  return {
    onNextClick: handleNextClick,
    onMoreClick: handleMoreClick,
    header: `${sculpture.name} by ${sculpture.artist}`,
    counter: `${index + 1} of ${sculptureList.length}`,
    more: `${showMore ? 'Hide' : 'Show'} details`,
    description: showMore ? sculpture.description : null,
    imageSrc: sculpture.url,
    imageAlt: sculpture.alt
  };
}

function updateDOM() {
  // Reset the current Hook index
  // before rendering the component.
  currentHookIndex = 0;
  let output = Gallery();

  // Update the DOM to match the output.
  // This is the part React does for you.
  nextButton.onclick = output.onNextClick;
  header.textContent = output.header;
  moreButton.onclick = output.onMoreClick;
  moreButton.textContent = output.more;
  image.src = output.imageSrc;
  image.alt = output.imageAlt;
  if (output.description !== null) {
    description.textContent = output.description;
    description.style.display = '';
  } else {
    description.style.display = 'none';
  }
}

let nextButton = document.getElementById('nextButton');
let header = document.getElementById('header');
let moreButton = document.getElementById('moreButton');
let description = document.getElementById('description');
let image = document.getElementById('image');
let sculptureList = [{
  name: 'Homenaje a la Neurocirugía',
  artist: 'Marta Colvin Andrade',
  description: 'Although Colvin is predominantly known for abstract themes that allude to pre-Hispanic symbols, this gigantic sculpture, an homage to neurosurgery, is one of her most recognizable public art pieces.',
  url: 'https://i.imgur.com/Mx7dA2Y.jpg',
  alt: 'A bronze statue of two crossed hands delicately holding a human brain in their fingertips.'  
}, {
  name: 'Floralis Genérica',
  artist: 'Eduardo Catalano',
  description: 'This enormous (75 ft. or 23m) silver flower is located in Buenos Aires. It is designed to move, closing its petals in the evening or when strong winds blow and opening them in the morning.',
  url: 'https://i.imgur.com/ZF6s192m.jpg',
  alt: 'A gigantic metallic flower sculpture with reflective mirror-like petals and strong stamens.'
}, {
  name: 'Eternal Presence',
  artist: 'John Woodrow Wilson',
  description: 'Wilson was known for his preoccupation with equality, social justice, as well as the essential and spiritual qualities of humankind. This massive (7ft. or 2,13m) bronze represents what he described as "a symbolic Black presence infused with a sense of universal humanity."',
  url: 'https://i.imgur.com/aTtVpES.jpg',
  alt: 'The sculpture depicting a human head seems ever-present and solemn. It radiates calm and serenity.'
}, {
  name: 'Moai',
  artist: 'Unknown Artist',
  description: 'Located on the Easter Island, there are 1,000 moai, or extant monumental statues, created by the early Rapa Nui people, which some believe represented deified ancestors.',
  url: 'https://i.imgur.com/RCwLEoQm.jpg',
  alt: 'Three monumental stone busts with the heads that are disproportionately large with somber faces.'
}, {
  name: 'Blue Nana',
  artist: 'Niki de Saint Phalle',
  description: 'The Nanas are triumphant creatures, symbols of femininity and maternity. Initially, Saint Phalle used fabric and found objects for the Nanas, and later on introduced polyester to achieve a more vibrant effect.',
  url: 'https://i.imgur.com/Sd1AgUOm.jpg',
  alt: 'A large mosaic sculpture of a whimsical dancing female figure in a colorful costume emanating joy.'
}, {
  name: 'Ultimate Form',
  artist: 'Barbara Hepworth',
  description: 'This abstract bronze sculpture is a part of The Family of Man series located at Yorkshire Sculpture Park. Hepworth chose not to create literal representations of the world but developed abstract forms inspired by people and landscapes.',
  url: 'https://i.imgur.com/2heNQDcm.jpg',
  alt: 'A tall sculpture made of three elements stacked on each other reminding of a human figure.'
}, {
  name: 'Cavaliere',
  artist: 'Lamidi Olonade Fakeye',
  description: "Descended from four generations of woodcarvers, Fakeye's work blended traditional and contemporary Yoruba themes.",
  url: 'https://i.imgur.com/wIdGuZwm.png',
  alt: 'An intricate wood sculpture of a warrior with a focused face on a horse adorned with patterns.'
}, {
  name: 'Big Bellies',
  artist: 'Alina Szapocznikow',
  description: "Szapocznikow is known for her sculptures of the fragmented body as a metaphor for the fragility and impermanence of youth and beauty. This sculpture depicts two very realistic large bellies stacked on top of each other, each around five feet (1,5m) tall.",
  url: 'https://i.imgur.com/AlHTAdDm.jpg',
  alt: 'The sculpture reminds a cascade of folds, quite different from bellies in classical sculptures.'
}, {
  name: 'Terracotta Army',
  artist: 'Unknown Artist',
  description: 'The Terracotta Army is a collection of terracotta sculptures depicting the armies of Qin Shi Huang, the first Emperor of China. The army consisted of more than 8,000 soldiers, 130 chariots with 520 horses, and 150 cavalry horses.',
  url: 'https://i.imgur.com/HMFmH6m.jpg',
  alt: '12 terracotta sculptures of solemn warriors, each with a unique facial expression and armor.'
}, {
  name: 'Lunar Landscape',
  artist: 'Louise Nevelson',
  description: 'Nevelson was known for scavenging objects from New York City debris, which she would later assemble into monumental constructions. In this one, she used disparate parts like a bedpost, juggling pin, and seat fragment, nailing and gluing them into boxes that reflect the influence of Cubism’s geometric abstraction of space and form.',
  url: 'https://i.imgur.com/rN7hY6om.jpg',
  alt: 'A black matte sculpture where the individual elements are initially indistinguishable.'
}, {
  name: 'Aureole',
  artist: 'Ranjani Shettar',
  description: 'Shettar merges the traditional and the modern, the natural and the industrial. Her art focuses on the relationship between man and nature. Her work was described as compelling both abstractly and figuratively, gravity defying, and a "fine synthesis of unlikely materials."',
  url: 'https://i.imgur.com/okTpbHhm.jpg',
  alt: 'A pale wire-like sculpture mounted on concrete wall and descending on the floor. It appears light.'
}, {
  name: 'Hippos',
  artist: 'Taipei Zoo',
  description: 'The Taipei Zoo commissioned a Hippo Square featuring submerged hippos at play.',
  url: 'https://i.imgur.com/6o5Vuyu.jpg',
  alt: 'A group of bronze hippo sculptures emerging from the sett sidewalk as if they were swimming.'
}];

// Make UI match the initial state.
updateDOM();

ليس عليك فهم هذا لاستخدام React، لكن قد تجد هذا نموذجًا ذهنيًا مفيدًا.

الحالة معزولة وخاصة

Fork

import Gallery from './Gallery.js';

export default function Page() {
  return (
    <div className="Page">
      <Gallery />
      <Gallery />
    </div>
  );
}

import Gallery from './Gallery.js'; export default function Page() { return ( <div className="Page"> <Gallery /> <Gallery /> </div> ); }

خلاصة

استخدم متغير حالة عندما يحتاج المكوّن إلى “تذكر” بعض المعلومات بين عمليات العرض (renders).
يتم الإعلان عن متغيرات الحالة بواسطة استدعاء الـ Hook المسمى useState.
الـ Hooks هي دوال خاصة تبدأ بكلمة use. تتيح لك “الارتباط” بميزات React مثل الحالة.
قد تذكرك الـ Hooks بعمليات الاستيراد: يجب استدعاؤها بشكل غير مشروط. استدعاء الـ Hooks، بما في ذلك useState، صالح فقط في المستوى الأعلى من مكوّن أو Hook آخر.
الـ Hook المسمى useState يُرجع زوجًا من القيم: الحالة الحالية والدالة لتحديثها.
يمكنك امتلاك أكثر من متغير حالة واحد. داخليًا، يطابقها React بناءً على ترتيبها.
الحالة خاصة بالمكوّن. إذا عرضته في مكانين، تحصل كل نسخة على حالتها الخاصة.

جرّب بعض التحديات

تحدي 1 من 4:
أكمل المعرض

بعد إصلاح الانهيار، أضف زر “Previous” يعرض المنحوتة السابقة. يجب ألا ينهار عند المنحوتة الأولى.

Fork

import { useState } from 'react';
import { sculptureList } from './data.js';

export default function Gallery() {
  const [index, setIndex] = useState(0);
  const [showMore, setShowMore] = useState(false);

  function handleNextClick() {
    setIndex(index + 1);
  }

  function handleMoreClick() {
    setShowMore(!showMore);
  }

  let sculpture = sculptureList[index];
  return (
    <>
      <button onClick={handleNextClick}>
        Next
      </button>
      <h2>
        <i>{sculpture.name} </i> 
        by {sculpture.artist}
      </h2>
      <h3>  
        ({index + 1} of {sculptureList.length})
      </h3>
      <button onClick={handleMoreClick}>
        {showMore ? 'Hide' : 'Show'} details
      </button>
      {showMore && <p>{sculpture.description}</p>}
      <img 
        src={sculpture.url} 
        alt={sculpture.alt}
      />
    </>
  );
}

السابقالاستجابة للأحداث (Events)

التاليالتصيير والالتزام (Render and Commit)

State: ذاكرة المكون

You will learn

عندما لا يكون المتغير العادي كافيا

إضافة متغير حالة

Meet your first Hook

مأزق

Anatomy of useState

ملاحظة

إعطاء مكون متغيرات حالة متعددة

غوص عميق

كيف يعرف React أي حالة يعيد؟

الحالة معزولة وخاصة

خلاصة

جرّب بعض التحديات

تحدي 1 من 4: أكمل المعرض

البدأ

تعلم React

State: ذاكرة المكون

You will learn

عندما لا يكون المتغير العادي كافيا

إضافة متغير حالة

Meet your first Hook

مأزق

Anatomy of useState

ملاحظة

إعطاء مكون متغيرات حالة متعددة

غوص عميق

كيف يعرف React أي حالة يعيد؟

الحالة معزولة وخاصة

خلاصة

جرّب بعض التحديات

تحدي 1 من 4: أكمل المعرض

Anatomy of `useState`

تحدي 1 من 4:
أكمل المعرض

Anatomy of `useState`

تحدي 1 من 4:
أكمل المعرض