WiX/mag

ویکس مگ / مجله آموزشی ویکس سِوِن

Props در React

انتقال داده با Props در React: راهنمای جامع

پیمان باقری

پیمان باقری

برنامه نویس و متخصص وب

در دنیای ری‌اکت، یکی از ویژگی‌های کلیدی که به توسعه‌دهندگان کمک می‌کند اپلیکیشن‌های انعطاف‌پذیر و مقیاس‌پذیر بسازند، استفاده از Props است. این ویژگی یک مکانیزم انتقال داده ساده اما قدرتمند است که به کامپوننت‌ها اجازه می‌دهد داده‌ها و رفتارها را بین خود به اشتراک بگذارند.

Props، ابزار اصلی برای برقراری ارتباط یک‌طرفه بین کامپوننت‌ها، به‌ویژه کامپوننت‌های والد و فرزند، محسوب می‌شود. این ویژگی به شما امکان می‌دهد داده‌ها را به صورت پویا به کامپوننت‌های مختلف ارسال کنید و رابط‌های کاربری تعاملی‌تر ایجاد کنید.

در این مقاله، علاوه بر توضیح کامل مفهوم Props، یاد می‌گیرید چگونه از آن در پروژه‌های ری‌اکت خود استفاده کنید، مزایا و محدودیت‌های آن را بررسی می‌کنیم و نکات پیشرفته‌ای برای بهره‌وری بهتر از این ابزار معرفی خواهیم کرد. با مطالعه این مقاله، مهارت‌های شما در مدیریت داده‌ها و طراحی کامپوننت‌های کارآمد در ری‌اکت به سطح بالاتری ارتقا خواهد یافت. در این مقاله از ویکس سون به این موضوع خواهیم پرداخت.

 

Props چیست؟

props یا همان “پراپز” در ری‌اکت کوتاه شده‌ی واژه‌ی “properties” است و مکانیزمی است که برای ارسال داده از یک کامپوننت به کامپوننت دیگر (معمولاً از والد به فرزند) استفاده می‌شود.props  به کامپوننت‌ها کمک می‌کند که قابلیت بازاستفاده بیشتری داشته باشند و ارتباط بین کامپوننت‌ها را ساده‌تر می‌کند.

ویژگی‌های Props

  • فقط خواندنی هستند: کامپوننت فرزند نمی‌تواند props را تغییر دهد؛ آن‌ها فقط برای مشاهده و استفاده در دسترس هستند.
  • تعریف رفتارها: علاوه بر داده‌های خام، می‌توان با props، توابعی را نیز به فرزند منتقل کرد تا رفتار مشخصی را پیاده‌سازی کند.
  • افزایش انعطاف‌پذیری: با استفاده از props، می‌توانید کامپوننت‌های قابل تنظیم ایجاد کنید که بسته به ورودی‌های props رفتارهای مختلفی ارائه دهند.

نمونه‌ای از مفهوم Props

function Greeting(props) {
  return <h1>Hello, {props.name}!</h1>;
}

<Greeting name="WiX7" />;

در اینجا، مقدار props.name برابر با “WiX7” است و پیام “Hello, WiX7!” نمایش داده می‌شود.

 

نحوه استفاده از Props

برای استفاده از props، باید مراحل زیر را طی کنید:

1. تعریف Props در والد

: در زمان استفاده از کامپوننت فرزند، مقادیر props را به عنوان ویژگی‌های JSX تعریف کنید:

<Greeting name="John" />

2. دریافت Props در فرزند

در کامپوننت فرزند، props به عنوان آرگومان تابع (برای کامپوننت‌های تابعی) یا به صورت this.props (برای کامپوننت‌های کلاسی) در دسترس است:

    • دریافت Props در کامپوننت تابعی

function Greeting(props) {
  return <h1>Hello, {props.name}!</h1>;
}
    • دریافت Props در کامپوننت کلاسی

class Greeting extends React.Component {
  render() {
    return <h1>Hello, {this.props.name}!</h1>;
  }
}

ارسال چندین Props

می‌توانید چندین props را همزمان به یک کامپوننت ارسال کنید:

<UserCard name="John" age={30} location="New York" />

Props به صورت پیش‌فرض

می‌توانید مقادیر پیش‌فرض برای props تعیین کنید:

Greeting.defaultProps = {
  name: "Guest"
};

 

انواع داده‌هایی که می‌توان با Props منتقل کرد

props می‌تواند انواع مختلفی از داده‌ها را بین کامپوننت‌ها منتقل کند. این قابلیت انعطاف‌پذیری بالایی به برنامه‌های ری‌اکت می‌دهد و امکان استفاده از انواع داده‌ها را برای شخصی‌سازی کامپوننت‌ها فراهم می‌کند.

  1. انواع اولیه (متن و عدد)

  • متن (String): برای انتقال نام، عنوان یا هر محتوای متنی.
<Greeting message="Welcome to React!" />
  • عدد (Number): برای انتقال مقادیر عددی مانند سن، رتبه‌بندی، یا اعداد دیگر.
<Profile age={25} />
  1. آرایه‌ها (Array)

برای ارسال لیست داده‌ها، مانند یک فهرست یا مجموعه‌ای از آیتم‌ها.

<ItemList items={["React", "JavaScript", "CSS"]} />
  1. اشیاء (Object)

برای ارسال داده‌های پیچیده‌تر با چندین ویژگی.

<UserDetails user={{ name: "Alice", age: 30, city: "New York" }} />
  1. توابع (Function)

برای ارسال توابع به عنوان props. این معمولاً برای تعریف رفتارها یا مدیریت رویدادها استفاده می‌شود.

<Button onClick={() => alert("Clicked!")} />
  1. عناصر JSX

می‌توان کامپوننت‌ها یا عناصر JSX را به عنوان props منتقل کرد.

<Card header={<Header />} footer={<Footer />} />
  1. مقادیر بولی (Boolean)

برای مشخص کردن فعال یا غیرفعال بودن یک ویژگی.

<ToggleSwitch isEnabled={true} />
  1. Props خاص (children)

برای انتقال محتوای دلخواه به داخل کامپوننت فرزند.

<Modal>
  <p>This is modal content!</p>
</Modal>

این تنوع داده‌ها به توسعه‌دهندگان کمک می‌کند تا کامپوننت‌های خود را به‌طور گسترده‌ای شخصی‌سازی کرده و ارتباط بین بخش‌های مختلف برنامه را ساده‌تر کنند.

 

مزایای استفاده از Props

استفاده از props چندین مزیت کلیدی دارد که آن را به یکی از اصول اصلی در ری‌اکت تبدیل می‌کند:

  1. کاهش تکرار کد

    props به شما این امکان را می‌دهد که کامپوننت‌های قابل استفاده مجدد ایجاد کنید. به‌جای تعریف کامپوننت‌های جداگانه برای هر سناریو، می‌توانید با ارسال props، همان کامپوننت را برای شرایط مختلف استفاده کنید.

  2. جداسازی وظایف

    با استفاده از props، والدین وظایف مدیریت داده‌ها و منطق را بر عهده می‌گیرند و فرزندان فقط مسئول نمایش و رندر کردن داده‌ها هستند. این جداسازی کد را تمیزتر و قابل مدیریت‌تر می‌کند.

  3. خوانایی و انعطاف‌پذیری

    کامپوننت‌هایی که از props استفاده می‌کنند، معمولاً خواناتر هستند و تغییرات در آن‌ها سریع‌تر انجام می‌شود. شما می‌توانید رفتار و محتوای هر کامپوننت را فقط با تغییر props تنظیم کنید.

  4. ارتباط کامپوننت‌ها

    props ابزاری است برای برقراری ارتباط بین کامپوننت‌های مختلف. این قابلیت، برنامه‌های ری‌اکت را مقیاس‌پذیرتر می‌کند و مدیریت داده‌ها را ساده‌تر می‌سازد.

  5. جلوگیری از وابستگی‌های غیرضروری

    props داده‌ها را از والد به فرزند انتقال می‌دهد، بدون این که نیاز باشد کامپوننت‌ها به‌طور مستقیم به یکدیگر وابسته باشند. این موضوع طراحی کامپوننت‌ها را ماژولارتر می‌کند.

  6. ساده‌سازی تست و دیباگ

    کامپوننت‌هایی که از props استفاده می‌کنند، به راحتی قابل تست هستند. شما می‌توانید با ارسال props مختلف، رفتارهای مختلف را بررسی کنید.

  7. پشتیبانی از رویکردهای مدرن ری‌اکت

    props با ویژگی‌هایی مانند Hooks و Context API به‌خوبی کار می‌کند و باعث می‌شود توسعه‌دهندگان بتوانند برنامه‌هایی انعطاف‌پذیر و قابل گسترش بسازند.

 

محدودیت‌های Props

با وجود مزایای گسترده‌ای که props ارائه می‌دهد، استفاده از آن محدودیت‌هایی نیز دارد که ممکن است در پروژه‌های پیچیده چالش‌هایی ایجاد کند. این محدودیت‌ها شامل موارد زیر است:

  1. ارتباط (جریان) یک‌طرفه داده‌ها

  • داده‌ها از کامپوننت والد به فرزند ارسال می‌شوند و این ارتباط فقط یک‌طرفه است. اگر کامپوننت فرزند نیاز به تغییر داده‌ها داشته باشد، باید از طریق یک callback به والد اطلاع دهد.
function Parent() {
  const [count, setCount] = useState(0);

  return <Child count={count} onIncrement={() => setCount(count + 1)} />;
}
  1. عدم پشتیبانی از تغییر داده‌ها در فرزند

  • props به‌صورت Read-only هستند. این بدان معناست که کامپوننت فرزند نمی‌تواند مقادیر props را مستقیماً تغییر دهد. این مسئله ممکن است در برخی سناریوها محدودکننده باشد.
  1. پیچیدگی در مدیریت داده‌های تو در تو

  • وقتی ساختار کامپوننت‌ها پیچیده و سلسله‌مراتبی می‌شود، انتقال props بین کامپوننت‌ها می‌تواند دشوار و زمان‌بر باشد. به این وضعیت معمولاً Props Drilling گفته می‌شود که می‌تواند کد را غیرقابل مدیریت کند.
function GrandParent() {
  return <Parent user={{ name: "Alice", age: 30 }} />;
}

function Parent({ user }) {
  return <Child user={user} />;
}

function Child({ user }) {
  return <p>{user.name}</p>;
}
  1. نیاز به جایگزین در پروژه‌های بزرگ

  • در پروژه‌های پیچیده و مقیاس‌پذیر، استفاده از Context API یا ابزارهای مدیریت حالت مانند Redux برای مدیریت داده‌ها معمولاً ترجیح داده می‌شود، چرا که props به تنهایی نمی‌تواند همه نیازها را برآورده کند.

 

استفاده پیشرفته از Props

  • پراپس های children

  • در ری‌اکت، پراپس های کودک (children) برای انتقال محتوای JSX از یک کامپوننت والد به کامپوننت فرزند استفاده می‌شوند. این ویژگی به کامپوننت‌ها اجازه می‌دهد که محتوای خود را به صورت داینامیک از والد دریافت کنند و در داخل کامپوننت فرزند نمایش دهند.مثال:
    // کامپوننت والد
    function ParentComponent() {
      return (
        <ChildComponent>
          <p>This is some content passed from parent!</p>
        </ChildComponent>
      );
    }
    
    // کامپوننت فرزند
    function ChildComponent(props) {
      return (
        <div>
          <h2>Content from Parent:</h2>
          {props.children}
        </div>
      );
    }

    در این مثال، کامپوننت ParentComponent یک پاراگراف <p> را به عنوان پراپس children به ChildComponent ارسال می‌کند. سپس ChildComponent این محتوا را از props.children دریافت کرده و در داخل خود نمایش می‌دهد.

  • انتقال تمام Props

با استفاده از اپراتور spread:

const props = { name: "John", age: 30 };
<UserCard {...props} />;
  • استفاده از توابع به عنوان Props

گاهی اوقات نیاز است که کامپوننت فرزند بتواند رویدادها یا رفتارهایی را کنترل کند که در والد تعریف شده‌اند. این کار با ارسال توابع به‌عنوان props انجام می‌شود.

function Parent() {
  const handleAlert = (message) => {
    alert(message);
  };

  return <Child showAlert={handleAlert} />;
}

function Child({ showAlert }) {
  return (
    <button onClick={() => showAlert("Button Clicked!")}>
      Click Me
    </button>
  );
}

در این مثال، والد تابعی را به فرزند ارسال می‌کند تا رویدادی خاص را کنترل کند.

  • ارسال JSX به‌عنوان Props

یکی دیگر از موارد پیشرفته، ارسال عناصر JSX یا کامپوننت‌ها به‌عنوان props است. این روش امکان ایجاد ساختارهای پویا و قابل شخصی‌سازی را فراهم می‌کند.

function Modal({ header, content, footer }) {
  return (
    <div>
      <header>{header}</header>
      <main>{content}</main>
      <footer>{footer}</footer>
    </div>
  );
}

function App() {
  return (
    <Modal
      header={<h1>Welcome</h1>}
      content={<p>This is the content of the modal.</p>}
      footer={<button>Close</button>}
    />
  );
}
  • استفاده از Default Props

می‌توانید مقادیر پیش‌فرض برای props تعریف کنید، تا اگر props خاصی ارسال نشد، مقدار پیش‌فرض اعمال شود.

function Greeting({ name = "Guest" }) {
  return <h1>Hello, {name}!</h1>;
}
  • اعتبارسنجی Props با PropTypes

برای اطمینان از اینکه props به درستی ارسال شده‌اند، می‌توان از PropTypes استفاده کرد.

import PropTypes from "prop-types";

function Button({ label, onClick }) {
  return <button onClick={onClick}>{label}</button>;
}

Button.propTypes = {
  label: PropTypes.string.isRequired,
  onClick: PropTypes.func.isRequired,
};
  • ارسال Props پویا و محاسبه‌شده

گاهی ممکن است نیاز باشد مقادیر props بر اساس شرایط خاصی محاسبه شوند و به کامپوننت فرزند ارسال شوند. این کار با استفاده از توابع یا عملیات‌های داخل JSX به‌سادگی امکان‌پذیر است.

function Parent({ user }) {
  const greeting = `Hello, ${user.name}!`;

  return <Child message={greeting} />;
}

function Child({ message }) {
  return <h1>{message}</h1>;
}

در اینجا، مقدار props message به‌صورت پویا در والد محاسبه و به فرزند ارسال می‌شود.

  • انتقال Props به تعداد زیادی کامپوننت

در پروژه‌هایی که نیاز است یک props مشابه به چندین کامپوننت منتقل شود، می‌توان از روش‌های بهینه مانند Spread Operator استفاده کرد:

const commonProps = { color: "blue", size: "large" };

function App() {
  return (
    <>
      <Button {...commonProps} label="Save" />
      <Button {...commonProps} label="Cancel" />
    </>
  );
}
  • پشتیبانی از React.memo برای بهینه‌سازی

اگر یک کامپوننت تابعی با استفاده از props زیادی رندر می‌شود، می‌توان از React.memo استفاده کرد تا فقط زمانی که props تغییر می‌کند، کامپوننت دوباره رندر شود.

const MemoizedChild = React.memo(function Child({ data }) {
  return <p>{data}</p>;
});

این نکته مخصوصاً در برنامه‌های بزرگ اهمیت دارد که به کاهش مصرف منابع و بهبود کارایی کمک می‌کند.

  • ارسال Props بین کامپوننت‌های بسیار دور

هنگامی که کامپوننت‌های والد و فرزند مستقیماً به هم مرتبط نیستند، اما نیاز به ارسال props وجود دارد، استفاده از Context API یک راهکار قدرتمند است. این روش جایگزینی مناسب برای Props Drilling است:

const UserContext = React.createContext();

function Parent() {
  return (
    <UserContext.Provider value={{ name: "Alice", age: 25 }}>
      <Child />
    </UserContext.Provider>
  );
}

function Child() {
  const user = React.useContext(UserContext);
  return <h1>{user.name}</h1>;
}

این تکنیک‌های پیشرفته به توسعه‌دهندگان کمک می‌کنند تا از قدرت و انعطاف props در پروژه‌های ری‌اکت حداکثر بهره را ببرند.

 

جدول راهنمای Props در ری اکت

موضوع شرح
props چیست؟ props یک شیء است که برای انتقال داده‌ها از یک کامپوننت والد به فرزند استفاده می‌شود.
نحوه استفاده از props با ارسال props به کامپوننت‌ها از طریق ویژگی‌ها در JSX، داده‌ها به راحتی از والد به فرزند منتقل می‌شوند.
انواع داده‌هایی که می‌توان با props منتقل کرد می‌توان انواع داده‌ها مانند رشته‌ها، اعداد، آرایه‌ها، اشیاء و حتی توابع را از طریق props منتقل کرد.
مزایای استفاده از props مدیریت داده‌ها، خوانایی بهتر کد، و قابلیت استفاده مجدد از کامپوننت‌ها بدون نیاز به کپی کردن داده‌ها.
محدودیت‌های props props فقط از والد به فرزند منتقل می‌شود و امکان تغییر مستقیم آنها در فرزند وجود ندارد.
استفاده پیشرفته استفاده از props استفاده از پراپس children، توابع، JSX، Default Props، PropTypes، پراپس پویا و…

 

جمع‌بندی:

Props یکی از مفاهیم اساسی و پراستفاده در ری‌اکت است که امکان انتقال داده‌ها و رفتارها بین کامپوننت‌ها را فراهم می‌کند. با استفاده از Props می‌توانید کامپوننت‌های قابل‌استفاده مجدد و پویا بسازید که مدیریت و طراحی رابط کاربری را آسان‌تر می‌کند.

در این مقاله، با مفاهیم پایه‌ای Props، محدودیت‌ها، نکات پیشرفته، و تکنیک‌های بهینه‌سازی آن آشنا شدید. نکات کلیدی این مقاله عبارت‌اند از:

  1. Props ابزاری یک‌طرفه برای انتقال داده‌ها است.
  2. با استفاده از Hooks و Context API می‌توان محدودیت‌های Props را کاهش داد.
  3. استفاده از React.memo و دیگر ابزارهای بهینه‌سازی می‌تواند عملکرد پروژه‌های بزرگ را بهبود بخشد.

با تسلط بر این مفهوم، می‌توانید برنامه‌های React خود را به شکلی سازمان‌یافته‌تر و مقیاس‌پذیرتر توسعه دهید. Props در کنار دیگر مفاهیم ری‌اکت، به شما کمک می‌کند کدی ساده‌تر، تمیزتر و با قابلیت استفاده مجدد بالا بنویسید.

 

مطالعه بیشتر در رفرنس های خارجی:

Passing Props to a Component (react.dev)

Components and Props (reactjs.org)

React Props (w3schools)

لیست کامل مقالات ” ری اکت ” ویکس سِوِن در لینک زیر :

ری اکت چیست؟