عرض مصدر jQuery/has

<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.has()‎</code>‎ في jQuery}}</noinclude>
== <code>‎.has(selector)‎</code> ==

=== القيم المعادة ===
يُعيد كائنًا من النوع [[jQuery/jQuery|jQuery]].

=== الوصف ===
يختار هذا التابع من العناصر التي حُدِّدَت مسبقًا العناصرَ السليلة منها التي تحقق الشروط المطلوبة في المحددات أو تطابق عنصر DOM.

=== <code>‎.has( selector )‎</code> ===
أضيف مع الإصدار: 1.4.

==== <code>selector</code> ====
سلسلة نصية من الكائن [[JavaScript/String|String]]، وتحتوي على تعبير المحدد لمطابقة عناصر معينة.

=== <code>‎.has( contained )‎</code> ===
أضيف مع الإصدار: 1.4.

==== <code>contained</code> ====
عنصر، وهو عنصر من شجرة DOM لاختيار الأب الذي يضمه.

لنفترض أنه لدينا كائن jQuery والذي يمثل مجموعة من عناصر DOM، فسينشئ التابع <code>‎.has()‎</code> كائن jQuery جديد يحتوي على مجموعة فرعية من المجموعة الأولى، والتي تحتوي على عناصر من المجموعة الأولى التي تُطابِق العناصر السليلة منها الشرط المُمرَّر إلى هذا التابع.

نأخذ مثالًا لصفحة تحتوي على قائمة غير مرتبة <code>[[HTML/ul|<nowiki><ul></nowiki>]]</code> متشعبة (أي يوجد عنصر <code>[[HTML/ul|<nowiki><ul></nowiki>]]</code> داخل عنصر <code>[[HTML/li|<nowiki><li></nowiki>]]</code>):<syntaxhighlight lang="html">
<ul>
  <li>list item 1</li>
  <li>list item 2
	<ul>
      <li>list item 2-a</li>
      <li>list item 2-b</li>
	</ul>
  </li>
  <li>list item 3</li>
  <li>list item 4</li>
</ul>
</syntaxhighlight>يمكننا تطبيق التابع <code>()has.</code> على العناصر <code>[[HTML/li|<nowiki><li></nowiki>]]</code> الموجودة في الصفحة مثل:<syntaxhighlight lang="html">
$( "li" ).has( "ul" ).css( "background-color", "red" );
</syntaxhighlight>ستكون نتيجة تشغيل هذه الشيفرة تلوينَ خلفية العنصر item 2 باللون الأحمر لأنه العنصر <code>[[HTML/li|<nowiki><li></nowiki>]]</code> الوحيد الذي له عنصر <code>[[HTML/ul|<nowiki><ul></nowiki>]]</code> من بين العناصر السليلة.

=== أمثلة ===
التحقق إن كان العنصر موجودًا ضمن عنصر آخر:<syntaxhighlight lang="html">
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>has demo</title>
  <style>
  .full {
	border: 1px solid red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<ul><li>Does the UL contain an LI?</li></ul>
 
<script>
$( "ul" ).append( "<li>" +
  ( $( "ul" ).has( "li" ).length ? "Yes" : "No" ) +
  "</li>" );
$( "ul" ).has( "li" ).addClass( "full" );
</script>
 
</body>
</html>
</syntaxhighlight>

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