نتائج البحث

اذهب إلى التنقل اذهب إلى البحث

العمل مع JavaScript في ريلز

يغطي هذا الدليل وظيفة Ajax/JavaScript المضمّنة في ريلز (والمزيد)؛ وسوف يمكنك من إنشاء تطبيقات Ajax غنية وديناميكية بكل سهولة! ستتعلم بعد قراءة هذا الدليل: أساسيات Ajax. جافاسكربت الواضحة (Unobtrusive JavaScript). كيف يساعدك مساعدو ريلز المدمجون (built-in helpers). كيفية التعامل مع Ajax من طرف الخادم. الجوهرة Turbolinks. مقدمة لفهم Ajax لفهم أجاكس، يجب أولًا فهم ما يفعله متصفّح الويب بشكل طبيعي. عندما تكتب http://localhost:3000 في شريط عنوان المتصفّح وتضغط على "Go" ، يقدّم المتصفح ("العميل") طلبًا للخادم، ويفرز الاستجابة ثم يجلب ...

التابع ‎‎.live()‎‎ في jQuery

‎.live( events, handler )‎ أهمل مع الإصدار: 1.7، وحذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين بجميع العناصر التي طابقت المحدِّد الحالي الآن وفي المستقبل. ‎.live( events, handler )‎ أُضيف مع الإصدار: 1.3. events سلسلة نصية تحتوي على نوع حدث JavaScript مثل "click" أو "keydown". يمكن للسلسلة النصية بدءًا من الإصدار jQuery 1.4 أن تحتوي على أنواع أحداث متعدِّدة مفصولةً بمسافة فارغة، أو أسماء أحداث مخصَّصة. handler دالة من الشكل ...

التابع ‎.delegate()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.delegate( selector, eventType, handler )‎ أُهمِل مع الإصدار: 3.0. القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يُرفق هذا التابع معالج بأحد الأحداث أو أكثر لكافة العناصر التي تطابق المُحدِد، الآن أو في المستقبل، استنادًا إلى مجموعة محددة من العناصر الجذر. ‎.delegate( selector, eventType, handler )‎ أُضيف مع الإصدار: 1.4.2. selector سلسلة نصية تُحدد ترشيح العناصر التي تبدأ الحدث من النوع String. eventType سلسلة نصية تحتوي على واحد أو أكثر من أنواع أحداث JavaScript مفصولة بمسافات، مثل "click"، أو "keydown,‎"، ...

التابع ‎‎.click()‎‎‎ في jQuery

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

التابع ‎.undelegate()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.undelegate()‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. اٌُهمل مع الإصدار: 3.0. الوصف إزالة معالج من الحدث لكافة العناصر التي تطابق المُحدِّد الحالي، استنادًا إلى مجموعة محددة من عناصر الجذر. ‎.undelegate()‎ أُضيف مع الإصدار: 1.4.2. هذا الشكل لا يقبل أي وسائط. ‎.undelegate( selector, eventType )‎ أُضيف مع الإصدار: 1.4.2. selector المحدد المستخدم لترشيح نتائج الحدث، وهو من النوع String. eventType سلسلة نصية من النوع String تحتوي على نوع حدث في JavaScript، مثل click أو keydown. ‎.undelegate( selector, eventType, handler )‎ ...

التابع ‎.trigger()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.trigger( eventType [, extraParameters ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تنفيذ جميع المعالجات والسلوكيات المرفقة بالعناصر المطابقة لنوع الحدث المُدخَل. ‎.trigger( eventType [, extraParameters ] )‎ أُضيف مع الإصدار: 1.0. eventType سلسلة نصية من النوع String تحتوي على نوع حدث JavaScript، مثل click أو submit . extraParameters معاملات إضافية لتمريرها إلى معالج الحدث وهي تكون من النوع Array أو PlainObject. ‎.trigger( event [, extraParameters ] )‎ أُضيف مع الإصدار: 1.3. event كائن jQuery.Event من النوع Event. ...

التابع ‎‎.one()‎‎ في jQuery

‎.one( events [, data ], handler )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر  بالعناصر المحدَّدة. يُنفَّذ معالج الحدث مرةً واحدةً لكل عنصر ولكل نوع من الأحداث المرتبطة. ‎.one( events [, data ], handler )‎ أُضيف مع الإصدار: 1.1. events سلسلة نصية تحتوي على نوع حدث واحد أو عدَّة أنواع من أحداث JavaScript مثل "click" أو "submit,‎". data كائن مجرَّد (Object) يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الحدث ...

التابع ‎.unbind()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.unbind( eventType [, handler ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. اٌُهمل مع الإصدار: 3.0. الوصف إزالة معالج أحداث سبق إرفاقه بالعناصر. ‎.unbind( eventType [, handler ] )‎ أُضيف مع الإصدار: 1.0. eventType سلسلة نصية من النوع String تحتوي على واحد أو أكثر من أنواع أحداث DOM، مثل click أو submit أو أسماء أحداث مخصصة. handler الدالة التي سيتوقف تنفيذها وهي على الشكل Function( Event eventObject )‎. ‎.unbind( eventType, false )‎ أُضيف مع الإصدار: 1.4.3. eventType سلسلة نصية ...

الأحداث في jQuery

تُستخدَم التوابع الموجودة في هذا القسم لتسجيل سلوكيات محدَّدة تحدث عندما وقع حدث معين ناتج عن تفاعل المستخدم مع المتصفح. أضف إلى ذلك وجود توابع تساعد على التعديل والتلاعب بتلك السلوكيات المسجلة مسبقًا. ‎.bind()‎ يُرفِق هذا التّابع مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر. ‎.blur()‎ يربط هذا التّابع مُعالِج أحداث (event handler) إلى حدث الضّبابيّة ‎(blur)‎ في JavaScript، أو يُطلِق هذا الحدث على عنصر ما. ‎.change()‎ يربط هذا التّابع مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو يُطلِق هذا الحدث ...

التابع ‎‎.on()‎‎ في jQuery

‎.on( events [, selector ] [, data ], handler )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر  بالعناصر المحدَّدة. ‎.on( events [, selector ] [, data ], handler )‎ أُضيف مع الإصدار: 1.7. events سلسلة نصية تحتوي على نوع حدث واحد، أو عدَّة أنواع أحداث مفصولة بمسافة فارغة بالإضافة إلى مجالات أسماء (namespaces) (اختياريَّا) مثل "click"، أو "keydown.myPlugin". selector سلسلة نصية تمثِّل اسم المحدِّد الذي يرشِّح أحفاد (descedants) العناصر ...

الأحداث (Events) في Laravel

مقدمة توفّر أحداث Laravel تطبيق مراقب بسيط  يسمح بالإشتراك والاستماع لعدّة أحداث يطلقها التطبيق. تُخزَّن أصناف الأحداث في الدليل app/Events، في حين توجد المنصتات في app/Listeners. لا تقلق إن لم تجد هذه الدلائل في التطبيق إذ تُصنع حين تولّد أحداثًا و منصتات باستعمال أوامر artisan. الأحداث طريقة ممتازة لفك ارتباط عدّة عناصر من التطبيق حيث يمكن أن يكون لحدث واحد عدّة منصتات منفصلة كليا عن بعضها البعض. مثلًا، قد تريد إرسال إعلان slack للمستخدم كلما شحن طلب. بدل ربط معالجة ...

التابع ‎.bind()‎‎ في jQuery

‎.bind( eventType [, eventData ], handler )‎ القيمة المعادة كائن jQuery. أُهمِل هذا التّابع في الإصدار: 3.0. الوصف يُستخدَم التّابع ‎.bind()‎ في إرفاق مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر. ‎.bind( eventType [, eventData ], handler )‎ أضيفت في الإصدار: 1.0. eventType سلسلة نصيّة، وتُمثِّل أنواع حدث DOM مثل click، أو submit، أو أسماء مُخصَّصة للأحداث. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج ...

التابع ‎.dblclick()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.dblclick( handler )‎ ‎‎القيمة المعادة يُعيد التابع ‎.dblclick( handler )‎ كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالجة أحداث بحدث dblclick من JavaScript، أو يُطلق هذا الحدث على عنصرٍ ما. ‎.dblclick( handler )‎ أُضيفت مع الإصدار: 1.0. handler هي دالة تُنفَّذ في كل مرة يُطلَق فيها الحدث، وهي على الشكل Function (Event eventObject)‎. ‎.dblclick( [eventData ], handler )‎ أُضيفت مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع ...

التابع ‎.triggerHandler()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.triggerHandler( eventType [, extraParameters ] )‎ القيمة المعادة يُعيد كائنًا من النوع Object. الوصف تنفيذ كافة معالجات الأحداث التي تتعلق على عنصرٍ لحدث. ‎.triggerHandler( eventType [, extraParameters ] )‎ أُضيف مع الإصدار: 1.2. eventType سلسلة نصية من النوع String تحتوي على نوع حدث JavaScript، مثل click أو submit . extraParameters معاملات إضافية لتمريرها إلى معالج الحدث وهي تكون من النوع Array أو PlainObject. ‎.triggerHandler( event [, extraParameters ] )‎ أُضيف مع الإصدار: 1.3. event كائن jQuery.Event من النوع Event. extraParameters ...

التابع ‎‎.off()‎‎ في jQuery

‎.off( events [, selector ] [, handler ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يزيل هذا التابع معالج حدث معين. ‎.off( events [, selector ] [, handler ] )‎ أُضيف مع الإصدار: 1.7. events سلسلة نصية تحتوي على نوع حدث واحد، أو عدَّة أنواع أحداث مفصولة بمسافة فارغة بالإضافة إلى مجال الاسم (اختياريَّا)، أو مجال الاسم فقط مثل "click"، أو "keydown.myPlugin"، أو "‎.myPlugin". selector سلسلة نصية تمثِّل اسم المحدِّد الذي يجب أن يطابق اسم الحدث الأساسي الذي ...

التابع ‎‎.mouseup()‎‎ في jQuery

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

التابع ‎‎.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 للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل ...

التابع ‎‎.change()‎‎‎ في jQuery

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

التابع ‎.toggle()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.toggle( handler, handler [, handler ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف ربط معالجين أو أكثر بالعناصر المتطابقة، لتنفيذها بالتناوب. ‎.toggle( handler, handler [, handler ] )‎ أُضيف مع الإصدار: 1.0، وأٌهمل مع الإصدار: 1.8، واُُزيل مع الإصدار: 1.9. handler دالة على الشكل Function( Event eventObject )‎، تنفَّذ عند النقر على العنصر كل مرة زوجية. handler دالة على الشكل Function( Event eventObject )‎، تنفَّذ عند النقر على العنصر كل مرة فردية. handler دالة على الشكل Function( Event ...

الخاصية ‎event.type‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.type القيمة المعادة تُعيد سلسلةً نصيةً من النوع String. الوصف تصف هذه الخاصية طبيعة الحدث. event.type أُضيفت مع الإصدار: 1.0. أمثلة التنبيه بنوع الحدث عند كل نقرة على العنصر <a>: $( "a" ).click(function( event ) { alert( event.type ); // "click" }); مصادر صفحة الخاصية event.type في توثيق jQuery الرسمي.

الخاصية ‎event.type‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.type القيمة المعادة تُعيد سلسلةً نصيةً من النوع String. الوصف تصف هذه الخاصية طبيعة الحدث. event.type أُضيفت مع الإصدار: 1.0. أمثلة التنبيه بنوع الحدث عند كل نقرة على العنصر <a>: $( "a" ).click(function( event ) { alert( event.type ); // "click" }); مصادر صفحة الخاصية event.type في توثيق jQuery الرسمي.

التابع ‎‎.keydown()‎‎ في jQuery

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

التابع ‎‎.mousedown()‎‎ في jQuery

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

التابع ‎‎.keyup()‎‎ في jQuery

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

التابع ‎‎.mouseleave()‎‎ في jQuery

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

التابع ‎‎.mouseenter()‎‎ في jQuery

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

التابع ‎‎.select()‎‎ في jQuery

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

التابع ‎.focus()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.focus( handler )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف ربط دالة معالج أحداث بحدث "focus" من JavaScript، أو إطلاق هذا الحدث على عنصر. ‎.focus( handler )‎ أُضيف مع الإصدار: 1.0. handler دالة على الشكل Function( Event eventObject )‎، تُنفَّذ في كل مرة يُطلَق فيها الحدث. ‎.focus( [eventData ], handler )‎ أُضيف مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript. handler دالة على الشكل Function( ...

التابع ‎‎.mouseover()‎‎ في jQuery

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

التابع ‎‎.mouseout()‎‎ في jQuery

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

تتبع الأحداث (Trace Events) في Node.js

مؤشر الاستقرار: 1 - تجريبي يوفر تتبع الأحداث آلية لتركيز معلومات التتبع التي  تولدت بواسطة V8، ونواه Node.js، وبرمجية مساحة المستخدم (userspace code). يمكن تفعيل التتبع بواسطة راية سطر الأوامر ‎--trace-event-categories أو باستخدام وحدة trace_events. وتقبل راية ‎‎--‎trace-event-categories قائمة بأسماء الفئات المفصولة بفاصلات. والفئات المتاحة هي:     • node - عنصر نائب (placeholder) فارغ.     • node.async_hooks - يتيح التقاط بيانات التتبع async_hooks المُفصَّلة. أحداث async_hooks لها asyncId فريد وخاصيتا triggerId و triggerAsyncId الخاصة.     • node.bootstrap ...

تعبير تعريف الدوال

الكلمة المحجوزة function تُستخدَم لتعريف دالة داخل تعبير (expression). يمكنك أيضًا تعريف الدوال عبر التصريح عنها function declaration أو عبر الدالة البانية Function. البنية العامة var myFunction = function [name]([param1[, param2[, ..., paramN]]]) { statements }; name اسم الدالة، ويمكن حذفه وحينئذٍ ستسمى الدالة بالدالة المجهولة؛ واسم الدالة لن يكون متاحًا إلا داخل الدالة نفسها (يمكن أن يستعمل لتنفيذها تعاوديًا [recursively]). param اسم الوسيط المُرَّر إلى الدالة، العدد الأقصى للوسائط التي يمكن تمريرها إلى الدالة يختلف حسب المحرِّك الذي ...

الخاصية ‎event.delegateTarget‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.delegateTarget القيمة المعادة تُعيد كائنًا من النوع Element. الوصف العنصر المُرفق به معالج أحداث jQuery المُستدعى حاليًا. event.delegateTarget أُضيف مع الإصدار: 1.7. تفيد هذه الخاصية عادةً في الأحداث المُفوَضة (delegated events) التي رُبِطَت بالحدث باستخدام التابع ‎.delegate()‎ أو التابع ‎.on()‎، عندما يرتبط معالج الحدث بالعنصر الأب للعنصر المُعالَج. على سبيل المثال، فيمكن استخدامه لتحديد وإزالة معالجات الأحداث في نقطة التفويض. بالنسبة إلى معالجات الأحداث غير المُفوَّضة المرفقة مباشرةً بعنصرٍ ما، وتكون الخاصية event.delegateTarget مساويةً دومًا للخاصية event.currentTarget. أمثلة عند النقر ...

الخاصية ‎event.delegateTarget‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.delegateTarget القيمة المعادة تُعيد كائنًا من النوع Element. الوصف العنصر المُرفق به معالج أحداث jQuery المُستدعى حاليًا. event.delegateTarget أُضيف مع الإصدار: 1.7. تفيد هذه الخاصية عادةً في الأحداث المُفوَضة (delegated events) التي رُبِطَت بالحدث باستخدام التابع ‎.delegate()‎ أو التابع ‎.on()‎، عندما يرتبط معالج الحدث بالعنصر الأب للعنصر المُعالَج. على سبيل المثال، فيمكن استخدامه لتحديد وإزالة معالجات الأحداث في نقطة التفويض. بالنسبة إلى معالجات الأحداث غير المُفوَّضة المرفقة مباشرةً بعنصرٍ ما، وتكون الخاصية event.delegateTarget مساويةً دومًا للخاصية event.currentTarget. أمثلة عند النقر ...

التابع ‎‎.mousemove()‎‎ في jQuery

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

التابع ‎event.isDefaultPrevented‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.isDefaultPrevented()‎ القيمة المعادة يُعيد كائنًا من النوع Boolean. الوصف يتحقق هذا التابع من استدعاء الحدث event.preventDefault()‎‎ على كائن الحدث هذا. event.isDefaultPrevented()‎ أُضيف مع الإصدار: 1.3. لا يقبل هذا التابع أي وسائط. أمثلة التحقق من استدعاء event.preventDefault()‎‎. $( "a" ).click(function( event ) { alert( event.isDefaultPrevented() ); // false event.preventDefault(); alert( event.isDefaultPrevented() ); // true }); مصادر صفحة التابع event.isDefaultPrevented في توثيق jQuery الرسمي.

التابع ‎event.isDefaultPrevented‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.isDefaultPrevented()‎ القيمة المعادة يُعيد كائنًا من النوع Boolean. الوصف يتحقق هذا التابع من استدعاء الحدث event.preventDefault()‎‎ على كائن الحدث هذا. event.isDefaultPrevented()‎ أُضيف مع الإصدار: 1.3. لا يقبل هذا التابع أي وسائط. أمثلة التحقق من استدعاء event.preventDefault()‎‎. $( "a" ).click(function( event ) { alert( event.isDefaultPrevented() ); // false event.preventDefault(); alert( event.isDefaultPrevented() ); // true }); مصادر صفحة التابع event.isDefaultPrevented في توثيق jQuery الرسمي.

التابع ‎‎.submit()‎‎ في jQuery

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

التابع ‎‎.keypress()‎‎ في jQuery

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

for في JavaScript

التعبير البرمجي for يُنشِئ حلقة تكرار تتألف من ثلاثة تعبيرات برمجية اختيارية تحيط بها أقواس وتفصل بينها فواصل منقوطة، ويليها تعبيرٌ برمجيٌ (وعادةً يكون قسمًا كتليًا [block statement]) سيُنفَّذ في كل تكرار للحلقة. البنية العامة for ([initialization]; [condition]; [final-expression]) statement initialization تعبير (يتضمن تعابير الإسناد) أو تصريح عن متغير، ويُستخدَم عادةً لتهيئة متغير العدّاد؛ وهذا التعبير قد يُصرِّح اختياريًا عن متغيرات جديدة باستخدام الكلمة المحجوزة var؛ وهذه المتغيرات ليست محليةً وتابعةً لحلقة التكرار، وإنما ستكون موجودةً في نفس ...

for...of في JavaScript

التعبير البرمجي for...of يمر على الكائنات التي يمكن الدوران على عناصرها (iterable objects) بما في ذلك الكائن Array و Map و Set و String و TypedArray و Arguments، وتنفيذ تعابير برمجية معيّنة على قيمة كل خاصية من خاصيات تلك الكائنات. البنية العامة for (variable of iterable) { statement } variable ستُنسَد قيمة الخاصية مختلفة لهذا المتغير في كل دورة. iterable خاصيات الكائن القابلة للدوران (iterable properties). الوصف الفرق بين حلقتَي التكرار for...of و for...in التعبيران البرمجيان for...in و for...of يُستخدَمان للدوران ...

for...in في JavaScript

التعبير البرمجي for...in يُنشِئ حلقة تكرار تمر على الخاصيات القابلة للإحصاء (enumerable properties) التابعة لأحد الكائنات، ويمكن تنفيذ تعابير برمجية لكل خاصية من خاصيات الكائن. البنية العامة for (variable in object) { //... } variable ستُنسَد قيمة الخاصية مختلفة لهذا المتغير في كل دورة. object الكائن الذي سنمر على الخاصيات القابلة للإحصاء (enumerable properties) التابعة له. الوصف حلقة التكرار for...in تمر على الخاصيات القابلة للإحصاء (enumerable properties) فقط، فالكائنات المُنشَأة من الدوال البانية المُضمَّنة في اللغة مثل Array و Object ...

التابع ‎‎.ajaxComplete()‎‎‎ في jQuery

‎.ajaxComplete( handler )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.ajaxComplete()‎ لتسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. يُعدُّ هذا التّابع حدثًا من أحداث Ajax. ‎.ajaxComplete( handler )‎ أضيفت في الإصدار: 1.0. handler دالة على الشكل ‎Function( Event event, jqXHR jqXHR, PlainObject ajaxOptions )‎،وهي الدالة التي ستُستدعى. حالما يكتمل تنفيذ طلب Ajax، تُطلَق jQuery الحدث ajaxComplete، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع‎.ajaxComplete() ‎. لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط لتحميل Ajax: <button ...

الخاصية ‎event.currentTarget‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.currentTarget القيمة المعادة تعيد كائنًا من النوع Element. الوصف عنصر DOM الحالي خلال مرحلة إنتاج فقاعات الحدث. event.currentTarget أُضيف مع الإصدار: 1.3. تساوي هذه الخاصية عادة عنصر this الوظيفة. إذا أُستخدِم jQuery.proxy أو أي شكل آخر لمعالجة النطاق، فسيكون this مساويًا لأي سياق مُدخَل، وليس event.currentTarget. أمثلة لاحظ أنَّ الخاصية CurrentTarget تتطابق مع قيمة المعامل this: $( "p" ).click(function( event ) { alert( event.currentTarget === this ); // true }); مصادر صفحة الخاصية event.currentTarget‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في توثيق jQuery الرسمي.

الخاصية ‎event.currentTarget‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.currentTarget القيمة المعادة تعيد كائنًا من النوع Element. الوصف عنصر DOM الحالي خلال مرحلة إنتاج فقاعات الحدث. event.currentTarget أُضيف مع الإصدار: 1.3. تساوي هذه الخاصية عادة عنصر this الوظيفة. إذا أُستخدِم jQuery.proxy أو أي شكل آخر لمعالجة النطاق، فسيكون this مساويًا لأي سياق مُدخَل، وليس event.currentTarget. أمثلة لاحظ أنَّ الخاصية CurrentTarget تتطابق مع قيمة المعامل this: $( "p" ).click(function( event ) { alert( event.currentTarget === this ); // true }); مصادر صفحة الخاصية event.currentTarget‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في توثيق jQuery الرسمي.

الحقل button

عناصر <input> ذات النوع button تُعرَض كأزرار عادية، والتي يمكن برمجتها للتحكم بأي شيء في الصفحة عبر ربط دالة معالجة أحداث معها (التي تُعالِج الحدث click عادةً). وعلى الرغم من أنَّ عناصر <input> ذات النوع button صحيحة تمامًا في HTML، لكن من المفضّل استخدام عنصر <button> الجديد لإنشاء الأزرار، لأن له ميزات إضافية، مثل دعمه للقيمة menu في الخاصية type التي تعني أنَّ الزر يستعمل لتفعيل قائمة منبثقة، والسماح بإضافة نص اللافتة للعنصر <button> بين وسم البداية ووسم النهاية مما ...

التابع ‎.ajaxSend()‎‎‎ في jQuery

‎.ajaxSend( handler )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.ajaxSend( handler )‎ في إرفاق دالة لتنفيذها قبل إرسال طلب Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. ‎.ajaxSend( handler )‎ أضيفت في الإصدار 1.0. handler دالة على الشكل ‎Function( Event event, jqXHR jqXHR, PlainObject ajaxOptions )‎، وهي الدالة المطلوب استدعاؤها. عندما يكون طلب Ajax على وشك أن يُرسَل، تُطلِق jQuery الحدث ajaxSend. تُنفَّذ حينها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع ‎.ajaxSend()‎. لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط ...

التابع ‎.ajaxStart()‎‎‎ في jQuery

‎.ajaxStart( handler )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.ajaxStart()‎ في تسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند بدء أول طلب Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. ‎.ajaxStart( handler )‎ أضيفت في الإصدار: 1.0. handler يُمثِّل الدالة المطلوب استدعاؤها. عندما يكون طلب Ajax على وشك أن يُرسَل، تتحقّق jQuery ما إذا كانت هناك طلبات Ajax أخرى، وإن لم يكن هناك أي طلب قيد المعالجة تُطلِق jQuery الحدث ajaxStart، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع ‎.ajaxStart()‎. ...

التابع ‎.ajaxStop()‎‎‎ في jQuery

‎.ajaxStop( handler )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎‎.ajaxStop()‎‎ في تسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال تنفيذ جميع طلبات Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. ‎.ajaxStop( handler )‎ أضيفت في الإصدار: 1.0. handler يُمثِّل الدالة المطلوب استدعاؤها. عندما يكتمل تنفيذ طلب Ajax، تتحقّق jQuery ما إذا كانت هناك طلبات Ajax أخرى، وإن لم يكن هناك أي طلب تُطلِق jQuery الحدث ajaxStop، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع ‎.ajaxStop()‎. يُطلَق الحدث ajaxStop أيضًا ...

التابع ‎‎.ajaxSuccess()‎‎‎ في jQuery

‎.ajaxSuccess( handler )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.ajaxSuccess()‎ لإرفاق دالة لتنفيذها عند اكتمال تنفيذ طلب Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. ‎.ajaxSuccess( handler )‎ أضيفت في الإصدار: 1.0. handler دالة على الشكل ‎Function( Event event, jqXHR jqXHR, PlainObject ajaxOptions, PlainObject data )‎، وهي الدالة المطلوب استدعاؤها. عندما يكتمل تنفيذ طلب Ajax، تُطلِق jQuery الحدث ajaxSuccess، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع ‎.ajaxSuccess()‎. لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط لتحميل Ajax: ...

الخاصية ‎event.stopPropagation()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.stopPropagation()‎ القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف تمنع هذه الخاصية الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث. event.stopPropagation()‎ أُضيف مع الإصدار: 1.0. لا تقبل هذه الخاصية أي وسائط. تستخدم الخاصية event.isPropagationStopped()‎ للحقق من استدعاء هذا التابع (على كائن الحدث هذا). تعمل هذه الخاصية مع الأحداث المخصصة المُطلَقة بواسطة التابع trigger()‎ أيضًا. لاحظ أن هذه الخاصية لن تمنع المعالجات الأخرى من العمل على نفس العنصر. ملاحظات ...

الخاصية ‎event.stopPropagation()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.stopPropagation()‎ القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف تمنع هذه الخاصية الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث. event.stopPropagation()‎ أُضيف مع الإصدار: 1.0. لا تقبل هذه الخاصية أي وسائط. تستخدم الخاصية event.isPropagationStopped()‎ للحقق من استدعاء هذا التابع (على كائن الحدث هذا). تعمل هذه الخاصية مع الأحداث المخصصة المُطلَقة بواسطة التابع trigger()‎ أيضًا. لاحظ أن هذه الخاصية لن تمنع المعالجات الأخرى من العمل على نفس العنصر. ملاحظات ...

التابع ‎.ajaxError()‎‎‎ في jQuery

‎.ajaxError( handler )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.ajaxError()‎ لتسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال تنفيذ طلب Ajax مع حدوث خطأ،  يُعدُّ هذا التّابع حدثًا من أحداث Ajax. ‎.ajaxError( handler )‎ أضيفت في الإصدار 1.0. handler دالة على الشكل ‎Function( Event event, jqXHR jqXHR, PlainObject ajaxSettings, String thrownError )‎، وهي الدالة المطلوب استدعاؤها. حالما يكتمل تنفيذ طلب Ajax، تُطلِق jQuery الحدث ajaxError. وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع ‎‎.ajaxError()‎‎. ملاحظة: لا يُستدعى مُعالِج الأحداث ...

التابع ‎‎.scroll()‎‎ في jQuery

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

التابع ‎.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 )‎، تُنفَّذ ...

المعامل void في JavaScript

المعامل void يُقدِّر قيمة التعبير المعطى (expression) ثم يُعيد القيمة undefined. البنية العامة void expression الوصف هذا المعامل يسمح بتقدير قيمة التعابير البرمجية للحصول على قيمة منها تساوي undefined (أي ستُنفَّذ تلك التعابير البرمجية لكن القيمة المعادة هي undefined). يُستخدَم المعامل void عادةً للحصول على القيمة الأوليّة undefined، وذلك باستخدام ‎void(0)‎ (أو الشكل المكافئ void 0)، يجدر بالذكر أنَّ هذا الاستخدام مفيدٌ إذا أعيد ضبط قيمة المتغير العام undefined إلى قيمة أخرى. أمثلة الدوال ذاتية الاستدعاء عند استخدام دالة ذاتية ...

التابع ‎.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 )‎، وتُنفَّذ ...

الخاصية ‎event.target‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎event.target القيمة المعادة تعيد كائنًا من النوع Element. الوصف تعيد هذه الخاصية عنصر DOM الذي بدأ الحدث. event.target أُضيفت مع الإصدار: 1.0. يمكن أن تكون الخاصية target هي العنصر لمُسجل للحدث أو لعناصره السليلة. غالبًا ما يكون من المفيد مقارنة event.target مع this لتحديد ما إذا كان الحدث يُعالج بسبب انتقال الحدث إلى العناصر الأب (event bubbling). هذه الخاصية مفيدة جدًا في تفويض الحدث، عند انتقال الحدث إلى العناصر الأب. أمثلة عرض اسم العنصر عند النقر عليه: <!doctype html> <html lang="en"> <head> ...

الخاصية ‎event.target‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎event.target القيمة المعادة تعيد كائنًا من النوع Element. الوصف تعيد هذه الخاصية عنصر DOM الذي بدأ الحدث. event.target أُضيفت مع الإصدار: 1.0. يمكن أن تكون الخاصية target هي العنصر لمُسجل للحدث أو لعناصره السليلة. غالبًا ما يكون من المفيد مقارنة event.target مع this لتحديد ما إذا كان الحدث يُعالج بسبب انتقال الحدث إلى العناصر الأب (event bubbling). هذه الخاصية مفيدة جدًا في تفويض الحدث، عند انتقال الحدث إلى العناصر الأب. أمثلة عرض اسم العنصر عند النقر عليه: <!doctype html> <html lang="en"> <head> ...

yield*‎ في JavaScript

التعبير yield*‎ يُستخدَم لتفويض التنفيذ إلى دالة مولِّدة أخرى أو كائن iterable. البنية العامة yield* [[expression]]; expression التعبير الذي سيُعيد كائن iterable. الوصف سيؤدي التعبير yield*‎ إلى المرور على عناصر الكائن ويعطي كل قيمة أعادها هذا الكائن. قيمة التعبير yield*‎ نفسه هي القيمة المُعادة من الكائن iterable عند إغلاقه (أي عندما تكون قيمة الخاصية done هي true). أمثلة تفويض التنفيذ إلى دالة مولِّدة أخرى لاحظ أنَّ القيمة التي تعطيها (yield) الدالة g1()‎ ستُعاد عند استدعاء الدالة next()‎ مثل القيم ...

debugger في JavaScript

التعبير البرمجي debugger يؤدي إلى تفعيل وظيفة التنقيح (debugging functionality) المتاحة، مثل بداية نقطة المقاطعة (breakpoint)؛ لكن إن لم يكن هنالك منقِّح أو وظيفة تنقيح متاحة فلن يكون لهذا التعبير أي أثر. البنية العامة debugger; أمثلة الشيفرة الآتية فيها التعبير البرمجي debugger الذي يؤدي إلى استدعاء المنقِّح (إن كان موجودًا) عند تنفيذ الدالة function potentiallyBuggyCode() { debugger; // شيفرة غير مستقرة فيها علل يجب تنقيحها } دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari ...

class في JavaScript

التصريح عن الصنف (class declaration) يؤدي إلى إنشاء صنف جديد له اسمٌ معيّن يستخدم الوراثة عبر سلسلة prototype. يمكنك أيضًا تعريف الأصناف عبر تعابير تعريف الأصناف (class expression)، لكن التصريح عن الصنف بهذه الطريقة يختلف عن استخدام تعابير تعريف الأصناف في أنَّه لا يسمح بإعادة التصريح عن الصنف مرةً أخرى، وسيرمي (throw) خطأً إن حاولنا ذلك. البنية العامة class name [extends] { // محتويات الصنف } الوصف كما في تعابير تعريف الأصناف، ستُنفَّذ التعابر البرمجية الموجودة ضمن الصنف في نمط ...

return في JavaScript

التعبير البرمجي return يؤدي إلى إنهاء تنفيذ الدالة ويُحدِّد قيمةً لتُعيدها الدالة إلى التعبير الذي استدعاها. البنية العامة return [[expression]]; expression التعبير البرمجي الذي ستُعاد قيمته، وإذا لم يُحدَّد فستُعاد القيمة undefined. الوصف عندما يُستخدَم التعبير البرمجي return في جسم الدالة، فسيتوقف تنفيذ الدالة؛ وستُعاد القيمة المعطية (إن وجِدَت) إلى التعبير الذي استدعى الدالة. فعلى سبيل المثال، ستعيد الدالة الآتية مربّع الوسيط x، على أن يكون الوسيط x رقميًا: function square(x) { return x * x; } var demo = ...

كائنEvalError في JavaScript

الكائن EvalError يُشير إلى حدوث خطأ في الدالة العامة eval()‎. من المهم ملاحظة أنَّ هذا الاستثناء لم يعد يرمى من لغة JavaScript؛ لكن الكائن EvalError قد بقي لأغراض التوافقية. البنية العامة new EvalError([message]) message وسيط اختياري، وهو وصفٌ نصيٌّ للخطأ موجَّهٌ للبشر. الخاصيات والدوال التابعة للدالة البانية EvalError الخاصيات EvalError.prototype تُمثِّل هذه الخاصية كائن prototype التابعة للكائن EvalError. الدوال الدالة البانية EvalError لا تملك أيّة دوال تابعة لها مباشرةً، وإنما ترث بعض الخاصيات عبر سلسلة prototype. الكائن prototype الخاصيات EvalError.prototype.constructor ...

undefinedفي JavaScript

الخاصية العامة undefined تُمثِّل القيمة الأوليّة undefined في JavaScript. سمات الخاصية undefined قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا البنية العامة undefined الوصف الخاصية undefined هي خاصيةٌ للكائن العام (global object) أي أنها متغيرٌ في المجال العام، والقيمة الابتدائية للخاصية undefined هي نوع البيانات الأوليّ undefined. الخاصية undefined غير قابلة للضبط وغير قابلة للكتابة في المتصفحات الحديثة (بدءًا من معيار ECMAScript 5)، لكن مع ذلك حاول تجنّب الكتابة عليها. المتغيرات التي لم تُسنَد لها قيمةٌ سيكون نوعها هو ...

switch في JavaScript

التعبير البرمجي switch يُستخدَم لمطابقة قيمة تعبير برمجي باستخدام عبارة case، ثم يُنفِّذ التعابير البرمجية المرتبطة معها. البنية العامة switch (expression) { case value1: // التعابير البرمجية التي ستُطبِّق // عندما تُطابِق قيمةُ التعبير قيمةَ الحالة [break;] case value2: // التعابير البرمجية التي ستُطبِّق // عندما تُطابِق قيمةُ التعبير قيمةَ الحالة [break;] ... case valueN: ...

yield في JavaScript

الكلمة المحجوزة yield تُستخدَم لإيقاف تنفيذ دالة مولِّدة (function*‎) مؤقتًا واستئناف تنفيذها. البنية العامة [rv] = yield [expression]; expression تعريف القيمة التي ستُعاد من الدالة الموِّلدة عبر بروتوكول iterator، وإذا لم تُحدَّد هذه القيمة فستُعاد القيمة undefined. rv إسناد القيمة الاختيارية المُمرَّرة إلى الدالة next()‎ التي تُستخدَم لاستئناف التنفيذ. الوصف الكلمة المحجوزة yield توقف تنفيذ دالة مولِّدة مؤقتًا وستُعاد قيمة التعبير الذي يلي الكلمة المحجوزة yield إلى التعبير البرمجي الذي استدعى الدالة المولِّدة؛ ويمكن عدّ الكلمة المحجوزة yield على أنها ...

throw في JavaScript

التعبير البرمجي throw يؤدي إلى رمي استثناء (exception) يُعرِّفه المستخدم، وسيؤدي ذلك إلى توقف تنفيذ الدالة الحالية (أي أنَّ التعابير البرمجية بعد throw لن تُنفَّذ) وسينتقل التنفيذ إلى أوّل catch، وإذا لم تكن موجودةً فسينتهي تنفيذ البرنامج. البنية العامة throw expression; expression التعبير الذي سيُرمى. الوصف يُستخدَم التعبير throw لرمي استثناء، وعندما ترمي استثناءً فإنَّ قيمة expression تُحدِّد ما هي قيمة الاستثناء. أمثلة: throw 'Error2'; // توليد استثناء له قيمة نصية throw 42; // توليد استثناء ...

const في JavaScript

الثوابت (constants) تكون تابعةً للمجال الكتلي (block scope) بما يُشبه المتغيرات المُعرَّفة عبر التعبير let، لكن قيمة الثوابت لا يمكن أن تتغير عبر إعادة إسناد القيمة، ولا يمكن إعادة تصريحها. البنية العامة const name1 = value1 [, name2 = value2 [, ... [, nameN = valueN]]]; nameN اسم الثابت، ويمكن أن يكون أيّ معرِّف صالح في JavaScript. valueN قيمة الثابت، ويمكن استخدام أيّ تعبير (expression) صالح في JavaScript بما في ذلك الدوال. الوصف تكون الثوابت إما عامةً أو محليةً وتابعةً ...

if...else في JavaScript

التعبير البرمجي الشرطي (if statement) يُستخدَم لتنفيذ تعبير برمجي معيّن عندما يكون الشرط محققًا، وإذا كان الشرط غير محققٍ فسيُنفِّذ تعبيرًا برمجيًا آخر. البنية العامة if (condition) statement1 [else statement2] condition تعبيرٌ يمكن أن يكون محققًا (true) أو غير محقق (false). statement1 التعبير البرمجي الذي سيُنفَّذ عندما يكون الشرط condition محققًا، ويمكن أن يكون هذا التعبير أيّ تعبيرٍ صالحٍ بما في ذلك تعابير if المتشعبة، ويمكن إنشاء قسم كتلي { ... } لتجميع أكثر من تعبير برمجي ...

JavaScript/Topics

الكائنات العامة في هذا القسم جميع الكائنات العامة المُضمَّنة في لغة JavaScript، إضافةً إلى جميع الخاصيات والدوال التابعة لها. الخاصيات العامة هذه الخاصيات العامة تُعيد قيمةً بسيطةً، فهي لا تُمثِّل دوالًا أو خاصياتٍ تابعة لأحد الكائنات. Infinity NaN undefined null الدوال العامة هذه الدوال العامة -أي التي تستدعى في النطاق العام بدل استدعائها على كائن بعينه- تُعيد نتائجها إلى التعبير البرمجي الذي استدعاها. eval()‎‎ isFinite()‎ isNaN()‎ parseFloat()‎ parseInt()‎ decodeURI()‎ decodeURIComponent()‎ encodeURI()‎ encodeURIComponent()‎ escape()‎ unescape()‎ الكائنات الأساسية هذه هي الكائنات الأساسية ...

المعامل in في JavaScript

المعامل in يُعيد القيمة true إذا كانت الخاصية المُحدَّدة موجودةً في الكائن أو في سلسلة prototype الخاصة به. البنية العامة prop in object prop سلسلة نصية أو رمز يُمثِّل اسم الخاصية أو فهرس المصفوفة. object الكائن الذي سنتحقق من وجود الخاصية فيه أو في سلسلة prototype الخاصة به. الوصف يوضِّح المثال الآتي بعض حالات استخدام المعامل in: // المصفوفات var trees = ['redwood', 'bay', 'cedar', 'oak', 'maple']; 0 in trees // true 3 in trees ...

break في JavaScript

التعبير البرمجي break يؤدي إلى إنهاء حلقة التكرار الحالية أو التعبير switch أو label، وستنقل تنفيذ البرنامج إلى التعبير البرمجي الذي يلي التعبير الذي انتهى. البنية العامة break [label]; label مُعرِّفٌ اختياريٌ مرتبطٌ بلافتة التعبير البرمجي، وإذا كان التعبير ليس حلقةً تكراريةً أو switch فسيصبح هذا المُعرِّف مطلوبًا وليس اختياريًا. الوصف يتضمن التعبير break إمكانية توفير لافتة اختيارية تسمح للبرنامج بالخروج من التعبير المُسمى؛ ويجب أن يكون التعبير break موجودًا ضمن ذاك التعبير المسمى. أمثلة استخدام break مع حلقة while ...

الدوال في JavaScript

على وجه العموم، الدالة هي «برنامجٌ فرعي» (subprogram) الذي يمكن استدعاؤه من شيفرة خارجية (أو داخلية، في حال أردنا استدعاء الدالة تعاوديًا [recursively])؛ وتحتوي الدالة على سلسلةٍ من التعابير البرمجية التي تسمى «جسم الدالة»، ويمكن تمرير قيم إلى الدالة، وتستطيع الدالة أن تعيد قيمةً ما. تُعدّ الدوال في JavaScript على أنَّها كائنات من الصنف الأول (first-class objects)، لأنها تملك خاصيات ودوال مثل بقية الكائنات، لكن ما يميّزها عن بقية الكائنات هو إمكانية استدعائها، إذ إنَّها كائنات من النوع Function. الوصف ...

while في JavaScript

التعبير البرمجي while يُنشِئ حلقة تكرار تُنفِّذ تعبيرًا برمجيًا معيّنًا طالما كان الشرط محققًا (true)، وسيتم التحقق من الشرط قبل تنفيذ التعبير البرمجي. البنية العامة while (condition) statement condition تعبير سيتم التحقق من صحته قبل كل تكرار، وإذا كانت قيمة الشرط condition هي true فسيُنفَّذ التعبير البرمجي statement، وعندما تصبح قيمة الشرط condition مساويةً للقيمة false فسينتقل التحكم إلى التعبير البرمجي الذي يلي حلقة while. statement  التعبير البرمجي الذي سيُنفَّذ طالما كان الشرط محققًا؛ ولتنفيذ أكثر من تعبير برمجي ...

var في JavaScript

تعبير variable يُصرِّح عن متغير، ويمكن تهيئة قيمته الابتدائية اختياريًا. البنية العامة var varname1 [= value1] [, varname2 [= value2] ... [, varnameN [= valueN]]]; varnameN اسم المتغير، ويمكن أن يكون أيّ معرِّف صالح في JavaScript. valueN القيمة الابتدائية للمتغير، ويمكن استخدام أيّ تعبير (expression) صالح في JavaScript، والقيمة الافتراضية هي undefined. الوصف التصريح عن المتغيرات سيُعالَج قبل تنفيذ أيّة شيفرات أينما وقعت، ومجال (scope) المتغيرات المُصرَّح عنا عبر var هو سياق التنفيذ الحالي (execution context)، كمجال الدوال، أو المجال ...

continue في JavaScript

التعبير البرمجي continue يؤدي إلى تجاوز تنفيذ التعابير البرمجية في التكرار الحالي (iteration) في حلقة التكرار الحالية أو حلقة التكرار المسماة (عبر لافتة)، وسيستمر تنفيذ الحلقة بدءًا من التكرار التالي. البنية العامة continue [label]; label مُعرِّفٌ اختياريٌ مرتبطٌ بلافتة التعبير البرمجي. الوصف على النقيض من التعبير break، لن يؤدي التعبير continue إلى إنهاء تنفيذ الحلقة كليًّا، وإنما: في حلقات while سيؤدي إلى الانتقال إلى الشرط. في حلقات for سيؤدي إلى الانتقال إلى تعبير تحديث معاملات حلقة التكرار. يمكن أن يضمّ ...

let في JavaScript

تعبير let يُصرِّح عن متغير محلي للقسم الكتلي، ويمكن تهيئة قيمته الابتدائية اختياريًا. البنية العامة let var1 [= value1] [, var2 [= value2]] [, ..., varN [= valueN]]; varnameN اسم المتغير، ويمكن أن يكون أيّ معرِّف صالح في JavaScript. valueN القيمة الابتدائية للمتغير، ويمكن استخدام أيّ تعبير (expression) صالح في JavaScript. الوصف التعبير let يسمح بالتصريح عن متغيرات يكون مجالها (scope) محدودًا إلى القسم الكتلي (block statement)، أو إلى التعبير (expression) الذي اُستخدِمَ فيه؛ وهو على النقيض من الكلمة المحجوزة ...

الدالة jQuery()‎‎ في jQuery

تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. ‎jQuery( selector [, context ] )‎ القيم المعادة تعيد كائنًا من النوع jQuery. الوصف تقبل هذه الدالة سلسلة نصية تحتوي على محدِّد CSS يُستعمَل لمطابقة مجموعة من العناصر. ‎jQuery( selector [, context ] )‎ أُضيفت مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد. context عنصر DOM، أو كائن Document، أو كائن jQuery ...

jQuery/Topics a-z

‎.add()‎ إنشاء كائن jQuery جديد من العناصر المضافة إلى مجموعة من العناصر المطابقة. ‎.addBack()‎ يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكْدَس (stack) إلى المجموعة الحاليّة، مع إمكانيّة ترشيحها بشكل اختياري عن طريق مُحدِّد (selector). ‎.addClass()‎ يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة. ‎.after()‎ يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. ‎.ajaxComplete()‎ يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. ‎.ajaxError()‎ ...

التابع ‎‎.html()‎‎ في jQuery

يجلب هذا التابع محتوى HTML لأول عنصر في مجموعة العناصر المطابقة أو يغير محتوى HTML لكل العناصر المطابقة. ()html. القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يجلب هذا التابع محتوى HTML لأول عنصر في مجموعة العناصر المطابقة. ‎.html()‎ أضيفت مع الإصدار: 1.0، ولا يقبل هذا التابع أي معاملات. هذا التابع غير متوافر في صفحات XML. في صفحة HTML، يمكن استعمال التابع ()html. لجلب محتوى أي عنصر. إذا طابق تعبير المحدد أكثر من عنصر، فسيُعاد محتوى HTML للعنصر الأول ...

التعامل مع Ajax في jQuery

تحوي مكتبة jQuery على مجموعة كاملة من الأدوات المخصصة للتعامل مع Ajax. التوابع والدوال الموجودة في هذا القسم تسمح لك مثلًا بتحميل بيانات من الخادم دون تحديث المتصفح صفحة الويب. ‎.ajaxComplete()‎ يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. ‎.ajaxError()‎ يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال تنفيذ طلب Ajax مع حدوث خطأ. ‎.ajaxSend()‎ يُرفِق هذا التّابع دالة لتنفيذها قبل إرسال طلب Ajax. ‎.ajaxStart()‎ يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند ...

التابع ‎.error()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎.error( handler )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. أُهمل مع الإصدار: 1.8، وأُزيل مع الإصدار: 3.0. الوصف ربط معالج الحدث بحدث الخطأ "error" في JavaScript. error( handler )‎ أُضيف مع الإصدار: 1.0. handler دالة تنفذ عند تشغيل الحدث وهي على الشكل Function( Event eventObject )‎. ‎.error( [eventData ], handler )‎ أُضيف مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript. handler دالة تنفذ عند تشغيل ...

التابع ‎‎.contextmenu()‎‎‎ في jQuery

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

الخاصية ‎‎‎.jquery‎ في jQuery

الخاصية ‎.jquery القيم المعادة تعيد سلسلة نصية من النوع String. الوصف يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. jquery أُضيف مع الإصدار: 1.0. الخاصِّيَّة ‎.jquery هي سلسلة نصية تحتوي على رقم إصدار jQuery مثل "1.5.0" أو "1.4.4"، وتُسند إلى نموذج jQuery الأولي، ويشار إليها عادةً عبر الاسم البديل ‎$.fn. أمثلة تحديد إن كان كائنٌ ما هو كائن jQuery: $(function() { // أصبحت الصفحة جاهزة }); استعمال اختصار للشكل ‎$(document).ready()‎ ووسيط لكتابة شيفرة الفشل الآمن (failsafe) في jQuery ...

التابع ‎.unload()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.unload( handler )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. اٌُهمل مع الإصدار: 1.8, اُُزيل مع الإصدار: 3.0. الوصف ربط أحد معالجات الأحداث بحدث unload في JavaScript. ‎.unload( handler )‎ أُضيف مع الإصدار: 1.0. handler دالة تُنفَّذ عند تشغيل الحدث، وهي على الشكل Function( Event eventObject )‎. ‎.unload( [eventData ], handler )‎ أُضيف مع الإصدار: 1.4.3. eventData كائن عادي من البيانات التي ستمرر إلى معالج الحدث وقد يكون من أي نوع من الأنواع. handler دالة تُنفَّذ عند تشغيل الحدث، وهي ...

التابع ‎‎.resize()‎‎ في jQuery

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

الوصول إلى الخاصيات في JavaScript

طرائق الوصول إلى الخاصيات توفِّر وصولًا إلى خاصيات أحد الكائنات باستخدام طريقة النقط أو طريقة الأقواس. البنية العامة object.property object['property'] الوصف يمكننا عدّ الكائنات على أنها مصفوفات ترابطية (أي associative array، ويُطلَق عليها أيضًا map و dictionary و hash و lookup table)، وتكون المفاتيح (keys) في المصفوفة هي أسماء خاصيات الكائن. من الشائع عند حديثنا عن خاصيات الكائنات التفريق بين الخاصيات (properties) والدوال التابعة للكائن، لكن تقنيًا تكون الدوال هي خاصيات مُنشَأة من الكائن Function. هنالك طريقتان للوصول إلى خاصيات الكائنات: ...

الدالة Promise.prototype.finally()‎ في JavaScript

الدالة finally()‎ تعيد وعدًا Pormise، وعندما تُقرَّر قيمة الوعد، سواءً كان مقبولًا أو مرفوضًا، فستُنفَّذ دالة رد النداء (callback) المُحدَّدة. وهذا ما يوفِّر طريقة لتنفيذ شيفرة ما بعد التعامل مع كائن Pormise سواءً كان الوعد مقبولًا أو مرفوضًا. تسمح هذه الدالة لنا بتفادي تكرار الشيفرات في دوال then()‎ و catch()‎. البنية العامة p.finally(onFinally); p.finally(function() { // قُرِّرَت قيمة الوعد، سواءً كان مقبولًا أم مرفوضًا }); المعاملات onFinally الدالة التي ستُستدعى عند تقرير قيمة الوعد. القيمة المعادة كائن Pormise الذي تكون ...

اللافتات label في JavaScript

التعبير البرمجي label يمكن أن يُستخدَم مع التعبير البرمجي break أو continue، وهو يوضع قبل التعابير البرمجية لإضافة لافتة (مُعرِّف) لها يمكن الإشارة إليها. لاحظ أنَّ من غير الشائع استخدام حلقات تكرار مع لافتات (labels)، وتُستخدَم عادةً الدوال بدلًا القيام بقفزات بين حلقات التكرار. البنية العامة label : statement label لافتة للتعبير البرمجي، ويمكن أن تكون أيّ مُعرِّف في JavaScript صالح (وليس كلمةً محجوزةً). statement التعابير البرمجية التي ستُضاف اللافتة إليها، ويمكن استخدام التعبير البرمجي break مع أيّ ...

الكائن Array في JavaScript

الكائن Array يُستخدَم في إنشاء المصفوفات، والتي هي قوائم شبيهة بالكائنات. إنشاء مصفوفة var fruits = ['Apple', 'Banana']; console.log(fruits.length); // 2 الوصول إلى عنصر من عناصر المصفوفة var first = fruits[0]; // Apple var last = fruits[fruits.length - 1]; // Banana المرور على عناصر المصفوفة بحلقة تكرار fruits.forEach(function(item, index, array) { console.log(item, index); }); // Apple 0 // Banana 1 إضافة عنصر في نهاية المصفوفة var newLength = fruits.push('Orange'); // ["Apple", "Banana", "Orange"] إزالة عنصر من نهاية المصفوفة var last = fruits.pop(); // إزالة Orange (من النهاية) // ["Apple", ...

المعامل الشرطي في JavaScript

المعامل الشرطي (conditional operator) هو المعامل الوحيد في JavaScript الذي يأخذ ثلاثة قيمة ليجري عليها عمليته، ومن الشائع استخدام هذا المعامل كاختصارٍ للتعبير البرمجي if. البنية العامة condition ? expr1 : expr2 condition تعبير برمجي نتيجته هي true أو false. expr1 و expr2 تعبيرين برمجيين من أيّ نوع. الوصف إذا كان الشرط condition محققًا true فسيُعيد المعامل قيمة التعبير expr1، وفيما عدا ذلك سيُعيد قيمة التعبير expr2؛ فمثلًا لو أردنَا عرض رسالة مختلفة اعتمادًا على قيمة المتغير isMember فسنستخدم التعبير ...

الكلمة المحجوزة this في JavaScript

الكلمة المحجوزة this لها سلوكٌ في JavaScript يختلف عن بقية لغات البرمجة، وهنالك اختلافاتٌ في سلوكها بين النمط strict و non-strict. في أغلبية الحالات، تُحدَّد قيمة الكلمة المحجوزة this وفق طريقة استدعاء الدالة، إذ لا يمكن ضبط قيمتها باستخدام عملية الإسناد العادية أثناء التنفيذ؛ وقد تختلف قيمة this في كل مرة تُستدعى فيها الدالة. أضافت ES5 الدالة bind التي تضبط قيمة this داخل الدالة بغض النظر عن طريقة استدعائها، وأضافت ES2015 الدوال السهمية (arrow functions) التي تُوفِّر ربطًا خاصًا بها ...

الكائن TypeError في JavaScript

الكائن TypeError يُشير إلى حدوث خطأ عندما يكون نوع المتغير أو المعامل غير صحيح. البنية العامة new TypeError([message]) message وسيط اختياري، وهو وصفٌ نصيٌّ للخطأ موجَّهٌ للبشر. الخاصيات والدوال التابعة للدالة البانية TypeError الخاصيات TypeError.prototype تُمثِّل هذه الخاصية كائن prototype التابعة للكائن TypeError. الدوال الدالة البانية TypeError لا تملك أيّة دوال تابعة لها مباشرةً، وإنما ترث بعض الخاصيات عبر سلسلة prototype. الكائن prototype الخاصيات TypeError.prototype.constructor تُحديد الدالة التي ستُنشِئ كائن prototype لكائنات TypeError؛ راجع صفحة الخاصيةObject.prototype.constructor لمزيدٍ من التفاصيل. TypeError.prototype.message رسالة ...

دالة getter في JavaScript

البنية get تؤدي إلى ربط خاصية من خاصيات الكائن بدالة التي ستستدعى عند محاولة الوصول إلى قيمة تلك الخاصية. البنية العامة {get prop() { ... } } {get [expression]() { ... } } prop اسم الخاصية الذي سترتبط بالدالة المعطية. expression بدءًا من ECMAScript 2015 (أي ES6)، يمكن استخدام التعابير لإنشاء أسماء محسوبة للخاصيات التي سترتبط بالدالة المعطية. الوصف يمكن أن تستخدم دالة getter في JavaScript لتنفيذ دالة معيّنة عندما تتم محاولة الوصول إلى خاصية من خاصيات الكائن بغية إعادة قيمة ...

الكائن Error في JavaScript

الدالة البانية Error تُنشِئ كائن خطأ، والنسخ الكائنات من النوع Error ستُرمى عند حدوث أخطاء في وقت التنفيذ (runtime errors)؛ لاحظ أنَّ الكائن Error يُستخدَم أيضًا ككائن أساس للاستثناءات التي يُعرَّفها المستخدم. انظر أدناه للحصول على قائمة بأنواع الأخطاء القياسية المُضمَّنة في اللغة. البنية العامة new Error([message]) message وسيط اختياري، وهو وصفٌ نصيٌّ للخطأ موجَّهٌ للبشر. الوصف الأخطاء التي تحدث في وقت التنفيذ (runtime errors) تؤدي إلى إنشاء ورمي كائنات Error جديدة. أنواع الأخطاء بجانب الدالة البانية Error العامة، هنالك ...

المعاملات الثنائية في JavaScript

المعاملات الثنائية (bitwise operators) تُعامِل القيم كأنها سلسلة تتألف من 32 بت (أصفار وواحدات) بدلًا من الأرقام Number في النظام العشري (decimal) أو الست عشري (hexadecimal) أو الثماني (octal)؛ فمثلًا يُمثَّل العدد 9 في نظام العد الثنائي بالمحارف 1001؛ وتجري معاملات البتات في JavaScript العمليات على التمثيل الثنائي للأعداد، لكنها تعيد قيمًا عدديةً عاديةً قياسيةً في JavaScript. الجدول الآتي يُلخِّص معاملات البتات في JavaScript: المعامل الاستخدام الوصف AND a & b يُعيد 1 مكان كل بت له القيمة 1 في ...

الإسناد بالتفكيك في JavaScript

الإسناد بالتفكيك (destructuring assignment) يسمح باستخراج القيم الموجودة في المصفوفات أو خاصيات أحد الكائنات إلى متغيرات مستقلة. البنية العامة var a, b, rest; [a, b] = [10, 20]; console.log(a); // 10 console.log(b); // 20 [a, b, ...rest] = [10, 20, 30, 40, 50]; console.log(a); // 10 console.log(b); // 20 console.log(rest); // [30, 40, 50] ({ a, b } = { a: 10, b: 20 }); console.log(a); // 10 console.log(b); // 20 // Stage 3 proposal ({a, b, ...rest} = {a: 10, b: 20, c: 30, d: 40}); console.log(a); // 10 console.log(b); // 20 console.log(rest); //{c: ...

الدالة Promise.prototype.then()‎ في JavaScript

الدالة then()‎ تعيد وعدًا Promise، وتأخذ وسيطين على الأكثر، وهما دالتا رد النداء (callback) لنجاح أو فشل الوعد. var promise1 = new Promise(function(resolve, reject) { resolve('Success!'); }); promise1.then(function(value) { console.log(value); // "Success!" }); ملاحظة: إذا كان أحد أو كلا المعاملين غير موجود، أو كان موجودًا لكنه ليس دالةً، فلن تضع الدالة then()‎ معالجًا له، لكنها لن تولِّد أي أخطاء. إذا أصبحت هنالك حالة للوعد Promise الذي استدعيت الدالة ()then عليه، ولم يكن للدالة ()then وسائط مناسبة، فسيُنشَأ وعدٌ Promise جديد دون ...

الدالة Promise.prototype.catch()‎ في JavaScript

الدالة catch()‎ تعيد وعدًا Promise وتتعامل مع حالات رفض الوعود فقط. وهي تسلك نفس سلوك استدعاء الدالة Promise.prototype.then(undefined, onRejected)‎. وفي الواقع، استدعاء الدالة obj.catch(onRejected)‎ سيستدعي الدالة obj.then(undefined, onRejected)‎ داخليًا. var promise1 = new Promise(function(resolve, reject) { throw 'Uh-oh!'; }); promise1.catch(function(error) { console.log(error); }); // Uh-oh! البنية العامة p.catch(onRejected); p.catch(function(reason) { // التعامل مع الرفض }); المعاملات onRejected دالة تستدعى عند رفض الوعد Promise. هذه الدالة تملك معاملًا وحيدًا: reason سبب الرفض. الوعد المُعاد من الدالة catch()‎ سيُرفَض إذا رمت الدالة onRejected أو ...

عرض (250 السابقة | 250 التالية) (20 | 50 | 100 | 250 | 500).