Learn React
Adding Interactivity

State: حافظه ی یک کامپوننت

کامپوننتها اغلب نیاز دارند که به خاطر تعاملات، آنچه در صفحه نمایش داده می‌شود را تغییر دهند. تایپ کردن در فرم باید مقدار ورودی را به‌روزرسانی کند، کلیک بر روی “بعدی” در گالری تصاویر باید تصویر نمایش داده شده را تغییر دهد، کلیک بر روی “خرید” باید محصولی را به سبد خرید اضافه کند. کامپوننت ها نیاز به “یادآوری” چیزها دارند: مقدار ورودی فعلی، تصویر فعلی، سبد خرید. در React، این نوع حافظهٔ مختص به جزئیات کامپوننت به عنوان وضعیت شناخته می‌شود.

You will learn

چگونه متغیر وضعیتی (state) را با استفاده از هوک ها (Hook) اضافه کنیم؟* useState چه جفت مقداری (values) گوی (Hook) useState برمی‌گرداند؟* چگونه بیش از یک متغیر وضعیتی (state) اضافه کنیم؟* چرا وضعیت (state) به عنوان محلی (local) نامیده می‌شود؟*

When a regular variable isn’t enough

اینجا یک کامپوننت است که یک تصویر مجسمه را نمایش می‌دهد. با کلیک بر روی دکمه “بعدی” باید مجسمه‌ی بعدی را با تغییر دادن مقدار 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 به‌روز می‌کند. اما دو مورد مانع از دیده‌شدن این تغییر می‌شوند:

  1. Local variables don’t persist between renders. متغیرهای محلی بین رندرها ثابت نمی‌مانند. وقتی ری‌اکت این- کامپوننت را بار دیگر رندر می‌کند، آن را از ابتدا رندر می‌کند، و هیچ تغییری در متغیرهای محلی را در نظر نمی‌گیرد.

  2. Changes to local variables won’t trigger renders. تغییرات در متغیرهای محلی رندرها را فراخوانی نمی‌کنند-.ری اکت درک نمی‌کند که نیاز به دوباره رندر کردن کامپوننت با داده‌های جدید دارد. برای به‌روز‌رسانی یک کامپوننت با داده‌های جدید، دو مورد نیاز است که اتفاق بیافت

  3. Retain داده‌ها را حفظ کنید تا بین رندرها باقی بمانند.

  4. Triggerبه React علامت بزنید تا کامپوننت را با داده‌های جدید رندر کند (دوباره رندر کند). گوی (Hook) useState این دو ویژگی را ارائه می‌دهد:

  5. A state variable متغیر وضعیت برای حفظ داده‌ها بین رندرها.

  6. A state setter function تابع تنظیم‌کننده وضعیت برای به‌روزرسانی متغیر و ایجاد علامتی برای React تا کامپوننت را مجدداً رندر کند.

useState

Adding a state variable

برای اضافه کردن متغیرهای استیت این عبارت را در بالای فایل ری اکت خود اضافه کنید: import useState

import { useState } from 'react';

Then, replace this line:

let index = 0;

with

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

index is a state variable and setIndex is the setter function.

The [ and ] syntax here is called array destructuring and it lets you read values from an array. The array returned by useState always has exactly two items.

This is how they work together in handleClick:

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

Now clicking the “Next” button switches the current sculpture:

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 یا قلاب- توابع خاصی هستند که تنها زمانی در دسترس هستند که ری اکت درحال رندر است! rendering (which we’ll get into in more detail on the next page). They let you “hook into” different React features.

استیت فقط یکی از انواع هوک یا قلاب است. (به ویژگی های اصلی ری اکت چنگ میزند)

Pitfall

Hooks—functions starting with use—can only be called at the top level of your components or your own Hooks.

شما نمیتوانید هوکها را داخل شرط-حلقه- یا سایر توابع پیچیده فراخوانی کنید. هوک ها هم تابع هستند اما این اصلا به فهم شما کمک نمیکند که فکر کنید: کامپوننت های شما نیاز به تعریفی پیچیده و بدون شرط دارند. شما ویژگی های ری اکت را در بالای کامپوننت خود -استفاده- . میکنید دقیقا مثل استفاده از ماجول ها در فایل.

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.

Note

معمولاً عرف این است که این زوج را به صورت const [چیزی، تنظیمچیزی] نام‌گذاری کنید. البته شما می‌توانید به آن‌ها هر نامی که دلتان می‌خواهد بدهید، اما رعایت معمول‌ها باعث می‌شود که در پروژه‌های مختلف بهتر فهمیده شوند. const [something, setSomething]

تنها آرگومان مورد نیاز برای useState، مقدار اولیه متغیر وضعیت شماست. در این مثال، مقدار اولیه اندیس به 0 تنظیم می‌شود با استفاده از useState(0). هر بار که کامپوننت شما رندر می‌شود، useState یک آرایه ارائه می‌دهد که دو مقدار را شامل می‌شود:

  1. The state variable (index) with the value you stored. متغیر وضعیت (اندیس) با مقدار ذخیره شده.
  2. The state setter function (setIndex) which can update the state variable and trigger React to render the component again. تابع تنظیم‌کننده وضعیت (تنظیماندیس) که می‌تواند متغیر وضعیت را به‌روز کند و باعث می‌شود React مجدداً کامپوننت را رندر کند. در زیر نحوه عملکرد آن آمده است:

Here’s how that happens in action:

const [index, setIndex] = useState(0);
  1. Your component renders the first time. اولین باری که کامپوننت شما رندر می‌شود. از آنجا که عدد 0 را به عنوان مقدار اولیه برای index به useState پاس داده‌اید، آن تابع [0، setIndex] را باز می‌گرداند. React به یاد می‌آورد که 0 آخرین مقدار وضعیت است.
  2. You update the state. شما وضعیت را به‌روز می‌کنید. وقتی کاربر بر روی دکمه کلیک می‌کند، setIndex(index + 1) فراخوانی می‌شود. index برابر با 0 است، بنابراین این به معنای setIndex(1) است. این اقدام باعث می‌شود React به یاد داشته باشد که حالا مقدار index برابر با 1 است و یک بار دیگر رندر شود.
  3. Your component’s second render. دومین رندر کامپوننت شما. هنوز React می‌بیند که شما از useState(0) استفاده کرده‌اید، اما به دلیل اینکه React به یاد دارد که شما index را برابر با 1 قرار داده‌اید، به جای آن [1، setIndex] را برمی‌گرداند.
  4. And so on!

Giving a component multiple state variables

شما می‌توانید تعداد دلخواهی از متغیرهای وضعیت با انواع مختلف را در یک کامپوننت داشته باشید. این کامپوننت دارای دو متغیر وضعیت است، یک عدد به نام ایندکس و یک بولین به نام نمایش_بیشتر که با کلیک بر روی “نمایش جزئیات” تغییر وضعیت می‌یابد: showMore

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}
      />
    </>
  );
}

It is a good idea to have multiple state variables if their state is unrelated, like index and showMore in this example. But if you find that you often change two state variables together, it might be easier to combine them into one. For example, if you have a form with many fields, it’s more convenient to have a single state variable that holds an object than state variable per field. Read Choosing the State Structure for more tips.

Deep Dive

How does React know which state to return?

شاید متوجه شده باشید که فراخوانی useState هیچ اطلاعاتی درباره کدام متغیر وضعیت به آن ارجاع داده می‌شود، دریافت نمی‌کند. هیچ “شناسه”‌ای که به useState منتقل شود وجود ندارد، پس چگونه می‌داند کدام یک از متغیرهای استیت را برگرداند؟ آیا بر اساس یک جادویی مانند تجزیه و تحلیل توابع عمل می‌کند؟ پاسخ نه است.

بدلاً از آن، برای فعال کردن دستور زبان مختصر آن‌ها، هوک‌ها بر اعتماد به ترتیب فراخوانی پایدار در هر بار رندر کامپوننت یکسان تکیه می‌کنند. این در عمل به خوبی کار می‌کند زیرا اگر قانون فوق را رعایت کنید (“تنها در سطح بالایی دستورهای هوک را فراخوانی کنید”)، هوک‌ها همیشه به همان ترتیب فراخوانی می‌شوند. علاوه بر این، یک افزونه لینتر اکثر اشتباهات را گرفتار می‌کند. در داخل، React یک آرایه از زوج‌های استیت برای هر کامپوننت نگه می‌دارد. همچنین شاخص زوج فعلی را که قبل از رندر شدن به 0 تنظیم شده است، حفظ می‌کند. هر بار که useState را فراخوانی می‌کنید، React زوج وضعیت بعدی را به شما ارائه می‌دهد و شاخص را افزایش می‌دهد. می‌توانید بیشتر در مورد این مکانیزم در React Hooks: Not Magic, Just Arrays. مطالعه کنید.

React Hooks: Not Magic, Just Arrays.

This example doesn’t use React but it gives you an idea of how useState works internally:

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();

You don’t have to understand it to use React, but you might find this a helpful mental model.

State is isolated and private

استیت محدود به یک نمونه از کامپوننت در صفحه است. به عبارت دیگر، اگر دو بار همان کامپوننت را رندر کنید، هر نسخه دارای استیت کاملاً جداگانه‌ای خواهد بود! تغییر یکی از آن‌ها تأثیری بر روی دیگری نخواهد داشت.

در این مثال، کامپوننت گالری که قبلاً ارائه شده بود، دو بار با هیچ تغییری در منطق خود رندر می‌شود. سعی کنید روی دکمه‌های درون هر یک از گالری‌ها کلیک کنید. توجه داشته باشید که استیت آن‌ها مستقل است:

import Gallery from './Gallery.js';

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

این ویژگی باعث می‌شود که وضعیت از متغیرهای معمولی که ممکن است در بالای ماژول‌تان تعریف کنید، متفاوت باشد. وضعیت به یک فراخوانی خاص تابع یا یک محل خاص در کد مرتبط نیست، بلکه به مکان مشخصی در صفحه مرتبط می‌شود. شما دو مولفه <گالری /> را رندر کرده‌اید، بنابراین وضعیت آن‌ها جداگانه ذخیره می‌شود.

<Gallery /> همچنین توجه کنید که کامپوننت صفحه هیچ اطلاعاتی در مورد وضعیت گالری ندارد و حتی نمی‌داند که وضعیتی دارد یا نه. به عکس از پراپ‌ها، وضعیت کاملاً به کامپوننتی که آن را تعریف می‌کند، خصوصیت دارد. کامپوننت والد نمی‌تواند آن را تغییر دهد. این به شما امکان می‌دهد که به هر کامپوننتی وضعیت اضافه یا آن را حذف کنید بدون اینکه بر روی سایر کامپوننت‌ها تأثیر بگذارید.

Unlike props, state is fully private to the component declaring it. اگر می‌خواستید هر دو گالری وضعیت‌های خود را همگام نگه دارند، راه درست در React این است که از کامپوننت‌های فرزند وضعیت را حذف کنید و آن را به نزدیک‌ترین والد مشترک آنها اضافه کنید. صفحات بعدی به تمرکز بر روی سازماندهی وضعیت یک کامپوننت تکی اختصاص دارند، اما ما به این موضوع در (/learn/sharing-state-between-components باز خواهیم گشت.

Recap

نکات مهم:


  • از یک متغیر وضعیت استفاده کنید وقتی که یک کامپوننت نیاز دارد که بین رندرها به یک برخی از اطلاعات “یادآوری” کند.
  • متغیرهای وضعیت با فراخوانی Hook useState اعلام می‌شوند.
  • Hook ها تابع‌های ویژه‌ای هستند که با use آغاز می‌شوند. آنها به شما اجازه می‌دهند تا به ویژگی‌های React مانند وضعیت متصل شوید.
  • Hook ها ممکن است به شما یادآوری واردات‌ها کنند: آنها باید بدون شرط فراخوانی شوند. فراخوانی Hook ها، از جمله useState، تنها در سطح بالایی یک کامپوننت یا یک Hook دیگر معتبر است.
  • Hook useState یک زوج از مقادیر را برمی‌گرداند: وضعیت فعلی و تابع برای به‌روزرسانی آن.
  • شما می‌توانید بیش از یک متغیر وضعیت داشته باشید. در داخلی، React آن‌ها را بر اساس ترتیب‌شان همسان می‌کند.
  • وضعیت به کامپوننت اختصاصی است. اگر آن را در دو مکان رندر کنید، هر نسخه وضعیت خودش را خواهد داشت.

Try out some challenges

Challenge 1 of 4:
Complete the gallery

When you press “Next” on the last sculpture, the code crashes. Fix the logic to prevent the crash. You may do this by adding extra logic to event handler or by disabling the button when the action is not possible.

After fixing the crash, add a “Previous” button that shows the previous sculpture. It shouldn’t crash on the first sculpture.

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}
      />
    </>
  );
}
PreviousResponding to EventsNextRender and Commit

How do you like these docs?