متد ( ) ajaxSetup در jQuery
در این بخش از آموزش JQuery ، متد ajaxSetup را شرح میدهیم.
به وسیله متد ajaxSetup ، می توان مقادیر پیش فرضی را برای استفاده در درخواست Ajax ، تعیین نمود .
شکل کلی استفاده از این متد بصورت زیر است :
$.ajaxSetup( { name:value , name:value , ... } ) ;
مقادیر پیش فرض را می توانید به صورت جفت های نام-مقدار تعیین نمایید .
مثال زیر کاربرد متد ajaxSetup را نشان میدهد :
$("button").click(function(){
$.ajaxSetup({url:"demo_ajax_load.txt",success:function(result){
$("div").html(result);}});
$.ajax();
});
در جدول زیر ، انواع مقادیر ممکن برای جفت های نام-مقدار را معرفی کرده ایم :
| جفت نام-مقدار |
شرح |
| async |
این پارامتر یک مقدار Boolean را تعیین می کند که آیا درخواست به صورت تبادل اطلاعاتی به سرور ارسال شود یا خیر . مقدار پیش فرض true است . |
| (beforeSend ( xhr |
به وسیله این پارامتر می توان یک تابع را تعیین کرد تا قبل از ارسال درخواست به سرور اجرا شود . |
| cashe |
این پارامتر یک مقدار Boolean را تعیین می کند ، که آیا صفحات دریافتی از سرور باید در حافظه Cashe ذخیره شوند یا خیر . مقدار پیش فرض true است . |
| (complete ( xhr , status |
این پارامتر یک تابع را تعیین می کند تا در هنگام پایان یافتن درخواست اجرا شود . مقدار پیش فرض true است . |
| data |
تعیین کننده اطلاعاتی است که می خواهید به سرور ارسال نمایید . |
| error |
این پارامتر تعیین کننده یک تابع است تا در صورتی که درخواست ناموفق بود ، اجرا شود . |
| password |
این پارامتر یک رمز عبور را برای استفاده در درخواست HTTP تعیین می کند . مقدار پیش فرض true است . |
| proccessData |
این پارامتر یک مقدار Boolean را تعیین می کند که آیا اطلاعاتی که قرار است به سرور ارسال شوند ، باید به صورت QueryString باشند یا خیر . مقدار پیش فرض true است . |
| success |
این پارامتر یک تابع را تعیین می کند تا در صورت اجرای موفق درخواست اجرا شود . |
| timeout |
مدت زمانی است که برای اجرای درخواست به میلی ثانیه تعیین می شود . |
| type |
این پارامتر نوع درخواست را تعیین می کند ( GET یا POST ) . |
| url |
این پارامتر آدرس صفحه مقصد که باید درخواست به آن ارسال شود را تعیین می کند . مقدار پیش فرض صفحه جاری است . |
| username |
این پارامتر یک نام کاربری را برای استفاده در درخواست HTTP تعیین می کند . |