التابع .focusout()
في jQuery
.focusout( handler )
القيمة المعادة
يُعيد كائنًا من النوع jQuery.
الوصف
يربط هذا التابع دالة معالج الحدث بحدث "focusout " من JavaScript.
.focusout( handler )
أُضيف مع الإصدار: 1.4.
handler
دالة على الشكل Function( Event eventObject )، تُنفَّذ في كل مرة يُطلَق فيها الحدث.
.focusout( [eventData ], handler )
أُضيف مع الإصدار: 1.4.3.
eventData
كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript.
handler
دالة على الشكل Function( Event eventObject )، تُنفَّذ في كل مرة يُطلَق فيها الحدث.
.focusout()
أُضيف مع الإصدار: 1.0.
لا يقبل هذا الشكل أي وسائط.
يُعد هذا التابع اختصارًا للتابع .on( "focusout", handler )
عند تمرير الوسائط، والتابع .trigger( "focusout" )
عند عدم تمرير أية وسائط.
يُرسَل الحدث focusout
إلى عنصرٍ ما عندما يكون هو، أو أي عنصر داخله، يفقد التركيز. ويختلف هذا عن الحدث blur
في أنه يدعم الكشف عن فقدان التركيز على العناصر السليلة (وبعبارة أخرى، فإنه يدعم فقاعات الحدث).
من الممكن استخدام هذا الحدث مع حدث focusin
.
ملاحظات إضافية
لما كان التابع .focusout()
هو مجرد اختصار للتابع .on( "focusout", handler )
، فإن فك الارتباط ممكن باستخدام .off( "focusout" )
.
أمثلة
مراقبة فقدان التركيز حين يحدث داخل الفقرات وملاحظة الفرق بين عدد focusout
وعدد blur
. (لا يتغير عدد blur
لأن هذه الأحداث لا تنتج فقاعات).