📞 02166056460

متد ajaxStart

10 / 10
از 1 کاربر
بازگشت به لیست مقالات » | شنبه 2 آبان 1405 در ساعت 15 و 24 دقیقه | نظرات کاربران ( 0 )
آموزش jQuery

متد ajaxStart در jQuery؛ آموزش کاربرد و مثال

اجرای تابع هنگام آغاز درخواست‌های Ajax و نمایش وضعیت بارگذاری

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

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

۱
شروع چرخه درخواست‌های فعال
۱
تابع قابل اجرا هنگام شروع
۳٫۳
نسخه jQuery با منسوخ شدن روش shorthand
۰۱

۵ نکته مهم درباره متد ajaxStart

برای استفاده درست از این رویداد، لازم است بدانید چه زمانی اجرا می‌شود، کجا باید آن را ثبت کنید و چه تفاوتی با رویدادهای دیگر Ajax دارد. نکته مهم این است که ajaxStart برای هر درخواست جداگانه اجرا نمی‌شود؛ این رویداد زمانی فراخوانی می‌شود که فعالیت Ajax در صفحه از حالت بدون درخواست فعال به حالت دارای درخواست فعال تغییر کند.

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

۰۲

۱. رویداد در آغاز فعالیت Ajax اجرا می‌شود

ajaxStart زمانی اجرا می‌شود که اولین درخواست Ajax در حالی آغاز شود که درخواست Ajax دیگری در حال اجرا نیست. به همین دلیل، این رویداد برای نمایش یک نشانگر عمومی بارگذاری مناسب است. اگر چند درخواست هم‌زمان آغاز شوند، شروع هر درخواست به تنهایی باعث اجرای دوباره این رویداد نمی‌شود.

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

۰۳

۲. تابع را به رویداد متصل کنید

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

$( selector ).ajaxStart( function ( ) ) ;

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

۰۴

۳. محل اتصال رویداد را درست انتخاب کنید

از jQuery 1.9 به بعد، رویدادهای سراسری Ajax باید به شیء document متصل شوند. به همین دلیل، اگر می‌خواهید رویداد در سطح صفحه به درخواست‌های مختلف واکنش نشان دهد، document انتخاب مناسبی است. اتصال رویداد فقط به یک عنصر محتوایی ممکن است باعث شود رفتار مورد انتظار را نبینید.

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

$( document ).on( "ajaxStart", function() {
  // دستورات زمان شروع درخواست
});
۰۵

۴. درخواست باید اجازه اجرای رویدادهای سراسری را داشته باشد

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

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

۰۶

۵. نسخه jQuery را در نظر بگیرید

روش shorthand یعنی فراخوانی مستقیم ajaxStart از نسخه jQuery 3.3 منسوخ اعلام شده است. منسوخ شدن به این معنی نیست که کد بلافاصله از کار می‌افتد؛ اما بهتر است در کدهای جدید از روش on استفاده کنید تا با الگوی پیشنهادی نسخه‌های جدید هماهنگ باشید.

برای نمونه، اگر در پروژه قدیمی خود با دستور $(document).ajaxStart(handler) روبه‌رو شدید، مفهوم آن را می‌توانید با اتصال رویداد از طریق on بازنویسی کنید. این تغییر کوچک، خوانایی کد را بیشتر می‌کند و روش اتصال رویدادها را در بخش‌های مختلف برنامه یکسان نگه می‌دارد.

راهنمای استفاده از ajaxStart در پروژه

۰۷

نمایش یک نشانگر بارگذاری

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

$("div").ajaxStart(function(){
  $(this).html("<img src='pars-soft.gif' />");
});

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

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

$(document).on("ajaxStart", function() {
  $("#loading-message").text("در حال بارگذاری...");
});
۰۸

پنهان کردن نشانگر پس از پایان درخواست

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

برای مثال، اگر نشانگر با شروع درخواست ظاهر شود اما پس از پایان درخواست مخفی نشود، کاربر ممکن است تصور کند صفحه هنوز مشغول است. در مقابل، اگر آن را هنگام پایان هر درخواست جداگانه مخفی کنید، ممکن است درخواست دیگری هنوز فعال باشد. ajaxStop برای زمانی است که همه درخواست‌های Ajax فعال به پایان رسیده‌اند.

$(document).on("ajaxStart", function() {
  $("#loading-message").show();
});

$(document).on("ajaxStop", function() {
  $("#loading-message").hide();
});
⏱️

ajaxStart

هنگام آغاز فعالیت Ajax در صفحه اجرا می‌شود.

✅

ajaxStop

پس از پایان همه درخواست‌های Ajax فعال اجرا می‌شود.

⚙️

on

روش پیشنهادی برای اتصال رویداد در کدهای جدید است.

اشتباهات رایج هنگام استفاده از ajaxStart

۰۹

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

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

۱۰

اتصال رویداد به عنصر نامناسب

اگر هدف، شنیدن رویداد سراسری Ajax است، اتصال handler به یک عنصر دلخواه در صفحه انتخاب مطمئنی نیست. از jQuery 1.9 به بعد، این رویدادها باید روی document ثبت شوند. بازبینی محل اتصال، یکی از نخستین کارهایی است که هنگام اجرا نشدن تابع باید انجام دهید.

۱۱

فراموش کردن رویداد پایان

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

پیشنهاد

برای تجربه بهتر، رابط کاربری را ساده نگه دارید

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

طراحی سایت ←
مزایای ajaxStart

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

نمایش شفاف وضعیت فعالیت صفحه
۰۱
رابط کاربری

اطلاع‌رسانی سریع

نمایش پیام در شروع درخواست

۰۲
مدیریت

وضعیت مشترک

مدیریت فعالیت Ajax در سطح صفحه

۰۳
کاربرد

نمایش بارگذاری

آشکار کردن پیام یا نشانگر مناسب

۰۴
هماهنگی

همراهی با ajaxStop

مدیریت آغاز و پایان فعالیت

۰۵
سازگاری

استفاده از on

هماهنگی با الگوی پیشنهادی jQuery

۱۲

نتیجه‌گیری

متد ajaxStart در jQuery راهی برای واکنش به آغاز فعالیت Ajax در صفحه است و می‌تواند در نمایش پیام بارگذاری یا تغییر وضعیت رابط کاربری استفاده شود. این رویداد برای شروع دوره درخواست‌های فعال اجرا می‌شود، نه برای تک‌تک درخواست‌ها. برای استفاده درست، handler را روی document ثبت کنید، تنظیمات global را بررسی کنید و برای پایان فعالیت از رویداد مناسب مانند ajaxStop کمک بگیرید.

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

سوالات متداول متد ajaxStart در jQuery

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

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

آیا ajaxStart برای هر درخواست اجرا می‌شود؟

خیر. ajaxStart زمانی اجرا می‌شود که درخواست Ajax جدیدی آغاز شود و درخواست فعالی از قبل وجود نداشته باشد. برای واکنش به هر درخواست به صورت جداگانه، از callbackهای همان درخواست استفاده کنید.

رویداد ajaxStart را به کدام عنصر متصل کنیم؟

برای رویداد سراسری Ajax در jQuery 1.9 و نسخه‌های جدیدتر، handler را به document متصل کنید. روش پیشنهادی، استفاده از $(document).on("ajaxStart", handler) است.

چطور نشانگر بارگذاری را پس از پایان درخواست مخفی کنیم؟

برای وضعیت کلی صفحه می‌توانید از رویداد ajaxStop استفاده کنید؛ این رویداد پس از پایان همه درخواست‌های Ajax فعال اجرا می‌شود. برای کنترل یک درخواست خاص، callback همان درخواست مناسب‌تر است.

آیا روش ajaxStart هنوز در نسخه‌های جدید jQuery قابل استفاده است؟

روش shorthand از jQuery 3.3 منسوخ شده است. برای کدهای جدید، اتصال رویداد با on توصیه می‌شود؛ این روش خواناتر است و با الگوی پیشنهادی jQuery هماهنگی دارد.

از رویدادهای Ajax آگاهانه استفاده کنید

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

مرور متد ajaxStart ←
ارسال نظر و نظرات ثبت شده
سایر مقالات
متد serializeArray ۵ نکته مهم درباره متد serializeArray در jQuery 💡آشنایی با متد در این بخش از آموزش JQuery، ب ...
متد serialize متد serialize در jQuery چیست و چگونه از آن استفاده کنیم؟ ⭐ آشنایی با serialize در این بخش از ...
متد $.post متد post در jQuery چیست و چگونه از آن استفاده کنیم؟ ⭐ آشنایی با درخواست POST در این راهنما، ...
متد load متد load در jQuery چیست و چگونه استفاده می‌شود؟ ⭐ متد load در jQuery متد load در jQuery ...
متد $.getScript آموزش jQuery متد getScript در jQuery؛ دریافت و اجرای فایل جاوااسکریپت نحوه استفاده، پارامت ...
متد $.getJSON آموزش جی کوئری متد $.getJSON در جی کوئری؛ آموزش دریافت داده های JSON نحوه استفاده، مدیریت ...
متد $.get آموزش jQuery آموزش متد $.get در jQuery؛ دریافت اطلاعات از سرور نحوه ارسال درخواست GET، دری ...
متد ajaxSuccess آموزش jQuery متد ajaxSuccess در jQuery؛ آموزش کاربرد و مثال آشنایی با رویداد موفقیت درخواس ...
متد ajaxStop آموزش jQuery متد ajaxStop در jQuery تشخیص پایان همه درخواست های هم زمان Ajax و اجرای کد من ...
متد ajaxStart آموزش jQuery متد ajaxStart در jQuery؛ آموزش کاربرد و مثال اجرای تابع هنگام آغاز درخواست&zw ...
متد $.ajaxSetup آموزش jQuery و Ajax متد ajaxSetup در jQuery: تنظیم پیش فرض درخواست های Ajax نحوه کار، نمون ...
متد ajaxSend آموزش jQuery متد ajaxSend در jQuery چیست و چگونه از آن استفاده کنیم؟ آشنایی با رویداد ارسا ...
متد ajaxError آموزش jQuery متد ajaxError در jQuery؛ مدیریت خطای درخواست Ajax نحوه کار، آرگومان‌ها، ...
متد ajaxComplete آموزش jQuery متد ajaxComplete در jQuery بررسی کاربرد، پارامترها، مثال عملی و نکات مهم روید ...
متد ajax آموزش jQuery متد Ajax در jQuery؛ راهنمای ارسال درخواست به سرور آشنایی با ساختار درخواست Aj ...
متد Get و Post ای جکس در جی کوئری آموزش jQuery Ajax متدهای GET و POST در jQuery Ajax انتخاب متد مناسب، ارسال داده و مدیریت پ ...
Ajax در Jquery چگونه است ؟ Ajax در jQuery چیست و چگونه کار می‌کند؟ 💡آشنایی با ایجکس Ajax در jQuery روشی ساده بر ...
دسته بندی
جستجو
⏳ در حال پردازش...
لطفا صبر کنید