التابع .mouseup() في jQuery
.mouseup( handler )
القيم المعادة
يعيد كائنًا من النوع jQuery.
الوصف
يربط هذا التابع معالج حدث معين مع الحدث mouseup (تحرير زر الفأرة المضغوط) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.mouseup( handler )
أُضيف مع الإصدار: 1.0.
handler
دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعَى فيها الحدث.
.mouseup( [eventData ], handler )
أُضيف مع الإصدار: 1.4.3.
eventData
أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة استخدام أي نوع)، ويُمثِّل كائنًا يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الأحداث.
handler
دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث.
.mouseup()
أُضيف مع الإصدار: 1.0، ولا يقبل هذا الشكل من التابع أي معلامات.
هذا التابع هو اختصار للتابع .on( "mouseup", handler ) في شكله الأول والثاني، واختصار للتابع .trigger( "mouseup" ) في شكله الثالث.
يُرسل الحدث mouseup إلى عنصرٍ عند تحرير زر الفأرة المضغوط ومؤشِّرها فوق هذا العنصر. يمكن أن تستقبل جميع عناصر HTML هذا الحدث.
انظر مثلًا إلى شيفرة HTML التالية:
<div id="target">
اضغط هنا
</div>
<div id="other">
استدعِ معالج الحدث
</div>
يمكن أن يُربَط معالج الحدث مع أي عنصر <div>:
$( "#target" ).mouseup(function() {
alert( "استدعي معالج الحدث بنجاح" );
});
عند الضغط على هذا العنصر، فسيظهر التنبيه التالي:
استُدعي معالج الحدث بنجاح
يمكن أيضًا استدعاء الحدث عند الضغط على عنصر آخر غير العنصر المطلوب:
$( "#other" ).click(function() {
$( "#target" ).mouseup();
});
بعد تنفيذ هذه الشيفرة، سيظهر التنبيه السابق أيضًا بالضغط على "استدعِ معالج الحدث".
إن ضغط المستخدم زر الفأرة خارج حيِّز العنصر ثمَّ حرك المؤشِّر إلى داخل العنصر وأفلت الزر الذي ضغطه، فهذا يعدُّ على أنه الحدث mouseup. لا تُعامل هذه السلسلة من الأحداث على أنَّها ضغطة زر في أغلب واجهات المستخدم، لذا يستحسن عادةً استعمال الحدث click ما لم يكن استعمال الحدث mouseup هو الأفضل في حالات معيَّنة.
ملاحظات إضافية
لمَّا كان التابع .mouseup() اختزالٌ للتابع .on( "mouseup", handler )، فمن الممكن استعمال .off( "mouseup" ) لإزالة الحدث mouseup أي عملية معاكسة لما سبق.
أمثلة
إظهار نصوص معينة عند استدعاء الحدث mouseup والحدث mousedown:
<!doctype html>
<html lang="ar">
<head>
<meta charset="utf-8">
<title>mouseup مثالٌ عن استعمال التابع</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<p>اضغط على زر الفأرة وحرّره هنا</p>
<script>
$( "p" )
.mouseup(function() {
$( this ).append( "<span style='color:#f00;'>حُرّر زر الفأرة</span>" );
})
.mousedown(function() {
$( this ).append( "<span style='color:#00f;'>ضُغط على زر الفأرة</span>" );
});
</script>
</body>
</html>