عرض مصدر jQuery/contains selector

<noinclude>{{DISPLAYTITLE:المحدد <code>‎‎:contains()‎</code>‎ في jQuery}}</noinclude>
== المحدد <code>‎:contains()</code>‎ ==

=== الوصف ===
يُستخدَم المُحدِّد ‎<code>:contains()‎</code> لتحديد كافّة العناصر التي تحتوي على النص المطلوب.

=== <code>‎jQuery( ":contains(text)" )‎</code> ===
أضيفت في الإصدار: 1.1.4.

==== <code>text</code> ====
[[JavaScript/String|سلسلة نصيّة]]، وتُمثِّل النص المطلوب البحث عنه. وهي حسّاسة لحالة الأحرف.

يُمكِن للنص المُطابِق أن يظهر مباشرةً بداخل العنصر المُحدَّد، أو في أي من العناصر المُنحدِرة عنه، أو مزيج من ذلك. وكما هو الحال مع مُحدِّدات قيم خاصيّات HTML، يُمكِن للنص الموجود بين قوسي التّابع ‎<code>:contains()</code>‎ أن يُكتَب على هيئة كلمة مُجرَّدة أو مُحاطًا بعلامتي اقتباس. يجب أن يحتوي النص على حالة تطابق حتى يُحدَّد.

=== أمثلة ===
إيجاد كافّة عناصر <code>[[HTML/div|<div‎>]]</code> التي تحتوي على الكلمة <code>John</code> ووضع خط تحتها:<syntaxhighlight lang="html">
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>contains مثال عن التّابع</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<div>John Resig</div>
<div>George Martin</div>
<div>Malcom John Sinclair</div>
<div>J. Ohn</div>
 
<script>
$( "div:contains('John')" ).css( "text-decoration", "underline" );
</script>
 
</body>
</html>
</syntaxhighlight>

==<span>مصادر</span>==
*<span>[http://api.jquery.com/contains-selector/ صفحة المحدد ‎‎:contains()‎ في توثيق jQuery الرسمي].</span>
[[تصنيف:jQuery]]
[[تصنيف:jQuery Selectors]]