jQuery 3.3

.mousedown()




jquery

.mousedown (معالج) إرجاع: jQuery

الوصف ؛: ربط معالج أحداث بحدث جافا سكريبت "mousedown" ، أو تشغيل هذا الحدث على عنصر.

  • الإصدار المضاف: 1.0 .mousedown (معالج)

    • معالج
      النوع: Function ( Event eventObject)
      هي وظيفة يتم تنفيذها في كل مرة يتم فيها تشغيل الحدث.
  • الإصدار المضاف: 1.4.3 .mousedown ([eventData] ، معالج)

    • eventData
      النوع: Anything
      كائن يحتوي على بيانات سيتم تمريرها إلى معالج الحدث.
    • معالج
      النوع: Function ( Event eventObject)
      هي وظيفة يتم تنفيذها في كل مرة يتم فيها تشغيل الحدث.
  • الإصدار المضاف: 1.0 .mousedown()

    • هذا التوقيع لا يقبل أي حجج.

هذه الطريقة هي اختصار لـ .on( "mousedown", handler) في الشكل الأول ، و .trigger( "mousedown" ) في الثانية.

يتم إرسال حدث mousedown إلى عنصر عندما يكون مؤشر الماوس فوق العنصر ، ويتم الضغط على زر الماوس. يمكن لأي عنصر HTML تلقي هذا الحدث.

على سبيل المثال ، ضع في اعتبارك HTML:

<div id="target">
  Click here
</div>
<div id="other">
  Trigger the handler
</div>
الشكل 1 - رسم توضيحي لصفحة HTML المقدمة

يمكن ربط معالج الحدث بأي <div> :

$( "#target" ).mousedown(function() {
  alert( "Handler for .mousedown() called." );
});

الآن إذا نقرنا على هذا العنصر ، فسيتم عرض التنبيه:

معالج لـ .mousedown () يسمى.

يمكننا أيضًا تشغيل الحدث عند النقر على عنصر مختلف:

$( "#other" ).click(function() {
  $( "#target" ).mousedown();
});

بعد تنفيذ هذه التعليمة البرمجية ، سيؤدي النقر فوق Trigger the handler أيضًا إلى تنبيه الرسالة.

يتم إرسال حدث mousedown عند النقر على أي زر ماوس. للتصرف فقط على أزرار محددة ، يمكننا استخدام خاصية الحدث الكائن. لا تدعم جميع المتصفحات هذه الخاصية (يستخدم Internet Explorer زرًا بدلاً من ذلك) ، ولكن jQuery يقوم بتطبيع الخاصية بحيث يكون استخدامها آمنًا في أي متصفح. ستكون القيمة 1 للزر الأيسر ، 2 للزر الأوسط ، أو 3 للزر الأيمن.

هذا الحدث مفيد بشكل أساسي لضمان أن الزر الأساسي قد تم استخدامه لبدء عملية السحب ؛ إذا تم تجاهلها ، يمكن أن تحدث نتائج غريبة عندما يحاول المستخدم استخدام قائمة السياق. بينما يمكن الكشف عن الأزرار الوسطى واليمنى بهذه الخصائص ، فإن هذا لا يمكن الاعتماد عليه. في Opera و Safari ، على سبيل المثال ، لا يمكن اكتشاف النقرات بزر الماوس الأيمن افتراضيًا.

إذا نقر المستخدم على عنصر ، اسحبه بعيدًا عنه ، ثم mousedown الزر ، فسيظل يتم حسابه mousedown . يتم التعامل مع تسلسل الإجراءات هذا على أنه "إلغاء" للضغط على الزر في معظم واجهات المستخدم ، لذلك من الأفضل عادة استخدام حدث click ما لم نكن نعلم أن حدث mousedown هو الأفضل لحالة معينة.

ملاحظات إضافية:

  • نظرًا .mousedown() طريقة .mousedown() هي مجرد اختصار لـ .on( "mousedown", handler ) ، فإن .off( "mousedown" ) ممكن باستخدام .off( "mousedown" ) .

مثال:

عرض النصوص عند تشغيل حدث الماوس والماوس.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>mousedown demo</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Press mouse and release here.</p>
 
<script>
$( "p" )
  .mouseup(function() {
    $( this ).append( "<span style='color:#f00;'>Mouse up.</span>" );
  })
  .mousedown(function() {
    $( this ).append( "<span style='color:#00f;'>Mouse down.</span>" );
  });
</script>
 
</body>
</html>

عرض: