in English

انهيار

قم بتبديل رؤية المحتوى عبر مشروعك باستخدام فئات قليلة ومكونات JavaScript الإضافية الخاصة بنا.

كيف تعمل

يتم استخدام ملحق طي JavaScript الإضافي لإظهار المحتوى وإخفائه. تُستخدم الأزرار أو المراسي كمشغلات يتم تعيينها لعناصر محددة تقوم بتبديلها. سيؤدي انهيار العنصر إلى تحريك العنصر heightمن قيمته الحالية إلى 0. بالنظر إلى كيفية تعامل CSS مع الرسوم المتحركة ، لا يمكنك استخدامها paddingعلى .collapseعنصر. بدلاً من ذلك ، استخدم الفئة كعنصر التفاف مستقل.

يعتمد تأثير الرسوم المتحركة لهذا المكون على prefers-reduced-motionالاستعلام عن الوسائط. راجع قسم الحركة المخفضة في وثائق إمكانية الوصول الخاصة بنا .

مثال

انقر فوق الأزرار أدناه لإظهار عنصر آخر وإخفائه عبر تغييرات الفئة:

  • .collapseيخفي المحتوى
  • .collapsingيتم تطبيقه أثناء الانتقالات
  • .collapse.showيظهر المحتوى

بشكل عام ، نوصي باستخدام زر مع data-targetالسمة. بينما لا يوصى به من وجهة نظر دلالية ، يمكنك أيضًا استخدام رابط مع hrefالسمة (و أ role="button"). في كلتا الحالتين ، data-toggle="collapse"مطلوب.

Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
<p>
  <a class="btn btn-primary" data-toggle="collapse" href="#collapseExample" role="button" aria-expanded="false" aria-controls="collapseExample">
    Link with href
  </a>
  <button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
    Button with data-target
  </button>
</p>
<div class="collapse" id="collapseExample">
  <div class="card card-body">
    Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
  </div>
</div>

أفقي

يدعم ملحق الطي أيضًا الطي الأفقي. أضف .widthفئة المعدل للانتقال widthبدلاً من heightوتعيين widthعلى العنصر الفرعي المباشر. لا تتردد في كتابة Sass المخصص الخاص بك ، أو استخدام الأنماط المضمنة ، أو استخدام أدوات العرض المساعدة الخاصة بنا .

يرجى ملاحظة أنه على الرغم من أن المثال أدناه يحتوي على min-heightمجموعة لتجنب إعادة الطلاء المفرطة في مستنداتنا ، فإن هذا ليس مطلوبًا بشكل صريح. مطلوب فقط widthعلى العنصر التابع.

This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
<p>
  <button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseWidthExample" aria-expanded="false" aria-controls="collapseWidthExample">
    Toggle width collapse
  </button>
</p>
<div style="min-height: 120px;">
  <div class="collapse width" id="collapseWidthExample">
    <div class="card card-body" style="width: 320px;">
      This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
    </div>
  </div>
</div>

أهداف متعددة

يمكن A <button>أو <a>إظهار وإخفاء عناصر متعددة بالرجوع إليها باستخدام محدد JQuery في السمة hrefأو الخاصية. data-targetمتعدد <button>أو <a>يمكن إظهار عنصر وإخفائه إذا كان كل منهم يشير إليه بسماته hrefأو data-targetسماته

Some placeholder content for the first collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
Some placeholder content for the second collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
<p>
  <a class="btn btn-primary" data-toggle="collapse" href="#multiCollapseExample1" role="button" aria-expanded="false" aria-controls="multiCollapseExample1">Toggle first element</a>
  <button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#multiCollapseExample2" aria-expanded="false" aria-controls="multiCollapseExample2">Toggle second element</button>
  <button class="btn btn-primary" type="button" data-toggle="collapse" data-target=".multi-collapse" aria-expanded="false" aria-controls="multiCollapseExample1 multiCollapseExample2">Toggle both elements</button>
</p>
<div class="row">
  <div class="col">
    <div class="collapse multi-collapse" id="multiCollapseExample1">
      <div class="card card-body">
        Some placeholder content for the first collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
      </div>
    </div>
  </div>
  <div class="col">
    <div class="collapse multi-collapse" id="multiCollapseExample2">
      <div class="card card-body">
        Some placeholder content for the second collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
      </div>
    </div>
  </div>
</div>

مثال الأكورديون

باستخدام مكون البطاقة ، يمكنك توسيع سلوك الانهيار الافتراضي لإنشاء أكورديون. لتحقيق نمط الأكورديون بشكل صحيح ، تأكد من استخدامه .accordionكغلاف.

بعض محتويات العناصر النائبة للوحة الأكورديون الأولى. يتم عرض هذه اللوحة افتراضيًا ، بفضل .showالفصل.

Some placeholder content for the second accordion panel. This panel is hidden by default.

And lastly, the placeholder content for the third and final accordion panel. This panel is hidden by default.
<div class="accordion" id="accordionExample">
  <div class="card">
    <div class="card-header" id="headingOne">
      <h2 class="mb-0">
        <button class="btn btn-link btn-block text-left" type="button" data-toggle="collapse" data-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
          Collapsible Group Item #1
        </button>
      </h2>
    </div>

    <div id="collapseOne" class="collapse show" aria-labelledby="headingOne" data-parent="#accordionExample">
      <div class="card-body">
        Some placeholder content for the first accordion panel. This panel is shown by default, thanks to the <code>.show</code> class.
      </div>
    </div>
  </div>
  <div class="card">
    <div class="card-header" id="headingTwo">
      <h2 class="mb-0">
        <button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
          Collapsible Group Item #2
        </button>
      </h2>
    </div>
    <div id="collapseTwo" class="collapse" aria-labelledby="headingTwo" data-parent="#accordionExample">
      <div class="card-body">
        Some placeholder content for the second accordion panel. This panel is hidden by default.
      </div>
    </div>
  </div>
  <div class="card">
    <div class="card-header" id="headingThree">
      <h2 class="mb-0">
        <button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
          Collapsible Group Item #3
        </button>
      </h2>
    </div>
    <div id="collapseThree" class="collapse" aria-labelledby="headingThree" data-parent="#accordionExample">
      <div class="card-body">
        And lastly, the placeholder content for the third and final accordion panel. This panel is hidden by default.
      </div>
    </div>
  </div>
</div>

إمكانية الوصول

تأكد من الإضافة aria-expandedإلى عنصر التحكم. تنقل هذه السمة بشكل صريح الحالة الحالية للعنصر القابل للطي المرتبط بالتحكم في برامج قراءة الشاشة والتقنيات المساعدة المماثلة. إذا تم إغلاق العنصر القابل للطي افتراضيًا ، فيجب أن يكون للسمة الموجودة في عنصر التحكم قيمة aria-expanded="false". إذا قمت بتعيين العنصر القابل للطي ليتم فتحه افتراضيًا باستخدام showالفئة ، فقم بتعيين aria-expanded="true"عنصر التحكم بدلاً من ذلك. سيقوم المكون الإضافي تلقائيًا بتبديل هذه السمة على عنصر التحكم بناءً على ما إذا كان العنصر القابل للطي قد تم فتحه أو إغلاقه (عبر JavaScript ، أو لأن المستخدم قام بتشغيل عنصر تحكم آخر مرتبط أيضًا بنفس العنصر القابل للطي). إذا لم يكن عنصر HTML لعنصر التحكم زرًا (على سبيل المثال ، <a>أو <div>) ، السمةrole="button"يجب أن تضاف إلى العنصر.

إذا كان عنصر التحكم الخاص بك يستهدف عنصرًا واحدًا قابلًا للطي - أي data-targetتشير السمة إلى idمحدد - يجب إضافة aria-controlsالسمة إلى عنصر التحكم ، الذي يحتوي على idالعنصر القابل للطي. تستخدم برامج قراءة الشاشة الحديثة والتقنيات المساعدة المماثلة هذه السمة لتزويد المستخدمين باختصارات إضافية للانتقال مباشرة إلى العنصر القابل للطي نفسه.

لاحظ أن التنفيذ الحالي لـ Bootstrap لا يغطي تفاعلات لوحة المفاتيح المتنوعة الموضحة في نمط الأكورديون الخاص بدليل ممارسات التأليف ARIA - ستحتاج إلى تضمينها بنفسك مع JavaScript مخصص.

إستعمال

يستخدم ملحق الطي بضع فئات للتعامل مع الرفع الثقيل:

  • .collapseيخفي المحتوى
  • .collapse.showيظهر المحتوى
  • .collapsingتتم إضافته عند بدء الانتقال ، وإزالته عند الانتهاء

يمكن العثور على هذه الفئات في _transitions.scss.

عبر سمات البيانات

ما عليك سوى إضافة data-toggle="collapse""و" data-targetإلى العنصر لتعيين عنصر تحكم واحد أو أكثر من العناصر القابلة للطي تلقائيًا. تقبل السمة data-targetمحدد CSS لتطبيق الطي عليه. تأكد من إضافة الفصل collapseإلى العنصر القابل للطي. إذا كنت ترغب في فتحه افتراضيًا ، فأضف فئة إضافية show.

لإضافة إدارة مجموعة تشبه الأكورديون إلى منطقة قابلة للطي ، أضف سمة البيانات data-parent="#selector". الرجوع إلى العرض التوضيحي لرؤية هذا في العمل.

عبر JavaScript

التمكين يدويًا باستخدام:

$('.collapse').collapse()

خيارات

يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-، كما في data-parent="".

اسم يكتب تقصير وصف
الأبوين المحدد | كائن jQuery | عنصر DOM خاطئة إذا تم توفير العنصر الرئيسي ، فسيتم إغلاق جميع العناصر القابلة للطي ضمن العنصر الرئيسي المحدد عند عرض هذا العنصر القابل للطي. (على غرار سلوك الأكورديون التقليدي - هذا يعتمد على cardالطبقة). يجب تعيين السمة على المنطقة القابلة للطي المستهدفة.
تبديل قيمة منطقية حقيقي تبديل العنصر القابل للطي عند الاستدعاء

طُرق

الطرق غير المتزامنة والانتقالات

جميع طرق API غير متزامنة وتبدأ في الانتقال . يعودون إلى المتصل بمجرد بدء الانتقال ولكن قبل أن ينتهي . بالإضافة إلى ذلك ، سيتم تجاهل استدعاء طريقة على مكون انتقالي .

راجع وثائق JavaScript الخاصة بنا للحصول على مزيد من المعلومات .

.collapse(options)

ينشط المحتوى الخاص بك كعنصر قابل للطي. يقبل الخيارات الاختيارية object.

$('#myCollapsible').collapse({
  toggle: false
})

.collapse('toggle')

تبديل عنصر قابل للطي إلى معروض أو مخفي. يعود إلى المتصل قبل إظهار العنصر القابل للطي أو إخفاؤه (أي قبل وقوع الحدث shown.bs.collapseأو ).hidden.bs.collapse

.collapse('show')

يظهر عنصرًا قابلًا للطي. يعود إلى المتصل قبل أن يظهر العنصر القابل للطي بالفعل (أي قبل shown.bs.collapseوقوع الحدث).

.collapse('hide')

يخفي عنصرًا قابلًا للطي. يعود إلى المتصل قبل أن يتم إخفاء العنصر القابل للطي (أي قبل hidden.bs.collapseوقوع الحدث).

.collapse('dispose')

يدمر انهيار عنصر.

الأحداث

تعرض فئة طي Bootstrap بعض الأحداث للتثبيت في وظيفة الانهيار.

نوع الحدث وصف
show.bs.capse يتم تشغيل هذا الحدث فورًا عند showاستدعاء أسلوب المثيل.
معروض. bs. الانهيار يتم تشغيل هذا الحدث عندما يصبح عنصر الطي مرئيًا للمستخدم (سينتظر حتى تكتمل انتقالات CSS).
إخفاء. b. الانهيار يتم تشغيل هذا الحدث فورًا عند hideاستدعاء الأسلوب.
مخفي. BS. طي يتم تشغيل هذا الحدث عند إخفاء عنصر تصغير عن المستخدم (سينتظر حتى تكتمل انتقالات CSS).
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something...
})