English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
يُستخدم طريقة $ .ajaxSetup() لضبط القيم الافتراضية للطلبات Ajax المستقبلية.
إلا إذا تم تغطية كل منهم في الطلبات اللاحقة، فإن جميع الطلبات اللاحقة التي تستخدم أي طريقة يتم تنفيذها باستخدام القيم الجديدة حتى تُتاح دعوة أخرى لـ $ .ajaxSetup().
$.ajaxSetup({name:value, name:value, ...})
تعيين URL افتراضية لجميع طلبات AJAX:
$.ajaxSetup({ url: "ajax_post.php" }); //سيتم استخدام URL "ajax_post.php" تلقائيًا في كل مرة يتم إرسال طلب Ajax: $.ajax({ data: {fname:"Seagull", lname:"Anna"}, method: "POST", success: function(response){ $("div").html(response); } });الاختبار لمعرفة إذا كان‹/›
تعيين URL افتراضية والوظيفة الناجحة لجميع طلبات AJAX:
$.ajaxSetup({ url: "ajax_data.txt", success: function(response){ $("div").html(response); } }); $("button").click(function(){ $.ajax(); });الاختبار لمعرفة إذا كان‹/›
إذا واجهت طلب Ajax خطأ، يتم عرض إشعار:
$.ajaxSetup({ url: "wrong_file.html", success: function(response){ $("div").html(response); }, error: function(xhr){ الخطأ: $("div").html("خطأ: " + xhr.status + " " + xhr.statusText); } }); $("button").click(function(){ $.ajax(); });الاختبار لمعرفة إذا كان‹/›
ملاحظة:الاشارة إلى) المحددة هنا ستؤثر على$ .ajaxالأنواع المشتقة من Ajax (مثلطريقة $ .get() أوجميع الطلبات. حيث قد يتوقع المُستخدمون الآخرون (مثل الأدوات المدمجة) استخدام الإعدادات الافتراضية العادية، مما قد يؤدي إلى سلوك سيء. لذلك،يُنصح بعدم استخدام طريقة $ .ajaxSetup().
يُستخدم اسم المعامل باستخدام اسم:قيمة لتحديد إعدادات الطلب AJAX.
أسماء محتملة: القيم المذكورة في الجدول أدناه:
الاسم | نوع القيمة | الوصف |
---|---|---|
async | النوع البولي | قيمة بولية تشير إلى ما إذا كان يجب معالجة الطلب بشكل غير متزامن. القيمة الافتراضية هي true |
beforeSend(xhr) | دالة | الوظيفة التي يتم تشغيلها قبل إرسال الطلب. |
cache | النوع البولي | قيمة بولية تشير إلى ما إذا كان يجب على المتصفح حفظ صفحة الطلب. القيمة الافتراضية هي true |
complete(xhr,status) | دالة | الوظيفة التي يتم تشغيلها عند اكتمال الطلب (بعد الوظائف الناجحة والمعطوبة). |
contentType | قيمة بولية أو نص | نوع المحتوى الذي يتم استخدامه عند إرسال البيانات إلى الخادم. القيمة الافتراضية هي: 'application / x-www-form-urlencoded' |
context | عنصر عادي | تحديد قيمة 'this' للوظائف الدالة المرتبطة بأيكس جيكس. |
data | PlainObject أو String أو Array | تحديد البيانات التي سيتم إرسالها إلى الخادم. |
dataFilter(data,type) | دالة | الوظيفة التي يتم استخدامها لمعالجة البيانات الجذرية لـ XMLHttpRequest. |
dataType | النص | نوع البيانات التي يتم توقعها من استجابة الخادم. |
error(xhr,status,error) | دالة | الوظيفة التي يتم تشغيلها عند فشل الطلب |
global | النوع البولي | قيمة بولية تحدد ما إذا كان يجب إطلاق معالج الحدث AJAX العالمي. القيمة الافتراضية هي true |
ifModified | النوع البولي | قيمة بولية تحدد ما إذا كان يجب أن تكون الطلب ناجحًا فقط عندما يتم تغيير الرد على الطلب منذ آخر مرة. القيمة الافتراضية هي: false. |
jsonp | نص أو بولية | تغطية وظيفة اللفظ المدمج في طلب jsonp. |
jsonpCallback | دالة | تحديد اسم الوظيفة التي يتم استدعاؤها في طلب jsonp. |
method | النص | تحديد طريقة HTTP التي يتم استخدامها في الطلب. (الإلتقاط أو الإضافة). القيمة الافتراضية هي GET |
password | النص | تحديد كلمة المرور التي يتم استخدامها في طلب التحقق من صحة HTTP. |
processData | النوع البولي | قيمة بولية، تحدد ما إذا كان يجب تحويل البيانات التي يتم إرسالها مع الطلب إلى سلسلة استعلام. القيمة الافتراضية هي true |
scriptCharset | النص | تحديد مجموعة الحروف للطلب |
statusCode | عنصر عادي | عنصر عادي يحتوي على عدد من الأرقام HTTP وكائنات الوظائف التي سيتم استدعاؤها عند وجود استجابة بهذه الأرقام$.ajax({ statusCode: { 404: function() { alert(“لا يمكن العثور على الصفحة”) } } }) |
success(response,status,xhr) | دالة | الوظيفة التي سيتم تشغيلها عند نجاح الطلب |
timeout | رقم | الوقت المحدد للتحقق المحلي (بالميليسي ثانية) |
traditional | النوع البولي | قيمة بولية، تحدد ما إذا كان سيتم استخدام نمط سلسلة المعلمات التقليدية |
type | النص | methodاسم المستخدم. إذا كنت تستخدم إصدار jQuery 1.9.0 أو أقدم، يجب عليك استخدام type |
url | النص | تحديد URL التي سيتم إرسال الطلب إليها. إذا لم يتم تحديد أي شيء، سيكون الطلب إلى الصفحة الحالية |
username | النص | تحديد اسم المستخدم الذي سيتم استخدامه في طلب التحقق من هوية HTTP |
xhr | دالة | دالة لإنشاء عنصر XMLHttpRequest |