نتائج البحث

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

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

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

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

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

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

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

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

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

Python/pathlib/Path/resolve

التابع Path.resolve يجعل المسار مسارًا مطلقًا، حيث يقوم بإزالة جميع الاختصارات (symlinks)، ويقوم بإعادة كائن مسار جديد. >>> p = Path() >>> p PosixPath('.') >>> p.resolve() PosixPath('/home/antoine/pathlib') يُزيل هذا التابع الأجزاء ".." وهو التابع الوحيد الذي يقوم بذلك. >>> p = Path('docs/../setup.py') >>> p.resolve() PosixPath('/home/antoine/pathlib/setup.py') يتم رمي الاستثناء FileNotFoundError إن كان المسار يشير إلى ملف غير موجود، في حال كانت قيمة الوسيط strict هي True. إن كانت قيمة الوسيط strict هي False فإن التابع يحلل المسار إلى أبعد نقطة ممكنة ويتم إلحاق أي بواقٍ دون التأكد من وجود ...

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

deferred.always( alwaysCallbacks [, alwaysCallbacks ] )‎ القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع دوال معالجة تُستدعَى عند قبول الكائن المؤجل Deferred أو رفضه. deferred.always( alwaysCallbacks [, alwaysCallbacks ] )‎ أُضيف مع الإصدار: 1.6. alwaysCallbacks هو دالة أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function()‎‎. alwaysCallbacks هو دالة إضافية إختيارية أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function()‎‎. يمكن أن يكون ...

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

deferred.always( alwaysCallbacks [, alwaysCallbacks ] )‎ القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع دوال معالجة تُستدعَى عند قبول الكائن المؤجل Deferred أو رفضه. deferred.always( alwaysCallbacks [, alwaysCallbacks ] )‎ أُضيف مع الإصدار: 1.6. alwaysCallbacks هو دالة أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function()‎‎. alwaysCallbacks هو دالة إضافية إختيارية أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function()‎‎. يمكن أن يكون ...

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

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

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

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

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

التابع ‎‎.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 أو يُطلِق هذا الحدث ...

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

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

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

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

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

jQuery.when( deferreds )‎ القيم المعادة يعيد كائنًا من النوع Promise. الوصف يوفِّر هذا التابع طريقةً لتنفيذ دوال ردود النداء بناءً على حالة الكائنات Thenable الممرَّرة إليها (من الممكن أن لا يمرَّر أيُّ كائن أيضًا)، ويمرَّر عادةً كائنات من النوع Deferred عوضًا عنها التي تمثل أحداثًا غير متزامنة. jQuery.when( deferreds )‎ أُضيف مع الإصدار: 1.5. deferreds كائنً من النوع Deferred أو Promise أو Thenable. إن لم تعطَ قيمة الوسيط deferreds، فسيعيد التابع jQuery.when()‎ الكائن Promise بحالة "مقبول". إن مُرِّر كائن واحد ...

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

jQuery.when( deferreds )‎ القيم المعادة يعيد كائنًا من النوع Promise. الوصف يوفِّر هذا التابع طريقةً لتنفيذ دوال ردود النداء بناءً على حالة الكائنات Thenable الممرَّرة إليها (من الممكن أن لا يمرَّر أيُّ كائن أيضًا)، ويمرَّر عادةً كائنات من النوع Deferred عوضًا عنها التي تمثل أحداثًا غير متزامنة. jQuery.when( deferreds )‎ أُضيف مع الإصدار: 1.5. deferreds كائنً من النوع Deferred أو Promise أو Thenable. إن لم تعطَ قيمة الوسيط deferreds، فسيعيد التابع jQuery.when()‎ الكائن Promise بحالة "مقبول". إن مُرِّر كائن واحد ...

التابع ‎‎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 ...

التابع ‎‎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 دون ...

التابع ‎‎$.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 )‎ يراد ...

التابع ‎.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()‎‎‎. عند قبول الكائن ...

الخاصية ‎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 ...

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

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

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

after( content [, content ] )‎. القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.after()‎ لإدخال المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. ‎.after( content [, content ] )‎ أضيفت في الإصدار: 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة html، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة. ...

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

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

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

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

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

event.isImmediatePropagationStopped()‎ القيمة المعادة تُعيد كائنًا من النوع Boolean. الوصف تتحقق هذه الخاصية من استدعاء الحدث event.stopImmediatePropagation()‎‎ على كائن الحدث هذا. event.isImmediatePropagationStopped()‎ أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. أُضيفت هذه الخاصية في المستوى الثالث من DOM. أمثلة التحقق من استدعاء event.stopImmediatePropagation()‎‎. <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.isImmediatePropagationStopped مثال على الخاصية</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>أنقر هنا</button> <div id="stop-log"></div> <script> function immediatePropStopped( event ) { var msg = ""; if ( event.isImmediatePropagationStopped() ) { ...

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

المحدد ‎:contains()‎ الوصف يُستخدَم المُحدِّد ‎:contains()‎ لتحديد كافّة العناصر التي تحتوي على النص المطلوب. ‎jQuery( ":contains(text)" )‎ أضيفت في الإصدار: 1.1.4. text سلسلة نصيّة String، وتُمثِّل النص المطلوب البحث عنه. وهي حسّاسة لحالة الأحرف. يُمكِن للنص المُطابِق أن يظهر مباشرةً بداخل العنصر المُحدَّد، أو في أي من العناصر المُنحدِرة عنه، أو مزيج من ذلك. وكما هو الحال مع مُحدِّدات قيم خاصيّات HTML، يُمكِن للنص الموجود بين قوسي التّابع ‎:contains()‎ أن يُكتَب على هيئة كلمة مُجرَّدة أو مُحاطًا بعلامتي اقتباس. يجب ...

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

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

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

إعادة القيمة الحالية للعنصر الأول في مجموعة العناصر المُطابقة أو تعيين قيمة (value) كل عنصر مُطابق. ‎.val()‎ القيمة المعادة يُعيد كائنًا من النوع String أو Number أو Array. الوصف إعادة القيمة الحالية للعنصر الأول في مجموعة العناصر المُطابقة. ‎.val()‎ أُضيف مع الإصدار: 1.0. لا يقبل هذا الشكل أي وسائط. يستخدم التابع ‎.val()‎ في المقام الأول للحصول على قيم عناصر النماذج مثل <input> و <select> و <textarea>. عند استدعائها على مجموعة فارغة، فإنها تُعيد undefined. عندما يكون العنصر الأول في المجموعة ...

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

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

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

‎.position()‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع الإحداثيات الحالية للعنصر الأول في المجموعة المطابقة نسبةً إلى أقرب عنصر أب متموضع (offset parent) لذلك العنصر. ‎.position()‎ أضيف مع الإصدار 1.2. لا يقبل هذا التابع أية وسائط. يجلب التابع ‎.position()‎ الإحداثيات الحالية لعنصرٍ (لإطار حوافه الخارجية [margin box] تحديدًا) نسبةً إلى أقرب عنصر أب له (إطار حواشيه [padding box] تحديدًا، أي باستثناء الهوامش والإطار). يختلف هذا التابع عن التابع ‎.offset()‎ الذي يعيد الإحداثيات الحالية للعنصر نسبةً إلى ...

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

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

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

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎event.namespace القيمة المعادة تُعيد كائنًا من النوع String. الوصف تعيد هذه الخاصية مجال الأسماء (namespace) المستخدم عند إطلاق الحدث. event.namespace أُضيف مع الإصدار: 1.4.3. من المرجح أن تُستعمَل هذه الخاصية بشكل أساسي من قبل مبرمجي الإضافات الذين يرغبون في التعامل مع المهام بشكل مختلف اعتمادًا على مجال الأسماء المستخدم. أمثلة معرفة مجال الأسماء المستخدم عند وقوع الحدث: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.namespace مثال على الخاصية</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>display event.namespace</button> <p></p> <script> $( "p" ).on( "test.something", function( event ) ...

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

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

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

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

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

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

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

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

التعامل مع البيانات في jQuery

يوفر هذا القسم مجموعة من التوابع التي تستعمل من أجل ربط بيانات محدَّدة مع عنصر محدَّد (أو مجموعة عناصر محدَّدة) وقراءة تلك البيانات لاحقًا. ‎.data()‎ يخزِّن التابع ‎.data()‎ بيانات عشوائية مرتبطة بالعناصر المتطابقة أو تُعيد القيمة في مخزن البيانات المحدد للعنصر الأول في مجموعة العناصر المتطابقة. ‎jQuery.data()‎ يخزِّن هذا التابع بيانات اعتباطيَّة ويقرنها بعنصر محدَّد، ويعيد القيمة التي ضُبِطَت. ‎jQuery.hasData()‎ يتحقَّق هذا التابع إن كان يملك عنصرٌ محدَّدٌ أيَّةَ بياناتٍ مرتبطةٍ به. jQuery‎.proxy()‎ يأخذ هذا التابع دالةً ويعيد أخرى جديدة ...

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

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

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

يُظهِر هذا التابع أو يعدل طابور الدوال المطلوب تنفيذها على العناصر المطابقة. ‎.queue( [queueName ] )‎ القيم المعادة يعيد مصفوفة من النوع Array. الوصف يجلب هذا التابع طابور الدوال المطلوب تنفيذها على العناصر المطابقة. ‎.queue( [queueName ] )‎ أُضيف مع الإصدار: 1.2. queueName سلسلة نصية تمثِّل اسم الطابور. القيمة الافتراضية هي fx وهو طابور التأثيرات القياسيَّة. أمثلة إظهار طول الطابور: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>queue مثالٌ عن استعمال التابع</title> <style> div { ...

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

يعيد هذا التابع قيمة الطول الحالي (تتضمن قيمة الحواشي فقط دون الإطار) لأول عنصر في مجموعة العناصر المطابقة أو يغير الطول الداخلي لكل العناصر المطابقة. ‎.innerHeight()‎ القيم المعادة يعيد عدد من النوع Number. الوصف يعيد هذا التابع قيمة الطوال الحالي (من ضمنها قيمة الحواشي فقط دون إطار) لأول عنصر في مجموعة العناصر المطابقة. ‎.innerHeight()‎ أضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أي معاملات. يعيد هذا التابع قيمة طول العنصر، وتدخل قيمة الحواشي العليا والسفلى ضمن تلك القيمة، بواحدة البكسل. ...

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

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

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

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

الخاصية ‎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 ...

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

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

التابع ‎‎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 الرسمي.

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

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

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

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

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

jQuery.ready القيم المعادة قيمة هذا الخاصية هي من النوع Thenable. الوصف هذه الخاصية هي كائنٌ شبيه بالكائن Pormise (يدعى Thenable) التي تستبين عن اللحظة الزمنيَّة التي يصبح فيها المستند جاهزًا. jQuery.ready أُضيف مع الإصدار: 1.8. بدءًا من الإصدار jQuery 3.0، أصبح بالإمكان استعمال الكائن الذي يعيده هذا التابع مع التابع jQuery.when()‎ والتابع jQuery.resolve()‎ الأساسي. لا يجب أن تبني الشيفرة أيَّة افتراضات تتعلق فيما إذا كان هذا الكائن هو jQuery.Deferred، أو Promise، أو أي نوع آخر من أنواع الكائن Promise. انظر ...