عرض مصدر jQuery/ajaxComplete

<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.ajaxComplete()‎‎</code>‎ في jQuery}}</noinclude>

== <code>‎.ajaxComplete( handler )‎</code> ==

=== القيمة المعادة ===
كائن [[jQuery/jQuery|jQuery]].

=== الوصف ===
يُستخدَم التّابع ‎<code>.ajaxComplete()‎</code> لتسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. يُعدُّ هذا التّابع حدثًا من [[JQuery/ajax events|أحداث Ajax]].

=== <code>‎.ajaxComplete( handler )‎</code> ===
أضيفت في الإصدار: 1.0.

==== <code>handler</code> ====
دالة على الشكل ‎<code>[[JavaScript/Function|Function]]( [[JavaScript/Event|Event]] event, [[jQuery/jqXHR|jqXHR]] jqXHR, [[JavaScript/Object|PlainObject]] ajaxOptions )‎</code>،وهي الدالة التي ستُستدعى.

حالما يكتمل تنفيذ طلب Ajax، تُطلَق jQuery الحدث <code>ajaxComplete</code>، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع‎<code>.ajaxComplete()</code> ‎.

لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط لتحميل Ajax:<syntaxhighlight lang="html">
<div class="trigger">Trigger</div>
<div class="result"></div>
<div class="log"></div>

</syntaxhighlight>أرفِق مُعالِج الحدث (event handler) إلى المستند:<syntaxhighlight lang="javascript">
$( document ).ajaxComplete(function() {
  $( ".log" ).text( "Triggered ajaxComplete handler." );
});

</syntaxhighlight>نفذ الآن طلب Ajax باستخدام أي تابع jQuery:<syntaxhighlight lang="javascript">
$( ".trigger" ).click(function() {
  $( ".result" ).load( "ajax/test.html" );
});

</syntaxhighlight>عندما يضغط المستخدم على العنصر الذي يمتلك الصنف <code>trigger</code> ويكتمل تنفيذ طلب Ajax، ستُعرَض رسالة السّجل.

تُستدعَى كافة مُعالِجات الحدث <code>ajaxComplete</code> عند اكتمال تنفيذ أي طلب Ajax، إن كنت تريد التفريق بين الطلبات فاستخدم المعاملات الممررة لمُعالِج الأحداث، ففي كل مرة يُنفَّذ فيها مُعالِج الحدث <code>ajaxComplete</code> يُمرِّر كائن الحدث، والكائن <code>XMLHttpRequest</code>، وكائن الإعدادات الذي استُخدِم في إنشاء الطّلب. بإمكاننا على سبيل المثال حصر الاستدعاء فقط من أجل الأحداث التي تتعامل مع روابط معينة:<syntaxhighlight lang="javascript">
$( document ).ajaxComplete(function( event, xhr, settings ) {
  if ( settings.url === "ajax/test.html" ) {
    $( ".log" ).text( "Triggered ajaxComplete handler. The result is " +
      xhr.responseText );
  }
});

</syntaxhighlight>'''ملاحظة:''' بإمكاننا الحصول على محتوى Ajax المُعاد عن طريق <code>xhr.responseText</code>.

=== ملاحظات إضافية ===
بدءًا من إصدار jQuery 1.9 أصبح إرفاق مُعالِجات الأحداث لأحداث Ajax العامة (jQuery global Ajax events) بالمستند إجباريًّا، بما في ذلك مُعالِجات الأحداث المُضافة عن طريق التّابع <code>‎.ajaxComplete()‎</code>.

إن استدعينا التابع ‎<code>[[jQuery/jQuery/ajax|$.ajax()]]</code>‎ أو ‎<code>[[jQuery/jQuery/ajaxSetup|$.ajaxSetup()]]</code>‎ مع تعيين الخيار <code>global</code> إلى القيمة <code>false</code>، فلن يُنفَّذ التّابع ‎<code>.ajaxComplete()</code>‎.

=== أمثلة ===
إظهار رسالة عند اكتمال طلب Ajax:<syntaxhighlight lang="javascript">
$( document ).ajaxComplete(function( event, request, settings ) {
  $( "#msg" ).append( "<li>Request Complete.</li>" );
});

</syntaxhighlight>

== مصادر ==
* <span> </span>[http://api.jquery.com/ajaxComplete/ صفحة التابع ‎‎.ajaxComplete()‎ في توثيق jQuery الرسمي].
[[تصنيف:jQuery]]
[[تصنيف:jQuery Method]]
[[تصنيف:jQuery Ajax]]