الفرق بين المراجعتين ل"jQuery/deferred"
Khaled-yassin (نقاش | مساهمات) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
(3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE | + | <noinclude>{{DISPLAYTITLE:الكائن المؤجل (Deferred Object)}}</noinclude> |
− | + | قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع <code>jQuery.Deferred()</code>. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة. | |
− | |||
يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير. | يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير. | ||
− | + | ===<code>[[jQuery/deferred/always|deferred.always()]]</code>=== | |
− | === <code>deferred.always() | + | يُضيف هذا التابع معالجات تُستدعَى عند حل الكائن المؤجل Deferred أو رفضه. |
− | + | ===<code>[[jQuery/deferred/catch|deferred.catch()]]</code>=== | |
− | + | يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred. | |
− | === <code>deferred.catch() | + | ===<code>[[jQuery/deferred/done|deferred.done()]]</code>=== |
− | + | يُضيف هذا التابع معالجات تستدعى عند حل الكائن المؤجل Deferred. | |
− | + | ===<code>[[jQuery/deferred/fail|deferred.fail()]]</code>=== | |
− | === <code>deferred.done() | + | يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred. |
− | + | === <code>[[jQuery/deferred/isRejected|deferred.isRejected()]]</code> === | |
− | |||
− | === <code>deferred.fail() | ||
− | |||
− | |||
− | |||
− | |||
− | === <code>deferred.isRejected()</code> === | ||
تحديد ما إذا كان الكائن المؤجل قد رُفِض. | تحديد ما إذا كان الكائن المؤجل قد رُفِض. | ||
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة. | موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة. | ||
− | === <code>deferred.isResolved()</code> === | + | === <code>[[jQuery/deferred/isResolved|deferred.isResolved()]]</code> === |
تحديد ما إذا كان الكائن المؤجل قد قُبِل. | تحديد ما إذا كان الكائن المؤجل قد قُبِل. | ||
− | + | ===<code>[[jQuery/deferred/notify|deferred.notify()]]</code>=== | |
− | === <code>deferred.notify() | + | يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط <code>args</code> المعطاة. |
− | + | ===<code>[[jQuery/deferred/notifyWith|deferred.notifyWith()]]</code>=== | |
− | + | يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط <code>args</code> والسياق context المعطاة. | |
− | === <code>deferred.notifyWith() | + | ===<code>[[jQuery/deferred/pipe|deferred.pipe()]]</code>=== |
− | + | تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds. | |
− | + | ===<code>[[jQuery/deferred/progress|deferred.progress()]]</code>=== | |
− | + | يُضيف هذا التابع معالجات تستدعى عندما ينتج الكائن المؤجل Deferred إشعارات التقدُّم. | |
− | + | ===<code>[[jQuery/deferred/promise|deferred.promise()]]</code>=== | |
− | === <code>deferred.pipe() | + | يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred. |
− | تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة. | + | ===<code>[[jQuery/deferred/reject|deferred.reject()]]</code>=== |
− | + | يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط <code>args</code> المُعطى. | |
− | === <code>deferred.progress() | + | ===<code>[[jQuery/deferred/rejectWith|deferred.rejectWith()]]</code>=== |
− | + | يرفض هذا التابع كائنًا مؤجلًا Deferred ويستدعي أي <code>failCallbacks</code> مع سياق <code>context</code> ووسائط <code>args</code> محددة. | |
− | + | ===<code>[[jQuery/deferred/resolve|deferred.resolve()]]</code>=== | |
− | === <code>deferred.promise() | + | قبول كائن مؤجل واستدعاء أي <code>doneCallbacks</code> مع الوسائط <code>args</code> المُحدَدة. |
− | + | ===<code>[[jQuery/deferred/resolveWith|deferred.resolveWith()]]</code>=== | |
− | + | يقبل كائن مؤجل ويستدعي أي <code>doneCallbacks</code> مع السياق <code>context</code> والوسائط <code>args</code> المُحدَدة. | |
− | === <code>deferred.reject() | + | ===<code>[[jQuery/deferred/state|deferred.state()]]</code>=== |
− | + | يُحدد هذا التابع الحالة الحالية لكائن مؤجل. | |
− | + | ===<code>[[jQuery/deferred/then|deferred.then()]]</code>=== | |
− | === <code>deferred.rejectWith() | + | يُضيف هذا التابع معالجات تُستدعَى عند قبول الكائن المؤجل أو رفضه أو ما زال قيد التقدم. |
− | + | ===<code>[[jQuery/jQuery/Deferred|jQuery.Deferred()]]</code>=== | |
− | + | هذه الدالة هي دالةٌ منتجة (factory function) تعيد كائن أداةٍ قابل للتسلسل (chainable utility object) يمكن استعمال مجموعة من التوابع مع هذا الكائن لتسجيل عدَّة دوال رد نداءٍ في طوابير ردود النداء (callback queues)، واستدعاء هذه الطوابير فيما بعد، ونقل حالة النجاح (success state) أو الفشل (failure state) لأي دالة متزامنة (synchronous) أو غير متزامنة (asynchronous). | |
− | === <code>deferred.resolve() | + | === <code>[[jQuery/jQuery/when|jQuery.when()]]</code> === |
− | قبول | ||
− | |||
− | === | ||
− | |||
− | |||
− | === <code>deferred.state() | ||
− | |||
− | |||
− | === <code>deferred.then() | ||
− | |||
− | |||
− | === <code>jQuery.Deferred() | ||
− | |||
− | |||
− | |||
− | |||
− | === <code>jQuery.when() | ||
نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة. | نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة. | ||
− | + | ===<code>[[jQuery/promise|.promise()]]</code>=== | |
− | === <code>.promise() | + | يعيد هذا التابع كائنًا من النوع promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة. |
− | |||
− | |||
== مصادر == | == مصادر == | ||
− | * صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي. | + | * [http://api.jquery.com/category/deferred-object/ صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي]. |
[[تصنيف:jQuery]] | [[تصنيف:jQuery]] | ||
[[تصنيف:jQuery Method]] | [[تصنيف:jQuery Method]] | ||
[[تصنيف:jQuery Deferred]] | [[تصنيف:jQuery Deferred]] |
المراجعة الحالية بتاريخ 15:02، 19 مارس 2019
قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع jQuery.Deferred()
. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة.
يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير.
deferred.always()
يُضيف هذا التابع معالجات تُستدعَى عند حل الكائن المؤجل Deferred أو رفضه.
deferred.catch()
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.
deferred.done()
يُضيف هذا التابع معالجات تستدعى عند حل الكائن المؤجل Deferred.
deferred.fail()
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.
deferred.isRejected()
تحديد ما إذا كان الكائن المؤجل قد رُفِض.
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة.
deferred.isResolved()
تحديد ما إذا كان الكائن المؤجل قد قُبِل.
deferred.notify()
يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args
المعطاة.
deferred.notifyWith()
يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args
والسياق context المعطاة.
deferred.pipe()
تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds.
deferred.progress()
يُضيف هذا التابع معالجات تستدعى عندما ينتج الكائن المؤجل Deferred إشعارات التقدُّم.
deferred.promise()
يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred.
deferred.reject()
يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط args
المُعطى.
deferred.rejectWith()
يرفض هذا التابع كائنًا مؤجلًا Deferred ويستدعي أي failCallbacks
مع سياق context
ووسائط args
محددة.
deferred.resolve()
قبول كائن مؤجل واستدعاء أي doneCallbacks
مع الوسائط args
المُحدَدة.
deferred.resolveWith()
يقبل كائن مؤجل ويستدعي أي doneCallbacks
مع السياق context
والوسائط args
المُحدَدة.
deferred.state()
يُحدد هذا التابع الحالة الحالية لكائن مؤجل.
deferred.then()
يُضيف هذا التابع معالجات تُستدعَى عند قبول الكائن المؤجل أو رفضه أو ما زال قيد التقدم.
jQuery.Deferred()
هذه الدالة هي دالةٌ منتجة (factory function) تعيد كائن أداةٍ قابل للتسلسل (chainable utility object) يمكن استعمال مجموعة من التوابع مع هذا الكائن لتسجيل عدَّة دوال رد نداءٍ في طوابير ردود النداء (callback queues)، واستدعاء هذه الطوابير فيما بعد، ونقل حالة النجاح (success state) أو الفشل (failure state) لأي دالة متزامنة (synchronous) أو غير متزامنة (asynchronous).
jQuery.when()
نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة.
.promise()
يعيد هذا التابع كائنًا من النوع promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة.