Нурах

Хэрхэн ажилладаг

Буулгах JavaScript залгаасыг контентыг харуулах, нуухад ашигладаг. Товчлуур эсвэл зангуу нь таны сэлгэх тодорхой элементүүдтэй зурагдсан гох болгон ашигладаг. Элементийг хумивал тухайн элементийг heightодоогийн утгаас нь анивчуулна 0. CSS нь хөдөлгөөнт дүрсийг хэрхэн зохицуулдгийг харгалзан элемент paddingдээр ашиглах боломжгүй. .collapseХарин оронд нь ангиудыг бие даасан боодлын элемент болгон ашигла.

Жишээ

Ангийн өөрчлөлтөөр өөр элементийг харуулах, нуухын тулд доорх товчлууруудыг дарна уу:

• .collapseагуулгыг нуудаг
• .collapsingшилжилтийн үед хэрэглэнэ
• .collapse.showагуулгыг харуулдаг

Ерөнхийдөө бид data-bs-targetшинж чанар бүхий товчлуурыг ашиглахыг зөвлөж байна. Хэдийгээр семантик талаас нь авч үзэхийг зөвлөдөггүй ч гэсэн hrefатрибуттай (болон a role="button") холбоосыг ашиглаж болно. Аль ч тохиолдолд data-bs-toggle="collapse"шаардлагатай.

<p>
  <a class="btn btn-primary" data-bs-toggle="collapse" href="#collapseExample" role="button" aria-expanded="false" aria-controls="collapseExample">
    Link with href
  </a>
  <button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
    Button with data-bs-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>

Хэвтээ

Нурах залгаас нь хэвтээ уналтыг мөн дэмждэг. Оронд нь .collapse-horizontalшилжихийн тулд өөрчлөгч ангийг нэмээд шууд хүүхэд элемент дээр a тохируулна уу . Өөрийн захиалгат Sass бичих, шугамын хэв маягийг ашиглах, эсвэл өргөн хэрэглээний хэрэгслүүдийг ашиглах боломжтой .widthheightwidth

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

Олон зорилт

A <button>эсвэл олон элементийг өөрийн эсвэл атрибут <a>дахь сонгогчоор лавлаж харуулах, нуух боломжтой . Элемент тус бүр өөрийн эсвэл атрибутаар нь иш татсан тохиолдолд олон буюу харуулах, нуух боломжтойhrefdata-bs-target<button><a>hrefdata-bs-target

<p>
  <a class="btn btn-primary" data-bs-toggle="collapse" href="#multiCollapseExample1" role="button" aria-expanded="false" aria-controls="multiCollapseExample1">Toggle first element</a>
  <button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target="#multiCollapseExample2" aria-expanded="false" aria-controls="multiCollapseExample2">Toggle second element</button>
  <button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-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>

Хүртээмжтэй байдал

aria-expandedХяналтын элемент дээр нэмэхээ мартуузай . Энэ шинж чанар нь удирдлагатай холбогдсон эвхэгддэг элементийн одоогийн төлөвийг дэлгэц уншигчид болон үүнтэй төстэй туслах технологид шууд дамжуулдаг. Хэрэв эвхэгддэг элемент нь анхдагчаар хаагдсан бол хяналтын элемент дээрх атрибут нь -ийн утгатай байх ёстой aria-expanded="false". Хэрэв та эвхэгддэг элементийг showанги ашиглан анхдагчаар нээлттэй байхаар тохируулсан aria-expanded="true"бол оронд нь удирдлага дээр тохируулна уу. Уг залгаас нь эвхэгддэг элемент нээгдсэн эсвэл хаагдсан эсэхээс (JavaScript-ээр дамжуулан, эсвэл хэрэглэгч ижил эвхэгддэг элементтэй холбогдсон өөр хяналтын элементийг идэвхжүүлсэн) үндэслэн удирдлага дээрх энэ атрибутыг автоматаар сэлгэх болно. Хэрэв хяналтын элементийн HTML элемент нь товчлуур биш бол (жишээ нь, <a>эсвэл <div>), атрибутrole="button"элементэд нэмэх ёстой.

Хэрэв таны хяналтын элемент нэг эвхэгддэг элементийг онилж байгаа бол, өөрөөр хэлбэл data-bs-targetшинж чанар нь idсонгогч руу чиглэж байгаа бол та эвхэгддэг элементийг aria-controlsагуулсан атрибутыг хяналтын элементэд нэмэх хэрэгтэй id. Орчин үеийн дэлгэц уншигчид болон үүнтэй төстэй туслах технологиуд нь хэрэглэгчдэд эвхэгддэг элемент рүү шууд шилжих нэмэлт товчлолоор хангахын тулд энэ шинж чанарыг ашигладаг.

Bootstrap-ийн одоогийн хэрэгжүүлэлт нь ARIA Зохиогчийн дадлагын гарын авлага баян хуурын загварт тайлбарласан янз бүрийн нэмэлт гарын харилцан үйлчлэлийг хамрахгүй гэдгийг анхаарна уу - та эдгээрийг өөртөө тохируулсан JavaScript-д оруулах хэрэгтэй болно.

Сасс

Хувьсагч

$transition-collapse:         height .35s ease;
$transition-collapse-width:   width .35s ease;

Ангиуд

scss/_transitions.scssНуралтын шилжилтийн ангиудыг олон бүрэлдэхүүн хэсгүүдэд (нуралт ба баян хуур) хуваалцдаг тул олж болно .

.collapse {
  &:not(.show) {
    display: none;
  }
}

.collapsing {
  height: 0;
  overflow: hidden;
  @include transition($transition-collapse);

  &.collapse-horizontal {
    width: 0;
    height: auto;
    @include transition($transition-collapse-width);
  }
}

Хэрэглээ

Нурах залгаас нь хүнд ачааг даах хэд хэдэн ангиллыг ашигладаг:

• .collapseагуулгыг нуудаг
• .collapse.showагуулгыг харуулж байна
• .collapsingШилжилт эхлэхэд нэмэгдэж, дуусах үед хасагдана

Эдгээр ангиудыг эндээс олж болно _transitions.scss.

Өгөгдлийн шинж чанаруудаар дамжуулан

Нэг буюу хэд хэдэн эвхэгддэг элементийн хяналтыг автоматаар хуваарилахын тулд элементэд " data-bs-toggle="collapse"a" -г нэмэхэд л хангалттай . data-bs-targetУг data-bs-targetатрибут нь задлах үйлдэл хийх CSS сонгогчийг хүлээн зөвшөөрдөг. collapseЭвхэгддэг элементэд ангийг нэмэхээ мартуузай . Хэрэв та үүнийг анхдагчаар нээхийг хүсвэл нэмэлт анги нэмнэ үү show.

Эвхэгддэг хэсэгт баян хуур шиг бүлгийн удирдлагыг нэмэхийн тулд дата атрибутыг нэмнэ үү data-bs-parent="#selector". Дэлгэрэнгүй мэдээллийг баян хуурын хуудаснаас авна уу .

JavaScript-ээр дамжуулан

Гараар идэвхжүүлэх:

const collapseElementList = document.querySelectorAll('.collapse')
const collapseList = [...collapseElementList].map(collapseEl => new bootstrap.Collapse(collapseEl))

Сонголтууд

Сонголтуудыг өгөгдлийн атрибутууд эсвэл JavaScript-ээр дамжуулж болох тул та -д сонголтын нэрийг нэмж data-bs-болно data-bs-animation="{value}". Өгөгдлийн шинж чанараар сонголтуудыг дамжуулахдаа сонголтын нэрийн төрлийг " camelCase "-ээс " kebab-case " болгон өөрчлөхөө мартуузай . Жишээлбэл, data-bs-custom-class="beautifier"оронд нь хэрэглэнэ data-bs-customClass="beautifier".

Bootstrap 5.2.0 хувилбарын хувьд бүх бүрэлдэхүүн хэсгүүд нь энгийн бүрэлдэхүүн хэсгийн тохиргоог JSON стринг болгон байрлуулах боломжтой туршилтын нөөцлөгдсөн өгөгдлийн шинж чанарыг дэмждэг. data-bs-configЭлемент data-bs-config='{"delay":0, "title":123}'болон data-bs-title="456"шинж чанаруудтай бол эцсийн titleутга нь байх 456ба тусдаа өгөгдлийн шинж чанарууд нь дээр өгөгдсөн утгыг дарна data-bs-config. Нэмж дурдахад, одоо байгаа өгөгдлийн атрибутууд нь JSON утгыг хадгалах боломжтой data-bs-delay='{"show":0,"hide":150}'.

Арга зүй

Таны агуулгыг эвхэгддэг элемент болгон идэвхжүүлнэ. Нэмэлт сонголтуудыг хүлээн зөвшөөрдөг object.

Та бүтээгчээр задлах жишээ үүсгэж болно, жишээлбэл:

const bsCollapse = new bootstrap.Collapse('#myCollapse', {
  toggle: false
})

Үйл явдал

Bootstrap-ийн уналтын анги нь уналтын функцэд холбогдох хэд хэдэн үйл явдлыг илчилдэг.

const myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', event => {
  // do something...
})