نتائج البحث

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

jQuery/Topics

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

الدالة 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 دالة من ...

الدالة 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 دالة من ...

الكائن المؤجل (Deferred Object)

قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع jQuery.Deferred()‎‎‎. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة. يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن ...

خدمات jQuery

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

الوحدة util‎ في Node.js

صُمِّمَت الوحدة util بشكل أساسي لتلبية احتياجات واجهات Node.js البرمجيّة الداخليّة. هذا لا يمنَع كون الأدوات، التي توفرها الوحدة، مفُيدةً للتطبيقات ولمطوري الوحدات البرمجيّة. يمكنك استيراد الوحدة والبدء باستخدامها عبر تنفيذ: const util = require('util'); util.callbackify(original)‎ أُضيف في الإصدار: v8.2.0. original‎:‏ <Function> دالة async‎ غير متزامنة. القيم المُعادة: <Function> دالةً من نمط دوال رد النداء (callback function). يأخُذ التابِع الدالة async (أو دالة تُعيد كاِئنًا من النوع Promise) ويعيد دالةً تتبع نمط دالة رد النداء «الخطأ أولًا» (error-first callback)، مثل ...

الدالة wsgiref.util.is_hop_by_hop()‎‎ في بايثون

تعيد الدالة القيمة True إن كان اسم الترويسة المعطى هو HTTP/1.0 "Hop-by-Hop"‎ وبحسب ما هو معرّف في RFC 2616. البنية العامة wsgiref.util.is_hop_by_hop(header_name) ‎المعاملات header_name اسم الترويسة الذي ستتحقّق الدالة منه. القيمة المعادة تعيد الدالة قيمة منطقية بالاعتماد على نتيجة عملية التحقّق التي ستجريها على اسم الترويسة. مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.

الدالة wsgiref.util.application_uri()‎‎ في بايثون

هذه الدالة مشابهة للدالة request_uri()‎ باستثناء أنّ هذه الدالة تتجاهل المتغيّرين PATH_INFO و QUERY_STRING. وتكون النتيجة معرف URI الأساسي لكائن التطبيق الذي يُوجّه إليه الطلب. البنية العامة wsgiref.util.application_uri(environ) ‎المعاملات environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. ‎القيمة المعادة تعيد الدالة معرّف URI الكامل في الطلب. مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.

الدالة simple_server.demo_app()‎‎ في بايثون

هذه الدالة عبارة عن تطبيق WSGI بسيط ولكن كامل، ويعيد صفحة نصية تتضمّن الرسالة ‎"Hello world!"‎ وقائمة بأزواج مفتاح/قيمة الموجودة في المعامل environ. يمكن الاستفادة من هذه الدالة في التحقق من قدرة مخدّم WSGI (مثل wsgiref.simple_server) على العمل كتطبيق WSGI بطريقة سليمة. البنية العامة wsgiref.simple_server.demo_app(environ, start_response) المعاملات environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.

تعريف الإضافات محليًّا (Introduce Local Extensions)

المشكلة الحاجة إلى بعض التوابع (methods) غير الموجودة في الصنف المساعد (utility class)، ومن غير الممكن إضافتها إلى ذلك الصنف. الحل إنشاء صنفٍ (class) جديدٍ يحتوي التوابع اللازمة، وجعله كصنف تغليفٍ (wrapper) للصنف المساعد أو كصنفٍ فرعيٍّ (subclass) له. مثال قبل إعادة التصميم يعتمد صنف العميل ClientClass على الصنف المساعد Date ولكنّه بحاجة إلى بعض التوابع غير الموجودة فيه (كتابع الحصول على اليوم التالي مثلًا): الصنف العميل ClientClass الذي يعتمد على الصنف المساعد Date. بعد إعادة التصميم أصبح هنالك صنف ...

الدالة wsgiref.util.request_uri()‎‎ في بايثون

تعيد الدالة معرّف URI الكامل في الطلب، -يمكن أن تتضمّن النتيجة المعادة سلسلة الطلب النصية- باستخدام الخوارزمية الموجودة في قسم "URL Reconstruction" في PEP 3333. البنية العامة wsgiref.util.request_uri(environ, include_query=True) المعاملات environ ‎environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. include_query لن تُضمّن سلسلة الطلب النصية في معرّف URI الناتج إن أخذ هذا المعامل قيمة خاطئة. القيمة المعادة تعيد الدالة معرّف URI الكامل في الطلب مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference ...

التابع Headers.get_all()‎‎ في بايثون

يعيد التابع قائمة بجميع القيم المندرجة ضمن الترويسة المعطاة. البنية العامة get_all(name) ‎المعاملات ‎name اسم الترويسة التي سيعيد التابع قائمة القيم المندرجة ضمنها. القيمة المعادة تكون القيم في القائمة المعادة مرتّبة بنفس ترتيب ظهور الترويسات في قائمة الترويسات الأصلية، أو ترتيب إضافتها إلى نسخة الصنف، وقد تتضمن قيمًا مكرّرة. يؤدي حذف الحقول وإعادة إضافتها إلى إدراجها في نهاية القائمة. يعيد التابع قائمة فارغة إن لم يعثر على أي حقل يحمل الاسم المطلوب. مصادر قسم WSGI environment utilities في صفحة WSGI ...

الدالة wsgiref.util.guess_scheme()‎‎ في بايثون

تخمّن الدالة ما يجب أن تكون عليه قيمة wsgi.url_scheme، إمّا "http" أو "https"، وذلك بالتحقق من قيمة متغير البيئة HTTPS في القاموس المعطى. البنية العامة wsgiref.util.guess_scheme(environ) ‎المعاملات ‎environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. القيمة المعادة تعيد الدالة النتيجة على هيئة سلسلة نصية. تظهر فائدة هذه الدالة عند إنشاء بوابة لتغليف بروتوكول CGI أو بروتوكول شبيه به مثل FastCGI. وعادة ما تتضمّن المخدّمات التي تقدّم مثل هذه البروتوكولات متغير HTTPS يحمل القيمة "1" أو ...

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

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

الدالة simple_server.make_server()‎‎ في بايثون

تنشئ الدالة مخدّم WSGI يستمع إلى المضيف والمنفذ المعطيين، ويستقبل الاتصالات من التطبيق المعطى. تعيد الدالة نسخة من صنف المخدّم المعطى وستعالج الطلبات باستخدام صنف المعالجة المعطى. البنية العامة wsgiref.simple_server.make_server(host, port, app, server_class=WSGIServer, handler_class=WSGIRequestHandler) المعاملات host المضيف الذي ستستمع إليه الدالة. port المنفذ الذي ستستمع إليه الدالة. app يجب أن يكون كائن تطبيق WSGI كما هو معرّف في PEP 3333. server_class صنف المخدّم الذي ستعيد الدالة نسخة منه. handler_class صنف المعالجة الذي ستستخدمه الدالة في معالجة الطلبات. راجع وحدة wsgiref.handlers. ...

التابع 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.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.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.isNumeric()‎‎ في jQuery

jQuery.isNumeric( value )‎ القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه عددًا (Number) أم لا. jQuery.isNumeric( value )‎ أُضيف مع الإصدار: 1.7. value أي شيء، ويمثل القيمة المراد التحقُّق منها. يتحقَّق التابع ‎$.isNumeric()‎ إن كان الوسيط المُمرَّر إليه قيمةً عدديَّةً، إذ يعيد آنذاك القيمة true أو يعيد القيمة false إن لم يكن. بدءًا من الإصدار jQuery 3.0، يعيد التابع ‎$.isNumeric()‎ القيمة true إن كان نوع الوسيط الممرَّر إليه عددًا أو سلسلة نصية يمكن ...

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

jQuery.makeArray( obj )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يحوِّل هذا التابع كائنًا شبيهًا بمصفوفة إلى مصفوفة JavaScript حقيقية. jQuery.makeArray( obj )‎ أُضيف مع الإصدار: 1.4. obj الكائن المراد تحويله إلى مصفوفة فعليَّة. تعيد أغلب التوابع عمومًا، في jQuery و JavaScript كلاهما، كائنات شبيه بمصفوفة (array-like). فتعيد الدالة المنتجة ‎‎$()‎ مثلًا الكائن jQuery الذي يملك العديد من خاصِّيَّات المصفوفة (مثل الخاصِّيَّة length، والمعامل [] للوصول إلى المصفوفة ...إلخ.) إلا أنَّه ليس مصفوفة حقيقية تمامًا ويفتقد إلى بعض توابع المصفوفات المدمجة ...

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

يعرض هذا التابع أو يعدِّل طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يعرض هذا التابع طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ أُضيف مع الإصدار: 1.3. element عنصر DOM الذي سيُبحث عن طابور الانتظار المرتبط به. queueName سلسلة نصية تحتوي على اسم الطابور. القيمة الافتراضيَّة هي fx وهو اسم طابور التأثيرات القياسي. ملاحظة: هذا التابع ذو مستوًى منخفض، لذا يجب عليك استعمال ...

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

jQuery.type( obj )‎ القيم المعادة يعيد سلسلة نصية (String). الوصف يعيد هذا التابع نوع JavaScript الداخلي للكائن المُمرَّر إليه. jQuery.type( obj )‎ أُضيفت مع الإصدار: 1.4.3 obj أي شيء، ويمثل الكائن المُراد معرفة نوعه الداخلي في JavaScript. يستعمل هذا التابع عددًا من التقنيات لتحديد نوع الكائن الذي سنحصل عليه بدقة، إذ يُحدَّد نوع الكائن كما يلي: إن كان الكائن غير مُعرَّف أو ذي قيمة عدميَّة، فستعاد حينئذٍ القيمة "undefined" أو القيمة "null" وفقًا لذلك: jQuery.type( undefined ) === "undefined"‎ jQuery.type() ...

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

jQuery.grep( array, function [, invert ] )‎ القيم المعادة يعيد مصفوفةً من النوع Array. الوصف يبحث هذا التابع عن عناصر مصفوفة تتطابق مع الدالة المرشِّحة المعطاة ثمَّ يعيد هذه العناصر بطريقة لا تتأثر فيها المصفوفة الأصليَّة. jQuery.grep( array, function [, invert ] )‎ أُضيفت مع الإصدار: 1.0. array كائنٌ شبيهٌ بمصفوفة (array-like object) يراد البحث ضمنه. function دالةٌ من الشكل Function( Object elementOfArray, Number indexInArray )‎ تعالج كل عنصر من عناصر الوسيط array المعطى. الوسيط الأول الممرَّر إلى هذه الدالة ...

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

jQuery.now()‎ القيم المعادة يعيد عددًا (Number). الوصف يعيد هذا التابع عددًا يمثِّل الوقت الحالي. jQuery.now()‎ أُضيف مع الإصدار: 1.4. لا يقبل هذا التابع أية وسائط. التابع ‎$.now()‎ هو اختزالٌ للعدد المعاد عبر استعمال ‎(new Date).getTime()‎. مصادر صفحة التابع ()jQuery.now في توثيق jQuery الرسمي.

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

jQuery.parseHTML( data [, context ] [, keepScripts ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يفسِّر هذا التابع سلسلة نصية تحتوي على شيفرة HTML ثمَّ يعيد مصفوفة من عقد DOM. jQuery.parseHTML( data [, context ] [, keepScripts ] )‎ أُضيف مع الإصدار: 1.8. data سلسلة نصية تحوي شيفرة HTML التي يراد تفسيرها. context عنصرٌ يمثِّل السياق الذي سيُنشَأ فيه محتوى HTML المُفسَّر. القيمة الافتراضيَّة هي العنصر document. keepScripts قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إضافة السكربتات الموجودة في شيفرة HTML ...

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

jQuery.parseXML( data )‎ القيم المعادة يعيد كائن مستند من النوع XMLDocument. الوصف يفسِّر هذا التابع سلسلة نصية بصيغة XML إلى مستند XML. jQuery.parseXML( data )‎ أُضيف مع الإصدار: 1.5. data سلسلة نصية بصيغة XML يراد تفسيرها. يستعمل التابع jQuery.parseXML()‎ دالة التفسير الأساسيَّة التي يوفِّرها المتصفح لإنشاء مستند XML صالح. يمكن أن يُمرَّر هذا المستند إلى jQuery لإنشاء كائن jQuery اعتيادي الذي يمكن تعديله أو نقله. أمثلة إنشاء كائن jQuery باستعمال سلسلة XML نصية وجلب قيمة العقدة title: <!doctype html> <html lang="en"> <head> ...

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

jQuery.now()‎ القيم المعادة يعيد عددًا (Number). الوصف يعيد هذا التابع عددًا يمثِّل الوقت الحالي. jQuery.now()‎ أُضيف مع الإصدار: 1.4. لا يقبل هذا التابع أية وسائط. التابع ‎$.now()‎ هو اختزالٌ للعدد المعاد عبر استعمال ‎(new Date).getTime()‎. مصادر صفحة التابع ()jQuery.now في توثيق jQuery الرسمي.

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

jQuery.unique( array )‎ أهمل مع الإصدار: 3.0. القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.unique( array )‎ أُضيف مع الإصدار: 1.1.3. array مصفوفةٌ من عناصر DOM. بدءًا من الإصدار jQuery 3.0، أهمل هذا التابع وأصبح اسمًا بديلًا للتابع jQuery.uniqueSort()‎. استَعمِل رجاءً التابع الأخير عوضًا عن هذا التابع. يرتِّب التابع ‎$.unique()‎ مصفوفةً من ...

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

jQuery.isFunction( value )‎ أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه دالةَ ردِّ نداءٍ أم لا. jQuery.isFunction( value )‎ أُضيف مع الإصدار: 1.2. value أي شيء، ويمثل القيمة المراد التحقُّق منها. بدءًا من الإصدار jQuery 3.3، أصبح التابع jQuery.isFunction()‎ مهملًا. في أغلب الحالات، يمكن الاستعاضة عن استعمال هذا التابع عبر استخدام typeof x === "function"‎. ملاحظة: بدءًا من الإصدار jQuery 1.3، لا يُضمن أن تُكتشَف الدوال التي يوفِّرها المتصفح، ...

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

يعرض هذا التابع أو يعدِّل طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يعرض هذا التابع طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ أُضيف مع الإصدار: 1.3. element عنصر DOM الذي سيُبحث عن طابور الانتظار المرتبط به. queueName سلسلة نصية تحتوي على اسم الطابور. القيمة الافتراضيَّة هي fx وهو اسم طابور التأثيرات القياسي. ملاحظة: هذا التابع ذو مستوًى منخفض، لذا يجب عليك استعمال ...

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

jQuery.dequeue( element [, queueName ] )‎ القيم المعادة يعيد النوع undefined. الوصف ينفَّذ هذا التابع الدالة التالية الموجودة في طابور الانتظار للعناصر المتطابقة. jQuery.dequeue( element [, queueName ] )‎ أُضيف مع الإصدار: 1.3. element العنصر DOM الذي يراد إحضار الدالة من الطابور وتنفيذها معه. queueName سلسلة نصية تحتوي على اسم الطابور. القيمة الافتراضية هي fx. ملاحظة: هذا التابع ذو مستوًى منخفض، لذا يجب عليك استعمال التابع ‎.dequeue()‎ بدلًا من ذلك. عند استدعاء التابع jQuery‎.dequeue()‎، ستزال الدالة التالية من الطابور ثم ...

التابع 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.isPlainObject()‎‎ في jQuery

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

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

jQuery.map( array, callback )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يُمرِّر هذا التابع كلَّ عنصر من عناصر مصفوفة أو كائن إلى دالةٍ، ثمَّ ينشئ مصفوفةً جديدةً تحتوي على القيم المعادة. jQuery.map( array, callback )‎ أُضيف مع الإصدار: 1.0. array المصفوفة المراد تعديل جميع عناصرها. callback دالةٌ من الشكل Function( Object elementOfArray, Number indexInArray )‎ ستعالج كل عنصر من عناصر المصفوفة على حدة. الوسيط الأول الممرَّر إلى هذه الدالة هو عنصر المصفوفة الحالي، والوسيط الثاني هو فهرس هذا العنصر في المصفوفة. ...

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

jQuery.type( obj )‎ القيم المعادة يعيد سلسلة نصية (String). الوصف يعيد هذا التابع نوع JavaScript الداخلي للكائن المُمرَّر إليه. jQuery.type( obj )‎ أُضيفت مع الإصدار: 1.4.3 obj أي شيء، ويمثل الكائن المُراد معرفة نوعه الداخلي في JavaScript. يستعمل هذا التابع عددًا من التقنيات لتحديد نوع الكائن الذي سنحصل عليه بدقة، إذ يُحدَّد نوع الكائن كما يلي: إن كان الكائن غير مُعرَّف أو ذي قيمة عدميَّة، فستعاد حينئذٍ القيمة "undefined" أو القيمة "null" وفقًا لذلك: jQuery.type( undefined ) === "undefined"‎ jQuery.type() ...

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

jQuery.uniqueSort( array )‎ القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.uniqueSort( array )‎ أُضيفت مع الإصدار: 1.12/2.2. array مصفوفةٌ من عناصر DOM. يرتِّب التابع ‎$.uniqueSort()‎ مصفوفةً من الكائنات ويحذف أيَّة عقدٍ متكرِّرة. تُعدُّ العقدة متكرِّرة إن كان لها الاسم نفسه الذي تملكه عقدة أخرى موجودة قبلها في المصفوفة. أمَّا كان هنالك عقدتين ...

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

jQuery.isNumeric( value )‎ القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه عددًا (Number) أم لا. jQuery.isNumeric( value )‎ أُضيف مع الإصدار: 1.7. value أي شيء، ويمثل القيمة المراد التحقُّق منها. يتحقَّق التابع ‎$.isNumeric()‎ إن كان الوسيط المُمرَّر إليه قيمةً عدديَّةً، إذ يعيد آنذاك القيمة true أو يعيد القيمة false إن لم يكن. بدءًا من الإصدار jQuery 3.0، يعيد التابع ‎$.isNumeric()‎ القيمة true إن كان نوع الوسيط الممرَّر إليه عددًا أو سلسلة نصية يمكن ...

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

jQuery.map( array, callback )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يُمرِّر هذا التابع كلَّ عنصر من عناصر مصفوفة أو كائن إلى دالةٍ، ثمَّ ينشئ مصفوفةً جديدةً تحتوي على القيم المعادة. jQuery.map( array, callback )‎ أُضيف مع الإصدار: 1.0. array المصفوفة المراد تعديل جميع عناصرها. callback دالةٌ من الشكل Function( Object elementOfArray, Number indexInArray )‎ ستعالج كل عنصر من عناصر المصفوفة على حدة. الوسيط الأول الممرَّر إلى هذه الدالة هو عنصر المصفوفة الحالي، والوسيط الثاني هو فهرس هذا العنصر في المصفوفة. ...

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

jQuery.isEmptyObject( object )‎ القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الكائن المُمرَّر إليه فارغًا (لا يحوي أيَّة خاصِّيَّة قابلة للإحصاء) أم لا. jQuery.isEmptyObject( object )‎ أُضيف مع الإصدار: 1.4. objcet الكائن المراد التحقُّق منه لمعرفة إن كان فارغًا أم لا. بدءًا من الإصدار jQuery 1.4، أصبح هذا التابع يتحقَّق من خاصِّيَّات الكائن نفسه، والخاصِّيَّات الموروثة عبر سلسلة prototypes (لا يستخدم هنا hasOwnProperty). يجب أن يكون الوسيط المعطى كائن JavaScript مجرَّد (Object)، إذ قد لا تعطي ...

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

jQuery.isFunction( value )‎ أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه دالةَ ردِّ نداءٍ أم لا. jQuery.isFunction( value )‎ أُضيف مع الإصدار: 1.2. value أي شيء، ويمثل القيمة المراد التحقُّق منها. بدءًا من الإصدار jQuery 3.3، أصبح التابع jQuery.isFunction()‎ مهملًا. في أغلب الحالات، يمكن الاستعاضة عن استعمال هذا التابع عبر استخدام typeof x === "function"‎. ملاحظة: بدءًا من الإصدار jQuery 1.3، لا يُضمن أن تُكتشَف الدوال التي يوفِّرها المتصفح، ...

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

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

التابع ‎‎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.each()‎‎ في jQuery

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

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

jQuery.globalEval( code )‎ القيم المعادة يعيد أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة إعادة أي نوع). الوصف يُنفِّذ هذا التابع جزءًا من شيفرة JavaScript على الصعيد العام. jQuery.globalEval( code )‎ أُضيفت مع الإصدار: 1.0.4 code سلسلة نصية تحوي شيفرة JavaScript المراد تنفيذها. يسلك هذا التابع سلوكًا مختلفًا عن سلوك الدالة eval()‎ الطبيعي في JavaScript، إذ يُنفَّذ التابع ضمن السياق العام (هذا السلوك مهم لتحميل سكربتات خارجيَّة ديناميكيًّا). أمثلة تنفيذ سكربت في السياق العام (global context): function ...

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

jQuery.extend( target [, object1 ] [, objectN ] )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يدمج هذا التابع محتويات عنصرين أو أكثر مع بعضهما بعضًا ويضع الناتج في الكائن الأول. jQuery.extend( target [, object1 ] [, objectN ] )‎ أُضيف مع الإصدار: 1.0. target الكائن الذي سيضاف إليه خاصِّيَّات جديدة من الكائنات الأخرى إن مُرِّرت، أو سيوسِّع مجال أسماء jQuery (namespace)‎ إن لم يُمرَّر سواه. object1 كائن يحتوي على خاصِّيَّات إضافية يراد دمجها مع الكائن الأول target المعطى. ...

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

jQuery.isEmptyObject( object )‎ القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الكائن المُمرَّر إليه فارغًا (لا يحوي أيَّة خاصِّيَّة قابلة للإحصاء) أم لا. jQuery.isEmptyObject( object )‎ أُضيف مع الإصدار: 1.4. objcet الكائن المراد التحقُّق منه لمعرفة إن كان فارغًا أم لا. بدءًا من الإصدار jQuery 1.4، أصبح هذا التابع يتحقَّق من خاصِّيَّات الكائن نفسه، والخاصِّيَّات الموروثة عبر سلسلة prototypes (لا يستخدم هنا hasOwnProperty). يجب أن يكون الوسيط المعطى كائن JavaScript مجرَّد (Object)، إذ قد لا تعطي ...

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

jQuery.trim( str )‎ القيم المعادة يعيد سلسلة نصية (String). الوصف يزيل هذا التابع جميع المسافات البيضاء (whitespace) من بداية ونهاية السلسلة النصية المُمرَّرة إليه. jQuery.trim( str )‎ أُضيف مع الإصدار: 1.0. str السلسلة النصية المُراد إزالة المسافات البيضاء من بدايتها ونهايتها. يزيل التابع ‎$.trim()‎ جميع محارف الأسطر الجديدة، والمسافات الفارغة (تدخل المسافات غير المقطوعة [non-breaking spaces] من ضمنها)، ومسافات الجدولة (tabs) من بداية ونهاية السلسلة النصية المعطاة. لن تتأثر محارف المسافات البيضاء إن وقعت في منتصف السلسلة النصيَّة. أمثلة إزالة ...

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

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

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

jQuery.merge( first, second )‎ القيم المعادة تعيد مصفوفةً (Array). الوصف تدمج هذه الدالة محتوى مصفوفتين مع بعضهما بعضًا وتضع الناتج في المصفوفة الأولى. jQuery.merge( first, second )‎ أُضيفت مع الإصدار: 1.0. first الكائن الأول الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتوى الوسيط الثاني إليه. second الكائن الثاني الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتواه إلى الوسيط الأول. تدمج الدالة ‎$.merge()‎ جميع محتويات المصفوفتين الممرَّرتين إليه في مصفوفة واحدة مع الحفاظ على ترتيب محتواهما، إذ تضاف محتويات المصفوفة الثانية ...

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

jQuery.removeData( element [, name ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع جزءًا من البيانات المُخزَّنة مسبقًا والمرفقة بعنصر محدَّد. jQuery.removeData( element [, name ] )‎ أُضيفت مع الإصدار: 1.2.3. element عنصر DOM الذي يراد حذف البيانات المرفقة به. name سلسلة نصية تحتوي على اسم قطعة البيانات المراد حذفها. ملاحظة: هذا التابع منخفض المستوى، لذا يجب عليك استعمال ‎.removeData()‎ عوضًا عنه. يوفر التابع jQuery.removeData()‎ إمكانيَّة حذف القيم التي ضُبطَت مسبقًا باستعمال التابع jQuery.data()‎. إن مُرِّر ...

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

jQuery.isXMLDoc( node )‎ أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كانت عقدة DOM المُمرَّر إليه ضمن مستند XML (أو هل هو مستند XML) أم لا. jQuery.isXMLDoc( node )‎ أُضيف مع الإصدار: 1.1.4. node عقدة DOM التي يراد التحقُّق منها لمعرفة إن كانت ضمن مستند XML. أمثلة التحقُّق من عقدة DOM لمعرفة إن كانت ضمن مستند XML: jQuery.isXMLDoc( document ) // false jQuery.isXMLDoc( document.body ) // false مصادر صفحة التابع ()jQuery.isXMLDoc في توثيق jQuery ...

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

jQuery.fn.extend( object )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يدمج هذا التابع محتويات كائنٍ مع الكائن prototype في jQuery لتوفير نسخةٍ جديدةٍ من توابع jQuery. jQuery.fn.extend( object )‎ أُضيف مع الإصدار: 1.0. object الكائن المراد دمجه مع الكائن prototype في jQuery. يوسِّع التابع jQuery.fn.extend()‎ الكائن prototype في ‎($.fn) jQuery لتوفير توابع جديدة يمكن ربطها (chain) بالدالة jQuery()‎. أمثلة إضافة تابعان جديدان إلى الكائن prototype في ‎($.fn) jQuery ثمَّ استعمال أحدهما: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>jQuery.fn.extend ...

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

‎.clearQueue( [queueName ] )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.clearQueue()‎ في إزالة كافّة العناصر التي لم تُشغَّل حتى الآن من الطابور. ‎.clearQueue( [queueName ] )‎ أضيفت في الإصدار: 1.4. queueName سلسلة نصيّة، وتُمثِّل اسم الطابور. القيمة الافتراضيّة هي fx، وهو طابور التأثيرات المعياري. عندما يُستدعى التّابع ‎.clearQueue()‎، فستُزال من الطابور كافّة الدوال الموجودة فيه والتي لم تُنفَّذ بعد. عندما يُستخدَم هذا التّابع دون وسيط، فسيُزيل ‎.clearQueue()‎ الدوال المتبقيّة من fx وهو طابور التأثيرات المعياري. يُشابِه هذا التّابع بهذه ...

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

jQuery.merge( first, second )‎ القيم المعادة تعيد مصفوفةً (Array). الوصف تدمج هذه الدالة محتوى مصفوفتين مع بعضهما بعضًا وتضع الناتج في المصفوفة الأولى. jQuery.merge( first, second )‎ أُضيفت مع الإصدار: 1.0. first الكائن الأول الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتوى الوسيط الثاني إليه. second الكائن الثاني الشبيه بالمصفوفة المراد دمج محتواه، إذ سيضاف محتواه إلى الوسيط الأول. تدمج الدالة ‎$.merge()‎ جميع محتويات المصفوفتين الممرَّرتين إليه في مصفوفة واحدة مع الحفاظ على ترتيب محتواهما، إذ تضاف محتويات المصفوفة الثانية ...

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

jQuery.parseJSON( json )‎ أهمل مع الإصدار: 3.0. القيم المعادة يعيد مصفوفةً (Array) أو سلسلةً نصيةً (String) أو عددًا (Number) أو كائنًا (Object) أو قيمة منطقيَّة (Boolean). الوصف يفسِّر هذا التابع سلسلة نصية بصيغة JSON إلى قيمة مقابلة في JavaScript. jQuery.parseJSON( json )‎ أُضيف مع الإصدار: 1.4.1. json سلسلة نصية بصيغة JSON يراد تفسيرها. بدءًا من الإصدار jQuery 3.0، أهمل التابع ‎$.parseJSON()‎، لذا استعمل التابع JSON.parse()‎ الأساسي في JavaScript عوضًا عنه. سيُرمى استثناءٌ في JavaScript إذا لم تكن السلسلة النصية المعطاة ...

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

jQuery.dequeue( element [, queueName ] )‎ القيم المعادة يعيد النوع undefined. الوصف ينفَّذ هذا التابع الدالة التالية الموجودة في طابور الانتظار للعناصر المتطابقة. jQuery.dequeue( element [, queueName ] )‎ أُضيف مع الإصدار: 1.3. element العنصر DOM الذي يراد إحضار الدالة من الطابور وتنفيذها معه. queueName سلسلة نصية تحتوي على اسم الطابور. القيمة الافتراضية هي fx. ملاحظة: هذا التابع ذو مستوًى منخفض، لذا يجب عليك استعمال التابع ‎.dequeue()‎ بدلًا من ذلك. عند استدعاء التابع jQuery‎.dequeue()‎، ستزال الدالة التالية من الطابور ثم ...

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

jQuery.parseHTML( data [, context ] [, keepScripts ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يفسِّر هذا التابع سلسلة نصية تحتوي على شيفرة HTML ثمَّ يعيد مصفوفة من عقد DOM. jQuery.parseHTML( data [, context ] [, keepScripts ] )‎ أُضيف مع الإصدار: 1.8. data سلسلة نصية تحوي شيفرة HTML التي يراد تفسيرها. context عنصرٌ يمثِّل السياق الذي سيُنشَأ فيه محتوى HTML المُفسَّر. القيمة الافتراضيَّة هي العنصر document. keepScripts قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إضافة السكربتات الموجودة في شيفرة HTML ...

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

jQuery.isWindow( obj )‎ أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الوسيط الممرَّر إليه هو الكائن window أم لا. jQuery.isWindow( obj )‎ أُضيف مع الإصدار: 1.4. obj الكائن المراد التحقُّق منه. يستعمل هذا التابع في مواضع عدَّة في jQuery لتحديد إن كانت العملية تنفَّذ مع الكائن window للمتصفح (مثل النافذ الحاليَّة أو الإطار iframe). أمثلة التحقُّق من الوسيط المعطى إن كان هو الكائن window أم لا: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> ...

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

jQuery.unique( array )‎ أهمل مع الإصدار: 3.0. القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.unique( array )‎ أُضيف مع الإصدار: 1.1.3. array مصفوفةٌ من عناصر DOM. بدءًا من الإصدار jQuery 3.0، أهمل هذا التابع وأصبح اسمًا بديلًا للتابع jQuery.uniqueSort()‎. استَعمِل رجاءً التابع الأخير عوضًا عن هذا التابع. يرتِّب التابع ‎$.unique()‎ مصفوفةً من ...

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

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

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

jQuery.extend( target [, object1 ] [, objectN ] )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يدمج هذا التابع محتويات عنصرين أو أكثر مع بعضهما بعضًا ويضع الناتج في الكائن الأول. jQuery.extend( target [, object1 ] [, objectN ] )‎ أُضيف مع الإصدار: 1.0. target الكائن الذي سيضاف إليه خاصِّيَّات جديدة من الكائنات الأخرى إن مُرِّرت، أو سيوسِّع مجال أسماء jQuery (namespace)‎ إن لم يُمرَّر سواه. object1 كائن يحتوي على خاصِّيَّات إضافية يراد دمجها مع الكائن الأول target المعطى. ...

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

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

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

jQuery.trim( str )‎ القيم المعادة يعيد سلسلة نصية (String). الوصف يزيل هذا التابع جميع المسافات البيضاء (whitespace) من بداية ونهاية السلسلة النصية المُمرَّرة إليه. jQuery.trim( str )‎ أُضيف مع الإصدار: 1.0. str السلسلة النصية المُراد إزالة المسافات البيضاء من بدايتها ونهايتها. يزيل التابع ‎$.trim()‎ جميع محارف الأسطر الجديدة، والمسافات الفارغة (تدخل المسافات غير المقطوعة [non-breaking spaces] من ضمنها)، ومسافات الجدولة (tabs) من بداية ونهاية السلسلة النصية المعطاة. لن تتأثر محارف المسافات البيضاء إن وقعت في منتصف السلسلة النصيَّة. أمثلة إزالة ...

التابع ‎‎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.inArray()‎‎ في jQuery

jQuery.inArray( value, array [, fromIndex ] )‎ القيم المعادة يعيد عددًا (Number). الوصف يبحث هذا التابع عن قيمة محدَّدة ضمن مصفوفةٍ ثمَّ يعيد قيمة فهرس موضعها (أو القيمة ‎-1 إن لم يجدها). jQuery.inArray( value, array [, fromIndex ] )‎ أُضيف مع الإصدار: 1.2. value أي شيء، ويمثل القيمة المراد البحث عنها. array المصفوفة المراد البحث ضمن عناصرها. fromIndex عددٌ (Number) يمثل قيمة فهرس أحد عناصر المصفوفة الذي يراد بدء عملية البحث عنده. القيمة الافتراضيَّة هي 0 أي البحث ضمن جميع ...

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

jQuery.globalEval( code )‎ القيم المعادة يعيد أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة إعادة أي نوع). الوصف يُنفِّذ هذا التابع جزءًا من شيفرة JavaScript على الصعيد العام. jQuery.globalEval( code )‎ أُضيفت مع الإصدار: 1.0.4 code سلسلة نصية تحوي شيفرة JavaScript المراد تنفيذها. يسلك هذا التابع سلوكًا مختلفًا عن سلوك الدالة eval()‎ الطبيعي في JavaScript، إذ يُنفَّذ التابع ضمن السياق العام (هذا السلوك مهم لتحميل سكربتات خارجيَّة ديناميكيًّا). أمثلة تنفيذ سكربت في السياق العام (global context): function ...

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

jQuery.isWindow( obj )‎ أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان الوسيط الممرَّر إليه هو الكائن window أم لا. jQuery.isWindow( obj )‎ أُضيف مع الإصدار: 1.4. obj الكائن المراد التحقُّق منه. يستعمل هذا التابع في مواضع عدَّة في jQuery لتحديد إن كانت العملية تنفَّذ مع الكائن window للمتصفح (مثل النافذ الحاليَّة أو الإطار iframe). أمثلة التحقُّق من الوسيط المعطى إن كان هو الكائن window أم لا: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> ...

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

jQuery.inArray( value, array [, fromIndex ] )‎ القيم المعادة يعيد عددًا (Number). الوصف يبحث هذا التابع عن قيمة محدَّدة ضمن مصفوفةٍ ثمَّ يعيد قيمة فهرس موضعها (أو القيمة ‎-1 إن لم يجدها). jQuery.inArray( value, array [, fromIndex ] )‎ أُضيف مع الإصدار: 1.2. value أي شيء، ويمثل القيمة المراد البحث عنها. array المصفوفة المراد البحث ضمن عناصرها. fromIndex عددٌ (Number) يمثل قيمة فهرس أحد عناصر المصفوفة الذي يراد بدء عملية البحث عنده. القيمة الافتراضيَّة هي 0 أي البحث ضمن جميع ...

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

jQuery.uniqueSort( array )‎ القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.uniqueSort( array )‎ أُضيفت مع الإصدار: 1.12/2.2. array مصفوفةٌ من عناصر DOM. يرتِّب التابع ‎$.uniqueSort()‎ مصفوفةً من الكائنات ويحذف أيَّة عقدٍ متكرِّرة. تُعدُّ العقدة متكرِّرة إن كان لها الاسم نفسه الذي تملكه عقدة أخرى موجودة قبلها في المصفوفة. أمَّا كان هنالك عقدتين ...

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

jQuery.makeArray( obj )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يحوِّل هذا التابع كائنًا شبيهًا بمصفوفة إلى مصفوفة JavaScript حقيقية. jQuery.makeArray( obj )‎ أُضيف مع الإصدار: 1.4. obj الكائن المراد تحويله إلى مصفوفة فعليَّة. تعيد أغلب التوابع عمومًا، في jQuery و JavaScript كلاهما، كائنات شبيه بمصفوفة (array-like). فتعيد الدالة المنتجة ‎‎$()‎ مثلًا الكائن jQuery الذي يملك العديد من خاصِّيَّات المصفوفة (مثل الخاصِّيَّة length، والمعامل [] للوصول إلى المصفوفة ...إلخ.) إلا أنَّه ليس مصفوفة حقيقية تمامًا ويفتقد إلى بعض توابع المصفوفات المدمجة ...

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

jQuery.parseXML( data )‎ القيم المعادة يعيد كائن مستند من النوع XMLDocument. الوصف يفسِّر هذا التابع سلسلة نصية بصيغة XML إلى مستند XML. jQuery.parseXML( data )‎ أُضيف مع الإصدار: 1.5. data سلسلة نصية بصيغة XML يراد تفسيرها. يستعمل التابع jQuery.parseXML()‎ دالة التفسير الأساسيَّة التي يوفِّرها المتصفح لإنشاء مستند XML صالح. يمكن أن يُمرَّر هذا المستند إلى jQuery لإنشاء كائن jQuery اعتيادي الذي يمكن تعديله أو نقله. أمثلة إنشاء كائن jQuery باستعمال سلسلة XML نصية وجلب قيمة العقدة title: <!doctype html> <html lang="en"> <head> ...

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

jQuery.isXMLDoc( node )‎ أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كانت عقدة DOM المُمرَّر إليه ضمن مستند XML (أو هل هو مستند XML) أم لا. jQuery.isXMLDoc( node )‎ أُضيف مع الإصدار: 1.1.4. node عقدة DOM التي يراد التحقُّق منها لمعرفة إن كانت ضمن مستند XML. أمثلة التحقُّق من عقدة DOM لمعرفة إن كانت ضمن مستند XML: jQuery.isXMLDoc( document ) // false jQuery.isXMLDoc( document.body ) // false مصادر صفحة التابع ()jQuery.isXMLDoc في توثيق jQuery ...

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

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

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

jQuery.parseJSON( json )‎ أهمل مع الإصدار: 3.0. القيم المعادة يعيد مصفوفةً (Array) أو سلسلةً نصيةً (String) أو عددًا (Number) أو كائنًا (Object) أو قيمة منطقيَّة (Boolean). الوصف يفسِّر هذا التابع سلسلة نصية بصيغة JSON إلى قيمة مقابلة في JavaScript. jQuery.parseJSON( json )‎ أُضيف مع الإصدار: 1.4.1. json سلسلة نصية بصيغة JSON يراد تفسيرها. بدءًا من الإصدار jQuery 3.0، أهمل التابع ‎$.parseJSON()‎، لذا استعمل التابع JSON.parse()‎ الأساسي في JavaScript عوضًا عنه. سيُرمى استثناءٌ في JavaScript إذا لم تكن السلسلة النصية المعطاة ...

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

jQuery.grep( array, function [, invert ] )‎ القيم المعادة يعيد مصفوفةً من النوع Array. الوصف يبحث هذا التابع عن عناصر مصفوفة تتطابق مع الدالة المرشِّحة المعطاة ثمَّ يعيد هذه العناصر بطريقة لا تتأثر فيها المصفوفة الأصليَّة. jQuery.grep( array, function [, invert ] )‎ أُضيفت مع الإصدار: 1.0. array كائنٌ شبيهٌ بمصفوفة (array-like object) يراد البحث ضمنه. function دالةٌ من الشكل Function( Object elementOfArray, Number indexInArray )‎ تعالج كل عنصر من عناصر الوسيط array المعطى. الوسيط الأول الممرَّر إلى هذه الدالة ...

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

jQuery.removeData( element [, name ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع جزءًا من البيانات المُخزَّنة مسبقًا والمرفقة بعنصر محدَّد. jQuery.removeData( element [, name ] )‎ أُضيفت مع الإصدار: 1.2.3. element عنصر DOM الذي يراد حذف البيانات المرفقة به. name سلسلة نصية تحتوي على اسم قطعة البيانات المراد حذفها. ملاحظة: هذا التابع منخفض المستوى، لذا يجب عليك استعمال ‎.removeData()‎ عوضًا عنه. يوفر التابع jQuery.removeData()‎ إمكانيَّة حذف القيم التي ضُبطَت مسبقًا باستعمال التابع jQuery.data()‎. إن مُرِّر ...

الصنف wsgiref.util.FileWrapper()‎‎ في بايثون

صنف تغليف wrapper تحوّل كائنًا شبيهًا بالملف file-like object إلى مكرّر. تدعم الكائنات الناتجة التكرار استخدام التابعين ‎__getitem__()‎ و ‎__iter__()‎ وذلك للتوافق مع الإصدار 2.1 من بايثون ومع Jython. البنية العامة wsgiref.util.FileWrapper(filelike, blksize=8192) المعاملات ‎blksize المعامل الاختياري يُمُرّر بصورة متكررة في كلّ مرة يجري فيها المرور على الكائن، إلى التابع read()‎ في الكائن الشبيه بالملف المعطى وذلك للحصول على سلاسل بايتات نصية. إذا أعاد التابع read()‎ سلسلة بايتات نصية فارغة، تتوقّف عملية التعاود تمامًا. إن كان الكائن الشبيه بالملفات المعطى ...

الصنف wsgiref.util.FileWrapper()‎‎ في بايثون

صنف تغليف wrapper تحوّل كائنًا شبيهًا بالملف file-like object إلى مكرّر. تدعم الكائنات الناتجة التكرار استخدام التابعين ‎__getitem__()‎ و ‎__iter__()‎ وذلك للتوافق مع الإصدار 2.1 من بايثون ومع Jython. البنية العامة wsgiref.util.FileWrapper(filelike, blksize=8192) المعاملات ‎blksize المعامل الاختياري يُمُرّر بصورة متكررة في كلّ مرة يجري فيها المرور على الكائن، إلى التابع read()‎ في الكائن الشبيه بالملف المعطى وذلك للحصول على سلاسل بايتات نصية. إذا أعاد التابع read()‎ سلسلة بايتات نصية فارغة، تتوقّف عملية التعاود تمامًا. إن كان الكائن الشبيه بالملفات المعطى ...

الدالة Header.add_header()‎‎ في بايثون

يضيف التابع ترويسة (يمكن أن تكون متعددة القيم) مع معاملات MIME اختيارية تُحدّد بواسطة المعاملات المفتاحية. البنية العامة add_header(name, value, **_params) المعاملات ‎name حقل الترويسة المراد إضافته. value القيمة المرتبطة بالحقل المضاف. ‎**_params يمكن استخدام المعاملات المفتاحية لتعيين معاملات MIME لحقل الترويسة. يجب أن يكون كل معامل سلسلة نصية أو يحمل القيمة None، ويجري تحويل جميع الشرطات السفلية underscores إلى خطوط فاصلة dashes وذلك لأنّ بايثون لا تسمح باستخدام الخطوط الفاصلة في المعرّفات، ولكن الكثير من معاملات MIME يتضمّن خطوطًا ...

الوحدة wsgiref.util()‎‎ في بايثون

تقدّم هذه الوحدة مجموعة متنوعة من الدوال التي تساعد في التعامل مع بيئات WSGI. بيئة WSGI هي قاموس يتضمّن متغيرات طلب HTTP وبحسب ما هو موصوف في PEP 3333.  تأخذ جميع الدوال المعامل environ وهو عبارة عن قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. دوال الوحدة wsgiref.util الدالة wsgiref.util.guess_scheme()‎ تخمّن الدالة ما يجب أن تكون عليه قيمة wsgi.url_scheme وذلك بالتحقق من قيمة متغير البيئة HTTPS في القاموس المعطى. الدالة wsgiref.util.request_uri()‎ تعيد الدالة معرّف URI الكامل في الطلب باستخدام ...

الدالة wsgiref.util.setup_testing_defaults()‎‎ في بايثون

تحدّث الدالة البيئة المعطاة بإضافة قيم افتراضية لغرض التجربة. تضيف هذه الدالة عددًا من المعاملات المطلوبة في WSGI وهي HTTP_POST و SERVER_NAME و SERVER_PORT و REQUEST_METHOD و SCRIPT_NAME و PATH_INFO وجميع المتغيرات wsgi.*‎ المعرّفة في PEP 3333. تقدّم الدالة القيم الافتراضية فقط، ولا تستبدل أي إعدادات مسبقة لهذه المتغيرات. إن الهدف من هذه الدالة هو تسهيل إجراء اختبارات الوحدات unit tests لمخدّمات وتطبيقات WSGI وذلك لتهيئة بيئات مؤقتة dummy environments؛ لهذا لا يجوز أن تستخدم من قبل مخدّمات وتطبيقات WSGI ...

تعريف التوابع الدخيلة (Introduce Foreign Methods)

المشكلة الحاجة إلى تابعٍ غير موجودٍ في الصنف المساعد (utility class) ومن غير الممكن إضافته إلى ذلك الصنف. الحل إضافة التابع المطلوب إلى صنف العميل (client class) وتمرير كائنٍ (object) من الصنف المساعد إليه كوسيط (argument). مثال قبل إعادة التصميم يحتوي الصنف Report تابعًا باسم sendReport والذي يستخدم الصنف المساعد Date لإنشاء تاريخ اليوم التالي عبر إضافة القيمة 1 إلى اليوم الحالي، كما يلي: في لغة Java: class Report { //... void sendReport() { Date ...

الدالة wsgiref.util.shift_path_info()‎‎ في بايثون

تنقل الدالة اسمًا منفردًا من PATH_INFO إلى SCRIPT_NAME وتعيد الاسم المنقول. يُعدّل القاموس المعطى في مكانه in-place، ويمكنك استخدام نسخة من القاموس إن كنت بحاجة إلى المحافظة على قيمة PATH_INFO أو SCRIPT_NAME الأصلية دون تعديل. تستخدم هذه الدالة عادة لمعالجة كل جزء من أجزاء مسار URI في الطلب، كأن تجري معالجة المسار كسلسلة من مفاتيح القاموس. تعدّل هذه الدالة البيئة الممرة لجعلها ملائمة للتنفيذ من قبل تطبيق WSGI آخر والموجود في معرّف URI الهدف. فعلى سبيل المثال لو كان هناك ...

الدالة validate.validator()‎‎ في بايثون

تغلّف هذه الدالة التطبيق المعطى وتعيد كائن تطبيق WSGI جديد، وسيوجّه التطبيق المعاد جميع الطلبات إلى التطبيق الأصلي، وسيتحقّق من أنّ كلًّا من التطبيق والمخدّم الذي يستدعيه متوافقان مع معايير WSGI وللبروتوكول RFC 2616. يؤدي وجود أيّ حالة من حالات عدم التوافق إلى إطلاق الخطأ AssertionError، ولكن يجب الانتباه إلى أنّ طريقة التعامل مع هذه الأخطاء تعتمد على المخدّم، فعلى سبيل المثال يعطي المخدّم wsgiref.simple_server و المخدّمات المستندة على أصناف الوحدة wsgiref.handlers (والتي لا تعيد تعريف توابع التعامل مع الأخطاء ...

الوحدة wsgiref.handlers‎‎ في بايثون

تقدّم هذه الوحدة أصناف معالجة أساسية لاستخدام مخدّمات وبوابات WSGI. تعالج هذه الأصناف الجزء الأكبر من عملية التواصل مع تطبيق WSGI ما دامت في بيئة مشابهة لبيئة CGI وإلى جانب تدفّقات المدخلات والمخرجات والأخطاء. الصنف wsgiref.handlers.CGIHandler يمكن الاستفادة من هذا الصنف عند الحاجة إلى تشغيل تطبيق WSGI كشيفرة CGI، حيث يمكن ببساطة تنفيذ التعبير CGIHandler().run(app)‎، إذ يمثل المعامل app كائن تطبيق WSGI الذي ترغب في تنفيذه. الصنف wsgiref.handlers.IISCGIHandler هذا الصنف هو بديل خاص للصنف CGIHandler، ويستخدم لنشر التطبيقات على مخدّم ...

الوحدة wsgiref.headers()‎‎ في بايثون

تقدّم هذه الوحدة الصنف Headers والذي يُستخدم لمعالجة ترويسات الاستجابة response headers في WSGI وذلك باستخدام طريقة مشابهة للقواميس. الصنف wsgiref.headers.Headers تنشئ الدالة البانية لهذا الصنف كائنًا شبيهًا بالقواميس يغلّف الترويسة المعطاة، ويجب أن تكون الترويسة على هيئة قائمة من صفوف (الاسم/القيمة) كما هو موصوف في PEP 3333. مصادر قسم WSGI response header tools في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.

الأصناف المجهولة في PHP

أُضيف دعم الأصناف المجهولة إلى الإصدار السابع من PHP، وهي مفيدة عند الحاجة إلى إنشاء نسخة واحدة بسيطة من الصنف. <?php // قبل الإصدار السابع class Logger { public function log($msg) { echo $msg; } } $util->setLogger(new Logger()); // الإصدار السابع وما بعده $util->setLogger(new class { public function log($msg) { echo $msg; } }); ?> يمكن للأصناف ...

الأصناف المجهولة في PHP

أُضيف دعم الأصناف المجهولة إلى الإصدار السابع من PHP، وهي مفيدة عند الحاجة إلى إنشاء نسخة واحدة بسيطة من الصنف. <?php // قبل الإصدار السابع class Logger { public function log($msg) { echo $msg; } } $util->setLogger(new Logger()); // الإصدار السابع وما بعده $util->setLogger(new class { public function log($msg) { echo $msg; } }); ?> يمكن للأصناف ...

المكتبة Active Support في ريلز

يعدُّ Active Support مجموعة من أصناف الأدوات (utility classes) وملحقات المكتبة القياسية التي وجد أنها مفيدة للاستعمال مع ريلز. توجد هذه الإضافات في هذه الحزمة، لذا يمكن تحميلها عند الحاجة في مشاريع روبي أي خارج إطار ريلز. يمكنك قراءة المزيد حول الملحقات في دليل ملحقات Active Support الأساسية. التنزيل والتثبيت يمكنك تثبيت أحدث إصدار من Active Support مع RubyGems: $ gem install activesupport ويمكنك أيضًا تنزيل الشيفرة المصدرية كجزء من مشروع ريلز في GitHub. مصادر صفحة Active Suppot من مشروع ريلز ...

التابع types.coroutine()‎ في بايثون

تحوّل هذه الدالة دالة مولّدة إلى دالة coroutine تعيد coroutine مبنيًا على مولّد. يكون هذا الـ coroutine هو كائن تكرار مولِّد، ويعدّ كذلك كائن coroutine ومن نوع awaitable. ولكن ليس بالضرورة أن يستخدم التابع ‎__await__()‎. ملاحظة: هذه الدالة جديدة في الإصدار 3.5 من بايثون. البنية العامة ‎types.coroutine(gen_func) المعاملات gen_func إن كانت دالة مولدة، فسيجري تعديلها في مكانها. وإن لم تكن دالة مولدة، فسيجري تغليفها. إن كانت الدالة تعيد نسخة من collections.abc.Generator، فإنّ النسخة ستُغلّف في كائن وسيط من نوع awaitable. ...

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()‎ يتعلَّق هذا التابع ...

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

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

الأحداث في jQuery

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

نقل الميزات ما بين الكائنات (Moving Features between Objects)

تساعد عملية إعادة التصميم (refactoring) في توزيع المهام بشكل مثاليّ على الأصناف (classes) المختلفة في الشيفرة، وتضمن تقنيات الحل هذه طريقةً آمنةً لنقل المهام (functionality) ما بين الأصناف، وإنشاء أصناف جديدة وحماية تفاصيل عملية التنفيذ (implementation) من الوصول العام (public access)، وهذه التقنيات تشمل: نقل التابع (Move Method) المشكلة: استخدام التابع (method) في صنفٍ (class) ما أكثر من استخدامه في صنفه الأساسيّ. الحل: إنشاء تابعٍ جديدٍ في الصنف الأكثر استخدامًا لذلك التابع ونقل شيفرته إلى التابع الجديد، ثم تحويل الشيفرة ...

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