نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
التابع .replaceWith() في jQuery
.replaceWith( newContent ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يبدِّل هذا التابع المحتوى الجديد المعطى مكان كل عنصر في مجموعة العناصر المطابقة، ويعيد مجموعة العناصر التي استُبدلت. .replaceWith( newContent ) أُضيف مع الإصدار: 1.2. newContent المحتوى الجديد الذي سيحل محل عناصر محدَّدة، وقد يكون سلسلة نصيَّة من الكائن htmlString أو عنصر DOM أو مصفوفة من عناصر DOM أو كائن jQuery. .replaceWith( function ) أُضيف مع الإصدار: 1.4. function دالة من الشكل Function()، وتعيد المحتوى الذي سيُستبدل بمجموعة العناصر ...
الخاصية event.isPropagationStopped() في jQuery
event.isPropagationStopped() القيمة المعادة تُعيد كائنًا من النوع Boolean. الوصف نتحقق هذه الخاصية من استدعاء الحدث event.stopPropagation() على كائن الحدث هذا. event.isPropagationStopped() أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. هذه الخاصية موصوفة في مواصفات W3C DOM Level 3 . أمثلة التحقق من استدعاء event.stopPropagation(). <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>event.isPropagationStopped مثال على الخاصية</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>أنقر هنا</button>
<div id="stop-log"></div>
<script>
function propStopped( event ) {
var msg = "";
if ( event.isPropagationStopped() ) {
...
التابع deferred.promise() في jQuery
deferred.promise( [target ] ) القيمة المعادة يُعيد كائنًا من النوع Promise. الوصف يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred. deferred.promise( [target ] ) أُضيف مع الإصدار: 1.5. target الكائن الذي يجب إرفاق تابع promise به وهو من النوع Object. يسمح التابع deferred.promise() لدالة غير متزامنة بمنع الشيفرات البرمجية الأخرى من التدخل في تقدم أو حالة الطلب الداخلي الخاص به. ويعرض التابع promise فقط التوابع المؤجلة اللازمة لإرفاق معالجات إضافية أو تحديد الحالة (then و done و fail و always ...
التابع .unwrap() في jQuery
.unwrap() القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إزالة آباء مجموعة العناصر المُطابقة من شجرة DOM، مع ترك العناصر المُطابقة في مكانها. .unwrap() أُضيف مع الإصدار: 1.4. لا يقبل هذا الشكل أي وسائط. .unwrap( [selector ] ) أُضيف مع الإصدار: 3.0. selector محدد للتحقق من العنصر الأب من النوع String. إذا لم يتطابق العنصر الأب لأحد العناصر مع المحدد، فلن يُحذف. يُزيل التابع .unwrap() العنصر الأب ويُعيد محتواه بدونه. وهو بالضبط معكوس التابع .wrap(). وتحل العناصر المطابقة (ومثيلاتها، إن ...
الخاصية event.which في jQuery
event.which القيمة المعادة تُعيد كائنًا من النوع Number. الوصف لكل حدث يتولد من لوحة المفاتيح أو الفأرة، تشير هذه الخاصية إلى المفتاح أو الزر المحدد المضغوط عليه. event.which الإصدار المضافة: 1.1.3. تضبط الخاصية event.which كلًا من event.keyCode و event.charCode. من المستحسن مراقبة event.which لإدخال مفتاح لوحة المفاتيح. تضبط event.which أيضا ضغط الأزرار (الأحداث mousedown و mouseup )، وإعادة إشعار يالقيمة 1 للزر الأيسر، 2 للزر الأوسط، و 3 للزر الأيمن. يستخدم event.which بدلاً من event.button. أمثلة تسجيل المفتاح المضغوط: <!doctype ...
التابع deferred.notify() في jQuery
deferred.notify( args ) القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred مع الوسائط args المعطاة. deferred.notify( args ) أُضيف مع الإصدار: 1.7. args الوسائط الاختيارية التي تُمرر إلى progressCallbacks وهي كائن من النوع Object. عادة، يجب أن يستدعي مُنشِئ الكائن Deferred هذا التابع فقط؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة الكائن Promise كسلسلة (chain) من خلال التابع deferred.promise(). عند استدعاء deferred.notify() فسيستدعى أي progressCallbacks سبق وأن أُضيف بواسطة ...
التابع 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.ajaxTransport() في jQuery
jQuery.ajaxTransport( dataType, handler ) القيم المعادة يعيد قيمةً من النوع undefined. الوصف ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax. jQuery.ajaxTransport( dataType, handler ) أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية تحدِّد نوع البيانات المراد استعمال هذا التابع معها. handler دالةٌ من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR ) تعيد الكائن transport الجديد لاستعماله مع نوع البيانات المحدَّد في الوسيط الأول. الكائن transport هو كائنٌ يوفر تابعين اثنين هما: التابع send، والتابع abort اللذان تستعملهما الدالة ...
التابع .scroll() في jQuery
.scroll( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين مع الحدث scroll في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر. .scroll( handler ) أُضيف مع الإصدار: 1.0. handler دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث. .scroll( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في 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.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.extend() في jQuery
jQuery.extend( target [, object1 ] [, objectN ] ) القيم المعادة يعيد كائنًا من النوع Object. الوصف يدمج هذا التابع محتويات عنصرين أو أكثر مع بعضهما بعضًا ويضع الناتج في الكائن الأول. jQuery.extend( target [, object1 ] [, objectN ] ) أُضيف مع الإصدار: 1.0. target الكائن الذي سيضاف إليه خاصِّيَّات جديدة من الكائنات الأخرى إن مُرِّرت، أو سيوسِّع مجال أسماء jQuery (namespace) إن لم يُمرَّر سواه. object1 كائن يحتوي على خاصِّيَّات إضافية يراد دمجها مع الكائن الأول target المعطى. ...
التابع .end() في jQuery
.end() القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف ينهي هذا التابع أحدث عملية الترشيح في السلسلة الحالية ويُعيد مجموعة العناصر المتطابقة إلى حالتها السابقة. .end() أُضيف مع الإصدار: 1.0. لا يقبل هذا التابع أي وسائط. تعمل معظم توابع jQuery للتنقل في شجرة DOM على نسخة من الكائن jQuery وتنتج كائنًا جديدًا آخر يطابق مجموعةً مختلفةً من عناصر DOM. عند حدوث ذلك، يبدو الأمر كما لو أن المجموعة الجديدة من العناصر تُدفَع إلى مكدس محفوظ داخل الكائن. ويدفع كل تابع ...
التابع deferred.always() في jQuery
deferred.always( alwaysCallbacks [, alwaysCallbacks ] ) القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع دوال معالجة تُستدعَى عند قبول الكائن المؤجل Deferred أو رفضه. deferred.always( alwaysCallbacks [, alwaysCallbacks ] ) أُضيف مع الإصدار: 1.6. alwaysCallbacks هو دالة أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function(). alwaysCallbacks هو دالة إضافية إختيارية أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function(). يمكن أن يكون ...
التابع .width() في jQuery
إعادة العرض الحالي المحسوب للعنصر الأول من مجموعة العناصر المُطابقة، أو ضبط عرض CSS لكل عنصر في مجموعة العناصر المُطابقة. .width() القيمة المعادة يُعيد كائنًا من النوع Number. الوصف إعادة العرض الحالي المحسوب للعنصر الأول من مجموعة العناصر المُطابقة. .width() أُضيف مع الإصدار: 1.0. لا يقبل هذا الشكل أي وسائط. الفرق بين .css(width) و .width() هو أن الأخير يعيد قيمة البكسل بدون وحدة (على سبيل المثال، 400) في حين أن الأول يعيد القيمة مع وحدات سليمة (على سبيل المثال، 400px). ...
التابع .toggle() في jQuery
.toggle( handler, handler [, handler ] ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف ربط معالجين أو أكثر بالعناصر المتطابقة، لتنفيذها بالتناوب. .toggle( handler, handler [, handler ] ) أُضيف مع الإصدار: 1.0، وأٌهمل مع الإصدار: 1.8، واُُزيل مع الإصدار: 1.9. handler دالة على الشكل Function( Event eventObject )، تنفَّذ عند النقر على العنصر كل مرة زوجية. handler دالة على الشكل Function( Event eventObject )، تنفَّذ عند النقر على العنصر كل مرة فردية. handler دالة على الشكل Function( Event ...
التابع jQuery.trim() في jQuery
jQuery.trim( str ) القيم المعادة يعيد سلسلة نصية (String). الوصف يزيل هذا التابع جميع المسافات البيضاء (whitespace) من بداية ونهاية السلسلة النصية المُمرَّرة إليه. jQuery.trim( str ) أُضيف مع الإصدار: 1.0. str السلسلة النصية المُراد إزالة المسافات البيضاء من بدايتها ونهايتها. يزيل التابع $.trim() جميع محارف الأسطر الجديدة، والمسافات الفارغة (تدخل المسافات غير المقطوعة [non-breaking spaces] من ضمنها)، ومسافات الجدولة (tabs) من بداية ونهاية السلسلة النصية المعطاة. لن تتأثر محارف المسافات البيضاء إن وقعت في منتصف السلسلة النصيَّة. أمثلة إزالة ...
المحدد :disabled في jQuery
المحدد :disabled الوصف يحدد جميع العناصر التي تم تعطيلها. jQuery( ":disabled" ) أُضيف مع الإصدار: 1.0. كما هو الحال مع الأصناف الوهمية الأخرى (تلك التي تبدأ بنقطتين رأسيتين ":")، فمن المستحسن أن تسبقها باسم وسم أو مُحدِّد آخر؛ خلاف ذلك، يستخدم المحدد العالمي ("*") كمحدد ضمني. بمعنى آخر، فإن $(':disabled') المجرد يعادل $('*:disabled') ، لذلك يجب استخدام $('input:disabled') أو ما شابه بدلاً من ذلك. وعلى الرغم من أن التحديدات التي تُنتج عنها عادة ما تكون متماثلة، فإن المحدد :disabled يختلف ...
الخاصية event.isPropagationStopped() في jQuery
event.isPropagationStopped() القيمة المعادة تُعيد كائنًا من النوع Boolean. الوصف نتحقق هذه الخاصية من استدعاء الحدث event.stopPropagation() على كائن الحدث هذا. event.isPropagationStopped() أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. هذه الخاصية موصوفة في مواصفات W3C DOM Level 3 . أمثلة التحقق من استدعاء event.stopPropagation(). <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>event.isPropagationStopped مثال على الخاصية</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>أنقر هنا</button>
<div id="stop-log"></div>
<script>
function propStopped( event ) {
var msg = "";
if ( event.isPropagationStopped() ) {
...
التابع 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( ...
التابع .dequeue() في jQuery
.dequeue( [queueName ] ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف ينفذ هذا التابع الدالة التالية في طابور الانتظار للعناصر المتطابقة. أُضيف مع الإصدار: 1.2 .dequeue( [queueName ] ) queueName سلسلة نصية تحتوي على اسم الطابور. وقيمتها الافتراضية fx وهو اسم طابور التأثيرات القياسية. عند استدعاء .dequeue()، تتم إزالة الدالة التالية في طابور (queue) الانتظار، ثم تُنفَّذ. ينبغي لهذه الدالة بدورها (بشكل مباشر أو غير مباشر) التسبب في استدعاء .dequeue()، بحيث يستمر التسلسل. أمثلة استخدام dequeue لإنهاء دالة انتظار ...
التابع .detach() في jQuery
.detach( [selector ] ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع مجموعة العناصر المتطابقة من DOM. .detach( [selector ] ) أُضيف مع الإصدار: 1.4. selector تعبير مُحدِّد يُرشِح مجموعة العناصر المتطابقة المراد حذفها وهو من النوع Selector. يعمل التابع .detach() مثل التابع .remove() ، باستثناء أن .detach() يحتفظ بكل بيانات jQuery المرتبطة بالعناصر المحذوفة. يُفيد هذا التابع عند إعادة إدراج العناصر التي تمت إزالتها إلى DOM في وقت لاحق. أمثلة حذف جميع الفقرات من DOM: <!doctype ...
التابع deferred.fail() في jQuery
deferred.fail( failCallbacks [, failCallbacks ] ) القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred. deferred.fail( failCallbacks [, failCallbacks ] ) أُضيف مع الإصدار: 1.5. failCallbacks هو دالة، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو دالة Function(). failCallbacks هو دالة إضافية اختيارية، أو مصفوفة دوال، تُستدعى عند رفض الكائن المؤجل Deferred، وهو على الشكل Function(). يقبل التابع deferred.fail() وسيطًا واحدًا أو أكثر، ويمكن أن تكون كلها إما دالة ...
التابع jQuery.error() في jQuery
jQuery.error( message ) الوصف يأخذ هذا التابع قيمةً ثمَّ يرمي استثناءً يحتوي على هذه القيمة. jQuery.error( message ) أُضيف مع الإصدار: 1.4.1. message رسالة الخطأ المراد إرسالها. أكثر من يستعمل هذا التابع هم المطورون في إضافاتهم (plugin) الذين يريدون توفير وإظهار معلومات أوسع حول رسائل الخطأ. أمثلة تجاهل الخطأ jQuery.error وإظهاره في سجل المتصفح: jQuery.error = console.error;
مصادر صفحة التابع ()jQuery.error في توثيق jQuery الرسمي.
التابع deferred.notify() في jQuery
deferred.notify( args ) القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred مع الوسائط args المعطاة. deferred.notify( args ) أُضيف مع الإصدار: 1.7. args الوسائط الاختيارية التي تُمرر إلى progressCallbacks وهي كائن من النوع Object. عادة، يجب أن يستدعي مُنشِئ الكائن Deferred هذا التابع فقط؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة الكائن Promise كسلسلة (chain) من خلال التابع deferred.promise(). عند استدعاء deferred.notify() فسيستدعى أي progressCallbacks سبق وأن أُضيف بواسطة ...
التابع jQuery.inArray() في jQuery
jQuery.inArray( value, array [, fromIndex ] ) القيم المعادة يعيد عددًا (Number). الوصف يبحث هذا التابع عن قيمة محدَّدة ضمن مصفوفةٍ ثمَّ يعيد قيمة فهرس موضعها (أو القيمة -1 إن لم يجدها). jQuery.inArray( value, array [, fromIndex ] ) أُضيف مع الإصدار: 1.2. value أي شيء، ويمثل القيمة المراد البحث عنها. array المصفوفة المراد البحث ضمن عناصرها. fromIndex عددٌ (Number) يمثل قيمة فهرس أحد عناصر المصفوفة الذي يراد بدء عملية البحث عنده. القيمة الافتراضيَّة هي 0 أي البحث ضمن جميع ...
التابع jQuery.hasData() في jQuery
jQuery.hasData( element ) القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كان يملك عنصرٌ محدَّدٌ أيَّةَ بياناتٍ مرتبطةٍ به. jQuery.hasData( element ) أُضيفت مع الإصدار: 1.5. element عنصر DOM يراد التحقُّق من وجود بيانات مرتبطة به. يوفِّر التابع jQuery.hasData() وسيلةً لتحديد إن كان العنصر الحالي يملك أيَّة بيانات رُبطَت به باستعمال التابع jQuery.data(). إن لم يكن هنالك بيانات مرتبطة بهذا العنصر، فسعيد التابع القيمة false. خلا ذلك، سيعيد التابع القيمة true. الميِّزة الأساسية للتابع jQuery.hasData( element ) ...
التابع .error() في jQuery
.error( handler ) القيمة المعادة يُعيد كائنًا من النوع jQuery. أُهمل مع الإصدار: 1.8، وأُزيل مع الإصدار: 3.0. الوصف ربط معالج الحدث بحدث الخطأ "error" في JavaScript. error( handler ) أُضيف مع الإصدار: 1.0. handler دالة تنفذ عند تشغيل الحدث وهي على الشكل Function( Event eventObject ). .error( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript. handler دالة تنفذ عند تشغيل ...
التابع 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 أي البحث ضمن جميع ...
التابع .addClass() في jQuery
.addClass( className ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .addClass() لإضافة الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة. .addClass( className ) أضيفت في الإصدار: 1.0. className سلسلة نصيّة من الكائن String، وتُمثِّل صنف أو عدة أصناف مفصولة بمسافة بينها لإضافتها إلى الخاصيّة class لكل عنصر مُطابق. .addClass( function ) أضيفت في الإصدار: 1.4. Function دالة على الشكل Function( Integer index, String currentClassName ) وتُعيد سلسلة نصيّة. دالة تُعيد اسم أو عدة أسماء لأصناف مفصولةً بمسافة بينها ...
الخاصية event.preventDefault() في jQuery
event.preventDefault() القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف استدعاء هذه الخاصية يُعطل إطلاق الإجراء الافتراضي للحدث. event.preventDefault() أُضيف مع الإصدار: 1.0. لا تقبل هذه الخاصية أي وسائط. على سبيل المثال، لن ينقل النقر على الروابط إلى عنوان URL جديد. ويمكن استخدام الخاصية event.isDefaultPrevented() للتحقق من استدعاء هذه الخاصية بواسطة معالج أحداث المستدعى بواسطة هذا الحدث. أمثلة إلغاء الإجراء الافتراضي (التنقل) للنقر على العنصر : <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>event.preventDefault مثال على الخاصية</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<a ...
التابع .change() في jQuery
.change( handler ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع .change() في ربط مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو إطلاق هذا الحدث على عنصر ما. .change( handler ) أضيفت في الإصدار: 1.0. handler دالة على الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث. .change( [eventData ], handler ) أضيفت في الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على ...
التابع .size() في jQuery
.size() أهمل هذا التابع في الإصدار: 1.8، وحذف في الإصدار: 3.0. القيم المعادة يعيد عددًا من النوع Number. الوصف يعيد هذا التابع عدد العناصر الموجودة في كائن jQuery محدَّد. .size() أُضيف مع الإصدار: 1.0. لا يقبل هذا التابع أية وسائط. أهمل التابع .size() بدءًا من الإصدار jQuery 1.8، لذا استعمل الخاصِّيَّة .length عوضًا عنه. يكافئ التابع .size() وظيفيًا الخاصِّيَّة .length. على أي حال، يفضل استعمال الخاصِّيَّة .length لأنها لا تسبب حملًا زائدًا كما يفعل استدعاء دالةٍ ما. إن كان لدينا ...
الخاصية event.preventDefault() في jQuery
event.preventDefault() القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف استدعاء هذه الخاصية يُعطل إطلاق الإجراء الافتراضي للحدث. event.preventDefault() أُضيف مع الإصدار: 1.0. لا تقبل هذه الخاصية أي وسائط. على سبيل المثال، لن ينقل النقر على الروابط إلى عنوان URL جديد. ويمكن استخدام الخاصية event.isDefaultPrevented() للتحقق من استدعاء هذه الخاصية بواسطة معالج أحداث المستدعى بواسطة هذا الحدث. أمثلة إلغاء الإجراء الافتراضي (التنقل) للنقر على العنصر : <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>event.preventDefault مثال على الخاصية</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<a ...
التابع .wrapInner() في jQuery
.wrapInner( wrappingElement ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تغليف شيفرة HTML حول محتوى كل عنصر في مجموعة العناصر المُطابقة. .wrapInner( wrappingElement ) أُضيف مع الإصدار: 1.2. wrappingElement شيفرة HTML أو تعبير مُحدد أو كائن jQuery أو عنصر DOM يحدد شيفرة تغليف محتوى العناصر المُطابقة. وهو من النوع Selector أو htmlString أو Element أو jQuery. .wrapInner( function ) أُضيف مع الإصدار: 1.4. function دالة على الشكل Function( Integer index ) => String. وهي دالة رد نداء تُنشئ شيفرة HTML لتغليف محتوى العناصر ...
التابع .focusin() في jQuery
.focusin( handler ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج الحدث بحدث "focusin" من JavaScript. .focusin( handler ) أُضيف مع الإصدار: 1.4. handler دالة على الشكل Function( Event eventObject )، وتُنفَّذ في كل مرة يُطلَق فيها الحدث. .focusin( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript. handler دالة على الشكل Function( Event eventObject )، وتُنفَّذ ...
التابع jQuery.uniqueSort() في jQuery
jQuery.uniqueSort( array ) القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.uniqueSort( array ) أُضيفت مع الإصدار: 1.12/2.2. array مصفوفةٌ من عناصر DOM. يرتِّب التابع $.uniqueSort() مصفوفةً من الكائنات ويحذف أيَّة عقدٍ متكرِّرة. تُعدُّ العقدة متكرِّرة إن كان لها الاسم نفسه الذي تملكه عقدة أخرى موجودة قبلها في المصفوفة. أمَّا كان هنالك عقدتين ...
التابع 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؛ يمكنك منع الشيفرات البرمجية ...
التابع .first() في jQuery
.first() القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يُقلِّص هذا التابع مجموعة العناصر المطابقة إلى الأول في المجموعة. .first() أُضيف مع الإصدار: 1.4. لا يقبل هذا التابع أي وسائط. إذا أُدخل كائن jQuery يمثل مجموعة من عناصر DOM، يقوم التابع .first() ببناء كائن jQuery جديد من العنصر الأول في تلك المجموعة. إليك صفحة بها قائمة بسيطة: <ul>
<li>list item 1</li>
<li>list item 2</li>
<li>list item 3</li>
<li>list item 4</li>
<li>list item 5</li>
</ul>
يمكننا تطبيق هذا ...
التابع $.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 المستقبليَّة. تبدو عملية الترشيح ...
التابع deferred.done() في jQuery
deferred.done( doneCallbacks [, doneCallbacks ] ) القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع مُعالجات تستدعى عند قبول الكائن المؤجل Deferred. deferred.done( doneCallbacks [, doneCallbacks ] ) أُضيف مع الإصدار: 1.5. doneCallbacks هو دالة، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function(). doneCallbacks هو دالة اختيارية إضافية، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function(). يقبل التابع deferred.done() وسيطًا واحدًا أو أكثر، وكلها يمكن أن تكون إما دالة مفردة ...
التابع 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؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير ...
الخاصية 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() ) {
...
التابع jQuery.makeArray() في jQuery
jQuery.makeArray( obj ) القيم المعادة يعيد مصفوفةً (Array). الوصف يحوِّل هذا التابع كائنًا شبيهًا بمصفوفة إلى مصفوفة JavaScript حقيقية. jQuery.makeArray( obj ) أُضيف مع الإصدار: 1.4. obj الكائن المراد تحويله إلى مصفوفة فعليَّة. تعيد أغلب التوابع عمومًا، في jQuery و JavaScript كلاهما، كائنات شبيه بمصفوفة (array-like). فتعيد الدالة المنتجة $() مثلًا الكائن jQuery الذي يملك العديد من خاصِّيَّات المصفوفة (مثل الخاصِّيَّة length، والمعامل [] للوصول إلى المصفوفة ...إلخ.) إلا أنَّه ليس مصفوفة حقيقية تمامًا ويفتقد إلى بعض توابع المصفوفات المدمجة ...
التابع .serialize() في jQuery
.serialize() القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يُرمِّز هذا التابع مجموعة من عناصر النماذج ويضعها في سلسلة نصيِّة من أجل إرسالها. .serialize() أُضيف مع الإصدار: 1.0. ولا يقبل هذا التابع أية وسائط. ينشئ التابع .serialize() سلسلة نصية من رموز URL المشفَّرة القياسيَّة (standard URL-encoded notation). يمكن تطبيقه على كائن jQuery الذي يحتوي على عناصر نموذج فردية مثل <input> و <textarea> و <select> بالشكل: $( "input, textarea, select" ).serialize();
من الأسهل عادةً تحديد العنصر <form> نفسه من أجل استعماله ...
التابع jQuery.holdReady() في jQuery
jQuery.holdReady( hold ) القيم المعادة يعيد القيمة undefined. الوصف يعلِّق هذا التابع تنفيذ الحدث ready في jQuery أو يحرِّره إن كان معلَّقًا. jQuery.holdReady( hold ) أُضيفت مع الإصدار: 1.6. hold قيمةٌ منطقيَّةٌ (Boolean) تحدِّد إن كان يراد تعليق تنفيذ الحدث ready أم إطلاقه للعمل بعد أن كان معلقًا. يعمل التابع $.holdReady() على تأجيل تنفيذ استدعاء الحدث ready. سيستخدم هذه الميِّزة المتطورة عادةً محمِّلات السكربت الديناميكيَّة (dynamic script loaders) التي تريد تحميل شيفرة JavaScript إضافيَّة -مثل إضافات jQuery- قبل السماح للحدث ...
التابع 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>
...
التابع .stop() في jQuery
.stop( [clearQueue ] [, jumpToEnd ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يوقف هذا التابع الحركة التي يجري تنفيذها آنذاك على العناصر المطابقة. .stop( [clearQueue ] [, jumpToEnd ] ) أُضيف مع الإصدار: 1.2. clearQueue قيمة منطقيَّة تحدِّد إن كان يجب حذف الحركات التي تنتظر في الطابور أيضًا أم لا. القيمة الافتراضيَّة هي false. jumpToEnd قيمة منطقيَّة تحدِّد إن كان يجب إكمال الحركة الحاليَّة مباشرةًَ والتوقف بعدها أم التوقف مباشرةً دون انتظار اكمال الحركة التي تنفَّذ آنذاك. ...
التابع 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.htmlPrefilter() في jQuery
jQuery.htmlPrefilter( html ) القيم المعادة يعيد سلسلةً نصيةً (String). الوصف يعدِّل ويرشِّح هذا التابع سلاسل HTML النصية الممرَّرة عبر توابع التعديل (manipulation) في jQuery. jQuery.htmlPrefilter( html ) أُضيف مع الإصدار: 1.12/2.2. html سلسلة نصية تحتوي على شيفرة HTML التي يراد تطبيق العمليَّة عليها. إنَّ الحاجة إلى استدعاء هذا التابع بشكل مباشر أمرٌ نادر الحدوث، إذ يستعمل بدلًا من ذلك كنقطة دخول لتعديل توابع التعديل الموجودة. إن أردنا مثلًا إزالة الوسم <del> من محتوى HTML الوارد، فاستعمل هذا التابع مثلما موضح ...
التابع 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 إذا لم تكن السلسلة النصية المعطاة ...
التابع deferred.catch() في jQuery
deferred.catch( failFilter ) القيمة المعادة يُعيد التابع deferred.catch( failFilter ) كائنًا من النوع Promise. الوصف يُضيف هذا التابع دوال معالجة أحداث تُستدعى عند رفض الكائن المؤجل Deferred. deferred.catch( failFilter ) أُضيف مع الإصدار: 3.0. failFilter هو دالة تُستدعى عند رفض الكائن المؤجل Deferred، وهو دالة Function(). deferred.catch( fn ) هو اسم مستعار للتابع deferred.then( null, fn ) . اقرأ صفحته لمزيد من المعلومات. أمثلة لما كان التابع jQuery.get يُعيد كائن jqXHR، وهو مشتق من الكائن Deferred، فيمكننا أن ننشئ دوال ...
التابع deferred.progress() في jQuery
deferred.progress( progressCallbacks [, progressCallbacks ] ) القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع معالجات تستدعى عندما ينتج الكائن المؤجل Deferred إشعارات التقدُّم. deferred.progress( progressCallbacks [, progressCallbacks ] ) أُضيف مع الإصدار: 1.7. progressCallbacks دالة، أو مصفوفة من الدوال، تُستدعَى عندما ينتج الكائن المؤجل Deferred إشعارات تقدُّم، وهو على شكل دالة Function() أو مصفوفة Array. progressCallbacks دالة إضافية اختيارية، أو مصفوفة من الدوال، تُستدعَى عندما ينتج الكائن المؤجل Deferred إشعارات تقدُّم، وهو على شكل دالة Function() أو ...
التابع .prev() في jQuery
.prev( [selector ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع العنصر الأخ الذي يسبق مباشرةً كل عنصر في مجموعة العناصر المطابقة. إن مُرِّر للتابع محدِّد، فسيرشِّح جميع تلك العناصر التي يجدها أيضًا ويعيد ما تطابق منها. .prev( [selector ] ) أُضيف مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد لمطابقة العناصر. إن كان لدينا كائن jQuery يمثل مجموعة عناصر DOM، فسيبحث التابع .prev() عن العنصر الأخ الذي يأتي قبل كل عنصر من هذه ...
التابع deferred.always() في jQuery
deferred.always( alwaysCallbacks [, alwaysCallbacks ] ) القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع دوال معالجة تُستدعَى عند قبول الكائن المؤجل Deferred أو رفضه. deferred.always( alwaysCallbacks [, alwaysCallbacks ] ) أُضيف مع الإصدار: 1.6. alwaysCallbacks هو دالة أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function(). alwaysCallbacks هو دالة إضافية إختيارية أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function(). يمكن أن يكون ...
التابع .toArray() في jQuery
.toArray() القيم المعادة يعيد مصفوفة من النوع Array. الوصف يضع هذا التابع جميع العناصر الموجودة في مجموعة jQuery في مصفوفة ثمَّ يعيدها. .toArray() أُضيف مع الإصدار: 1.4. ولا يقبل هذا التابع أية وسائط. يضع هذا التابع جميع العناصر الموجودة في مجموعة jQuery في مصفوفة ثم يعيدها: alert( $( "li" ).toArray() );
ستُعاد جميع عقد DOM المطابقة عند استدعاء هذا السطر في مصفوفة قياسية: [<li id="foo">, <li id="bar">]
أمثلة تحديد جميع العناصر <div> في الصفحة ثمَّ إعادة العناصر DOM في مصفوفة ثمَّ ...
التابع 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.param() في jQuery
jQuery.param( obj ) القيم المعادة يعيد سلسلةً نصيةً (Array). الوصف يرمِّز (serialize) هذا التابع محتويات مصفوفة، أو كائن مجرَّد، أو كائن jQuery ويضعها في سلسلة نصيَّة لتصبح ملائمة لاستعمالها في سلسلة الاستعلام النصية لعنوان URL أو لإرسالها في طلبات Ajax. في حال تمرير كائن jQuery، فيجب أن يحوي هذا الكائن عناصر إدخال <input> لها خاصِّيَّات بالشكل اسم/قيمة. jQuery.param( obj ) أُضيف مع الإصدار: 1.2. obj مصفوفة، أو كائن مجرَّد (Object)، أو كائن jQuery التي يراد ترميزها. jQuery.param( obj, traditional ) ...
الخاصية event.timeStamp في jQuery
event.timeStamp القيمة المعادة تعيد كائنًا من النوع Object. الوصف فرق الوقت محسوب بالميللي ثانية بين وقت إنشاء المتصفح للحدث وليلة رأس سنة 1970. event.timeStamp أضيفت في الإصدار: 1.2.6. يمكن أن تكون هذه الخاصية مفيدة لتوصيف أداء الحدث بالحصول على قيمة event.timeStamp عند نقطتين في الشيفرة البرمجية وملاحظة الاختلاف. لتحديد الوقت الحالي داخل معالج الأحداث، يُستخدم التابع (new Date).getTime() بدلاً من ذلك. ملاحظة: نظرًا لوجود علّة منذ عام 2004، لا تستخدم هذه القيمة بشكل صحيح في متصفح Firefox ولا يمكن معرفة ...
التابع .promise() في jQuery
.promise( [type ] [, target ] ) القيم المعادة يعيد كائنًا من النوع Promise. الوصف يعيد هذا التابع كائنًا من النوع Promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة. .promise( [type ] [, target ] ) أُضيف مع الإصدار: 1.6. type سلسلة نصية تمثِّل نوع الطابور المراد مراقبته. قيمته الافتراضية هي fx. target كائن مجرَّد (object) يبين أيًّا من توابع Promise يجب ...
التابع jQuery.removeData() في jQuery
jQuery.removeData( element [, name ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع جزءًا من البيانات المُخزَّنة مسبقًا والمرفقة بعنصر محدَّد. jQuery.removeData( element [, name ] ) أُضيفت مع الإصدار: 1.2.3. element عنصر DOM الذي يراد حذف البيانات المرفقة به. name سلسلة نصية تحتوي على اسم قطعة البيانات المراد حذفها. ملاحظة: هذا التابع منخفض المستوى، لذا يجب عليك استعمال .removeData() عوضًا عنه. يوفر التابع jQuery.removeData() إمكانيَّة حذف القيم التي ضُبطَت مسبقًا باستعمال التابع jQuery.data(). إن مُرِّر ...
التابع .slice() في jQuery
.slice( start [, end ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يقلِّص هذا التابع مجموعة العناصر المطابقة إلى مجموعة فرعيَّة موجودة في مجال محدَّد. .slice( start [, end ] ) أُضيف مع الإصدار: 1.1.4. start عدد صحيح يمثل مؤشرًا صفريًا (0-based index) يشير إلى موقع العنصر الذي يبدأ عنده مجال المجموعة الفرعيَّة. إن كانت قيمته سالبة، فسيشير إلى موقع العنصر الذي يمثِّل بداية المجال ولكن بدءًا من نهاية المجموعة. end عددٌ صحيحٌ يمثِّل فهرسًا صفريًا (0-based index) ...
التابع .focusout() في jQuery
.focusout( handler ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج الحدث بحدث "focusout" من JavaScript. .focusout( handler ) أُضيف مع الإصدار: 1.4. handler دالة على الشكل Function( Event eventObject )، تُنفَّذ في كل مرة يُطلَق فيها الحدث. .focusout( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript. handler دالة على الشكل Function( Event eventObject )، تُنفَّذ ...
التابع .slideUp() في jQuery
()slideUp. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يخفي هذا التابع جميع العناصر المطابقة مع حركة انسحابيَّة. .slideUp( [duration ] [, complete ] ) أضيف مع الإصدار 1.0. duration عدد أو سلسلة نصية تمثِّل كمية الوقت الذي ستستغرقه عملية تحريك العنصر، وقيمته الافتراضيَّة هي 400. complete دالةٌ من الشكل Function() وتُستدعَى مرةً وحدةً مع كل عنصر من العناصر المطابقة بعد اكتمال الحركة المطبَّقة عليه. .slideDown( options ) أضيف مع الإصدار: 1.0. Options كائن من النوع Object، وهو مجموعة من ...
التابع .removeProp() في jQuery
.removeProp( propertyName ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع خاصِّيَّة كائنيِّة محدَّدة لكل عنصر في مجموعة العناصر المطابقة. .removeProp( propertyName ) أُضيف مع الإصدار: 1.6. propertyName سلسلة نصية تمثِّل اسم الخاصِّيَّة الكائنية المراد حذفها. يحذف التابع .removeProp() الخاصِّيَّات التي ضُبطَت باستعمال التابع .prop(). قد تولِّد المتصفحات خطأً عند محاولة حذف بعض الخاصِّيَّات المضمَّنة لعنصر DOM أو الكائن window. تسند الخاصِّيَّة jQuery آنذاك القيمة undefined للخاصِّيَّة وتتجاهل أي خطأ ولَّده المتصفح. من المهم عمومًا حذف الخاصِّيَّات ...
التابع jQuery.param() في jQuery
jQuery.param( obj ) القيم المعادة يعيد سلسلةً نصيةً (Array). الوصف يرمِّز (serialize) هذا التابع محتويات مصفوفة، أو كائن مجرَّد، أو كائن jQuery ويضعها في سلسلة نصيَّة لتصبح ملائمة لاستعمالها في سلسلة الاستعلام النصية لعنوان URL أو لإرسالها في طلبات Ajax. في حال تمرير كائن jQuery، فيجب أن يحوي هذا الكائن عناصر إدخال <input> لها خاصِّيَّات بالشكل اسم/قيمة. jQuery.param( obj ) أُضيف مع الإصدار: 1.2. obj مصفوفة، أو كائن مجرَّد (Object)، أو كائن jQuery التي يراد ترميزها. jQuery.param( obj, traditional ) ...
العمل مع JavaScript في ريلز
يغطي هذا الدليل وظيفة Ajax/JavaScript المضمّنة في ريلز (والمزيد)؛ وسوف يمكنك من إنشاء تطبيقات Ajax غنية وديناميكية بكل سهولة! ستتعلم بعد قراءة هذا الدليل: أساسيات Ajax. جافاسكربت الواضحة (Unobtrusive JavaScript). كيف يساعدك مساعدو ريلز المدمجون (built-in helpers). كيفية التعامل مع Ajax من طرف الخادم. الجوهرة Turbolinks. مقدمة لفهم Ajax لفهم أجاكس، يجب أولًا فهم ما يفعله متصفّح الويب بشكل طبيعي. عندما تكتب http://localhost:3000 في شريط عنوان المتصفّح وتضغط على "Go" ، يقدّم المتصفح ("العميل") طلبًا للخادم، ويفرز الاستجابة ثم يجلب ...
الخاصية .jquery في jQuery
الخاصية .jquery القيم المعادة تعيد سلسلة نصية من النوع String. الوصف يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. jquery أُضيف مع الإصدار: 1.0. الخاصِّيَّة .jquery هي سلسلة نصية تحتوي على رقم إصدار jQuery مثل "1.5.0" أو "1.4.4"، وتُسند إلى نموذج jQuery الأولي، ويشار إليها عادةً عبر الاسم البديل $.fn. أمثلة تحديد إن كان كائنٌ ما هو كائن jQuery: $(function() {
// أصبحت الصفحة جاهزة
});
استعمال اختصار للشكل $(document).ready() ووسيط لكتابة شيفرة الفشل الآمن (failsafe) في jQuery ...
المحدد :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 "مرحبًا";
});
$( ...
التابع .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 على جهازٍ ذي مواصفات منخفضة. يواجه المستخدمون مشكلاتٍ في إمكانيَّة الوصول مع الحركات. يمكن إيقاف هذا السلوك وتشغيل الحركات ...
التابع .get() في jQuery
يجلب عناصر DOM المطابقة والمخزنة في كائن jQuery. .get( index ) الوصف يعيد هذا التابع عنصرًا واحدًا من العناصر الموجودة في كائن jQuery. .get( index ) index فهرس صفري من النوع Number (عدد صحيح) يشير إلى العنصر المراد إعادته. يوفر التابع .get() إمكانية الوصول إلى كل عناصر DOM الموجودة في كل كائن jQuery. إذا كانت قيمة الفهرس index خارج المجال (أي أصغر من عدد العناصر الموجودة ضمن الكائن – أي قيمة سالبة – أو أكبر أو تساوي عدد هذه العناصر)، ...
التابع .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 يختلف تمامًا عن ...
الخاصية event.target في jQuery
event.target القيمة المعادة تعيد كائنًا من النوع Element. الوصف تعيد هذه الخاصية عنصر DOM الذي بدأ الحدث. event.target أُضيفت مع الإصدار: 1.0. يمكن أن تكون الخاصية target هي العنصر لمُسجل للحدث أو لعناصره السليلة. غالبًا ما يكون من المفيد مقارنة event.target مع this لتحديد ما إذا كان الحدث يُعالج بسبب انتقال الحدث إلى العناصر الأب (event bubbling). هذه الخاصية مفيدة جدًا في تفويض الحدث، عند انتقال الحدث إلى العناصر الأب. أمثلة عرض اسم العنصر عند النقر عليه: <!doctype html>
<html lang="en">
<head>
...
التابع jQuery.ajax() في jQuery
jQuery.ajax( url [, settings ] ) القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف ترسل هذه الدالة طلب (Ajax) HTTP غير متزامن. jQuery.ajax( url [, settings ] ) أُضيف مع الإصدار: 1.5. url سلسلة نصية تحتوي على العنوان URL المراد إرسال الطلب إليه. settings كائن مجرَّد (object) يمثِّل مجموعة من الأزواج مفتاح/قيمة التي تضبط طلب Ajax. جميع الإعدادات اختيارية ويمكن تعيين إعدادات افتراضية لأي ضبط باستعمال التابع $.ajaxSetup(). انظر إلى القسم التالي للاطلاع على القائمة الكاملة لجميع الإعدادات. jQuery.ajax( [ ...
المحدد :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 وقد ...
المحدد :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">العنصر الجذر في هذا ...
التابع .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", ...
الخاصية 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 ...
المحدد :focus في jQuery
المحدد :focus الوصف يحدد العنصر إذا كان مُركّزًا عليه حاليًا. jQuery( ":focus" ) أُضيف مع الإصدار: 1.6. كما هو الحال مع الأصناف الزائفة الأخرى (تلك التي تبدأ بنقطتين رأسيتين :)، فمن المستحسن أن تسبق :focus باسم وسم أو مُحدِّد آخر؛ خلاف ذلك، يستخدم المحدد العالمي (*) كمحدد ضمني. وبعبارة أخرى ، فإن $( ":focus" ) يعادل $( "*:focus" ). بمعنى آخر، فإن $( ":focus" ) المجرد يعادل $( "*:focus" ). إذا كنت تبحث عن العنصر المُركّز حاليًا ، فسيقوم $( ...
المحدد :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 و الذي سنبحث عنه في مجموعة العناصر المطابقة. القيم المعادة إذا لم يُمرر ...
الخاصية 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 ) ...
الخاصية event.delegateTarget في jQuery
event.delegateTarget القيمة المعادة تُعيد كائنًا من النوع Element. الوصف العنصر المُرفق به معالج أحداث jQuery المُستدعى حاليًا. event.delegateTarget أُضيف مع الإصدار: 1.7. تفيد هذه الخاصية عادةً في الأحداث المُفوَضة (delegated events) التي رُبِطَت بالحدث باستخدام التابع .delegate() أو التابع .on()، عندما يرتبط معالج الحدث بالعنصر الأب للعنصر المُعالَج. على سبيل المثال، فيمكن استخدامه لتحديد وإزالة معالجات الأحداث في نقطة التفويض. بالنسبة إلى معالجات الأحداث غير المُفوَّضة المرفقة مباشرةً بعنصرٍ ما، وتكون الخاصية event.delegateTarget مساويةً دومًا للخاصية event.currentTarget. أمثلة عند النقر ...
التعامل مع البيانات في jQuery
يوفر هذا القسم مجموعة من التوابع التي تستعمل من أجل ربط بيانات محدَّدة مع عنصر محدَّد (أو مجموعة عناصر محدَّدة) وقراءة تلك البيانات لاحقًا. .data() يخزِّن التابع .data() بيانات عشوائية مرتبطة بالعناصر المتطابقة أو تُعيد القيمة في مخزن البيانات المحدد للعنصر الأول في مجموعة العناصر المتطابقة. jQuery.data() يخزِّن هذا التابع بيانات اعتباطيَّة ويقرنها بعنصر محدَّد، ويعيد القيمة التي ضُبِطَت. jQuery.hasData() يتحقَّق هذا التابع إن كان يملك عنصرٌ محدَّدٌ أيَّةَ بياناتٍ مرتبطةٍ به. jQuery.proxy() يأخذ هذا التابع دالةً ويعيد أخرى جديدة ...
الخاصية 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 ...
الخاصية jQuery.ready في jQuery
jQuery.ready القيم المعادة قيمة هذا الخاصية هي من النوع Thenable. الوصف هذه الخاصية هي كائنٌ شبيه بالكائن Pormise (يدعى Thenable) التي تستبين عن اللحظة الزمنيَّة التي يصبح فيها المستند جاهزًا. jQuery.ready أُضيف مع الإصدار: 1.8. بدءًا من الإصدار jQuery 3.0، أصبح بالإمكان استعمال الكائن الذي يعيده هذا التابع مع التابع jQuery.when() والتابع jQuery.resolve() الأساسي. لا يجب أن تبني الشيفرة أيَّة افتراضات تتعلق فيما إذا كان هذا الكائن هو jQuery.Deferred، أو Promise، أو أي نوع آخر من أنواع الكائن Promise. انظر ...
الخاصية event.target في jQuery
event.target القيمة المعادة تعيد كائنًا من النوع Element. الوصف تعيد هذه الخاصية عنصر DOM الذي بدأ الحدث. event.target أُضيفت مع الإصدار: 1.0. يمكن أن تكون الخاصية target هي العنصر لمُسجل للحدث أو لعناصره السليلة. غالبًا ما يكون من المفيد مقارنة event.target مع this لتحديد ما إذا كان الحدث يُعالج بسبب انتقال الحدث إلى العناصر الأب (event bubbling). هذه الخاصية مفيدة جدًا في تفويض الحدث، عند انتقال الحدث إلى العناصر الأب. أمثلة عرض اسم العنصر عند النقر عليه: <!doctype html>
<html lang="en">
<head>
...
الخاصية event.metaKey في jQuery
event.metaKey القيمة المعادة يُعيد كائنًا من النوع Boolean. الوصف تشير هذه الخاصية إذا ما كان مفتاح META مضغوطًا عند إطلاق الحدث. event.metaKey أُضيفت مع الإصدار: 1.0.4 تعيد هذه الخاصية قيمة منطقية ( true أو false ) تشير إلى ما إذا كان مفتاح META مضغوط عليه في وقت إطلاق الحدث. قد يشير هذا المفتاح إلى اسم مفتاح بديل في بعض الأنظمة. في لوحات مفاتيح ماك ، يشير مفتاح META إلى مفتاح Command (⌘). في لوحات مفاتيح ويندوز، يشير مفتاح META إلى ...
التابع jQuery.ajax() في jQuery
jQuery.ajax( url [, settings ] ) القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف ترسل هذه الدالة طلب (Ajax) HTTP غير متزامن. jQuery.ajax( url [, settings ] ) أُضيف مع الإصدار: 1.5. url سلسلة نصية تحتوي على العنوان URL المراد إرسال الطلب إليه. settings كائن مجرَّد (object) يمثِّل مجموعة من الأزواج مفتاح/قيمة التي تضبط طلب Ajax. جميع الإعدادات اختيارية ويمكن تعيين إعدادات افتراضية لأي ضبط باستعمال التابع $.ajaxSetup(). انظر إلى القسم التالي للاطلاع على القائمة الكاملة لجميع الإعدادات. jQuery.ajax( [ ...
التابع .height() في jQuery
يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة. .height() القيم المعادة عدد من النوع Number. الوصف يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة سابقًا. .height() أضيف مع الإصدار 1.0، ولا يقبل هذا التابع أي معاملات. الفرق بين التابع .css( "height" ) والتابع .height() هو أن الأخير يعيد قيمة الطول بدون واحدة (يعيد 400 مثلًا)، بينما يعيد التابع الأول قيمة الطول مع واحدة (يعيد 400px مثلًا). يفضل استعمال ...
عرض (250 السابقة | 250 التالية) (20 | 50 | 100 | 250 | 500).