{"componentChunkName":"component---src-templates-docs-js","path":"/docs/components-and-props.html","result":{"data":{"markdownRemark":{"html":"

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

\n

از لحاظ مفهومی کامپوننت‌ها همانند توابع جاوااسکریپت هستند. آنها ورودی‌های دلخواه خود (props) را دریافت می‌کنند و المنت‌هایی از ری‌اکت را باز می‌گردانند که توصیف کننده آنچه باید روی صفحه نمایان شود است.

\n

کامپوننت‌هایی از جنس تابع و کلاس

\n

ساده‌ترین راه برای تعریف کردن یک کامپوننت، نوشتن یک تابع جاوااسکریپت است:

\n
function Welcome(props) {\n  return <h1>Hello, {props.name}</h1>;\n}
\n

این تابع یک کامپوننت ری‌اکت قابل‌قبول است، زیرا یک “props” (که کوچک شده properties است) که آرگومانی از جنس شی همراه با داده است را دریافت و یک المنت ری‌اکت را باز می‌گرداند.\nبه این نوع کامپوننت‌ها، «کامپوننت‌‌های تابع‌» گفته می‌شود زیرا آنها در واقعیت تابع‌هایی از جاوااسکریپت هستند.

\n

شما همچنین می‌توانید از کلاس‌های ES6 برای تعریف کامپوننت‌ها استفاده کنید:

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

دو کامپوننت بالا از نظر ری‌اکت یکسان هستند.

\n

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

\n

رندر کردن یک کامپوننت

\n

پیش‌تر ما فقط با المنت‌هایی از ری‌اکت مواجه شدیم که بیانگر تگ‌های DOM بودند:

\n
const element = <div />;
\n

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

\n
const element = <Welcome name=\"Sara\" />;
\n

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

\n

برای مثال کد زیر “Hello, Sara” را روی صفحه رندر می‌کند:

\n
function Welcome(props) {  return <h1>Hello, {props.name}</h1>;\n}\n\nconst element = <Welcome name=\"Sara\" />;ReactDOM.render(\n  element,\n  document.getElementById('root')\n);
\n

روی CodePen امتحان کنید

\n

بیایید جمع‌بندی کنیم که در این مثال چه اتفاقی می‌افتد:

\n

۱. ما تابع ReactDOM.render() را با المنت <Welcome name="Sara" /> فرا می‌خوانیم.

\n

۲. ری‌اکت کامپوننت Welcome را به همراه {name: 'Sara'} که در ورودی تابع به عنوان props تعریف شده است، فرا می‌خواند.

\n

۳. کامپوننت Welcome ما یک المنت <h1>Hello, Sara</h1> را به عنوان نتیجه باز می‌گرداند.

\n

۴. DOM ری‌اکت به صورت بهینه DOM را به‌روزرسانی می‌کند تا <h1>Hello, Sara</h1> را نمایش دهد.

\n
\n

نکته: همیشه نام کامپوننت‌ها را با یک حرف بزرگ شروع کنید.

\n

ری‌اکت با کامپوننت‌هایی که با حروف کوچک شروع شده باشند همانند تگ‌های DOM برخورد می‌کند. برای مثال تگ <div /> بیانگر یک تگ HTML است , اما <Welcome /> بیانگر یک کامپوننت است و بنابرین لازم است Welcome در scope باشد.

\n

برای یادگیری دلیل این قرارداد، لطفا JSX In Depth را مطالعه فرمایید.

\n
\n

ترکیب کامپوننت‌ها

\n

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

\n

برای مثال ما می‌توانیم یک کامپوننت به نام App بسازیم که Welcome را بارها رندر می‌کند:

\n
function Welcome(props) {\n  return <h1>Hello, {props.name}</h1>;\n}\n\nfunction App() {\n  return (\n    <div>\n      <Welcome name=\"Sara\" />      <Welcome name=\"Cahal\" />      <Welcome name=\"Edite\" />    </div>\n  );\n}\n\nReactDOM.render(\n  <App />,\n  document.getElementById('root')\n);
\n

روی CodePen امتحان کنید

\n

معمولا، پروژه‌های جدید ری‌اکت دارای یک کامپوننت App واحد در بالاترین سطح هستند. اما اگر شما ری‌اکت را با پروژه‌ای موجود ادغام می‌کنید، می‌توانید از سطوح پایین به بالا طراحی کنید، برای مثال از یک کامپوننت کوچک مانند Button شروع کنید و تدریجا تا بالای سلسله مراتب view طراحی را ادامه دهید.

\n

استخراج کامپوننت‌ها

\n

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

\n

برای مثال این کامپوننت Comment را در نظر بگیرید:

\n
function Comment(props) {\n  return (\n    <div className=\"Comment\">\n      <div className=\"UserInfo\">\n        <img className=\"Avatar\"\n          src={props.author.avatarUrl}\n          alt={props.author.name}\n        />\n        <div className=\"UserInfo-name\">\n          {props.author.name}\n        </div>\n      </div>\n      <div className=\"Comment-text\">\n        {props.text}\n      </div>\n      <div className=\"Comment-date\">\n        {formatDate(props.date)}\n      </div>\n    </div>\n  );\n}
\n

روی CodePen امتحان کنید

\n

این کامپوننت author (یک شیء)، text (یک string)، و date (یک تاریخ) را به عنوان props دریافت و یک دیدگاه را در یک شبکه اجتماعی توصیف می‌کند.

\n

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

\n

در ابتدا Avatar را استخراج می‌نماییم:

\n
function Avatar(props) {\n  return (\n    <img className=\"Avatar\"      src={props.user.avatarUrl}      alt={props.user.name}    />  );\n}
\n

کامپوننت Avatar نیازی به دانستن اینکه قرار است در داخل یک Comment رندر شود ندارد. برای همین به prop آن بجای author اسمی عام نظیر user داده‌ایم.

\n

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

\n

حال می‌توانیم Comment را کمی ساده کنیم:

\n
function Comment(props) {\n  return (\n    <div className=\"Comment\">\n      <div className=\"UserInfo\">\n        <Avatar user={props.author} />        <div className=\"UserInfo-name\">\n          {props.author.name}\n        </div>\n      </div>\n      <div className=\"Comment-text\">\n        {props.text}\n      </div>\n      <div className=\"Comment-date\">\n        {formatDate(props.date)}\n      </div>\n    </div>\n  );\n}
\n

سپس ما کامپوننت UserInfo را استخراج می‌کنیم که Avatar را در کنار اسم کاربر رندر می‌کند:

\n
function UserInfo(props) {\n  return (\n    <div className=\"UserInfo\">      <Avatar user={props.user} />      <div className=\"UserInfo-name\">        {props.user.name}      </div>    </div>  );\n}
\n

این به ما کمک می‌کند تا Comment را حتی بیشتر از این ساده کنیم:

\n
function Comment(props) {\n  return (\n    <div className=\"Comment\">\n      <UserInfo user={props.author} />      <div className=\"Comment-text\">\n        {props.text}\n      </div>\n      <div className=\"Comment-date\">\n        {formatDate(props.date)}\n      </div>\n    </div>\n  );\n}
\n

روی CodePen امتحان کنید

\n

استخراج کامپوننت‌ها شاید در ابتدا به نظر کار سختی بیاید، اما داشتن یک پالت از کامپوننت‌هایی با قابلیت استفاده مجدد در اپ‌های بزرگتر، هزینه آن را باز می‌گرداند. به عنوان یک قانون کلی در نظر داشته باشید که اگر قسمتی از رابط کاربری شما بارها استفاده شده است (نظیر Button, Panel , Avatar) و یا اینکه قسمتی از رابط کاربری پیچیدگی منحصر به فرد خود را دارد (نظیر App, FeedStory, Comment) آن قسمت کاندیدای مناسبی برای استخراج و تبدیل شدن به یک کامپوننت مجزا است.

\n

propها فقط قابل خواندن هستند

\n

بدون در نظر گرفتن اینکه شما یک کامپوننت را به عنوان یک تابع یا یک کلاس تعریف کرده‌اید، آن کامپوننت نباید هرگز propهای خودش را تغییر دهد.\nاین تابع sum را در نظر بگیرید:

\n
function sum(a, b) {\n  return a + b;\n}
\n

اینگونه توابع “خالص (pure)” نامیده می‌شوند زیرا سعی نمی‌کنند که ورودی خود را تغییر دهند و همیشه با ورودی‌های مشخص خروجی‌های ثابتی را نمایش می‌دهند.

\n

در نقطه متقابل این کامپوننت “ناخالص (impure)” است زیرا ورودی خود را تغییر می‌دهد:

\n
function withdraw(account, amount) {\n  account.total -= amount;\n}
\n

ری‌اکت خیلی منعطف است اما یک قانون سختگیرانه دارد:

\n

تمامی کامپوننت‌های ری‌اکت باید نسبت به propهای خود همانند توابع خالص عمل کنند.

\n

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

","frontmatter":{"title":"کامپوننت‌‌ها و prop ها","next":"state-and-lifecycle.html","prev":"rendering-elements.html"},"fields":{"path":"content/docs/components-and-props.md","slug":"docs/components-and-props.html"}}},"pageContext":{"slug":"docs/components-and-props.html"}},"staticQueryHashes":[]}