الفرق بين المراجعتين لصفحة: «jQuery/deferred»
Khaled-yassin (نقاش | مساهمات) |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE | <noinclude>{{DISPLAYTITLE:الكائن المؤجل (Deferred Object)}}</noinclude> | ||
قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع <code>jQuery.Deferred()</code>. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة. | قُدِّم الكائن المؤجل في الإصدار 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> === | ||
قبول كائن مؤجل واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة. | |||
=== | |||
=== <code>deferred.state() | |||
=== <code>deferred.then() | |||
=== <code>jQuery.Deferred() | |||
=== <code>jQuery.when() | |||
نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة. | نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة. | ||
===<code>[[jQuery/promise|.promise()]]</code>=== | |||
=== <code>.promise() | يعيد هذا التابع كائنًا من النوع promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة. | ||
== مصادر == | == مصادر == | ||
* [http://api.jquery.com/category/deferred-object/ صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي]. | * [http://api.jquery.com/category/deferred-object/ صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي]. | ||
المراجعة الحالية بتاريخ 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) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة.