We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

شروع به کار

These docs are old and won’t be updated. Go to react.dev for the new React docs.

The new Quick Start teaches modern React and includes live examples.

این صفحه مروری بر مستندات ری‌اکت و منابع مربوط به آن می‌باشد .

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


ری‌اکت را امتحان کنید

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

زمین بازی آنلاین

اگر به سر و کله زدن با ری‌اکت علاقه‌مند هستید، میتوانید از محیط‌های انلاین برای کد زدن استفاده کنید. قالب Hello World را بر روی سایت‌‌هایی مانند CodePen، CodeSandbox یا Stackblitz امتحان کنید.

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

افزودن ری‌اکت به یک وبسایت

شما می‌تواتید ری‌اکت را در یک دقیقه به یک صفحه HTML اضافه کنید. شما می‌توانید به تدریج حضور آن را گسترش دهید، و یا آن را در چند ویجت (widgets) پویا نگه دارید.

ایجاد کردن یک برنامه جدید ری‌اکت

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

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

یادگیری ری‌اکت

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

  • اگر شما یادگیری همراه با انجام دادن را ترجیح می‌دهید ، با آموزش عملی ما شروع کنید.
  • اگر شما یادگیری گام به گام مفاهیم را ترجیح می‌دهید، با راهنمایی به مفاهیم اصلی ما شروع کنید.

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

مثال‌های ابتدایی

در صفحه اصلی ری‌اکت تعداد کمی مثال ساده ری‌اکت همراه با ویرایشگر زنده (live editor) وجود دارد. حتی اگر شما هنوز چیزی در مورد ری‌اکت نمیدانید، سعی کنید کد آن‌ها را تغییر دهید و ببینید چگونه بر نتیجه آن‌ها تاثیر می‌گذارد.

ری‌اکت برای مبتدی‌ها

اگر احساس می‌کنید که اسناد ری‌اکت با سرعت بیشتری نسبت به آنچه که با آن راحت هستید حرکت می‌کند، این مرور کلی ری‌اکت از Tania Rascia را چک کنید. این مرور مهم‌ترین مفاهیم ری‌اکت را به طور مفصل و مبتدی‌-دوستانه معرفی می‌کند. زمانی که این کار را انجام دادید، مستندات را دوباره امتحان کنید!

ری‌اکت برای طراح‌ها

اگر شما از یک زمینه با سابقه طراحی می‌آیید، این منابع جای خوبی برای شروع شما هستند

منابع جاوا‌‌ اسکریپت

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

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

نکته

هر وقت شما با چیزی در جاوا اسکریپت گیج شدید، MDN و javascript.info بهترین وب‌سایت‌ها یرای چک کردن هستند. همچنین انجمن‌های پشتیبانی از جامعه وجود دارند که شما در آن‌جا می‌توانید کمک بگیرید.

آموزش عملی

اگر شما یادگیری همراه با انجام‌دادن را ترجیح می‌دهید آموزش عملی ما را چک کنید . در این آموزش ، ما یک بازی دوز (tic-tac-toe) در ری‌اکت می‌سازیم. شما ممکن است وسوسه بشوید بی‌خیال آن بشوید چون به ساختن بازی‌های کامپیوتری علاقه‌ای ندارید؛ اما یک فرصت به این آموزش بدهید. تکنیک‌هایی که در این آموزش یاد می‌گیرید برای ساختن هر نوع برنامه ری‌اکت بنیادی و اساسی هستند و یاد گرفتن آن درک عمیق‌تری از آن به شما خواهد داد .

راهنمایی گام به گام

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

فکر کردن در چهارچوب ری‌اکت

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

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

مفاهیم پیشرفته

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

مرجع API

این بخش اسناد زمانی که می‌خواهید جزئیات بیشتری را در مورد یک API مشخص ری‌اکت یاد بگیرید مفید است . به عنوان مثال، React.Component API reference می‌تواند جزئیاتی را برای شما درباره‌ی اینکه چگونه setState() کار می‌کند و روش‌های مختلف چرخه عمر (lifecycle) برای چه مواردی مفید است فراهم می‌کند.

واژه‌نامه و سوالات متداول

بخش واژه‌نامه شامل مرور کلی عبارات رایجی که در مستندات ری‌اکت می‌بینید را شامل می‌شود. همچنین یک بخش سوالات متداول اختصاص داده شده به سوالات کوتاه و پاسخ در مورد موضوعات رایج وجود دارد، شامل ساختن درخواست‌های AJAX ، کامپوننت state و ساختار فایل.

به روز بمانید

بلاگ ری‌اکت منبع رسمی برای به‌روزرسانی‌های از طرف تیم ری‌اکت است. هر چیز مهمی شامل نکات انتشار (release notes) یا اعلام‌های استهلاک (deprecation notices)، ابتدا در اینجا پست خواهد شد.

شما همچنین می‌توانید صفحه اکانت @reactjs را در تويیتر دنبال کنید، اما اگر بلاگ ری‌اکت را مطالعه کنید هیچ چیز مهمی را از دست نمی‌دهید .

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

مستندات نسخه‌بندی‌شده

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

چیزی از قلم افتاده است؟

اگر چیزی در مستندسازی از قلم افتاده‌است و یا اگر بخشی از آن را گیج‌کننده دیدید، لطفا یک موضوع (issue) در رپو اسناد باز کنید همراه با پیشنهادهای شما برای پیشرفت بیشتر مستند‌سازی قرار دهید، یا آن را در صفحه توییتر اکانت @reactjs توییت کنید. ما مشتاقیم که آن را از شما بشنویم!

آیا این صفحه مفید است؟ویرایش این صفحه