الفرق بين المراجعتين لصفحة: «jQuery/change»
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>.change()</code> في jQuery}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>.change()</code> في jQuery}}</noinclude> | ||
==<code>.change( handler )</code>== | |||
== <code>.change( handler )</code> == | |||
===القيمة المعادة=== | ===القيمة المعادة=== | ||
كائن [[JQuery/jQuery|jQuery]]. | كائن [[JQuery/jQuery|jQuery]]. | ||
===الوصف=== | ===الوصف=== | ||
يُستخدَم التابع <code>.change()</code> في ربط مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو إطلاق هذا الحدث على عنصر ما. | يُستخدَم التابع <code>.change()</code> في ربط مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو إطلاق هذا الحدث على عنصر ما. | ||
===<code>.change( handler )</code>=== | |||
=== <code>.change( handler )</code> === | |||
أضيفت في الإصدار: 1.0. | أضيفت في الإصدار: 1.0. | ||
====<code>handler</code>==== | ====<code>handler</code>==== | ||
دالة على الشكل [[JavaScript/Function|Function]]( [[JavaScript/Event|Event]] eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث. | دالة على الشكل [[JavaScript/Function|Function]]( [[JavaScript/Event|Event]] eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث. | ||
===<code>.change( [eventData ], handler )</code>=== | |||
=== <code>.change( [eventData ], handler )</code> === | |||
أضيفت في الإصدار: 1.4.3. | أضيفت في الإصدار: 1.4.3. | ||
====<code>eventData</code>==== | ====<code>eventData</code>==== | ||
أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الأحداث. | أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الأحداث. | ||
====<code>handler</code>==== | ====<code>handler</code>==== | ||
دالة على الشكل [[JavaScript/Function|Function]]( [[JavaScript/Event|Event]] eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث. | دالة على الشكل [[JavaScript/Function|Function]]( [[JavaScript/Event|Event]] eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث. | ||
===<code>.change()</code>=== | |||
=== <code>.change()</code> === | |||
أضيفت في الإصدار: 1.0. | أضيفت في الإصدار: 1.0. | ||
| سطر 28: | سطر 21: | ||
يُعدُّ هذا التّابع اختصارًا للتابع <code>.on( "change", handler )</code> في أول شكلين له، وللتّابع <code>.trigger( "change" )</code> في شكله الثّالث. | يُعدُّ هذا التّابع اختصارًا للتابع <code>.on( "change", handler )</code> في أول شكلين له، وللتّابع <code>.trigger( "change" )</code> في شكله الثّالث. | ||
يُرسَل الحدث <code>change</code> إلى العنصر عندما تتغيّر قيمته، ويكون هذا الحدث محدودًا لعناصر <code>[[HTML/input|<input>]]</code>، و <code>[[HTML/textarea|<textarea>]]</code>، و <code>[[HTML/select|<select>]]</code>. يُطلَق هذا الحدث مباشرةً بالنسبة لمربّعات الاختيار ومربّعات التأشير وأزرار الانتقاء (radio buttons) عندما يختار المستخدم عن طريق الفأرة، ولكن يُؤجَّل بالنسبة لأنواع العناصر الأخرى حتى يفقد العنصر التركيز عنه | |||
مراجعة 16:13، 22 مايو 2018
.change( handler )
القيمة المعادة
كائن jQuery.
الوصف
يُستخدَم التابع .change() في ربط مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو إطلاق هذا الحدث على عنصر ما.
.change( handler )
أضيفت في الإصدار: 1.0.
handler
دالة على الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث.
.change( [eventData ], handler )
أضيفت في الإصدار: 1.4.3.
eventData
أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الأحداث.
handler
دالة على الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث.
.change()
أضيفت في الإصدار: 1.0.
لا يقبل هذا الشكل من التّابع أيّة وسائط.
يُعدُّ هذا التّابع اختصارًا للتابع .on( "change", handler ) في أول شكلين له، وللتّابع .trigger( "change" ) في شكله الثّالث.
يُرسَل الحدث change إلى العنصر عندما تتغيّر قيمته، ويكون هذا الحدث محدودًا لعناصر <input>، و <textarea>، و <select>. يُطلَق هذا الحدث مباشرةً بالنسبة لمربّعات الاختيار ومربّعات التأشير وأزرار الانتقاء (radio buttons) عندما يختار المستخدم عن طريق الفأرة، ولكن يُؤجَّل بالنسبة لأنواع العناصر الأخرى حتى يفقد العنصر التركيز عنه