المحدد ‎‎:contains()‎‎ في jQuery

من موسوعة حسوب

المحدد ‎:contains()

الوصف

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

‎jQuery( ":contains(text)" )‎

أضيفت في الإصدار: 1.1.4.

text

سلسلة نصيّة، وتُمثِّل النص المطلوب البحث عنه. وهي حسّاسة لحالة الأحرف.

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

أمثلة

إيجاد كافّة عناصر <div‎> التي تحتوي على الكلمة John ووضع خط تحتها:

<!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>

مصادر