متد ( ) Ajax در jQuery
در این بخش از آموزش JQuery ، متد ajax را شرح میدهیم.
از متد ajax ، برای ارسال یک درخواست Ajax به سرور استفاده می شود .
تمامی متدهای Ajax در jQuery از متد ajax برای ارسال درخواست خود استفاده می کنند . اما در زمانی که هیچ کدام از آنها را نتوان به کار برد ، باید از متد ( ) Ajax استفاده کرد .
شکل کلی استفاده از این متد بصورت زیر است :
$.ajax( { name:value , name:value , ... } ) ;
مقادیر پیش فرض را می توانید به صورت جفت های نام-مقدار تعیین نمایید .
مثال زیر کاربرد متد ajax را نشان میدهد :
$("button").click(function(){
$.ajax({url:"demo_test.txt",success:function(result){
$("#div1").html(result);
}});
});
در جدول زیر ، انواع مقادیر ممکن برای جفت های نام-مقدار را معرفی کرده ایم :
انواع جفت های نام-مقدار
جفت نام-مقدار |
شرح |
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 تعیین می کند . |