نتائج البحث

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

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

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

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

jQuery.sub( )‎ أهمل مع الإصدار: 1.7. حذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينشئ هذا التابع نسخةً جديدةً من jQuery للتمكن من تعديل خاصِّيَّاتها وتوابعها دون المساس بالمكتبة الأصليَّة. jQuery.sub( )‎ أُضيفت مع الإصدار: 1.5. لا يقبل هذا التابع أية وسائط. أهمل هذا التابع بدءًا من الإصدار jQuery 1.7 وسيُنقل إلى إضافةٍ في الإصدار jQuery 1.8. هنالك حالتان خاصَّتان أنشئ التابع jQuery.sub()‎ من أجلهما. الحالة الأولى هي من أجل توفير طريقة للتحكم بتوابع jQuery دون ...

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

jQuery.sub( )‎ أهمل مع الإصدار: 1.7. حذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينشئ هذا التابع نسخةً جديدةً من jQuery للتمكن من تعديل خاصِّيَّاتها وتوابعها دون المساس بالمكتبة الأصليَّة. jQuery.sub( )‎ أُضيفت مع الإصدار: 1.5. لا يقبل هذا التابع أية وسائط. أهمل هذا التابع بدءًا من الإصدار jQuery 1.7 وسيُنقل إلى إضافةٍ في الإصدار jQuery 1.8. هنالك حالتان خاصَّتان أنشئ التابع jQuery.sub()‎ من أجلهما. الحالة الأولى هي من أجل توفير طريقة للتحكم بتوابع jQuery دون ...

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

‎.detach( [selector ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع مجموعة العناصر المتطابقة من DOM. ‎.detach( [selector ] )‎ أُضيف مع الإصدار: 1.4. selector تعبير مُحدِّد يُرشِح مجموعة العناصر المتطابقة المراد حذفها وهو من النوع Selector. يعمل التابع ‎.detach()‎ مثل التابع  ‎.remove()‎ ، باستثناء أن ‎.detach()‎ يحتفظ بكل بيانات jQuery المرتبطة بالعناصر المحذوفة. يُفيد هذا التابع عند إعادة إدراج العناصر التي تمت إزالتها إلى DOM في وقت لاحق. أمثلة حذف جميع الفقرات من DOM: <!doctype ...

حذف المعاملات (Remove Parameter)

المشكلة لا يُستخدم معاملٌ ما في متن التابع. الحل إزالة المعامل غير المستخدم. مثال قبل إعادة التصميم تعريف المعامل Date في بداية التابع ()getContact وعدم استخدامه. تعريف المعامل Date في بداية التابع ()getContact وعدم استخدامه. بعد إعادة التصميم إزالة المعامل Date من التابع ()getContact لعدم استخدامه: إزالة المعامل Date من التابع ()getContact. لم إعادة التصميم؟ يفرض كل معامل موجود في استدعاء التوابع على المبرمج أن يقرأه لمعرفة ما هي المعلومات الموجودة في هذا المعامل. وإذا كان المعامل غير مستخدم على ...

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

‎.pushStack( elements )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يضيف هذا التابع مجموعة من عناصر DOM إلى مُكدِّس jQuery. ‎.pushStack( elements )‎ أُضيف مع الإصدار: 1.0. elements مصفوفة من العناصر المراد إضافتها إلى المُكدِّس، وتوضع هنالك في كائن jQuery جديد. ‎.pushStack( elements, name, arguments )‎ أُضيف مع الإصدار: 1.0. elements مصفوفة من العناصر المراد إضافتها إلى المُكدِّس ووضعها هنالك في كائن jQuery جديد. name سلسلة نصية تمثِّل اسم تابع jQuery الذي ولَّد مصفوفة العناصر. arguments مصفوفة تحتوي على ...

الاستغناء عن الوسيط (Remove Middle Man)

المشكلة احتواء الصنف (class) على العديد من التوابع (methods) التي تنقل (delegate) سياق البرنامج إلى كائنات (objects) أخرى. الحل حذف تلك التوابع وإجبار العميل (client) على الاستدعاء المباشر للتوابع النهائية (التي سيصل إليها بالنهاية وتحتوي المهام الفعليّة). مثال قبل إعادة التصميم يتعامل صنف العميل (client class) مع صنفٍ واحدٍ فقط وهو الصنف Person، والذي بدوره يستدعي كائنًا من صنفٍ آخر باسم Department دون أن يكون العميل على علمٍ بتفاصيل ذلك الاستدعاء، كما هو واضح في مخطط الأصناف الآتي: مخطط يوضح ...

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

jQuery.Callbacks( flags )‎ القيم المعادة تعيد كائن ردود النداء Callbacks. الوصف تعيد هذه الدالة كائنًا مُتعدِّد الأغراض يُزوِّدنا بطريقة فعَّالة لإدارة قائمة ردود النداء. jQuery.Callbacks( flags )‎ أُضيف مع الإصدار: 1.7. flags سلسلة نصية تمثل قائمة اختياريَّة من عدِّة رايات (flags) مفصولةٍ بفراغٍ تسهم في تغيير كيفيَّة سلوك قائمة ردود النداء. تُستخدَم الدالة ‎$.Callbacks()‎ داخليًّا لتأمين الوظائف الأساسيَّة التي يحتاجها المكونين ‎$.ajax()‎ و ‎$.Deferred()‎ في jQuery. يمكن أن تُستخدَم كقاعدة متجانسة لتعريف وظائف العناصر الجديدة. تدعم الدالة ‎$.Callbacks()‎ عددًا من ...

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

jQuery.Callbacks( flags )‎ القيم المعادة تعيد كائن ردود النداء Callbacks. الوصف تعيد هذه الدالة كائنًا مُتعدِّد الأغراض يُزوِّدنا بطريقة فعَّالة لإدارة قائمة ردود النداء. jQuery.Callbacks( flags )‎ أُضيف مع الإصدار: 1.7. flags سلسلة نصية تمثل قائمة اختياريَّة من عدِّة رايات (flags) مفصولةٍ بفراغٍ تسهم في تغيير كيفيَّة سلوك قائمة ردود النداء. تُستخدَم الدالة ‎$.Callbacks()‎ داخليًّا لتأمين الوظائف الأساسيَّة التي يحتاجها المكونين ‎$.ajax()‎ و ‎$.Deferred()‎ في jQuery. يمكن أن تُستخدَم كقاعدة متجانسة لتعريف وظائف العناصر الجديدة. تدعم الدالة ‎$.Callbacks()‎ عددًا من ...

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

‎.contents()‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.contents()‎ للحصول على العناصر الأبناء لكل عنصر من مجموعة العناصر المُطابِقة، بما في ذلك عقد النصوص والتعليقات. ‎.contents()‎ أضيفت في الإصدار: 1.2. لا يقبل هذا التّابع أي وسائط. يسمح لنا التّابع ‎‎.contents()‎‎، من خلال إعطاء كائن jQuery يُمثِّل مجموعة عناصر DOM، أن نبحث خلال العناصر الأبناء المباشرين لها في شجرة DOM وأن نبني كائن jQuery جديد من العناصر المُطابِقة. إنّ التابعين ‎.contents()‎ و ‎.children()‎ متشابهان فيما عدا أنّ التّابع ‎.contents()‎ يُضمِّن العقد ...

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

‎.promise( [type ] [, target ] )‎ القيم المعادة يعيد كائنًا من النوع Promise. الوصف يعيد هذا التابع كائنًا من النوع Promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة. ‎.promise( [type ] [, target ] )‎ أُضيف مع الإصدار: 1.6. type سلسلة نصية تمثِّل نوع الطابور المراد مراقبته. قيمته الافتراضية هي fx. target كائن مجرَّد (object) يبين أيًّا من توابع Promise يجب ...

تعديل العناصر في jQuery

جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر (أو مجموعة من العناصر) بأكمله وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث عن توابع تعدل خاصية عنصر، فانتقل إلى قسم «تعديل الخاصيات»). ‎.after()‎ يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. ‎.append()‎ يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل إلى آخر كل عنصر من مجموعة العناصر المُطابِقة. ‎.appendTo()‎ يُدخِل هذا التّابع كل عنصر من ...

إزالة رايات التحكم (Remove Control Flag)

المشكلة لديك متغيرات منطقية تعمل كرايات تحكم لتعبيرات منطقية متعددة. الحل استخدم الكلمات المفتاحية break و continue و return بدلًا من هذه المتغيرات. لم إعادة التصميم؟ تعود رايات التحكم إلى الأيام الخوالي، عندما كان يُتاح دائمًا للمبرمج "الأصيل" نقطة إدخال واحدة للدوال (سطر تعريف الدالة) ونقطة خروج واحدة (في نهاية الدالة). لكن هذا النمط المتشدد عفا عليه الزمن في لغات البرمجة الحديثة، إذ أصبح لدينا عوامل خاصة لتعديل تدفق التحكم في الحلقات وغيرها من التركيبات المُعقدة مثل: break: إيقاف الحلقة. continue: ...

ازالة توابع الإعدادات (Remove Setting Method)

المشكلة يكون تعيين قيمة الحقل فقط عند إنشائه، ولا تتغير في أي وقت لاحق. الحل إزالة التوابع التي تضبط قيمة الحقل. مثال قبل إعادة التصميم يضبط التابع ()setImmutableValue قيمةً غير قابلة للتغيير أو التعديل في المستقبل: يغيّر التابع من قيمة الحقل. بعد إعادة التصميم حذف التابع ()setImmutableValue من الصنف Customer: إزالة التابع الذي يضبط قيمة الحقل. لم إعادة التصميم؟ إذا كنت تريد منع أي تغييرات في قيمة الحقل. آلية الحل يجب أن تكون قيمة الحقل قابلة للتغيير فقط في الباني. ...

إزالة الإسناد إلى المعاملات (Remove Assignments to Parameters)

المشكلة إسناد قيمةٍ ما إلى أحد المعاملات (parameter) داخل التابع (method body). الحل استخدام متغيِّرٍ محليٍّ (local variable) بدلًا من المعامل. مثال قبل إعادة التصميم نلاحظ وجود عمليّة إسنادٍ (من بعد الإنقاص بمقدار 2) إلى معامل التابع الوارد باسم inputVal: في لغة Java: int discount(int inputVal, int quantity) { if (inputVal > 50) { inputVal -= 2; } //... } في لغة #C: int Discount(int inputVal, int quantity) { if (inputVal > 50) ...

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

‎.size()‎ أهمل هذا التابع في الإصدار: 1.8، وحذف في الإصدار: 3.0. القيم المعادة يعيد عددًا من النوع Number. الوصف يعيد هذا التابع عدد العناصر الموجودة في كائن jQuery محدَّد. ‎.size()‎ أُضيف مع الإصدار: 1.0. لا يقبل هذا التابع أية وسائط. أهمل التابع ‎.size()‎ بدءًا من الإصدار jQuery 1.8، لذا استعمل الخاصِّيَّة ‎.length عوضًا عنه. يكافئ التابع ‎.size()‎ وظيفيًا الخاصِّيَّة ‎.length. على أي حال، يفضل استعمال الخاصِّيَّة ‎.length لأنها لا تسبب حملًا زائدًا كما يفعل استدعاء دالةٍ ما. إن كان لدينا ...

Array.prototype.splice()‎

الدالة Array.prototype.splice()‎ تغيّر محتويات مصفوفة بإزالة عناصر موجودة فيها أو إضافة عناصر جديدة إليها. var myFish = ['angel', 'clown', 'mandarin', 'sturgeon']; myFish.splice(2, 0, 'drum'); // إضافة عنصر في الفهرس 2 // myFish: ["angel", "clown", "drum", "mandarin", "sturgeon"] myFish.splice(2, 1); // إزالة عنصر واحد (1) في الفهرس 2 // myFish: ["angel", "clown", "mandarin", "sturgeon"] البنية العامة array.splice(start[, deleteCount[, item1[, item2[, ...]]]]) start الفهرس الذي سنبدأ فيه تغيير المصفوفة (ويكون المبدأ هو 0)، وإذا كانت هذه القيمة أكبر من عدد عناصر المصفوفة (أي length)، فسيُضبَط فهرس ...

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

يخزِّن التابع ‎.data()‎ بيانات عشوائية مرتبطة بالعناصر المتطابقة أو تُعيد القيمة في مخزن البيانات المحدد للعنصر الأول في مجموعة العناصر المتطابقة. ‎.data( key, value )‎ القيمة المعادة يعيد التابع ‎.data()‎ كائنًا من النوع jQuery. الوصف يُخزن بيانات عشوائية مرتبطة بالعناصر المتطابقة. ‎.data( key, value )‎ أُضيفت مع الإصدار: 1.2.3. key سلسلة نصية مُنشَأة من الكائن String تشير إلى جزء من البيانات المراد تعيينه. value قيمة البيانات الجديدة، ويمكن أن تكون من أي نوع من أنواع JavaScript ما عدا القيمة undefined. ...

التابع singleton_method_removed في الصنف BasicObject في روبي

يُستَدعى التابع singleton_method_removed كرد نداءٍ (callback) في كل مرة يُحذف فيها تابع منفرد (singleton method) من المُستقبِل (receiver). البنية العامة singleton_method_removed(symbol) أمثلة مثال على استخدام التابع singleton_method_removed: module Chatty def Chatty.singleton_method_removed(id) puts "Removing #{id.id2name}" end def self.one() end def two() end def Chatty.three() end class << self remove_method :three remove_method :one end end يظهر هذا المثال عند تنفيذه المخرجات التالية: Removing three Removing one ...

الدالة ()map_remove في Sass

تعيد الدالة map_remove()‎ خريطة (map) جديدة بعد حذف مفاتيح معيّنة من الخريطة الممرَّرة إليها. تُعيد الدالة map_remove()‎ خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا. البنية العامة map_remove($map, $keys...) المعاملات ‎$map الخريطة المراد حذف مفاتيح محدَّدة منها. ‎$keys المفاتيح المراد حذفها من الخريطة ‎$map. القيم المعادة تُعاد خريطة الخريطة ‎$map بعد حذف المفاتيح ‎$keys منها. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$map خريطةً. أمثلة مثال عن استخدام الدالة map_remove()‎: map-remove(("foo": 1, "bar": 2), "bar") // ("foo": 1) map-remove(("foo": ...

التابع Module.method_removed‎ في روبي

يستدعى التابع method_removed في كل مرة يُزال تابع نسخة (instance method) من المُستقبِل (receiver). البنية العامة method_removed(method_name)‎ المعاملات method_name‎ اسم تابع النسخة. أمثلة مثال على استخدام التابع method_removed‎: module Chatty def self.method_removed(method_name) puts "Removing #{method_name.inspect}" end def self.some_class_method() end def some_instance_method() end class << self remove_method :some_class_method end remove_method :some_instance_method end‎ ناتج تنفيذ هذا المثال هو: Removing :some_instance_method انظر أيضا التابع method_defined?‎: يتحقق إن كان التابع المعطى مُعرّفًا في الوحدة أو ...

التابع String.remove()‎ في أردوينو

يحذف التابع remove()‎ عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها. البنية العامة string.remove(index) string.remove(index, count) تمثِّل string السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس index وحتى نهاية السلسلة أو بعدد المحارف count فقط. المعاملات index عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس بداية المحارف المراد حذفها. count عددٌ صحيحٌ عديم الإشارة يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس ...

التابع String.remove()‎ في أردوينو

يحذف التابع remove()‎ عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها. البنية العامة string.remove(index) string.remove(index, count) تمثِّل string السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس index وحتى نهاية السلسلة أو بعدد المحارف count فقط. المعاملات index عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس بداية المحارف المراد حذفها. count عددٌ صحيحٌ عديم الإشارة يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس ...

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

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

التابع set.remove()‎ في بايثون

يحذف التابع عنصرًا واحدًا من المجموعة. البنية العامة remove(elem) المعاملات elem العنصر المراد حذفه من المجموعة. إن لم يكن هذا العنصر ضمن المجموعة يطلق التابع الخطأ KeyError. أمثلة أمثلة نموذجية عن استخدام هذا التابع: >>> s = {1, 2, 3, 4, 5} >>> s.remove(3) >>> s {1, 2, 4, 5} >>> s.remove(6) Traceback (most recent call last): File "<stdin>", line 1, in <module> KeyError: 6 انظر أيضًا المجموعات في بايثون. التابع set.add()‎: إضافة عنصر واحد إلى المجموعة. التابع set.discard()‎: حذف عنصر واحد من المجموعة إن ...

الوسيط (Middle Man)

توصيف المشكلة عندما يكون للصنف (class) مهمةٌ واحدةٌ فقط وهي تفويض المهام (delegation) لصنفٍ آخر، فما أهمية وجوده بالأصل؟ أسبابها قد تنتج المشكلة عن التخلُّص المفرط من الاستدعاءات المتسلسلة كعلاجٍ لمشكلة سلاسل الرسائل (message chains). أو قد تنتُج عن النقل التدريجيّ للصنف (class) إلى أصناف أخرى ليبقى الصنف الأصليّ فارغًا إلا من أوامر التفويض (delegation). وما الحل؟ حذف الوسيط (remove middle man) إن كانت معظم أصناف التابع (method's classes) تفوِّض المهام (delegate) إلى صنفٍ آخر. إليك المزيد ستحصل بحلِّ المشكلة ...

الشيفرة الميتة (Dead Code)

توصيف المشكلة وجود العديد من المتغيِّرات (variables) أو المعاملات (parameters) أو الحقول (fields) أو التوابع (methods) أو الأصناف (classes) غير المستخدمة في الشيفرة. أسبابها عدم توفُّر الوقت الكافي لتوضيب الشيفرة وإزالة ما لم يعُد مستخدَمًا فيها، وذلك بعد تغيُّر متطلَّبات البرنامج أو إجراء بعض الإصلاحات به. وجود تعابيرَ شرطيَّةٍ معقَّدةٍ لا يتحقَّقُ شرطُ أحد فروعها (بسبب خطأٍ ما أو بحالاتٍ خاصّةٍ لن تحدث). وما الحل؟ الطريقة الأسرع لإيجاد الشيفرة الميتة هي استخدام بيئةٍ تطويريّةٍ متكاملةٍ (IDE) قويّةٍ وجيدة، ويتلخَّص الحل ...

التابع String.trim()‎ في أردوينو

يزيل التابع trim()‎ جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه. بدءًا من الإصدار 1.0، أصبح التابع يعدل السلسلة النصية المعطاة نفسها بدلًا من أن يعيد سلسلة نصية أخرى ناتجة عن عملية إزالة المسافات البيضاء من السلسلة النصية الأصلية. وبالتالي، كن حذرًا من استعمال هذه الدالة.  البنية العامة string.trim() تمثِّل string السلسلة النصية التي يراد حذف المسافات البيضاء من بدايتها ونهايتها. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع remove()‎: String stringValue = " ...

التابع String.trim()‎ في أردوينو

يزيل التابع trim()‎ جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه. بدءًا من الإصدار 1.0، أصبح التابع يعدل السلسلة النصية المعطاة نفسها بدلًا من أن يعيد سلسلة نصية أخرى ناتجة عن عملية إزالة المسافات البيضاء من السلسلة النصية الأصلية. وبالتالي، كن حذرًا من استعمال هذه الدالة.  البنية العامة string.trim() تمثِّل string السلسلة النصية التي يراد حذف المسافات البيضاء من بدايتها ونهايتها. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع remove()‎: String stringValue = " ...

التخطيط الشمولي المفرط (Speculative Generality)

توصيف المشكلة وجود أصنافٍ (classes) أو توابعَ (methods) أو حقولٍ (fields) أو معاملاتٍ (parameters) غير مُستخدَمة في الشيفرة. أسبابها إنشاء عناصرَ إضافيّةٍ "قد" يحتاجها المبرمج مستقبلًا لميّزات يُخطِّط لها (وقد لا تُنفَّذ أصلًا)، وغير مستخدمةٍ بالوقت الحاليّ، مما يجعل الشيفرة أكثر صعوبةً بالفهم والدعم. وما الحل؟ هدم الهيكليّة الهرميّة (collapse hierarchy) لإزالة الأصناف المُجرَّدة (abstract classes) غير المُستخدَمة. دمج الأصناف (inline classes) للحدُّ من عمليات تفويض المهامّ (delegation) غير الضروريّة لصنفٍ آخر. دمج التوابع (inline methods) للتخلُّص من التوابع عديمة ...

Array.prototype.shift()‎

الدالة Array.prototype.shift()‎ تحذف أوّل عنصر من المصفوفة وتُعيد قيمته، وهذه الدالة تُغيّر عدد عناصر (length) المصفوفة. var a = [1, 2, 3]; var b = a.shift(); console.log(a); // [2, 3] console.log(b); // 1 البنية العامة arr.shift() القيمة المعادة القيمة المحذوفة من المصفوفة، أو القيمة undefined إذا كانت المصفوفة فارغة. الوصف الدالة shift تحذف آخر عنصر من المصفوفة وتُعيد تلك القيمة إلى التعبير البرمجي الذي استدعاها؛ وإذا اُستدعيت الدالة shift على مصفوفة فارغة فستُعيد القيمة undefined. أمثلة المثال الآتي يُنشِئ مصفوفةً باسم myFish تحتوي ...

أصناف البيانات (Data Classes)

توصيف المشكلة وجود العديد من أصناف البيانات في الشيفرة، والتي تُستخدَم لتخزين البيانات التي تحتاج إليها الأصناف الأخرى، إذ تحتوي على حقولٍ للبيانات (fields) وتوابع للوصول إليها (accessors) أي توابعَ للحصول على بيانات الحقول (getter) وأخرى لتعديلها (setter)، ولا تقوم هذه الأصناف بأيّ مهمّة أخرى ولا تستطيع كذلك تنفيذ العمليات (operations) على بياناتها بمفردها. أسبابها من الطبيعي أن يحتوي الصنف -بادئ الأمر- على القليل من الحقول العامّة (public fields) وبعض التوابع للوصول إليها (accessors) ولكن إن استمرَّ الصنف كذلك فلن ...

الدالة weakref.finalize()‎ في بايثون

يعيد هذا الصنف كائن إنهاء finalizer قابل للاستدعاء، ويجري استدعاؤه عند استرجاع الكائن المعطى بواسطة مجموعة garbage. البنية العامة class weakref.finalize(obj, func, *args, **kwargs) المعاملات يعدّ كائن الإنهاء "حيًّا" إلى حين استدعائه (إما على نحو صريح أو في مجموعة garbage) وبعد ذلك يصبح "ميّتًا". تؤدي عملية استدعاء كائن إنهاء حيّ إلى إعادة نتيجة تنفيذ func(*arg, **kwarg)‎، في حين تعيد عملية استدعاء كائن إنهاء ميّت القيمة None. من الضروري التأكّد من أن func و args و kwargs لا تمتلك أيّ إشارات ...

jQuery/Topics a-z

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

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

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

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

‎.not( [selector ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع عناصر محدَّدة من مجموعة من العناصر المطابقة. ‎.not( selector )‎ أُضيف مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد، أو عنصر DOM، أو مصفوفة من العناصر لمطابقة مجموعة معينة من العناصر. ‎.not( function )‎ أُضيف مع الإصدار: 1.4. function دالة من الشكل Function( Number index, Element element )‎ تعيد قيمة منطقيَّة Boolean، وتُستعمَل للتحقُّق من كلِّ عنصر من عناصر المجموعة. تقبل هذه الدالة ...

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

‎.is( selector )‎ القيمة المعادة يُعيد كائنًا من النوع Boolean. الوصف التحقق من مجموعة العناصر المطابقة الحالية مقابل مُحدَّد أو عنصر أو كائن jQuery وإعادة القيمة true إذا تطابق أحد هذه العناصر على الأقل مع الوسائط المُدخلَة. ‎.is( selector )‎ أُضيف مع الإصدار: 1.0. selector سلسلة من النوع Selector تحتوي على تعبير مُحدِّد لمطابقة العناصر. ‎.is( function )‎ أُضيف مع الإصدار: 1.6. function دالة على الشكل Function( Integer index, Element element )  => Boolean، وهي تستخدم كاختبار لكل عنصر في ...

المحددات في jQuery

توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها. من أجل استعمال المحارف الخاصة (مثل !"#$%&'()*+,./:;<=>?@[\]^`{|}~) كجزء صرف من الاسم المراد تحديده، يجب أن تهرب تلك المحارف عبر \\. على سبيل المثال، إن كان اسم العنصر المراد تحديده هو id="foo.bar"، يمكنك تحديده عبر المُحدِّد $("#foo\\.bar"). تحوي مواصفات CSS القياسية (أي W3C CSS specification) مجموعة كاملة من القواعد المتعلقة بالمحددات الصالحة. هنالك أيضًا مقالة مفيدة لصاحبها Mathias Bynens تتحدث عن تهريب ...

أساس jQuery

تشكل التوابع والدوال الموجودة في هذا القسم أساس مكتبة jQuery. ‎.length تعيد هذه الخاصِّيَّة عدد العناصر الموجودة في كائن jQuery. ‎.jquery يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. ‎jQuery()‎ تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. ‎jQuery.contains()‎ يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر. ‎jQuery.cssHooks()‎ يتعلَّق هذا التابع ...

jQuery/Topics

أساس jQuery تشكل التوابع والدوال الموجودة في هذا القسم أساس مكتبة jQuery. المحددات توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها. التنقل بين العناصر تتيح التوابع في هذا القسم بتحديد عناصر موجودة في موضع محدد والتنقل بينها. تعديل العناصر جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر (أو مجموعة من العناصر) بأكمله وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث ...

المحدد ‎‎‎:not()‎‎ في jQuery

المحدد ‎:not()‎ الوصف يختار هذا المحدِّد جميع العناصر التي لا تطابق المحدِّد المعطى. jQuery( ":not(selector)" )‎ أُضيف مع الإصدار: 1.0. selector المحدِّد المراد منه ترشيح العناصر. يقبل هذا التابع أن يُمرَّر إليه جميع المحدِّدات مثل ‎:not(div a)‎ و ‎:not(div,a)‎. ملاحظات إضافية سينتهي المطاف بالتابع ‎.not()‎ إلى تزويدك بنتائج أكثر قابلية للقراءة عوضًا عن تمرير محدِّدات أو متغيرات معقَّدة إلى مرشِّح المحدِّد ‎:not()‎، ويكون التابع في أغلب الأحيان هو الخيار الأفضل. أمثلة إيجاد جميع مربعات الاختيار (checkbox) التي لم تُختار، وتمييز ...

خدمات jQuery

توفر التوابع الموجودة في هذا القسم بعض عدة خدمات ووظائف متنوعة. يصعب حصرها في تصنيف أو قسم واحد. ‎jQuery.dequeue()‎ ينفَّذ هذا التابع الدالة التالية الموجودة في طابور الانتظار للعناصر المتطابقة. ‎jQuery.each()‎ هذه الدالة هي دالة تكرار عامة تستعمل لتكرار تنفيذ دالة بسلاسة تامة عبر الكائنات والمصفوفات. عدد مرات تكرار تنفيذ الدالة على المصفوفات والكائنات الشبيهة بالمصفوفات التي لها الخاصِّيَّة length (مثل الكائن الذي يحوي وسائط دالةٍ) تنحصر بالمجال من 0 إلى length-1، إذ length هو عدد العناصر. أمَّا عدد مرات ...

الأحداث في jQuery

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

التابع deque.clear()‎ في بايثون

حذف جميع العناصر من كائن deque ويصبح طول الكائن 0. البنية العامة d.‎clear() أمثلة يبين المثال التالي آلية عمل التابع: >>> from collections import deque >>> d = deque('abcdef') >>> d deque(['a', 'b', 'c', 'd', 'e', 'f']) >>> d.clear() >>> d deque([]) >>> len(d) 0 انظر أيضًا التابع pop()‎:  :يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيمن في الكائن deque. التابع popleft()‎:  :يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيسر في الكائن deque. التابع remove()‎:  :يحذف التابع أوّل عنصر يحمل القيمة المعطاة. مصادر قسم deque Objects في صفحة ...

التابع array.remove()‎ في بايثون

يحذف التابع أول ظهور للقيمة المعطاة من المصفوفة. البنية العامة ‎array.remove(x) المعاملات x القيمة المراد حذفها من المصفوفة. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1.remove(3) انظر أيضًا التابع array.append()‎: يضيف التابع عنصرًا جديدًا يحمل القيمة المعطاة إلى نهاية المصفوفة. التابع array.extend()‎: يلحق التابع عناصر كائن التكرار المعطى إلى نهاية المصفوفة. التابع array.insert()‎: يدرج التابع عنصرًا جديدًا يحمل القيمة المعطاة في المصفوفة قبل ...

تبسيط استدعاءات التوابع (Simplifying Method Calls)

تجعل التقنيات التي سيشار إليها في هذا القسم استدعاءات التوابع أبسط وأسهل للفهم والاستيعاب. سيؤدي ذلك بدوره إلى تبسيط الواجهات للتفاعل بين الأصناف. هذه التقنيات هي: إعادة تسمية التوابع (Rename Method) المشكلة: لا يعبِّر اسم التابع عن ما يقوم به. الحل: إعادة تسمية التابع. إضافة المعاملات (Add Parameter) المشكلة: لا يملك التابع بيانات كافية لتنفيذ بعض الإجراءات. الحل: إنشاء معامل جديد لتمرير البيانات الضرورية. حذف المعاملات (Remove Parameter) المشكلة: لا يُستخدم معاملٌ ما في متن التابع. الحل: إزالة المعامل غير ...

الوحدة heapq في بايثون

تقدّم هذه الوحدة وسيلة لاستخدام خوارزمية طابور الكومة heap queue والتي تعرف كذلك بخوارزمية طابور الأولوية priority queue. الكومات Heaps هي مشجّرات ثنائية binary trees تمتلك كل عقدة أبوية parent node فيها قيمة تكون أصغر من أو مساوية لأي قيمة أخرى في العقد البنوية children. تستخدم الوحدة مصفوفات تكون فيها heap[k] <= heap[2*k+1]‎ و heap[k] <= heap[2*k+2]‎ لجميع قيم k، ويبدأ عدّ العناصر من الصفر. ولغرض المقارنة، تُعدّ العناصر غير الموجودة ما لا نهائية. أما أهمّ خصائص الكومة هي أنّ ...

التابع Object.remove_instance_variable في روبي

يَحذِف التابع remove_instance_variable متغيِّر نسخةٍ باسمٍ محدَّدٍ من الكائن الذي استدعي معه ويُعيد قيمة ذلك المتغيِّر. البنية العامة remove_instance_variable(symbol) → obj المعاملات symbol الرَّمز المعرِّف لمتغير النسخة المراد حذفه. القيم المعادة تعاد قيمة متغير النسخة symbol بعد حذفه من الكائن المعطى. أمثلة مثالٌ عن استخدام التابع remove_instance_variable: class Dummy attr_reader :var def initialize @var = 99 end def remove remove_instance_variable(:@var) end end d = Dummy.new d.var #=> ...

التابع Module.undef_method‎ في روبي

يمنع التابع undef_method الصنف الحالي من الاستجابة للاستدعاءات الموجهة إلى التابع المعطى. سلوك هذا التابع مخالف لسلوك التابع remove_method الذي يحذف التابع من الصنف المعين؛ ستبحث روبي في الأصناف العليا (superclasses) وفي الوحدات المختلطة (mixed-in modules) عن مُستقبِل (receiver) محتمل. البنية العامة undef_method(symbol) → self undef_method(string) → self‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. يحول هذا المعامل إن أعطي إلى رمز. القيمة المعادة يعاد الكائن المعطى نفسه. أمثلة مثال على استخدام التابع undef_method‎: class Parent def hello ...

تقنيات إعادة التصميم (Refactoring Techniques)

إنشاء التوابع تستهدف إعادة التصميم بشكل رئيسيٍّ إنشاء التوابع الصحيحة المناسبة، إذ تكون التوابع الطويلة سببًا للمشاكل في كثيرٍ من الحالات، وتجعل شيفرات بعض التوابع منطق التنفيذ (execution logic) غامضًا ويصبح التابع بهذا عصيَّ الفهم من جهةٍ وصعب التغييرٍ من جهة ثانية. يشمل هذا القسم من الحلول كلَّ ما يتعلق بالتوابع وإزالة التكرار (duplicates) في الشيفرة ليسمح بإجراء التطويرات المستقبليّة، وهذه التقنيات هي: استخراج التوابع (Extract Methods): والتي تتمثل بوجود أجزاء من الشيفرة يُمكن عزلها وتجميعها سويةً. دمج التوابع (Inline ...

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

jQuery.noConflict( [removeAll ] )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يجبر هذا التابع jQuery على التنازل عن التحكم بالمتغيِّر $. jQuery.noConflict( [removeAll ] )‎ أُضيف مع الإصدار: 1.0. removeAll قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إزالة جميع متغيرات jQuery من النطاق العام (global scope) بما فيها jQuery نفسها. تستعمل أغلب مكتبات JavaScript المعامل $ بوصفه دالةً أو اسم متغيِّر مثلما تفعل jQuery تمامًا. ففي حالة مكتبة jQuery، يُعدُّ $ اسمًا بديلًا للعبارة jQuery، لذا تكون جميع الوظائف متاحة ...

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

jQuery.noConflict( [removeAll ] )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يجبر هذا التابع jQuery على التنازل عن التحكم بالمتغيِّر $. jQuery.noConflict( [removeAll ] )‎ أُضيف مع الإصدار: 1.0. removeAll قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إزالة جميع متغيرات jQuery من النطاق العام (global scope) بما فيها jQuery نفسها. تستعمل أغلب مكتبات JavaScript المعامل $ بوصفه دالةً أو اسم متغيِّر مثلما تفعل jQuery تمامًا. ففي حالة مكتبة jQuery، يُعدُّ $ اسمًا بديلًا للعبارة 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 ...

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

jQuery.ajaxPrefilter( [dataTypes ], handler )‎ القيم المعادة يعيد قيمةً غير مُعرَّفة (undefined). الوصف يعالج هذا التابع إعدادات Ajax المخصَّصة أو يعدِّل إعدادات موجودة قبل أن يرسل كل طلب وقبل أن يعالج باستعمال الدالة ‎$.ajax()‎. jQuery.ajaxPrefilter( [dataTypes ], handler )‎ أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية اختياريَّة تحتوي على نوع بيانات (dataType) واحد أو عدَّة أنواع مفصولة بفراغ. handler دالة من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR )‎ وتستعمل لتعيين قيم افتراضيَّة لطلبات Ajax المستقبليَّة. تبدو عملية الترشيح ...

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

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

المحدد ‎‎‎:submit‎ في jQuery

المحدد submit: الوصف يحدِّد جميع عناصر الإدخال ذات النوع submit. ‎jQuery( ":submit" )‎ أضيف مع الإصدار 1.0. يُستعمَل المحدِّد ‎:submit عادةً مع العناصر <input> أو <button>. انتبه إلى أنَّ بعض المتصفحات تعامل العنصر <button> على أنَّها من النوع submit ضمنيًّا بينما لا تفعل متصفحات أخرى ذلك (مثل المتصفح Internet Explorer). إن أردت التأكد من عمل الشيفرة عبر جميع المتصفحات، وضمان تحديد العناصر <button> التي سترسل النموذج بشكل صحيح، فاستعمل الخاصِّيَّة type دومًا وحدِّد قيمتها. ملاحظات إضافية لمَّا كان المحدِّد ‎:submit ...

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

event.result القيمة المعادة تُعيد كائنًا من النوع Object. الوصف تعيد هذه الخاصية القيمة الأخيرة المُعادة بواسطة معالج الأحداث الذي أطلقه هذا الحدث، ما لم تكن هذه القيمة غير معرفة undefined. event.result أُضيف مع الإصدار: 1.3. يمكن أن تكون هذه الخاصية مفيدة للحصول على القيم المُعادة السابقة للأحداث المخصصة. أمثلة عرض قيمة معالج الحدث المُعادة السابقة: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.result مثال على الخاصية</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>عرض event.result</button> <p></p> <script> $( "button" ).click(function( event ) { return "مرحبًا"; }); $( ...

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

jQuery.getJSON( url [, data ] [, success ] )‎ القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف تجلب هذه الدالة بياناتٍ مرمَّزة بصيغة JSON من الخادم باستعمال طلب HTTP عبر الطريقة GET. jQuery.get( url [, data ] [, success ] )‎ أُضيفت مع الإصدار: 1.0. url سلسلة نصية تحتوي على الرابط URL الذي سيُرسَل الطلب إليه. data كائنٌ مجرَّد أو سلسلة نصية تُرسَل إلى الخادم مع الطلب. success دالةٌ من الشكل Function( Object data, String textStatus, jqXHR jqXHR )‎ يراد ...

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

deferred.done( doneCallbacks [, doneCallbacks ] )‎ القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع مُعالجات تستدعى عند قبول الكائن المؤجل Deferred. deferred.done( doneCallbacks [, doneCallbacks ] )‎ أُضيف مع الإصدار: 1.5. doneCallbacks هو دالة، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function()‎. doneCallbacks هو دالة اختيارية إضافية، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function()‎. يقبل التابع deferred.done()‎ وسيطًا واحدًا أو أكثر، وكلها يمكن أن تكون إما دالة مفردة ...

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

‎.eq( index )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تقليص مجموعة العناصر المتطابقة إلى تلك الموجودة في الفهرس المُحدَد. ‎.eq( index )‎ أُضيف مع الإصدار: 1.1.2. index عدد صحيح يشير إلى الموضع الصفري للعنصر، وهو من النوع Number. ‎.eq( indexFromEnd )‎ أُضيف مع الإصدار: 1.4. indexFromEnd عدد صحيح يشير إلى موضع العنصر، مع العد تنازليا من العنصر الأخير في المجموعة، وهو من النوع Number. إذا كان لدينا كائن jQuery يمثل مجموعة من عناصر DOM، فسينشئ التابع ‎.eq()‎ كائن jQuery ...

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

‎.last()‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يزيل هذا التابع جميع العناصر المتطابقة من المجموعة باستثناء العنصر الأخير. ‎.last()‎ أُضيف مع الإصدار: 1.4. لا يقبل هذا التابع أي معاملات. إن أعطي للتابع ‎.last()‎ كائن jQuery يمثل مجموعةً من عناصر DOM، فسيبني كائن jQuery جديد من العنصر الأخير في تلك المجموعة. افترض أنه لدينا صفحة تحتوي على قائمة بسيطة مثل: <ul> <li>عنصر القائمة الأول</li> <li>عنصر القائمة الثاني</li> <li>عنصر القائمة الثالث</li> <li>عنصر القائمة الرابع</li> <li>عنصر ...

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

تعمل التوابع الموجودة في هذا القسم على جلب وضبط قيم خاصيات CSS لعنصر محدَّد (أو مجموعة عناصر محدَّدة). ‎.height()‎ يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة. ‎.innerHeight()‎ يعيد هذا التابع قيمة الطول الحالي (تتضمن قيمة الحواشي فقط دون الإطار) لأول عنصر في مجموعة العناصر المطابقة أو يغير الطول الداخلي لكل العناصر المطابقة. ‎.innerWidth()‎ يعيد هذا التابع قيمة العرض الحالي (تدخل قيمة الحواشي ضمنها فقط) لأول عنصر من مجموعة العناصر المطابقة ...

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

jQuery.contains( container, contained )‎ القيم المعادة يعيد قيمة منطقيَّة (Boolean). الوصف يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر. jQuery.contains( container, contained )‎ أُضيف مع الإصدار: 1.4. container عنصر DOM الذي قد يحوي العنصر contained المعطى. contained العنصر DOM الذي سيتأكد التابع من أنَّه عنصرٌ سليلٌ من العنصر container. يعيد التابع ‎$.contains()‎ القيمة true إن كان العنصر contained المعطى هو عنصر سليل من العنصر container المعطى أيضًا سواءً كان ذلك العنصر ابنًا ...

الخاصية ‎‎jQuery.fx.off()‎‎ في jQuery

jQuery.fx.off القيم المعادة قيمتهما هي قيمة منطقية (Boolean). الوصف تعمل هذه الخاصِّيَّة على تعطيل جميع الحركات على الصعيد العام. jQuery.fx.off أُضيفت مع الإصدار: 1.3. عند تغيير قيمة هذه الخاصِّيَّة إلى القيمة true، ستَنقل جميع التوابع الحركيَّة العناصر إلى حالتها النهائية مباشرةً عند استدعائها دون إظهار أي تأثيرات أو تطبيق أية حركات على العنصر. يُرغب باستعمال هذه الخاصِّيَّة لسببين هما: تعمل jQuery على جهازٍ ذي مواصفات منخفضة. يواجه المستخدمون مشكلاتٍ في إمكانيَّة الوصول مع الحركات. يمكن إيقاف هذا السلوك وتشغيل الحركات ...

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

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

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

deferred.promise( [target ] )‎ القيمة المعادة يُعيد كائنًا من النوع Promise. الوصف يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred. deferred.promise( [target ] )‎ أُضيف مع الإصدار: 1.5. target الكائن الذي يجب إرفاق تابع promise به وهو من النوع Object. يسمح التابع deferred.promise()‎‎ لدالة غير متزامنة بمنع الشيفرات البرمجية الأخرى من التدخل في تقدم أو حالة الطلب الداخلي الخاص به. ويعرض التابع promise فقط التوابع المؤجلة اللازمة لإرفاق معالجات إضافية أو تحديد الحالة (then و done و fail و always ...

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

jQuery.cssNumber القيم المعادة يعيد كائنًا من النوع Object. الوصف يعيد هذا التابع كائنًا يحتوي على جميع خاصِّيَّات CSS التي يمكن استعمالها دون واحدة. يستعمل التابع ‎.css()‎ هذا الكائن ليتحقَّق إن كان بإمكانه إضافة الواحدة px إلى القيم المعطاة دون واحدة. jQuery.cssNumber أُضيف مع الإصدار: 1.4.3. يمكنك أن تتخيل أنَّ jQuery.cssNumber ليس إلا قائمةً بجميع خاصِّيَّات CSS التي يمكنك استعمالها دون واحدة. يستعمل التابع ‎.css()‎ هذه القائمة ليحدِّد إن كان هنالك حاجة لإضافة الواحدة px إلى القيم عديمة الواحدة. تكون مفاتيح ...

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

jQuery.error( message )‎ الوصف يأخذ هذا التابع قيمةً ثمَّ يرمي استثناءً يحتوي على هذه القيمة. jQuery.error( message )‎ أُضيف مع الإصدار: 1.4.1. message رسالة الخطأ المراد إرسالها. أكثر من يستعمل هذا التابع هم المطورون في إضافاتهم (plugin) الذين يريدون توفير وإظهار معلومات أوسع حول رسائل الخطأ. أمثلة تجاهل الخطأ jQuery.error وإظهاره في سجل المتصفح: jQuery.error = console.error; مصادر صفحة التابع ()jQuery.error في توثيق jQuery الرسمي.

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

deferred.resolve( [args ] )‎ القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف قبول كائن مؤجل واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة. deferred.resolve( [args ] )‎ أُضيف مع الإصدار: 1.5. args الوسائط الاختيارية التي تُمرر إلى دوال doneCallbacks، ويمكن أن يكون من أي نوع من أنواع JavaScript. عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن Promise كسلسلة (chain) من خلال التابع deferred.promise()‎‎‎. عند قبول الكائن ...

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

يجلب عناصر DOM المطابقة والمخزنة في كائن jQuery. ‎.get( index )‎ الوصف يعيد هذا التابع عنصرًا واحدًا من العناصر الموجودة في كائن jQuery. ‎.get( index )‎ index فهرس صفري من النوع Number (عدد صحيح) يشير إلى العنصر المراد إعادته. يوفر التابع ‎.get()‎ إمكانية الوصول إلى كل عناصر DOM الموجودة في كل كائن jQuery. إذا كانت قيمة الفهرس index خارج المجال (أي أصغر من عدد العناصر الموجودة ضمن الكائن – أي قيمة سالبة – أو أكبر أو تساوي عدد هذه العناصر)، ...

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

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

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

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

المحدد ‎:enabled‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

المحدد ‎:enabled الوصف يحدد كل العناصر المُفعَّلة (enabled). jQuery( ":enabled" )‎ أُ‎ضيف مع الإصدار: 1.0. كما هو الحال مع الأصناف الزائفة الأخرى (تلك التي تبدأ بنقطتين رأسيتين :)، فمن المستحسن أن تسبقها باسم وسم أو مُحدِّد آخر؛ خلاف ذلك، سيستخدم المحدد العالمي (*) كمحدد ضمني. بمعنى آخر، فإن ‎$(':enabled')‎ المجرد يعادل ‎$('*:enabled')‎، لذلك يُفضَّل استخدام ‎$('input:enabled')‎ أو ما شابه بدلًا من ذلك. وعلى الرغم من أن التحديدات التي تُنتج عنها عادة ما تكون متماثلة، فإن المحدد ‎:enabled يختلف تمامًا عن ...

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

()hide. الوصف يخفي هذا التابع كل العناصر المتطابقة. ‎.hide()‎ أضيف مع الإصدار: 1.0. لا يقبل هذا الشكل من التابع أي معاملات. ‎.hide( [duration ] [, complete ] )‎ أضيف مع الإصدار 1.0. duration عدد أو سلسلة نصية تمثل كم من الوقت الذي ستستغرقه عملية إخفاء العنصر، وقيمته الافتراضية هي 400. complete دالة تُستدعى بعد انتهاء حركة الإخفاء. تُستدعى مرةً لكل عنصر يراد إخفاؤه. ‎.hide( options )‎ ‎أضيف مع الإصدار: 1.0. Options كائن من النوع Object، وهو مجموعة من الخيارات الإضافية ...

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

deferred.resolve( [args ] )‎ القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف قبول كائن مؤجل واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة. deferred.resolve( [args ] )‎ أُضيف مع الإصدار: 1.5. args الوسائط الاختيارية التي تُمرر إلى دوال doneCallbacks، ويمكن أن يكون من أي نوع من أنواع JavaScript. عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن Promise كسلسلة (chain) من خلال التابع deferred.promise()‎‎‎. عند قبول الكائن ...

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

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎deferred.state()‎ القيمة المعادة يُعيد كائنًا من النوع String. الوصف يُحدد هذا التابع الحالة الحالية لكائن مؤجل. deferred.state()‎ أُضيف مع الإصدار: 1.7. هذا التابع لا يقبل أي وسائط. يعيد التابع deferred.state()‎ سلسلة نصية تمثل الحالة الحالية للكائن المؤجل. يمكن أن يكون الكائن المؤجل في إحدى الحالات الثلاث: معلق pending : الكائن المؤجل ليس في حالة مكتملة (لا "مرفوض" ولا "مقبول"). مقبول resolved : الكائن المؤجل موجود في حالة قبول، مما يعني أنَّه قد استدعي التابع deferred.resolve()‎ أو التابع deferred.resolveWith()‎ للكائن أو أنَّ الدالة ...

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

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

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

deferred.rejectWith( context [, args ] )‎ القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف يرفض هذا التابع كائنًا مؤجلًا Deferred ويستدعي أي failCallbacks مع سياق context ووسائط args محددة. deferred.rejectWith( context [, args ] )‎ أُضيف مع الإصدار: 1.5. context السياق المُمَرر إلى failCallbacks على أنه الكائن this وهو من النوع كائن Object. args الوسائط الاختيارية التي تُمرر إلى failCallbacks وهي كائن من النوع Array. عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية ...

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

jQuery.ajax( url [, settings ] )‎ القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف ترسل هذه الدالة طلب ‎(Ajax) HTTP غير متزامن. jQuery.ajax( url [, settings ] )‎ أُضيف مع الإصدار: 1.5. url سلسلة نصية تحتوي على العنوان URL المراد إرسال الطلب إليه. settings كائن مجرَّد (object) يمثِّل مجموعة من الأزواج مفتاح/قيمة التي تضبط طلب Ajax. جميع الإعدادات اختيارية ويمكن تعيين إعدادات افتراضية لأي ضبط باستعمال التابع ‎$.ajaxSetup()‎. انظر إلى القسم التالي للاطلاع على القائمة الكاملة لجميع الإعدادات. jQuery.ajax( [ ...

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

‎.appendTo( target )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.appendTo()‎ في إدخال كل عنصر من مجموعة العناصر المُطابِقة إلى نهاية العنصر الهدف. ‎.appendTo( target )‎ أضيفت في الإصدار: 1.0. target مُحدِّد (Selector) أو سلسلة نصيّة من الكائن htmlString أو عنصر أو مصفوفة أو كائن jQuery، وتُمثِّل مجموعة العناصر المُطابِقة التي ستُدخَل إلى نهاية العنصر أو العناصر المُحدَّدة عن طريق هذا المُعامِل. ينجز التّابعان ‎.append()‎ و ‎.appendTo()‎ نفس المهمة ويكمن الفرق الأساسي بينهما في الصّياغة، أي في مكان تحديد المحتوى ...

المحدد ‎‎‎:lang()‎‎ في jQuery

المحدد ‎:lang()‎ الوصف يختار هذا المحدِّد جميع العناصر التي تشترك بلغة معيَّنة. jQuery( ":lang(language)" )‎ أُضيف مع الإصدار: 1.9. language رمز لغة العناصر المراد تحديدها. يطابق المحدد ‎:lang()‎ العناصر التي تمتلك قيمة لغة مساوية إلى رمز اللغة المعطى أو القيمة التي تبدأ برمز اللغة المعطى ثم تُتيع بالمحرف "-" مباشرةً. سيطابق مثلًا المحدِّد ‎$("div:lang(en)")‎ العنصر <div lang="en"‎> والعنصر <div lang="en-us"‎> وأي عناصر سليلة لهما، ولكن لن يطابق العنصر <div lang="ar"‎>. تُحدَّد قيمة اللغة في عناصر HTML باستعمال الخاصية lang وقد ...

التابع ‎.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()‎. لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط ...

المحدد ‎‎‎:root‎ في jQuery

المحدد ‎:root الوصف يحدِّد العنصر الجذر في شجرة المستند. ‎jQuery( ":root" )‎ أُضيف مع الإصدار: 1.9. العنصر الجذر في مستندات HTML هو دومًا العنصر <html>، وهو العنصر الذي يحدده ‎$(":root")‎. أمثلة إظهار اسم عقدة العنصر الجذر: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>root مثالٌ عن استعمال المحدد</title> <style> span.fot { color: red; font-size: 120%; font-style: italic; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <div id="log">العنصر الجذر في هذا ...

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

jQuery.proxy( function, context )‎ القيم المعادة يعيد دالةً (Function). الوصف يأخذ هذا التابع دالةً ويعيد أخرى جديدة تحوي محتوًى محددًّا. jQuery.proxy( function, context )‎ أُضيف مع الإصدار: 1.4. function دالةٌ من الشكل Function()‎ يراد تبديل سياقها. context الكائن الذي يجب أن يُعيَّن سياق (this) الدالة إليه. jQuery.proxy( context, name )‎ أُضيف مع الإصدار: 1.4. context الكائن الذي يجب أن يُعيَّن سياق الدالة إليه. name سلسلة نصية تمثل اسم الدالة التي يراد تبديل سياقها (يجب أن تكون خاصِّيَّة للكائن context). jQuery.proxy( ...

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

jQuery.isPlainObject( object )‎ القيم المعادة يعيد قيمةً منطقيِّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه كائنًا مجرَّدًا (أُنشئ باستعمال "{}" أو "new Object") أم لا. jQuery.isPlainObject( object )‎ أُضيف مع الإصدار: 1.4. object الكائن المراد التحقُّق منه. ملاحظة: كائنات المضيف (Host objects، أو الكائنات المستعملة من قِبَل بيئة المتصفح المضيف لإكمال بيئة التنفيذ ECMAScript) لها عددٌ من التناقضات التي يصعب على أي ميِّزة صارمة اكتشافها عبر المنصات. نتيجةً لذلك، قد يعطي التابع ‎$.isPlainObject()‎ قيمًا غير متناسقة تختلف ...

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

jQuery.escapeSelector( selector )‎ القيم المعادة يعيد محدِّدًا (selector). الوصف يهرِّب هذا التابع مجموعةً من المحارف التي تشبه اسم محدِّد في CSS. jQuery.escapeSelector( selector )‎ أُضيف مع الإصدار: 3.0. selector سلسلة نصية تحتوي على اسم يماثل اسم محدِّد يراد تهريبه. هذا التابع مفيد جدًا في الحالات التي يحتوي فيها اسم صنف أو مُعرِّف (ID) على محارف لها معنًى خاص في CSS مثل المحرف . أو المحرف :. هذا التابع مشتق من التابع CSS.escape()‎ لمجموعة عمل CSS. الفارق الأساسي بينه وبين ‎$.escapeSelector()‎ ...

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

‎.offsetParent()‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يعيد أقرب عنصر جد (ancestor) متموضع (positioned) للعنصر المطابق. ‎.offsetParent()‎ أُضيف مع الإصدار: 1.2.6. ولا يقبل هذا الشكل أي وسائط. إن كان لدينا كائن jQuery يمثِّل مجموعة عناصر DOM، فسيسمح لنا التابع ‎.offsetParent()‎ بالبحث في العناصر الأجداد (ancestors) لهذه العناصر في شجرة DOM ثمَّ ينشئ كائن jQuery جديد ويضع فيه أقرب عنصر جد متموضع عثر عليه. يكون العنصر متموضعًا (positioned) إذا كانت قيمة الخاصِّيَّة position له هي إمَّا relative أو absolute ...

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

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎event.pageX القيمة المعادة تُعيد كائنًا من النوع Number. الوصف تُعيد هذه الخاصية موضع الفأرة بالنسبة إلى الحافة اليسرى للمستند. event.pageX أُضيف مع الإصدار: 1.0.4. أمثلة إظهار موضع الفأرة بالنسبة للحافة اليسرى والحافة العلوية للمستند (داخل iframe): <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.pageX مثال على الخاصية</title> <style> body { background-color: #eef; } div { padding: 20px; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <div id="log"></div> <script> $( document ).on( "mousemove", ...

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

jQuery.escapeSelector( selector )‎ القيم المعادة يعيد محدِّدًا (selector). الوصف يهرِّب هذا التابع مجموعةً من المحارف التي تشبه اسم محدِّد في CSS. jQuery.escapeSelector( selector )‎ أُضيف مع الإصدار: 3.0. selector سلسلة نصية تحتوي على اسم يماثل اسم محدِّد يراد تهريبه. هذا التابع مفيد جدًا في الحالات التي يحتوي فيها اسم صنف أو مُعرِّف (ID) على محارف لها معنًى خاص في CSS مثل المحرف . أو المحرف :. هذا التابع مشتق من التابع CSS.escape()‎ لمجموعة عمل CSS. الفارق الأساسي بينه وبين ‎$.escapeSelector()‎ ...

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

jQuery.post( url [, data ] [, success ] [, dataType ] )‎ القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف تجلب هذه الدالة بياناتٍ من الخادم باستعمال طلب HTTP عبر الطريقة POST. jQuery.post( url [, data ] [, success ] [, dataType ] )‎ أُضيف مع الإصدار: 1.0. url سلسلة نصية تحتوي على الرابط URL الذي سيُرسل الطلب إليه. data كائنٌ مجرَّد أو سلسلة نصية ترسل إلى الخادم مع الطلب. success دالةٌ من الشكل Function( Object data, String textStatus, jqXHR ...

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

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

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

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎event.pageY القيمة المعادة تُعيد كائنًا من النوع Number. الوصف تُعيد هذه الخاصية موضع الفأرة بالنسبة إلى الحافة العلوية للمستند. event.pageY أُضيف مع الإصدار: 1.0.4. أمثلة إظهار موضع الفأرة بالنسبة للحافة اليسرى والحافة العلوية للمستند (داخل iframe): <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.pageY مثال على المحدد</title> <style> body { background-color: #eef; } div { padding: 20px; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <div id="log"></div> <script> $( document ).on( "mousemove", function( event ...

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

‎.fadeIn( [duration ] [, complete ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يعرض هذا التابع العناصر المطابقة عن طريق تحويلها إلى الإعتام (opaque، أي لن تصبح شفافةً) تدريجيًا. ‎.fadeIn( [duration ] [, complete ] )‎ أُضيف مع الإصدار: 1.0. duration (القيمة الافتراضية: 400) مدة الحركة وهو من النوع عدد Number أو سلسلة نصية String. complete دالة على الشكل Function()‎، تُستدعى بمجرد اكتمال الحركة، وتُستدعى مرة واحدة لكل عنصر مطابق. ‎.fadeIn( options )‎ أُضيف مع الإصدار: 1.0. options ...

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

‎.insertBefore( target )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف. ‎.insertBefore( target )‎ أُضيف مع الإصدار: 1.0. target كائن قد يكون من النوع Selector أو htmlString أو Element أو Array أو jQuery، وهو يمثل محدد أو عنصر أو مصفوفة عناصر أو سلسلة HTML أو كائن jQuery؛ ستدرج مجموعة العناصر المطابقة قبل العنصر (العناصر) المحدد بواسطة هذا المعامل. يُنفذ التابع ‎.before()‎ والتابع ‎.insertBefore()‎ نفس المهمة. الاختلاف الرئيسي هو في بناء الجملة، على ...

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

deferred.pipe( [doneFilter ] [, failFilter ] )‎ أُهمِلَت مع الإصدار: 1.8. القيمة المعادة يُعيد كائنًا من النوع Promise. الوصف تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds. deferred.pipe ([doneFilter] [، failFilter])‎ أُضيف مع الإصدار: 1.6. doneFilter هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل Function()‎. failFilter هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل Function()‎. أُضيف مع الإصدار: 1.7. deferred.pipe ([doneFilter] [، failFilter] [، progressFilter])‎ doneFilter هو دالة اختيارية تُستدعى عند ...

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

jQuery.isArray( obj )‎ القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الوسيط الممرَّر إليه مصفوفةً أم لا. jQuery.isArray( obj )‎ أُضيف مع الإصدار: 1.3. obj الكائن المراد التحقُّق منه لمعرف إن كان مصفوفةً أم لا. يعيد التابع ‎$.isArray()‎ قيمةً منطقيَّةً تُحدِّد إن كان الكائن المعطى مصفوفةً وليس كائنًا شبيهًا بمصفوفةٍ مثل الكائن jQuery. أمثلة التحقُّق إن كان الوسيط المعطى مصفوفةً أم لا: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>jQuery.isArray مثالٌ عن استعمال التابع</title> <script ...

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

jQuery.get( url [, data ] [, success ] [, dataType ] )‎ القيم المعادة يعيد كائنًا من النوع jqXHR. الوصف يجلب هذا التابع بياناتٍ من الخادم باستعمال طلب HTTP عبر الطريقة GET. jQuery.get( url [, data ] [, success ] [, dataType ] )‎ أُضيفت مع الإصدار: 1.0. url سلسلة نصية تحتوي على الرابط URL الذي سيُرسل الطلب إليه. data كائنٌ مجرَّد أو سلسلة نصية ترسل إلى الخادم مع الطلب. success دالةٌ من الشكل Function( Object data, String textStatus, jqXHR ...

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

jQuery.Deferred( [beforeStart ] )‎ القيم المعادة تعيد كائنًا مؤجلًا من النوع Deferred. الوصف هذه الدالة هي دالةٌ منتجة (factory function) تعيد كائن أداةٍ قابل للتسلسل (chainable utility object) يمكن استعمال مجموعة من التوابع مع هذا الكائن لتسجيل عدَّة دوال رد نداءٍ في طوابير ردود النداء (callback queues)، واستدعاء هذه الطوابير فيما بعد، ونقل حالة النجاح (success state) أو الفشل (failure state) لأي دالة متزامنة (synchronous) أو غير متزامنة (asynchronous). jQuery.Deferred( [beforeStart ] )‎ أُضيف مع الإصدار: 1.5. beforeStart دالة من ...

المحدد ‎:focus‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

المحدد ‎:focus الوصف يحدد العنصر إذا كان مُركّزًا عليه حاليًا. jQuery( ":focus" )‎ أُضيف مع الإصدار: 1.6. كما هو الحال مع الأصناف الزائفة الأخرى (تلك التي تبدأ بنقطتين رأسيتين :)، فمن المستحسن أن تسبق ‎:focus باسم وسم أو مُحدِّد آخر؛ خلاف ذلك، يستخدم المحدد العالمي (*) كمحدد ضمني. وبعبارة أخرى ، فإن ‎$( ":focus" )‎ يعادل ‎$( "*:focus" )‎. بمعنى آخر، فإن ‎$( ":focus" )‎ المجرد يعادل ‎$( "*:focus" )‎.  إذا كنت تبحث عن العنصر المُركّز حاليًا ، فسيقوم ‎$( ...