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

المحدد `‎:lang()‎`

الوصف

يختار هذا المحدِّد جميع العناصر التي تشترك بلغة معيَّنة.

`jQuery( ":lang(language)" )‎`

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

`language`

رمز لغة العناصر المراد تحديدها.

يطابق المحدد ‎:lang()‎ العناصر التي تمتلك قيمة لغة مساوية إلى رمز اللغة المعطى أو القيمة التي تبدأ برمز اللغة المعطى ثم تُتيع بالمحرف "-" مباشرةً. سيطابق مثلًا المحدِّد ‎$("div:lang(en)")‎ العنصر <div lang="en"‎> والعنصر <div lang="en-us"‎> وأي عناصر سليلة لهما، ولكن لن يطابق العنصر <div lang="ar"‎>.

تُحدَّد قيمة اللغة في عناصر HTML باستعمال الخاصية lang وقد تحدَّد أحيانًا من معلومات العناصر <meta> أو ترويسة HTTP.

نقاشات وتفاصيل أوسع حول هذا الاستخدام تجدها في مواصفة W3C CSS.

أمثلة

تلوين عناصر <div> بألوان مختلفة تبعًا للغتها:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>lang مثالٌ عن استعمال المحدد</title>
  <style>
  body {
    background-color: #ccc;
  }
  h3 {
    margin: .25em 0;
  }
  div {
    line-height: 1.5em
  }
  .eg {
    background-color: #f00;
    color: #fff;
  }
  .eg .eg {
    background-color: #fff;
    color: #000;
  }
  .eg .eg .eg {
    background-color: #000;
    color: #fff;
  }
  .spain {
    background-color: #f00;
    color: #ff0;
  }
  .spain .spain {
    background-color: #ff0;
    color: #f00;
    line-height: 3em;
  }
  .spain .spain .spain {
    background-color: #f00;
    color: #ff0;
    line-height: 1.5em;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<h3>مصر</h3>
<div lang="ar-eg">أحمر
  <div>أبيض
    <div>أسود</div>
  </div>
</div>
<h3>España</h3>
<div lang="es-es">rojo
  <div>amarillo
    <div>y rojo</div>
  </div>
</div>
 
<script>
$( "div:lang(ar-eg)" ).addClass( "eg" );
$( "div:lang(es-es)" ).addClass( "spain" );
</script>
 
</body>
</html>

مصادر

صفحة المحدِّد ‎‎:lang()‎ في توثيق jQuery الرسمي.