التابع ‎‎.click()‎‎‎ في jQuery

‎.click( handler )‎

القيمة المعادة

كائن jQuery.

الوصف

يُستخدَم التابع ‎‎.click()‎‎ في ربط مُعالِج الأحداث (event handler) إلى الحدث click في JavaScript أو إطلاق هذا الحدث على عنصر ما.

‎.click( handler )‎

أضيفت في الإصدار: 1.0.

handler

دالة على الشكل ‎Function( Event eventObject )‎، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث.

‎.click( [eventData ], handler )‎

أضيفت في الإصدار: 1.4.3.

eventData

أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الأحداث.

handler

دالة على الشكل ‎Function( Event eventObject )‎، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث.

‎.click()‎

أضيفت في الإصدار: 1.0.

لا يقبل هذا الشكل من التّابع أيّة وسائط.

يُعدُّ هذا التّابع اختصارًا للتابع ‎.on( "click", handler )‎ في أول شكلين له، وللتّابع ‎.trigger( "click" )‎ في شكله الثّالث. يُرسَل الحدث click إلى العنصر عندما يكون مُؤشّر الفأرة فوق العنصر ويُنقَر على زر الفأرة ثمّ يُترَك. بإمكان أي عنصر HTML أن يستقبل هذا الحدث، فلنأخذ مثال HTML التالي:

<div id="target">
  انقر هنا
</div>
<div id="other">
  إطلاق مُعالِج الأحداث
</div>

يُمكِن ربط مُعالِج الحدث إلى عنصر ‎<div>‎:

$( "#target" ).click(function() {
  alert( "استُدعي معالج الأحداث للتابع .click()" );
});

إن ضغطنا الآن على هذا العنصر، ستُعرَض رسالة السّجل:

استُدعي معالج الأحداث للتابع .click()