الفرق بين المراجعتين لصفحة: «jQuery/error»
Khaled-yassin (نقاش | مساهمات) |
لا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 5: | سطر 5: | ||
يُعيد كائنًا من النوع [[jQuery/jQuery|jQuery]]. | يُعيد كائنًا من النوع [[jQuery/jQuery|jQuery]]. | ||
أُهمل مع الإصدار: [http://api.jquery.com/category/version/1.8 1.8]، | أُهمل مع الإصدار: [http://api.jquery.com/category/version/1.8 1.8]، وأُزيل مع الإصدار: [http://api.jquery.com/category/version/3.0 3.0]. | ||
=== الوصف === | === الوصف === | ||
| سطر 25: | سطر 25: | ||
دالة تنفذ عند تشغيل الحدث وهي على الشكل <code>[[JavaScript/Function|Function]]( [[JavaScript/Event|Event]] eventObject )</code>. | دالة تنفذ عند تشغيل الحدث وهي على الشكل <code>[[JavaScript/Function|Function]]( [[JavaScript/Event|Event]] eventObject )</code>. | ||
هذا التابع هو اختصار للتابع [[jQuery/on|.on( "error", handler )]]. | هذا التابع هو اختصار للتابع <code>[[jQuery/on|.on( "error", handler )]]</code>. | ||
بدءًا من إصدار jQuery 1.8، أُهمِل التابع <code>.error()</code> . استخدم <code>.on( "error", handler )</code> لإرفاق معالجات الأحداث إلى الحدث <code>error</code> بدلاً من ذلك. | |||
يُرسَل حدث <code>error</code> إلى العناصر، مثل الصور، التي يُرجَع إليها من المستند وتُحمَّل بواسطة المتصفح. ويستدعى إذا لم يُحمَّل العنصر بشكل صحيح. | |||
على سبيل المثال، تأمل هذه الصفحة وبها عنصر صورة بسيط:<syntaxhighlight lang="html"> | على سبيل المثال، تأمل هذه الصفحة وبها عنصر صورة بسيط:<syntaxhighlight lang="html"> | ||
| سطر 39: | سطر 39: | ||
}) | }) | ||
.attr( "src", "missing.png" ); | .attr( "src", "missing.png" ); | ||
</syntaxhighlight>إذا تعذر تحميل الصورة (على سبيل المثال، لأنها غير موجودة على عنوان URL المرفق)، | </syntaxhighlight>إذا تعذر تحميل الصورة (على سبيل المثال، لأنها غير موجودة على عنوان URL المرفق)، فسيعرض التنبيه:<syntaxhighlight lang="text"> | ||
Handler for .error() called. | Handler for .error() called. | ||
</syntaxhighlight>يجب إرفاق معالج الحدث قبل أن يطلق المتصفح الحدث <code>error</code>، ولذلك يضبط هذا المثال الخاصية <code>src</code> بعد إرفاق المعالج. أيضًا، قد لا ينطلق الحدث <code>error</code> بشكل صحيح عند عرض الصفحة محليًا؛ ويعتمد <code>error</code> على شيفرات حالة HTTP ولن تنطلق عمومًا إذا كان عنوان URL يستخدم البروتوكول <code>file:</code>. | </syntaxhighlight>يجب إرفاق معالج الحدث قبل أن يطلق المتصفح الحدث <code>error</code>، ولذلك يضبط هذا المثال الخاصية <code>src</code> بعد إرفاق المعالج. أيضًا، قد لا ينطلق الحدث <code>error</code> بشكل صحيح عند عرض الصفحة محليًا؛ ويعتمد <code>error</code> على شيفرات حالة HTTP ولن تنطلق عمومًا إذا كان عنوان URL يستخدم البروتوكول <code>file:</code>. | ||
ملاحظة: لا يجب إرفاق معالج أحداث <code>error</code> من النوع jQuery بكائن <code>window</code>. يقوم المتصفح بإطلاق حدث <code>error</code> الكائن <code>window</code> عند حدوث خطأ في | ملاحظة: لا يجب إرفاق معالج أحداث <code>error</code> من النوع jQuery بكائن <code>window</code>. يقوم المتصفح بإطلاق حدث <code>error</code> الكائن <code>window</code> عند حدوث خطأ في السكربت. ومع ذلك، يتلقى حدث <code>error</code> الكائن <code>window</code> وسائط مختلفة ولديه متطلبات قيمة معادة مختلفة عن معالجات الأحداث التقليدية. استخدم <code>window.onerror</code> بدلًا من ذلك. | ||
=== ملاحظات إضافية === | === ملاحظات إضافية === | ||
لما كان التابع <code>.error()</code> هو اختصار للتابع <code>.on( "error", handler )</code>، | لما كان التابع <code>.error()</code> هو اختصار للتابع <code>.on( "error", handler )</code>، فيمكن فصل دالة معالجة الحدث باستخدام <code>[[jQuery/off|.off( "error" )]]</code> . | ||
=== أمثلة === | === أمثلة === | ||
لتبديل كل الصور المفقودة إلى صور أخرى، يمكن تحديث الخاصية <code>src</code> داخل دالة رد النداء المُمرر إلى <code>.error()</code> . تأكد من وجود صورة الاستبدال؛ وإلا سينطلق الحدث <code>error</code> إلى أجل غير مسمى. إذا كانت الصورة <code>missing.png</code> مفقود، فستستبدل إلى الصورة <code>replacement.png</code>.<syntaxhighlight lang="jquery"> | |||
$( "img" ) | $( "img" ) | ||
.error(function() { | .error(function() { | ||
| سطر 60: | سطر 60: | ||
* [http://api.jquery.com/error/ صفحة المحدد .error() في توثيق jQuery الرسمي]. | * [http://api.jquery.com/error/ صفحة المحدد .error() في توثيق jQuery الرسمي]. | ||
[[تصنيف:jQuery]] | [[تصنيف:jQuery]] | ||
[[تصنيف:jQuery Deprecated]] | |||
[[تصنيف:jQuery Method]] | [[تصنيف:jQuery Method]] | ||
[[تصنيف:jQuery Events]] | [[تصنيف:jQuery Events]] | ||
المراجعة الحالية بتاريخ 09:10، 17 مايو 2018
.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
دالة تنفذ عند تشغيل الحدث وهي على الشكل Function( Event eventObject ).
هذا التابع هو اختصار للتابع .on( "error", handler ).
بدءًا من إصدار jQuery 1.8، أُهمِل التابع .error() . استخدم .on( "error", handler ) لإرفاق معالجات الأحداث إلى الحدث error بدلاً من ذلك.
يُرسَل حدث error إلى العناصر، مثل الصور، التي يُرجَع إليها من المستند وتُحمَّل بواسطة المتصفح. ويستدعى إذا لم يُحمَّل العنصر بشكل صحيح.
على سبيل المثال، تأمل هذه الصفحة وبها عنصر صورة بسيط:
<img alt="Book" id="book">
يمكن ربط معالج الحدث بالصورة:
$( "#book" )
.error(function() {
alert( "Handler for .error() called." )
})
.attr( "src", "missing.png" );
إذا تعذر تحميل الصورة (على سبيل المثال، لأنها غير موجودة على عنوان URL المرفق)، فسيعرض التنبيه:
Handler for .error() called.
يجب إرفاق معالج الحدث قبل أن يطلق المتصفح الحدث error، ولذلك يضبط هذا المثال الخاصية src بعد إرفاق المعالج. أيضًا، قد لا ينطلق الحدث error بشكل صحيح عند عرض الصفحة محليًا؛ ويعتمد error على شيفرات حالة HTTP ولن تنطلق عمومًا إذا كان عنوان URL يستخدم البروتوكول file:.
ملاحظة: لا يجب إرفاق معالج أحداث error من النوع jQuery بكائن window. يقوم المتصفح بإطلاق حدث error الكائن window عند حدوث خطأ في السكربت. ومع ذلك، يتلقى حدث error الكائن window وسائط مختلفة ولديه متطلبات قيمة معادة مختلفة عن معالجات الأحداث التقليدية. استخدم window.onerror بدلًا من ذلك.
ملاحظات إضافية
لما كان التابع .error() هو اختصار للتابع .on( "error", handler )، فيمكن فصل دالة معالجة الحدث باستخدام .off( "error" ) .
أمثلة
لتبديل كل الصور المفقودة إلى صور أخرى، يمكن تحديث الخاصية src داخل دالة رد النداء المُمرر إلى .error() . تأكد من وجود صورة الاستبدال؛ وإلا سينطلق الحدث error إلى أجل غير مسمى. إذا كانت الصورة missing.png مفقود، فستستبدل إلى الصورة replacement.png.
$( "img" )
.error(function() {
$( this ).attr( "src", "replacement.png" );
})
.attr( "src", "missing.png" );