متد ()ajaxSetup در jQuery
متد ()ajaxSetup در jQuery
مثال (متد ()ajaxSetup در jQuery)
تعیین URL پیش فرض و تابع نتیجه برای تمامی درخواست های AJAX:
$("button").click(function(){
$.ajaxSetup({url:"demo_ajax_load.txt",success:function(result){
$("div").html(result);}});
$.ajax();
});
تعریف و کاربرد
متد ()ajaxSetup مقدار پیش فرضی برای درخواست های بعدی AJAX تعیین می کند.
نحوه ی استفاده از متد ()ajaxSetup
$.ajaxSetup({name:value, name:value, ... })
برای مشخص کردن تنظیمات یک درخواست آجاکسی به یک یا چند پارامتر name:value (نام/مقدار) نیاز داریم.
در جدول زیر، name:value (نام/مقدار) هایی که می توانند به کار روند آورده شده است:
| نام | مقدار/توضیحات |
|---|---|
| async | یک مقدار Boolean است که تعیین می کند آیا درخواست باید به صورت غیر همزمان به سرور ارسال شود یا خیر . مقدار پیش فرض true است. |
| beforeSend(xhr) | به وسیله این پارامتر می توان یک تابع را تعیین کرد تا قبل از ارسال درخواست به سرور اجرا شود. |
| cache | یک مقدار Boolean است که تعیین می کند آیا صفحات دریافتی از سرور باید در حافظه Cashe ذخیره شوند یا خیر . مقدار پیش فرض true است. |
| complete(xhr,status) | یک تابع که پس از پایان یافتن درخواست اجرا می شود. (بعد از موفقیت و شکست تابع) |
| contentType | نوع محتوای استفاده شده در زمان ارسال داده به سرور. مقدار پیش فرض "application/x-www-form-urlencoded" است. |
| context | یک مقدار "this" برای تمامی توابع مرتیط بازگشتی AJAX تعیین می کند. |
| data | تعیین کننده اطلاعاتی است که می خواهید به سرور ارسال نمایید . |
| dataFilter(data,type) | یک تابع که برای دسترسی به اطلاعات واکنشی خام در XMLHttpRequest مورد استفاده قرار می گیرد. |
| dataType | نوع داده بازگشتی از طرف سرور را مشخص می کند. |
| error(xhr,status,error) | یک تابع که در صورت اجرای ناموفق درخواست، اجرا می شود. |
| global | یک مقدار Boolean است که تعیین می کند آیا چرخه ی سراسری رویداد AJAX برای یک درخواست دسته بندی شده است یا خیر. مقدار پیش فرض true است. |
| ifModified | ا یک مقدار Boolean است که تعیین می کند آیا درخواست تنها درست است، حتی در صورتی که درخواست جدید بعد از آخرین درخواست تغییر کرده باشد. مقدار پیش فرض false است. |
| jsonp | این پارامتر یک رشته برجسته از تابع پاسخ در درخواست jsonp را باز می گرداند. |
| jsonpCallback | این پارامتر یک نام برای کلیه ی توابع پاسخ در درخواست jsonp را تعیین می کند. |
| password | این پارامتر یک رمز عبور را برای استفاده در درخواست HTTP تعیین می کند . مقدار پیش فرض true است. |
| processDat | این پارامتر یک مقدار Boolean را تعیین می کند که آیا اطلاعاتی که قرار است به سرور ارسال شوند ، باید به صورت QueryString باشند یا خیر . مقدار پیش فرض true است. |
| scriptCharset | این پارامتر یک کاراکتر برای درخواست تعیین می کند. |
| success(result,status,xhr) | یک تابع است که در صورت اجرای موفق درخواست، اجرا می شود. |
| timeout | مدت زمانی است که برای اجرای درخواست (به میلی ثانیه) تعیین می شود. |
| traditional | این پارامتر یک مقدار Boolean را تعیین می کند که آیا از سبک سنتی در ترکیب بندی پارامتر ها استفاده کند یا خیر. |
| type | این پارامتر نوع درخواست را تعیین می کند (GET یا POST). |
| url | این پارامتر آدرس صفحه مقصد که باید درخواست به آن ارسال شود را تعیین می کند. مقدار پیش فرض صفحه جاری است. |
| username | این پارامتر یک نام کاربری را برای استفاده در درخواست HTTP تعیین می کند. |
| xhr | یک تابع که برای ایجاد شی XMLHttpRequest استفاده می شود. |
خودتان امتحان کنید - مثالs
کنترل کننده خطا برای درخواست های آجاکسی را مشخص می کند.
چگونگی استفاده از تنظیمات خطا برای مشخص کردن خطاها در درخواست های آجاکسی.
کلیه متدهای Ajax در jQuery- نوشته شده توسط مهدی مؤمنی
- بازدید: 7169
