فرم‌ها در React – ارسال داده با onSubmit و action در فرم‌های جستجو

فرم‌ها بخش جدایی‌ناپذیر هر اپلیکیشن مدرن هستند. در این مقاله، نحوهٔ ساخت فرم جستجو در React را بررسی می‌کنیم. ابتدا از onSubmit برای مدیریت ارسال فرم استفاده می‌کنیم و سپس با معرفی ویژگی action، فرم را به رفتار بومی HTML نزدیک‌تر می‌کنیم. این ساختار باعث افزایش خوانایی، قابلیت استفاده با صفحه‌کلید، و آمادگی برای نسخه‌های آیندهٔ React می‌شود.

React formsonSubmitactionpreventDefault

~2 دقیقه مطالعه · آخرین به‌روزرسانی ۲ آبان ۱۴۰۴

مقدمه


فرم‌ها در React مانند HTML عمل می‌کنند، اما با قدرت مدیریت وضعیت و رویدادها. در این مقاله، فرم جستجو را با استفاده از input و button پیاده‌سازی می‌کنیم و سپس آن را به کامپوننت جداگانه تبدیل می‌کنیم. در ادامه، ویژگی action را جایگزین onSubmit می‌کنیم تا فرم به رفتار بومی HTML نزدیک‌تر شود.


ساخت فرم با onSubmit


ابتدا input و button را درون یک فرم قرار می‌دهیم و از onSubmit برای مدیریت ارسال استفاده می‌کنیم:


<form onSubmit={handleSearchSubmit}>
  <InputWithLabel ... />
  <button type="submit">Submit</button>
</form>

در تابع handleSearchSubmit از event.preventDefault() استفاده می‌کنیم تا از رفرش شدن صفحه جلوگیری شود:


const handleSearchSubmit = (event) => {
  setUrl(`${API_ENDPOINT}${searchTerm}`);
  event.preventDefault();
};

استخراج فرم به کامپوننت جداگانه


فرم را به کامپوننت SearchForm تبدیل می‌کنیم تا کد خواناتر و قابل استفاده مجدد شود:


const SearchForm = ({ searchTerm, onSearchInput, onSearchSubmit }) => (
  <form onSubmit={onSearchSubmit}>
    <InputWithLabel ... />
    <button type="submit">Submit</button>
  </form>
);

استفاده از action به‌جای onSubmit


در نسخه‌های جدیدتر React، می‌توان از ویژگی action برای ارسال فرم استفاده کرد. این ویژگی تابعی را اجرا می‌کند که داده‌ها را پردازش می‌کند:


const SearchForm = ({ searchTerm, onSearchInput, searchAction }) => (
  <form action={searchAction}>
    <InputWithLabel ... />
    <button type="submit">Submit</button>
  </form>
);

در این حالت، دیگر نیازی به preventDefault() نیست، زیرا فرم به‌صورت بومی مدیریت می‌شود:


const searchAction = () => {
  setUrl(`${API_ENDPOINT}${searchTerm}`);
};

مزایای استفاده از فرم در React


  • افزایش ساختار و خوانایی HTML
  • امکان ارسال با کلید Enter
  • قابلیت استفاده مجدد با کامپوننت‌های جداگانه
  • آمادگی برای نسخه‌های آینده React با استفاده از action

جمع‌بندی


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


نوشته و پژوهش‌شده توسط دکتر شاهین صیامی

مقالات مرتبط

کتابخانه‌های شخص ثالث در React – استفاده از axios و async/await برای دریافت داده‌ها

در این مقاله، نحوهٔ جایگزینی fetch با کتابخانهٔ axios برای دریافت داده‌ها از API در React را بررسی می‌کنیم. سپس با استفاده از async/await و بلوک try/catch، کد دریافت داده‌ها را خواناتر و قابل مدیریت‌تر می‌کنیم. این روش‌ها باعث افزایش سازگاری با مرورگرهای قدیمی، بهبود تست‌پذیری، و کاهش پیچیدگی کد می‌شوند.

ادامه

دریافت صریح داده‌ها در React – کنترل درخواست‌های API با دکمه تأیید

در پیاده‌سازی اولیه، هر بار که کاربر در فیلد جستجو تایپ می‌کرد، درخواست جدیدی به API ارسال می‌شد. این مقاله نحوهٔ تغییر این رفتار به دریافت صریح داده‌ها را آموزش می‌دهد؛ به‌طوری‌که فقط با کلیک روی دکمهٔ تأیید، درخواست به API ارسال شود. با تعریف دو وضعیت مجزا برای searchTerm و url، و استفاده از useCallback و useEffect، کنترل کامل بر زمان ارسال درخواست فراهم می‌شود.

ادامه

وضعیت‌های غیرممکن در React – مدیریت پیش‌بینی‌پذیر وضعیت با useReducer

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

ادامه

مدیریت پیشرفته وضعیت در React – استفاده از useReducer برای انتقال‌های پیچیده

در حالی که useState برای مدیریت وضعیت‌های ساده مناسب است، هوک useReducer در React راه‌حلی مقیاس‌پذیر برای مدیریت وضعیت‌های پیچیده و وابسته ارائه می‌دهد. این مقاله نحوهٔ مهاجرت وضعیت لیست داستان‌ها از useState به useReducer را بررسی می‌کند، و نشان می‌دهد چگونه با تعریف اکشن‌هایی مانند SET_STORIES و REMOVE_STORY می‌توان منطق وضعیت را به‌صورت متمرکز و خوانا مدیریت کرد.

ادامه

رندر شرطی در React – نمایش وضعیت بارگذاری و خطا هنگام دریافت داده‌های غیرهمزمان

در React، رندر شرطی ابزاری قدرتمند برای کنترل نمایش رابط کاربری بر اساس وضعیت‌های مختلف است. این مقاله نحوهٔ نمایش پیام «در حال بارگذاری…» هنگام دریافت داده‌های غیرهمزمان، و پیام خطا در صورت شکست دریافت داده را بررسی می‌کند. با استفاده از useState و useEffect، وضعیت‌های isLoading و isError را مدیریت کرده و با استفاده از عملگرهای منطقی و ternary، رندر شرطی را پیاده‌سازی می‌کنیم.

ادامه

داده‌های غیرهمزمان در React – شبیه‌سازی دریافت داده از API با useEffect و Promise

در React، داده‌ها معمولاً از منابع خارجی به‌صورت غیرهمزمان دریافت می‌شوند. این مقاله نحوهٔ شبیه‌سازی دریافت داده از API با استفاده از Promise و useEffect را بررسی می‌کند. ابتدا داده‌های نمونه را به‌صورت غیرهمزمان بارگذاری می‌کنیم، سپس با تأخیر ۲ ثانیه‌ای، رفتار واقعی‌تری از دریافت داده را پیاده‌سازی می‌کنیم. این گام نخست برای اتصال به API واقعی در آینده است.

ادامه