عرض مصدر jQuery/event/stopPropagation

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

=== القيمة المعادة ===
يُعيد هذا التابع القيمة <code>[[JavaScript/undefined|undefined]]</code>.

=== الوصف ===
يمنع هذا التابع الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث.

=== <code>event.stopPropagation()‎</code> ===
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.0 1.0].

لا يقبل هذا التابع أي وسائط.

يُستخدم التابع <code>[[jQuery/event/isPropagationStopped|event.isPropagationStopped()]]</code>‎ للحقق من استدعاء هذا التابع (على كائن الحدث هذا).

يعمل هذا التابع مع الأحداث المخصصة المُطلَقة بواسطة التابع <code>[[jQuery/trigger|trigger()‎]]</code> أيضًا.

لاحظ أن هذا التابع لن يمنع المعالجات الأخرى من العمل على نفس العنصر.

=== ملاحظات إضافية ===
نظرًا لأن التابع ‎<code>[[jQuery/live|.live()‎]]</code> يعالج الأحداث بمجرد نشرها إلى أعلى المستند، لا يمكن إيقاف نشر أحداث live. وبالمثل، فإن الأحداث التي يعالجها التابع ‎<code>[[jQuery/delegate|.delegate()]]</code>‎ سوف تنتشر إلى العناصر التي فُوِّضَت إليها؛ ستُنفَّذ بالفعل معالجات الأحداث المرتبطة بأي عناصر تحتها في شجرة DOM في الوقت الذي يُستدعى فيه معالج الحدث المفوَّض. لذلك، قد تمنع هذه المعالجات المعالجَ المفوَّض من التشغيل عن طريق استدعاء <code>event.stopPropagation()‎</code> أو إعادة <code>false</code> .

=== أمثلة ===
منع انتقال الأحداث عبر شجرة DOM إلى العناصر الأب عند وقوع حدث النقر:<syntaxhighlight lang="javascript">
$( "p" ).click(function( event ) {
  event.stopPropagation();
  // Do something
});
</syntaxhighlight>

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