انهيار
قم بتبديل رؤية المحتوى عبر مشروعك باستخدام فئات قليلة ومكونات JavaScript الإضافية الخاصة بنا.
انقر فوق الأزرار أدناه لإظهار عنصر آخر وإخفائه عبر تغييرات الفئة:
.collapse
يخفي المحتوى.collapsing
يتم تطبيقه أثناء الانتقالات.collapse.show
يظهر المحتوى
يمكنك استخدام ارتباط مع href
السمة ، أو زر مع data-target
السمة. في كلتا الحالتين ، data-toggle="collapse"
مطلوب.
<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">
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
</div>
</div>
يمكن A <button>
أو <a>
إظهار وإخفاء عناصر متعددة بالرجوع إليها باستخدام محدد JQuery في السمة href
أو الخاصية. data-target
متعدد <button>
أو <a>
يمكن إظهار عنصر وإخفائه إذا كان كل منهم يشير إليه بسماته href
أو data-target
سماته
<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">
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
</div>
</div>
</div>
<div class="col">
<div class="collapse multi-collapse" id="multiCollapseExample2">
<div class="card card-body">
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
</div>
</div>
</div>
</div>
باستخدام مكون البطاقة ، يمكنك توسيع سلوك الانهيار الافتراضي لإنشاء أكورديون.
<div id="accordion">
<div class="card">
<div class="card-header" id="headingOne">
<h5 class="mb-0">
<button class="btn btn-link" data-toggle="collapse" data-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
Collapsible Group Item #1
</button>
</h5>
</div>
<div id="collapseOne" class="collapse show" aria-labelledby="headingOne" data-parent="#accordion">
<div class="card-body">
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingTwo">
<h5 class="mb-0">
<button class="btn btn-link collapsed" data-toggle="collapse" data-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
Collapsible Group Item #2
</button>
</h5>
</div>
<div id="collapseTwo" class="collapse" aria-labelledby="headingTwo" data-parent="#accordion">
<div class="card-body">
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingThree">
<h5 class="mb-0">
<button class="btn btn-link collapsed" data-toggle="collapse" data-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
Collapsible Group Item #3
</button>
</h5>
</div>
<div id="collapseThree" class="collapse" aria-labelledby="headingThree" data-parent="#accordion">
<div class="card-body">
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
</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 لا يغطي تفاعلات لوحة المفاتيح المختلفة الموضحة في نمط الأكورديون 1.1 لممارسات التأليف WAI-ARIA - ستحتاج إلى تضمينها بنفسك مع JavaScript مخصص.
يستخدم ملحق الطي بضع فئات للتعامل مع الرفع الثقيل:
.collapse
يخفي المحتوى.collapse.show
يظهر المحتوى.collapsing
تتم إضافته عند بدء الانتقال ، وإزالته عند الانتهاء
يمكن العثور على هذه الفئات في _transitions.scss
.
ما عليك سوى إضافة data-toggle="collapse"
"و" data-target
إلى العنصر لتعيين عنصر تحكم واحد أو أكثر من العناصر القابلة للطي تلقائيًا. تقبل السمة data-target
محدد CSS لتطبيق الطي عليه. تأكد من إضافة الفصل collapse
إلى العنصر القابل للطي. إذا كنت ترغب في فتحه افتراضيًا ، فأضف فئة إضافية show
.
لإضافة إدارة مجموعة تشبه الأكورديون إلى منطقة قابلة للطي ، أضف سمة البيانات data-parent="#selector"
. الرجوع إلى العرض التوضيحي لرؤية هذا في العمل.
التمكين يدويًا باستخدام:
$('.collapse').collapse()
يمكن تمرير الخيارات عبر سمات البيانات أو JavaScript. لسمات البيانات ، قم بإلحاق اسم الخيار بـ data-
، كما في data-parent=""
.
اسم | يكتب | تقصير | وصف |
---|---|---|---|
الأبوين | المحدد | كائن jQuery | عنصر DOM | خاطئة | إذا تم توفير العنصر الرئيسي ، فسيتم إغلاق جميع العناصر القابلة للطي ضمن العنصر الرئيسي المحدد عند عرض هذا العنصر القابل للطي. (على غرار سلوك الأكورديون التقليدي - هذا يعتمد على card الطبقة). يجب تعيين السمة على المنطقة القابلة للطي المستهدفة. |
تبديل | قيمة منطقية | حقيقي | تبديل العنصر القابل للطي عند الاستدعاء |
الطرق غير المتزامنة والانتقالات
جميع طرق API غير متزامنة وتبدأ في الانتقال . يعودون إلى المتصل بمجرد بدء الانتقال ولكن قبل أن ينتهي . بالإضافة إلى ذلك ، سيتم تجاهل استدعاء طريقة على مكون انتقالي .
راجع وثائق JavaScript الخاصة بنا للحصول على مزيد من المعلومات.
ينشط المحتوى الخاص بك كعنصر قابل للطي. يقبل الخيارات الاختيارية object
.
$('#myCollapsible').collapse({
toggle: false
})
تبديل عنصر قابل للطي إلى معروض أو مخفي. يعود إلى المتصل قبل إظهار العنصر القابل للطي أو إخفاؤه (أي قبل وقوع الحدث shown.bs.collapse
أو ).hidden.bs.collapse
يظهر عنصرًا قابلًا للطي. يعود إلى المتصل قبل أن يظهر العنصر القابل للطي بالفعل (أي قبل shown.bs.collapse
وقوع الحدث).
يخفي عنصرًا قابلًا للطي. يعود إلى المتصل قبل أن يتم إخفاء العنصر القابل للطي (أي قبل hidden.bs.collapse
وقوع الحدث).
يدمر انهيار عنصر.
تعرض فئة طي Bootstrap بعض الأحداث للتثبيت في وظيفة الانهيار.
نوع الحدث | وصف |
---|---|
show.bs.capse | يتم تشغيل هذا الحدث فورًا عند show استدعاء أسلوب المثيل. |
معروض. bs. الانهيار | يتم تشغيل هذا الحدث عندما يصبح عنصر الطي مرئيًا للمستخدم (سينتظر حتى تكتمل انتقالات CSS). |
إخفاء. b. الانهيار | يتم تشغيل هذا الحدث فورًا عند hide استدعاء الأسلوب. |
مخفي. BS. طي | يتم تشغيل هذا الحدث عند إخفاء عنصر تصغير عن المستخدم (سينتظر حتى تكتمل انتقالات CSS). |
$('#myCollapsible').on('hidden.bs.collapse', function () {
// do something…
})