الفرق بين المراجعتين لصفحة: «jQuery/jQuery/isFunction»

من موسوعة حسوب
< jQuery‏ | jQuery
مرئينص الويكي
إضافة محتويات الصفحة.
 
إضافة محتويات الصفحة.
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:التابع <code>‎‎jQuery.isEmptyObject()‎</code>‎ في jQuery}}</noinclude>
<noinclude>{{DISPLAYTITLE:التابع <code>‎‎jQuery.isFunction()‎</code>‎ في jQuery}}</noinclude>
== <code>jQuery.isEmptyObject( object )‎</code> ==
== <code>jQuery.isFunction( value )‎</code> ==
أهمل مع الإصدار: 3.3.


=== القيم المعادة ===
=== القيم المعادة ===
سطر 6: سطر 7:


=== الوصف ===
=== الوصف ===
يتحقَّق هذا التابع إن كان الكائن المُمرَّر إليه فارغًا (لا يحوي أيَّة خاصِّيَّة قابلة للإحصاء) أم لا.
يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه دالةَ ردِّ نداءٍ أم لا.


=== <code>jQuery.isEmptyObject( object )‎</code> ===
=== <code>jQuery.isFunction( value )‎</code> ===
أُضيف مع الإصدار: 1.4.
أُضيف مع الإصدار: 1.2.


==== <code>objcet</code> ====
==== <code>value</code> ====
الكائن المراد التحقُّق منه لمعرفة إن كان فارغًا أم لا.
أي شيء، ويمثل القيمة المراد التحقُّق منها.


بدءًا من الإصدار jQuery 1.4، أصبح هذا التابع يتحقَّق من خاصِّيَّات الكائن نفسه، والخاصِّيَّات الموروثة عبر سلسلة <code>prototypes</code> (لا يستخدم هنا <code>hasOwnProperty</code>). يجب أن يكون الوسيط المعطى [[JavaScript/Object|كائن JavaScript مجرَّد]] (Object)، إذ قد لا تعطي أنواع الكائنات الأخرى (مثل عناصر DOM، [[JavaScript/Number|والأعداد]] أو [[JavaScript/String|السلاسل النصية]] الأوليَّة، وكائنات المضيف ...إلخ.) نتائج ثابتة عبر المتصفحات. لتحديد إن كان الكائن المعطى [[JavaScript/Object|كائن JavaScript مجرَّد]]، استعمل التابع <code>[[jQuery/jQuery/isPlainObject|‎$.isPlainObject()‎]]</code>.
بدءًا من الإصدار jQuery 3.3، أصبح التابع <code>jQuery.isFunction()‎</code> مهملًا. في أغلب الحالات، يمكن الاستعاضة عن استعمال هذا التابع عبر استخدام <code>typeof x === "function"‎</code>.
 
'''ملاحظة''': بدءًا من الإصدار jQuery 1.3، لا يُضمن أن تُكتشَف الدوال التي يوفِّرها المتصفح، مثل <code>alert()</code>‎ وتوابع عناصر DOM مثل <code>getAttribute()‎</code>، كدوالٍ في بعض المتصفحات مثل المتصفح IE.


=== أمثلة ===
=== أمثلة ===
التحقُّق إن كان الكائن المعطى فارغًا أم لا:<syntaxhighlight lang="javascript">
التحقُّق من بعض القيم الممرَّرة إن كانت دوالًا أم لا:<syntaxhighlight lang="html">
jQuery.isEmptyObject({}); // true
<!doctype html>
jQuery.isEmptyObject({ foo: "bar" }); // false
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.isFunction مثالٌ عن استعمال التابع</title>
  <style>
  div {
    color: blue;
    margin: 2px;
    font-size: 14px;
  }
  span {
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<div>jQuery.isFunction( objs[ 0 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 1 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 2 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 3 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 4 ] ) = <span></span></div>
<script>
function stub() {}
var objs = [
  function() {},
  { x:15, y:20 },
  null,
  stub,
  "function"
];
jQuery.each( objs, function( i ) {
  var isFunc = jQuery.isFunction( objs[ i ]);
  $( "span" ).eq( i ).text( isFunc );
});
</script>
</body>
</html>
 
</syntaxhighlight>سنحصل عند تنفيذ هذه الشيفرة على النتيجة التالية:<syntaxhighlight lang="text">
jQuery.isFunction( objs[ 0 ] ) = true
jQuery.isFunction( objs[ 1 ] ) = false
jQuery.isFunction( objs[ 2 ] ) = false
jQuery.isFunction( objs[ 3 ] ) = true
jQuery.isFunction( objs[ 4 ] ) = false


</syntaxhighlight>التحقُّق إن كان الوسيط المعطى دالةً:<syntaxhighlight lang="javascript">
$.isFunction(function() {});
</syntaxhighlight>سنحصل عند تنفيذ هذه الشيفرة على النتيجة التالية:<syntaxhighlight lang="text">
true
</syntaxhighlight>
</syntaxhighlight>


== مصادر ==
== مصادر ==
* [http://api.jquery.com/jQuery.isEmptyObject/ صفحة التابع ()jQuery.isEmptyObject في توثيق jQuery الرسمي.]
* [http://api.jquery.com/jQuery.isFunction/ صفحة التابع ()jQuery.isFunction في توثيق jQuery الرسمي.]
[[تصنيف:jQuery]]
[[تصنيف:jQuery]]
[[تصنيف:jQuery Method]]
[[تصنيف:jQuery Method]]
[[تصنيف:jQuery Deprecated]]
[[تصنيف:jQuery Utilities]]
[[تصنيف:jQuery Utilities]]

المراجعة الحالية بتاريخ 17:26، 30 يونيو 2018

jQuery.isFunction( value )‎

أهمل مع الإصدار: 3.3.

القيم المعادة

يعيد قيمةً منطقيَّةً (Boolean).

الوصف

يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه دالةَ ردِّ نداءٍ أم لا.

jQuery.isFunction( value )‎

أُضيف مع الإصدار: 1.2.

value

أي شيء، ويمثل القيمة المراد التحقُّق منها.

بدءًا من الإصدار jQuery 3.3، أصبح التابع jQuery.isFunction()‎ مهملًا. في أغلب الحالات، يمكن الاستعاضة عن استعمال هذا التابع عبر استخدام typeof x === "function"‎.

ملاحظة: بدءًا من الإصدار jQuery 1.3، لا يُضمن أن تُكتشَف الدوال التي يوفِّرها المتصفح، مثل alert()‎ وتوابع عناصر DOM مثل getAttribute()‎، كدوالٍ في بعض المتصفحات مثل المتصفح IE.

أمثلة

التحقُّق من بعض القيم الممرَّرة إن كانت دوالًا أم لا:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>jQuery.isFunction مثالٌ عن استعمال التابع</title>
  <style>
  div {
    color: blue;
    margin: 2px;
    font-size: 14px;
  }
  span {
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<div>jQuery.isFunction( objs[ 0 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 1 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 2 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 3 ] ) = <span></span></div>
<div>jQuery.isFunction( objs[ 4 ] ) = <span></span></div>
 
<script>
function stub() {}
var objs = [
  function() {},
  { x:15, y:20 },
  null,
  stub,
  "function"
];
 
jQuery.each( objs, function( i ) {
  var isFunc = jQuery.isFunction( objs[ i ]);
  $( "span" ).eq( i ).text( isFunc );
});
</script>
 
</body>
</html>

سنحصل عند تنفيذ هذه الشيفرة على النتيجة التالية:

jQuery.isFunction( objs[ 0 ] ) = true
jQuery.isFunction( objs[ 1 ] ) = false
jQuery.isFunction( objs[ 2 ] ) = false
jQuery.isFunction( objs[ 3 ] ) = true
jQuery.isFunction( objs[ 4 ] ) = false

التحقُّق إن كان الوسيط المعطى دالةً:

$.isFunction(function() {});

سنحصل عند تنفيذ هذه الشيفرة على النتيجة التالية:

true

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=jQuery/jQuery/isFunction&oldid=11551»