jQuery 3.3

.wrapAll()




jquery

.wrapAll (wrappingElement) إرجاع: jQuery

الوصف ؛: التفاف هيكل HTML حول جميع العناصر في مجموعة من العناصر المتطابقة.

  • الإصدار المضافة: 1.2 التفافالكلمة (wrappingElement)

    • wrappingElement
      النوع: Selector أو htmlString أو Element أو jQuery
      محدد أو عنصر أو سلسلة HTML أو كائن jQuery يحدد الهيكل ليتم التفاف حول العناصر المطابقة.
  • الإصدار المضافة: 1.4 التفافكل (وظيفة)

    • وظيفة
      النوع: Function () => String أو jQuery
      وظيفة رد اتصال تقوم بإعادة محتوى HTML أو كائن jQuery إلى الالتفاف حول جميع العناصر المتطابقة. داخل الدالة ، يشير this إلى العنصر الأول في المجموعة. قبل jQuery 3.0 ، تم استدعاء رد الاتصال بشكل غير صحيح لكل عنصر في المجموعة واستلم موضع فهرس العنصر في المجموعة كوسيطة.

يمكن أن تأخذ الدالة .wrapAll() أي سلسلة أو كائن يمكن تمريره إلى الدالة $() لتحديد بنية DOM. قد تكون هذه البنية متداخلة عدة مستويات ، ولكن يجب أن تحتوي على عنصر واحد فقط. سيتم لف الهيكل حول جميع العناصر في مجموعة العناصر المتطابقة ، كمجموعة واحدة.

خذ بعين الاعتبار HTML التالية:

<div class="container">
  <div class="inner">Hello</div>
  <div class="inner">Goodbye</div>
</div>

باستخدام .wrapAll() ، يمكننا إدراج بنية HTML حول عناصر <div> الداخلية مثل:

$( ".inner" ).wrapAll( "<div class='new' />");

يتم إنشاء عنصر <div> الجديد على الطاير وإضافته إلى DOM. والنتيجة هي <div> جديدة ملفوفة حول جميع العناصر المتطابقة:

<div class="container">
  <div class="new">
    <div class="inner">Hello</div>
    <div class="inner">Goodbye</div>
  </div>
</div>

أمثلة:

التفاف div الجديد حول جميع الفقرات.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px solid blue;
  }
  p {
    background: yellow;
    margin: 4px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
 
<script>
$( "p" ).wrapAll( "<div></div>" );
</script>
 
</body>
</html>

عرض:

يلتف شجرة تم إنشاؤها حديثا من الكائنات حول الامتدادات. لاحظ أن أي شيء بين الفواصل يمتد مثل <strong> (النص الأحمر) في هذا المثال. حتى المساحة البيضاء بين الفواصل غير موجودة. انقر فوق عرض المصدر لمشاهدة html الأصلي.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px blue solid;
    margin: 2px;
    padding: 2px;
  }
  p {
    background: yellow;
    margin: 2px;
    padding: 2px;
  }
  strong {
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<span>Span Text</span>
<strong>What about me?</strong>
<span>Another One</span>
 
<script>
$( "span").wrapAll( "<div><div><p><em><b></b></em></p></div></div>" );
</script>
 
</body>
</html>

عرض:

التفاف div الجديد حول جميع الفقرات.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px solid blue;
  }
  p {
    background: yellow;
    margin: 4px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
 
<script>
$( "p" ).wrapAll( document.createElement( "div" ) );
</script>
 
</body>
</html>

عرض:

التفاف div مزدوجة jQuery كائن div حول كافة الفقرات. لاحظ أنها لا تحرك الكائن ولكنها تستنسخ فقط من أجل الالتفاف حول هدفها.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>wrapAll demo</title>
  <style>
  div {
    border: 2px solid blue;
    margin: 2px;
    padding: 2px;
  }
  .doublediv {
    border-color: red;
  }
  p {
    background: yellow;
    margin: 4px;
    font-size: 14px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Hello</p>
<p>cruel</p>
<p>World</p>
<div class="doublediv"><div></div></div>
 
<script>
$( "p" ).wrapAll( $( ".doublediv" ) );
</script>
 
</body>
</html>

عرض: