📞 02166056460

مرجع توابع کار با Ajax در JQuery

9 / 10
از 5 کاربر
بازگشت به لیست مقالات » | شنبه 2 آبان 1405 در ساعت 16 و 58 دقیقه | نظرات کاربران ( 0 )
راهنمای مرجع jQuery

مرجع توابع کار با Ajax در jQuery

آشنایی با متدهای درخواست، رویدادهای Ajax و ارسال اطلاعات فرم

مرجع توابع کار با Ajax در jQuery به شما کمک می‌کند متد مناسب را برای دریافت اطلاعات، ارسال فرم و مدیریت وضعیت درخواست‌ها انتخاب کنید. در این راهنما، کاربرد متدهای پرکاربرد، تفاوت روش‌های دریافت و ارسال داده و نکات مهم پیاده‌سازی را به زبان ساده بررسی می‌کنیم.

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

۰۱

متدهای Ajax در jQuery چه کاری انجام می‌دهند؟

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

برای نمونه، در یک صفحه فروشگاهی می‌توان از $.get() برای دریافت فهرست محصولات استفاده کرد و نتیجه را در بخشی از صفحه نمایش داد. برای ارسال اطلاعات یک فرم نیز می‌توان از $.post() یا متد عمومی‌تر $.ajax() کمک گرفت.

۱۳
متد معرفی‌شده در این مرجع
۶
متد مرتبط با رویدادهای Ajax
۵
روش دریافت یا ارسال درخواست
۲
روش آماده‌سازی داده فرم

این دسته‌بندی یک نمای سریع از مرجع توابع کار با Ajax در jQuery می‌دهد. تعداد متدها به معنای نیاز به استفاده هم‌زمان از همه آن‌ها نیست؛ در هر پروژه، انتخاب باید بر اساس نوع داده، روش HTTP، شکل پاسخ و نیازهای مدیریت خطا انجام شود.

مرجع توابع کار با Ajax در jQuery

۰۲

فهرست متدهای اصلی

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

نام متد شرح
$.ajax() متد ajax یک درخواست Ajax را با تنظیمات دلخواه به سرور ارسال می‌کند.
ajaxComplete() با متد ajaxComplete می‌توان تابعی را تعیین کرد که پس از پایان درخواست‌های Ajax اجرا شود.
ajaxError() با متد ajaxError می‌توان هنگام رخ دادن خطا در درخواست Ajax، تابعی را اجرا کرد.
ajaxSend() با متد ajaxSend می‌توان پیش از ارسال درخواست Ajax به سرور، تابعی را اجرا کرد.
$.ajaxSetup() با متد ajaxSetup می‌توان مقادیر پیش‌فرضی را برای درخواست‌های بعدی Ajax تعیین کرد.
ajaxStart() با متد ajaxStart می‌توان هنگام آغاز نخستین درخواست Ajax فعال، تابعی را اجرا کرد.
ajaxStop() با متد ajaxStop می‌توان پس از پایان همه درخواست‌های فعال Ajax، تابعی را اجرا کرد.
ajaxSuccess() با متد ajaxSuccess می‌توان پس از پایان موفقیت‌آمیز درخواست Ajax، تابعی را اجرا کرد.
$.get() متد get با درخواست HTTP GET اطلاعات را از سرور دریافت می‌کند.
$.getScript() متد getScript یک فایل JavaScript را با درخواست HTTP GET دریافت و اجرا می‌کند.
.load() متد load اطلاعات را از سرور می‌خواند و در عنصر انتخاب‌شده قرار می‌دهد.
$.post() متد post داده‌ها را با درخواست HTTP POST به سرور می‌فرستد.
.serialize() متد serialize داده‌های فرم را به شکل رشته‌ای از جفت‌های نام و مقدار آماده می‌کند.
.serializeArray() متد serializeArray داده‌های فرم را به شکل آرایه‌ای از اشیا با نام و مقدار آماده می‌کند.

۵ نکته مهم درباره متدهای Ajax در jQuery

۰۳

۱. میان متد عمومی و میان‌برها انتخاب کنید

$.ajax() متدی عمومی و انعطاف‌پذیر است که امکان تعیین گزینه‌هایی مانند نشانی مقصد، روش درخواست، نوع داده و تابع‌های موفقیت و خطا را فراهم می‌کند. این کنترل بیشتر زمانی ارزشمند است که رفتار درخواست باید با جزئیات مشخص شود.

در مقابل، $.get() و $.post() میان‌برهایی برای درخواست‌های رایج هستند. برای مثال، اگر تنها قصد دریافت یک فهرست ساده را دارید، استفاده از GET کد را مختصر می‌کند؛ اما اگر به تنظیمات بیشتری نیاز دارید، $.ajax() انتخاب مناسب‌تری خواهد بود.

مثال کاربردی: در صفحه‌ای که نتایج جست‌وجو را بدون بارگذاری مجدد به‌روز می‌کند، می‌توان از GET برای ارسال عبارت جست‌وجو و دریافت نتیجه استفاده کرد. برای ثبت فرم تماس یا اطلاعاتی که باید در بدنه درخواست فرستاده شوند، معمولاً POST مناسب‌تر است.

۰۴

۲. رویداد مناسب را برای هر مرحله به کار ببرید

رویدادهای Ajax برای نظارت بر چرخه درخواست کاربرد دارند. ajaxSend() به زمان ارسال درخواست مربوط است، ajaxSuccess() برای واکنش به پایان موفق مناسب است و ajaxError() امکان رسیدگی به خطا را فراهم می‌کند.

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

رویدادهای کلی مانند ajaxStart() و ajaxStop() برای زمانی مفیدند که لازم است وضعیت کلی درخواست‌های فعال صفحه را دنبال کنید. در مقابل، تابع‌های موفقیت و خطای مربوط به یک درخواست، کنترل دقیق‌تری برای همان عملیات فراهم می‌کنند.

۰۵

۳. داده فرم را متناسب با نیاز آماده کنید

.serialize() داده‌های ورودی فرم را به رشته‌ای از جفت‌های نام و مقدار تبدیل می‌کند. این قالب برای بسیاری از درخواست‌های فرم مناسب است و ارسال داده‌های متنی را آسان می‌کند.

اگر در کد خود به ساختاری قابل پردازش‌تر نیاز دارید، .serializeArray() داده‌ها را به صورت آرایه‌ای از اشیا ارائه می‌دهد. برای مثال، هنگام بررسی مقدار هر فیلد یا آماده کردن داده‌ها پیش از ارسال، این قالب می‌تواند خواناتر باشد.

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

۰۶

۴. پاسخ را به شکل درست در صفحه نمایش دهید

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

اگر نیاز دارید پاسخ را پیش از نمایش پردازش کنید، دریافت داده با $.get() یا $.ajax() انعطاف بیشتری می‌دهد. برای نمونه، می‌توانید نتیجه را بررسی کنید، پیام مناسب نشان دهید و سپس محتوای مورد نظر را در محل مشخص‌شده قرار دهید.

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

۰۷

۵. خطا و تنظیمات پیش‌فرض را فراموش نکنید

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

$.ajaxSetup() امکان تعریف تنظیمات مشترک برای درخواست‌های بعدی را فراهم می‌کند. با این حال، تنظیمات سراسری را با دقت به کار ببرید؛ تغییر یک مقدار عمومی ممکن است روی درخواست‌های بخش‌های دیگر برنامه نیز اثر بگذارد.

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

مقایسه متدهای پرکاربرد Ajax

۰۸

تفاوت کاربردها در یک نگاه

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

متد کاربرد اصلی زمان استفاده پیشنهادی
$.ajax() ارسال درخواست با تنظیمات قابل تعیین وقتی به کنترل بیشتر روی درخواست نیاز دارید
$.get() دریافت اطلاعات با HTTP GET برای خواندن داده از سرور
$.post() ارسال اطلاعات با HTTP POST برای فرستادن داده‌هایی مانند اطلاعات فرم
.load() دریافت محتوا و قراردادن آن در عنصر برای بارگذاری مستقیم بخشی از صفحه
.serialize() تبدیل داده فرم به رشته برای آماده‌سازی ساده فیلدهای فرم
.serializeArray() تبدیل داده فرم به آرایه برای پردازش جداگانه مقادیر فرم
۰۹

چطور متد درست را انتخاب کنیم؟

ابتدا مشخص کنید داده قرار است از سرور دریافت شود یا به آن ارسال شود. سپس بررسی کنید آیا به تنظیمات پیشرفته، پردازش پاسخ یا قرار دادن مستقیم محتوا در صفحه نیاز دارید. پاسخ این پرسش‌ها معمولاً انتخاب را میان متدهای کوتاه‌تر و $.ajax() روشن می‌کند.

📡

دریافت داده

برای خواندن اطلاعات از سرور، متد GET را بررسی کنید.

📤

ارسال داده

برای فرستادن اطلاعات، از POST یا تنظیمات درخواست Ajax بهره ببرید.

🎛️

کنترل بیشتر

برای تعیین جزئیات درخواست، متد عمومی $.ajax() را انتخاب کنید.

برای استفاده از متدهای jQuery، بارگذاری درست کتابخانه و سازگاری آن با کدهای پروژه را نیز بررسی کنید. در طراحی سایت، انتخاب ابزار تنها بخشی از کار است؛ ساختار درست درخواست و نمایش واضح نتیجه هم در تجربه کاربر نقش دارد.

نمونه ساده ارسال درخواست Ajax

۱۰

استفاده از $.get()

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

$.get("/api/products", function (data) {
  console.log(data);
}).fail(function () {
  console.error("دریافت اطلاعات ناموفق بود.");
});

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

۱۱

ارسال داده فرم با $.ajax()

وقتی لازم است روش درخواست و مسیرهای موفقیت یا خطا را مشخص کنید، $.ajax() انعطاف بیشتری در اختیار شما می‌گذارد. نمونه زیر داده یک فرم را با .serialize() آماده می‌کند.

$.ajax({
  url: "/api/contact",
  method: "POST",
  data: $("#contact-form").serialize(),
  success: function (response) {
    console.log("اطلاعات با موفقیت ارسال شد.");
  },
  error: function () {
    console.error("ارسال اطلاعات ناموفق بود.");
  }
});

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

مزایای استفاده از متدهای Ajax در jQuery

مزایای متدهای Ajax در jQuery

درخواست‌های ساده‌تر و روشن‌تر

ابزارهایی برای دریافت، ارسال و مدیریت پاسخ
۰۱
کارایی

به‌روزرسانی بخشی از صفحه

بدون بارگذاری دوباره تمام صفحه

۰۲
سادگی

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

برای درخواست‌های رایج و ساده

۰۳
انعطاف

تنظیم درخواست

با گزینه‌های متنوع در $.ajax()

۰۴
مدیریت

رسیدگی به رویدادها

برای موفقیت، خطا و پایان درخواست

۰۵
فرم‌ها

آماده‌سازی داده

با قالب رشته‌ای یا آرایه‌ای

جمع‌بندی مرجع توابع کار با Ajax در jQuery

۱۲

انتخاب آگاهانه متد مناسب

در این مرجع توابع کار با Ajax در jQuery با متدهای ارسال درخواست، دریافت اطلاعات، مدیریت رویدادها و آماده‌سازی داده فرم آشنا شدید. برای دریافت یا ارسال ساده، میان‌برهایی مانند $.get() و $.post() می‌توانند کافی باشند؛ برای تنظیمات جزئی‌تر، $.ajax() گزینه‌ای انعطاف‌پذیر است.

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

برای توسعه پروژه خود آماده‌اید؟

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

طراحی سایت ←

سوالات متداول متدهای Ajax در jQuery

Ajax در jQuery چه کاربردی دارد؟

Ajax در jQuery برای تبادل اطلاعات با سرور، بدون بارگذاری دوباره تمام صفحه به کار می‌رود. می‌توان با آن داده دریافت کرد، فرم فرستاد یا بخشی از محتوای صفحه را به‌روز کرد.

تفاوت $.get() و $.post() چیست؟

$.get() برای ارسال درخواست با روش HTTP GET و دریافت اطلاعات استفاده می‌شود؛ $.post() داده‌ها را با روش HTTP POST به سرور می‌فرستد. انتخاب نهایی به هدف درخواست و نیازهای سمت سرور بستگی دارد.

چه زمانی باید از $.ajax() استفاده کرد؟

زمانی از $.ajax() استفاده کنید که به کنترل بیشتری بر گزینه‌های درخواست، روش ارتباط، داده ارسالی یا مدیریت پاسخ و خطا نیاز دارید. برای درخواست‌های ساده، میان‌برهایی مانند GET و POST ممکن است خواناتر باشند.

تفاوت serialize و serializeArray چیست؟

.serialize() داده‌های فرم را به شکل رشته‌ای از جفت‌های نام و مقدار آماده می‌کند؛ .serializeArray() همان داده‌ها را به صورت آرایه‌ای از اشیا برمی‌گرداند. قالب مناسب را بر اساس نحوه پردازش داده در برنامه انتخاب کنید.

ajaxError و ajaxSuccess چه زمانی اجرا می‌شوند؟

ajaxSuccess() برای واکنش به پایان موفق درخواست Ajax کاربرد دارد و ajaxError() برای رسیدگی به خطا استفاده می‌شود. مدیریت هر دو مسیر کمک می‌کند کاربر در وضعیت موفقیت یا شکست، بازخورد مناسبی دریافت کند.

ارسال نظر و نظرات ثبت شده
سایر مقالات
توابع کاربردی متفرقه در JQuery آموزش JQuery توابع کاربردی متفرقه در JQuery؛ معرفی و راهنمای استفاده آشنایی با متدهای data ...
مرجع توابع کار با Ajax در JQuery راهنمای مرجع jQuery مرجع توابع کار با Ajax در jQuery آشنایی با متدهای درخواست، رویدادهای A ...
مرجع توابع کار با Html و Css در JQuery راهنمای jQuery مرجع توابع کار با HTML و CSS در jQuery آشنایی با متدهای پرکاربرد برای مدیری ...
مرجع افکت ها (Effeccts) در JQuery افکت ها در jQuery چیستند و چه کاربردی دارند؟ 💡 آشنایی با افکت های jQuery افکت ها در jQuer ...
مرجع رویدادها (Events) در JQuery رویدادهای jQuery چیست؟ راهنمای کاربرد و مدیریت رویدادها 💡آشنایی با رویدادها در این بخش از آ ...
مرجع انتخاب گرها (Selectors) در JQuery انتخاب گرهای jQuery؛ راهنمای کامل سلکتورها و کاربرد آن ها 💡مقدمه ای برای انتخاب عناصر صفحه ...
دسته بندی
جستجو
⏳ در حال پردازش...
لطفا صبر کنید