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