التابع .size() في jQuery
< jQuery
اذهب إلى التنقل
اذهب إلى البحث
.size()
أهمل هذا التابع في الإصدار: 1.8، وحذف في الإصدار: 3.0.
القيم المعادة
يعيد عددًا من النوع Number.
الوصف
يعيد هذا التابع عدد العناصر الموجودة في كائن jQuery محدَّد.
.size()
أُضيف مع الإصدار: 1.0. لا يقبل هذا التابع أية وسائط.
أهمل التابع .size() بدءًا من الإصدار jQuery 1.8، لذا استعمل الخاصِّيَّة .length عوضًا عنه.
يكافئ التابع .size() وظيفيًا الخاصِّيَّة .length. على أي حال، يفضل استعمال الخاصِّيَّة .length لأنها لا تسبب حملًا زائدًا كما يفعل استدعاء دالةٍ ما.
إن كان لدينا قائمة غير مرتبة <ul> في الصفحة:
<ul>
<li>أحمد</li>
<li>عبد المعطي</li>
</ul>
يعطي التابع .size() والخاصِّيَّة .length كلاهما عدد عناصر هذه القائمة:
alert( "الحجم: " + $( "li" ).size() );
alert( "الحجم: " + $( "li" ).length );
ستكون النتيجة إصدار التنبيهين التاليين:
الحجم: 2
الحجم: 2
أمثلة
إيجاد عدد العناصر <div>، ويمكن إضافة عنصر آخر بالضغط على أحدها:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>size مثالٌ عن استعمال التابع</title>
<style>
body {
cursor: pointer;
min-height: 100px;
}
div {
width: 50px;
height: 30px;
margin: 5px;
float: left;
background: blue;
}
span {
color: red;
}
</style>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<span></span>
<div></div>
<script>
$( document.body )
.click(function() {
$( this ).append( $( "<div>" ) );
var n = $( "div" ).size();
$( "span" ).text( "There are " + n + " divs. Click to add more." );
})
// Trigger the click to start
.click();
</script>
</body>
</html>