English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
طريقة .ajax() تنفذ طلبات HTTP متزامنة (Ajax).
$.ajax() هو أساس جميع الطلبات Ajax التي يرسلها jQuery. عادة لا تحتاج إلى استدعاء هذه الطريقة مباشرة، لأن يمكنك$.get(),$.post()وload()بعض الطرق البديلة الأكثر تقدماً، ويمكن استخدامها بشكل أسهل. ولكن، إذا كنت بحاجة إلى خيارات أقل، يمكن استخدام $.ajax() بشكل أكثر مرونة.
النوع الأول من الجملة: إصدار 1.5+:
$.ajax(url, {name:value, name:value, ...})النوع الثاني من الجملة 1.0+ إصدار:
$.ajax(name:value, name:value, ...)
استخدامإضافةلطلبات AJAXالإصدارتغيير نص عنصر DIV: إصدار 1.5:
$.ajax("ajax_intro.txt", {success: function(response){
$("div").html(response);
});اختبار لـ‹/›استخدامإضافةلطلبات AJAXالإصدارتغيير نص عنصر DIV1.0الإصدار:
$.ajax({
url: "ajax_intro.txt",
success: function(response){
$("div").html(response);
}
});اختبار لـ‹/›طلب صفحة ajax_get.php وإرسال بعض البيانات الأخرى:
$.ajax({
url: "ajax_get.php",
data: {fname:"Seagull", lname:"Anna"},
success: function(response){
$("div").html(response);
}
});اختبار لـ‹/›طلب صفحة ajax_get.php وإرسال بعض البيانات الأخرى، وإطلاق رسالة حالة الإشعار:
$.ajax({
url: "ajax_get.php",
data: {fname:"Seagull", lname:"Anna"},
success: function(response, status){
$("div").html(response);
alert(status);
}
});اختبار لـ‹/›استخدام طريقة HTTP POST لطلب صفحة ajax_post.php:
$.ajax({
url: "ajax_post.php",
method: "POST",
success: function(response){
$("div").html(response);
}
});اختبار لـ‹/›استخدام إعداد الاتصال المتسلسل لتعيين الطلب المتسلسل:
$.ajax({
url: "ajax_get.php",
async: false,
data: {fname:"Seagull", lname:"Anna"},
success: function(response){
$("div").html(response);
}
});اختبار لـ‹/›استخدام dataType لتعيين نوع البيانات المطلوبة في الطلب:
$.ajax({
url: "/javascript/myscript.js",
dataType: "script"
});اختبار لـ‹/›إذا واجهت طلبات Ajax خطأ، فأظهر إشعارًا:
$.ajax({
url: "wrong_file.html",
success: function(response){
$("div").html(response);
},
error: function(xhr){
$("div").html("خطأ: " + xhr.status + " " + xhr.statusText);
}
});اختبار لـ‹/›طلب ملف، وإعلام المستخدم عند إكمال العملية. إذا فشل الطلب، فأظهر إشعارًا:
let request = $.ajax({
url: "ajax_get.php",
data: {fname:"Seagull", lname:"Anna"}
});
request.done(function(msg){
$("div").html(msg);
});
request.fail(function(xhr, textStatus){
$("div").html("فشل الطلب: " + textStatus);
});اختبار لـ‹/›تحديد اسم:قيمة واحدة أو أكثر للطلب AJAX
الاسم المحتمل: القيم المدرجة في الجدول أدناه:
| الاسم | نوع القيمة | الوصف |
|---|---|---|
| async | بولية | قيمة بولية تحدد ما إذا كان يجب معالجة الطلب بشكل متسلسل. القيمة الافتراضية هي true |
| beforeSend(xhr) | دالة | الوظيفة التي يتم تنفيذها قبل إرسال الطلب |
| cache | بولية | قيمة بولية تحدد ما إذا كان يجب على المتصفح حفظ صفحة الطلب. القيمة الافتراضية هي true |
| complete(xhr,status) | دالة | الوظيفة التي يتم تنفيذها عند اكتمال الطلب (بعد الوظائف الناجحة والفاشلة) |
| contentType | قيمة بولية أو نص | نوع المحتوى المستخدم لإرسال البيانات إلى الخادم. القيمة الافتراضية هي "application / x-www-form-urlencoded" |
| context | عنصر عادي | تحديد قيمة "this" لجميع الدوال التدعيمية ذات الصلة بAJAX |
| 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 code ووظيفة$.ajax({
statusCode: {
404: function() {
alert('لا يمكن العثور على الصفحة');
}
}
}) |
| success(response,status,xhr) | دالة | الوظيفة التي سيتم تشغيلها عند نجاح الطلب |
| timeout | رقم | التوقيت المحلي للطلب (بالميليسيوندات) |
| traditional | بولية | قيمة بولية، تحدد ما إذا كان سيتم استخدام شكل سلسلة التقديم التقليدية |
| type | الخط | methodالاسم المبدئي. إذا كنت تستخدم إصدار jQuery 1.9.0 أو أقل، فعليك استخدام type |
| url | الخط | تحديد URL التي سيتم إرسال الطلب إليها. الافتراض هو الصفحة الحالية |
| username | الخط | تحديد اسم المستخدم الذي سيتم استخدامه في طلب التحقق من هوية HTTP |
| xhr | دالة | دالة لإنشاء ملف XMLHttpRequest |