عرض مصدر jQuery/undelegate

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

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

اٌُهمل مع الإصدار: [http://api.jquery.com/category/version/3.0 3.0].

=== الوصف ===
إزالة معالج من الحدث لكافة العناصر التي تطابق المُحدِّد الحالي، استنادًا إلى مجموعة محددة من عناصر الجذر.

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

هذا الشكل لا يقبل أي وسائط.

=== <code>‎.undelegate( selector, eventType )‎</code> ===
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.4.2 1.4.2].

==== <code>selector</code> ====
المحدد المستخدم لترشيح نتائج الحدث، وهو من النوع [[JavaScript/String|<code>String</code>]].

==== <code>eventType</code> ====
سلسلة نصية من النوع <code>[[JavaScript/String|String]]</code> تحتوي على نوع حدث في JavaScript، مثل <code>click</code> أو <code>keydown</code>.

=== <code>‎.undelegate( selector, eventType, handler )‎</code> ===
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.4.2 1.4.2].

==== <code>selector</code> ====
المحدد المستخدم لترشيح نتائج الحدث، وهو من النوع [[JavaScript/String|<code>String</code>]].

==== <code>eventType</code> ====
سلسلة نصيةمن النوع [[JavaScript/String|<code>String</code>]] تحتوي على نوع حدث في JavaScript، مثل <code>click</code> أو <code>keydown</code>.

==== <code>handler</code> ====
دالة تُنفذ عند إطلاق الحدث، وهي على الشكل <code>[[JavaScript/Function|Function]]( Event eventObject )‎</code>.

=== <code>‎.undelegate( selector, events )‎</code> ===
أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.4.3 1.4.3].

==== <code>selector</code> ====
المحدد المستخدم لترشيح نتائج الحدث، وهو من النوع [[JavaScript/String|<code>String</code>]].

==== <code>events</code> ====
كائن من النوع [[JavaScript/Object|PlainObject]] وهو يحتوي على نوع حدث واحد أو أكثر ودوال مرتبطة مسبقًا لإزالتها منها.

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

==== <code>namespace</code> ====
سلسلة نصية من النوع [[JavaScript/String|<code>String</code>]] تحتوي على مساحة اسم المراد إزالة كل الأحداث منها.

أهمل <code>‎.undelegate()</code>‎‎ بدءًا من الإصدار jQuery [http://api.jquery.com/category/version/3.0 3.0]. وحل محله التابع <code>[[jQuery/off|‎.off()‎]]</code> منذ الإصدار jQuery [http://api.jquery.com/category/version/1.7 1.7]، لذا كان استخدامه غير محبذ بالفعل.

يعد التابع <code>‎.undelegate()</code>‎‎ طريقة لإزالة معالجات الأحداث التي سبق ربطها باستخدام <code>[[jQuery/delegate|‎.delegate()‎]]</code>.

=== أمثلة ===
يمكن ربط الأحداث بالزر الملون ثم إزالتها منه:<syntaxhighlight lang="html">
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>undelegate demo</title>
  <style>
  button {
    margin: 5px;
  }
  button#theone {
    color: red;
    background: yellow;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<button id="theone">لا يحدث شيء...</button>
<button id="bind">ربط النقر</button>
<button id="unbind">إزالة النقر</button>
<div style="display:none;">انقر!</div>
 
<script>
function aClick() {
  $( "div" ).show().fadeOut( "slow" );
}
$( "#bind" ).click(function() {
  $( "body" )
    .delegate( "#theone", "click", aClick )
    .find( "#theone" ).text( "يمكن النقر!" );
});
$( "#unbind" ).click(function() {
  $( "body" )
    .undelegate( "#theone", "click", aClick )
    .find( "#theone" ).text( "لا يحدث شيء..." );
});
</script>
 
</body>
</html>
</syntaxhighlight>لإزالة جميع الأحداث المُرفقة من جميع الفقرات <code>[[HTML/p|<nowiki><p></nowiki>]]</code>:<syntaxhighlight lang="jquery">
$( "p" ).undelegate();
</syntaxhighlight>لإزالة جميع أحداث النقر المُرفقة من جميع الفقرات <code>[[HTML/p|<nowiki><p></nowiki>]]</code>:<syntaxhighlight lang="jquery">
$( "p" ).undelegate( "click" );

</syntaxhighlight>لإزالة معالج واحد سبق إرفاقه، تُمرر الدالة كوسيط ثالث:<syntaxhighlight lang="jquery">
var foo = function () {
  // شيفرة للتعامل مع نوع من الأحداث
};
 
//  ... الآن سيستدعى foo عند النقر فوق الفقرات ...
$( "body" ).delegate( "p", "click", foo );
 
//  ... لن يستدعى foo بعد الآن.
$( "body" ).undelegate( "p", "click", foo );

</syntaxhighlight>لإزالة جميع الأحداث المُرفقة من خلال مجال الأسماء الخاص بها:<syntaxhighlight lang="jquery">
var foo = function() {
  // شيفرة للتعامل مع نوع من الأحداث
};
 
// إرفاق الأحداث تحت مساحة الاسم ".whatever"
$( "form" ).delegate( ":button", "click.whatever", foo );
 
$( "form" ).delegate( "input[type='text'] ", "keypress.whatever", foo );
 
// إلغاء ارفاق كافة الأحداث المرفقة تحت مساحة الاسم ".whatever"
$( "form" ).undelegate( ".whatever" );
</syntaxhighlight>

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