الفرق بين المراجعتين لصفحة: «jQuery/deferred»
Khaled-yassin (نقاش | مساهمات) |
Khaled-yassin (نقاش | مساهمات) |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الفئة: الكائن المؤجل (Deferred Object)}}</noinclude> | <noinclude>{{DISPLAYTITLE:الفئة: الكائن المؤجل (Deferred Object)}}</noinclude> | ||
قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع <code>jQuery.Deferred()</code>. ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة. | |||
يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير. | يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير. | ||
| سطر 45: | سطر 45: | ||
=== <code>deferred.reject()</code> === | === <code>deferred.reject()</code> === | ||
رفض | رفض كائن مؤجلًا واستدعاء أي failCallbacks مع الوسائط args المُحدَدة. | ||
=== <code>deferred.rejectWith()</code> === | === <code>deferred.rejectWith()</code> === | ||
رفض | رفض كائن مؤجلًا واستدعاء أي failCallbacks مع السياق والوسائط args المُحدَدة. | ||
=== <code>deferred.resolve()</code> === | === <code>deferred.resolve()</code> === | ||
قبول | قبول كائن مؤجلًا واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة. | ||
=== deferred.<code>resolveWith</code>() === | === deferred.<code>resolveWith</code>() === | ||
قبول | قبول كائن مؤجلًا واستدعاء أي doneCallbacks مع السياق الوسائط args المُحدَدة. | ||
=== <code>deferred.state()</code> === | === <code>deferred.state()</code> === | ||
| سطر 74: | سطر 74: | ||
== مصادر == | == مصادر == | ||
* صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي. | * صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي. | ||
[[تصنيف:jQuery]] | [[تصنيف:jQuery]] | ||
[[تصنيف:jQuery Method]] | [[تصنيف:jQuery Method]] | ||
[[تصنيف:jQuery Deferred]] | [[تصنيف:jQuery Deferred]] | ||
مراجعة 22:25، 7 مايو 2018
قُدِّم الكائن المؤجل في الإصدار jQuery 1.5، وهو كائن أداة قابل للتسلسل ينشأ عن طريق استدعاء التابع jQuery.Deferred(). ويمكنه تسجيل عدة دوال رد اتصال في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة.
يكون الكائن المؤجل قابلاً للتسلسل، مماثلاً للطريقة التي يكون فيها كائن jQuery قابلاً للتسلسل، ولكن له توابعه الخاصة. بعد إنشاء كائن مؤجل، يمكنك استخدام أي من التوابع المذكورة أدناه إما بالتسلسل مباشرة من إنشاء الكائن، أو حفظ الكائن في متغير واستدعاء تابع أو أكثر على ذلك المتغير.
deferred.always()
إضافة معالجات تُستدعَى عند حل الكائن المؤجل أو رفضه.
deferred.catch()
إضافة معالجات تُستدعى عند رفض الكائن المؤجل.
deferred.done()
إضافة معالجات تستدعى عند حل الكائن المؤجل.
deferred.fail()
إضافة معالجات تُستدعى عند رفض الكائن المؤجل.
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة.
deferred.isRejected()
تحديد ما إذا كان الكائن المؤجل قد رُفِض.
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.7 | التوابع المُزالة.
deferred.isResolved()
تحديد ما إذا كان الكائن المؤجل قد قُبِل.
deferred.notify()
استدعاء دالة progressCallbacks لكائن مؤجل بواسطة الوسائط args المعطاة.
deferred.notifyWith()
استدعاء دالة progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args والسياق context المعطاة.
موجود أيضًا في: التوابع المُهملة > التوابع المُهملة في الإصدار 1.8 {3}|{/3}
deferred.pipe()
تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة.
deferred.progress()
إضافة معالجات تُستدعى عندما ينتج الكائن المؤجل إشعارات التقدُّم.
deferred.promise()
إعادة كائن Promise للكائن المؤجل.
deferred.reject()
رفض كائن مؤجلًا واستدعاء أي failCallbacks مع الوسائط args المُحدَدة.
deferred.rejectWith()
رفض كائن مؤجلًا واستدعاء أي failCallbacks مع السياق والوسائط args المُحدَدة.
deferred.resolve()
قبول كائن مؤجلًا واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة.
deferred.resolveWith()
قبول كائن مؤجلًا واستدعاء أي doneCallbacks مع السياق الوسائط args المُحدَدة.
deferred.state()
تحديد الحالة الحالية لكائن مؤجل.
deferred.then()
إضافة معالجات تُستدعى عند قبول الكائن المؤجل أو رفضه أو إذا ما زال قيد التنفيذ.
jQuery.Deferred().
دالة مصنع تقوم بإعادة كائن أداة متسلسل مع توابع لتسجيل عدة دوال رد النداء في صفوف رد الاتصال، واستدعاء هذه الصفوف، ونقل حالة النجاح أو الفشل لأي دالة متزامنة أو غير متزامنة.
موجود أيضًا في: القلب
jQuery.when()
نوفير طريقة لتنفيذ دوال رد الاتصال استنادًا إلى صفر أو أكثر من كائنات قابلة للعمليات Then، وعادة ما تكون الكائنات المؤجلة التي تمثل الأحداث غير المتزامنة.
.promise()
إعادة كائن Promise لمراقبة الانتهاء من كافة الإجراءات من نوع معين مرتبط بالمجموعة، أو في صفوف الانتظار أو لا.
مصادر
- صفحة الكائن المؤجل (Deferred Object) في توثيق jQuery الرسمي.