التابع .focusin() في jQuery
.focusin( handler )
القيمة المعادة
يُعيد كائنًا من النوع jQuery.
الوصف
يربط هذا التابع دالة معالج الحدث بحدث "focusin" من JavaScript.
.focusin( handler )
أُضيف مع الإصدار: 1.4.
handler
دالة على الشكل Function( Event eventObject )، وتُنفَّذ في كل مرة يُطلَق فيها الحدث.
.focusin( [eventData ], handler )
أُضيف مع الإصدار: 1.4.3.
eventData
كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript.
handler
دالة على الشكل Function( Event eventObject )، وتُنفَّذ في كل مرة يُطلَق فيها الحدث.
.focusin()
أُضيف مع الإصدار: 1.0.
لا يقبل هذا الشكل أي وسائط.
يُعد هذا التابع اختصارًا للتابع .on( "focusin", handler ) في صورته الأولى والثانية، والتابع .trigger( "focusin" ) في صورته الثالثة.
يُرسَل الحدث focusin إلى عنصرٍ ما عندما يكون هو، أو أي عنصر داخله، ينال التركيز. ويختلف هذا عن الحدث focus في أنه يدعم الكشف عن حدث التركيز على العناصر الأب (وبعبارة أخرى، فإنه يدعم انتقال الأحداث [event bubbling]).
من الممكن استخدام هذا الحدث مع حدث focusout.
ملاحظات إضافية
لما كان التابع .focusin() هو مجرد اختصار للتابع .on( "focusin", handler )، فإن فك الارتباط ممكن باستخدام .off( "focusin" ).
أمثلة
مراقبة التركيز حين يحدث داخل الفقرات <p> في الصفحة:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>focusin demo</title>
<style>
span {
display: none;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<p><input type="text"> <span>focusin fire</span></p>
<p><input type="password"> <span>focusin fire</span></p>
<script>
$( "p" ).focusin(function() {
$( this ).find( "span" ).css( "display", "inline" ).fadeOut( 1000 );
});
</script>
</body>
</html>