الأحداث في jQuery

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

تُستخدَم التوابع الموجودة في هذا القسم لتسجيل سلوكيات محدَّدة تحدث عندما وقع حدث معين ناتج عن تفاعل المستخدم مع المتصفح. أضف إلى ذلك وجود توابع تساعد على التعديل والتلاعب بتلك السلوكيات المسجلة مسبقًا.

‎.bind()‎

يُرفِق هذا التّابع مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر.

‎.blur()‎

يربط هذا التّابع مُعالِج أحداث (event handler) إلى حدث الضّبابيّة ‎(blur)‎ في JavaScript، أو يُطلِق هذا الحدث على عنصر ما.

‎.change()‎

يربط هذا التّابع مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو يُطلِق هذا الحدث على عنصر ما.

‎.click()‎

يربط هذا التّابع مُعالِج الأحداث (event handler) إلى الحدث click في JavaScript أو يُطلِق هذا الحدث على عنصر ما.

‎.contextmenu()‎

يربط هذا التّابع مُعالِج أحداث (event handler) إلى الحدث ‎contextmenu‎ في JavaScript، أو يُطلِق هذا الحدث على عنصر ما.

‎.dblclick()‎

يربط هذا التابع معالج حدث بحدث "dblclick" من JavaScript، أو يُطلق هذا الحدث على عنصرٍ ما.

‎.delegate()‎

إرفاق معالج بأحد الأحداث أو أكثر لكافة العناصر التي تطابق المُحدِد، الآن أو في المستقبل، استنادًا إلى مجموعة محددة من عناصر الجذر.

‎.error()‎

ربط معالج الحدث بحدث الخطأ "error" في JavaScript.

=‎event.currentTarget

عنصر DOM الحالي خلال مرحلة إنتاج فقاعات الحدث.

‎event.data

كائن اختياري يحتوي على بيانات الحدث، يُمرر إلى دالة معالجة الحدث.

‎event.delegateTarget

العنصر المُرفق به معالج أحداث jQuery المُستدعى حاليًا.

‎event.isDefaultPrevented()‎

يتحقق هذا التابع من استدعاء الحدث event.preventDefault()‎‎ على كائن الحدث هذا.

event‎.isImmediatePropagationStopped()‎

تتحقق هذه الخاصية من استدعاء الحدث event.stopImmediatePropagation()‎‎ على كائن الحدث هذا.

‎event.isPropagationStopped()‎

نتحقق هذه الخاصية من استدعاء الحدث event.stopPropagation()‎‎ على كائن الحدث هذا.

‎event.metaKey

تشير هذه الخاصية إذا ما كان مفتاح META مضغوطًا عند إطلاق الحدث.

event‎.namespace

تعيد هذه الخاصية مجال الأسماء (namespace) المستخدم عند إطلاق الحدث.

‎event.pageX

تُعيد هذه الخاصية موضع الفأرة بالنسبة إلى الحافة اليسرى للمستند.

‎event.pageY

تُعيد هذه الخاصية موضع الفأرة بالنسبة إلى الحافة العلوية للمستند.

‎event.preventDefault()‎

استدعاء هذه الخاصية يُعطل إطلاق الإجراء الافتراضي للحدث.

‎event.relatedTarget

عنصر DOM الآخر المتضمن في الحدث، إن وجد.

‎event.result

تعيد هذه الخاصية القيمة الأخيرة المُعادة بواسطة معالج الأحداث الذي أطلقه هذا الحدث، ما لم تكن هذه القيمة غير معرفة undefined.

‎event.stopImmediatePropagation()‎

تمنع هذه الخاصية تنفيذ بقية معالجات الأحداث ومنع الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling).

‎event.stopPropagation()‎

يمنع هذا التابع الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث.

‎event.target

تعيد هذه الخاصية عنصر DOM الذي بدأ الحدث.

‎event.timeStamp

فرق الوقت محسوب بالميللي ثانية بين وقت إنشاء المتصفح للحدث وليلة رأس سنة 1970.

‎event.type

تصف هذه الخاصية طبيعة الحدث.

‎event.which

لكل حدث يتولد من لوحة المفاتيح أو الفأرة، تشير هذه الخاصية إلى المفتاح أو الزر المحدد المضغوط عليه.

‎.focus()‎

ربط دالة معالج أحداث بحدث "focus" من JavaScript، أو إطلاق هذا الحدث على عنصر.

‎.focusin()‎

يربط هذا التابع دالة معالج الحدث بحدث "focusin" من JavaScript.

‎.focusout()‎

يربط هذا التابع دالة معالج الحدث بحدث "focusout" من JavaScript.

‎.hover()‎

يربط هذا التابع معالجًا واحدًا أو معالجين بالعناصر المطابقة لتُنفَّذ عندما يدخل ويخرج مؤشر الفأرة من حيز العناصر.

‎jQuery.holdReady()‎

يعلِّق هذا التابع تنفيذ الحدث ready في jQuery أو يحرِّره إن كان معلَّقًا.

jQuery‎.queue()‎

يعرض هذا التابع طابور الدوال المراد تنفيذها على العنصر المطابق.

‎.keydown()‎

يربط هذا التابع معالج حدث معين مع الحدث keydown (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.keypress()‎

يربط هذا التابع معالج حدث معين مع الحدث keypress (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.keyup()‎

يربط هذا التابع معالج حدث معين مع الحدث keyup (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.live()‎

يربط هذا التابع معالج حدث معين بجميع العناصر التي طابقت المحدِّد الحالي الآن وفي المستقبل.

‎.mousedown()‎

يربط هذا التابع معالج حدث معين مع الحدث mousedown (الضغط على زر الفأرة) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.mouseenter()‎

يربط هذا التابع معالج حدث معين مع الحدث mouseenter عندما يدخل مؤشِّر الفأرة حيِّز عنصر، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.mouseleave()‎

يربط هذا التابع معالج حدث معين مع الحدث mouseleave عندما يخرج مؤشِّر الفأرة من حيِّز عنصرٍ، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.mousemove()‎

يربط هذا التابع معالج حدث معين مع الحدث mousemove (التحرك داخل العنصر) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.mouseout()‎

يربط هذا التابع معالج حدث معين مع الحدث mouseout (الخروج من حيِّز عنصر) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.mouseover()‎

يربط هذا التابع معالج حدث معين مع الحدث mouseover (الدخول حيِّز عنصر) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.mouseup()‎

يربط هذا التابع معالج حدث معين مع الحدث mouseup (تحرير زر الفأرة المضغوط) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.off()‎

يزيل هذا التابع معالج حدث معين.

‎.on()‎

يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة.

‎.one()‎

يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة. يُنفَّذ معالج الحدث مرةً واحدةً لكل عنصر ولكل نوع من الأحداث المرتبطة.

‎.ready()‎

ينفِّذ هذا التابع دالةً عندما تكون شجرة DOM جاهزة.

‎.resize()‎

يربط هذا التابع معالج حدث معين مع الحدث resize في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.scroll()‎

يربط هذا التابع معالج حدث معين مع الحدث scroll في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.select()‎

يربط هذا التابع معالج حدث معين مع الحدث select في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.submit()‎

يربط هذا التابع معالج حدث معيَّن مع الحدث submit في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.

‎.toggle_event()‎

ربط معالجين أو أكثر بالعناصر المتطابقة، لتنفيذها بالتناوب.

‎.trigger()‎

تنفيذ جميع المعالجات والسلوكيات المرفقة بالعناصر المطابقة لنوع الحدث المُدخَل.

‎.triggerHandler()‎

تنفيذ كافة معالجات الأحداث التي تتعلق على عنصرٍ لحدث.

‎.unbind()‎

إزالة معالج أحداث سبق إرفاقه بالعناصر.

‎.undelegate()‎

إزالة معالج من الحدث لكافة العناصر التي تطابق المُحدِّد الحالي، استنادًا إلى مجموعة محددة من عناصر الجذر.

‎.unload()‎

ربط أحد معالجات الأحداث بحدث unload في JavaScript.