in English

Listahan ng pangkat

Ang mga pangkat ng listahan ay isang nababaluktot at makapangyarihang bahagi para sa pagpapakita ng isang serye ng nilalaman. Baguhin at palawigin ang mga ito upang suportahan ang halos anumang nilalaman sa loob.

Pangunahing halimbawa

Ang pinakapangunahing pangkat ng listahan ay isang hindi nakaayos na listahan na may mga listahan ng mga item at mga wastong klase. Buuin ito gamit ang mga sumusunod na opsyon, o gamit ang iyong sariling CSS kung kinakailangan.

  • Isang bagay
  • Ang pangalawang item
  • Pangatlong item
  • Pang-apat na item
  • At ang panglima
<ul class="list-group">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Mga aktibong item

Idagdag .activesa a .list-group-itemupang isaad ang kasalukuyang aktibong pagpili.

  • Isang aktibong item
  • Ang pangalawang item
  • Pangatlong item
  • Pang-apat na item
  • At ang panglima
<ul class="list-group">
  <li class="list-group-item active" aria-current="true">An active item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Mga item na hindi pinagana

Idagdag .disabledsa isang .list-group-itempara magmukhang hindi pinagana. Tandaan na ang ilang elemento na may .disableday mangangailangan din ng custom na JavaScript upang ganap na hindi paganahin ang kanilang mga kaganapan sa pag-click (hal, mga link).

  • Isang item na hindi pinagana
  • Ang pangalawang item
  • Pangatlong item
  • Pang-apat na item
  • At ang panglima
<ul class="list-group">
  <li class="list-group-item disabled" aria-disabled="true">A disabled item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Gumamit ng <a>s o <button>s upang lumikha ng mga naaaksyunan na mga item ng pangkat ng listahan na may hover, naka-disable, at aktibong estado sa pamamagitan ng pagdaragdag ng .list-group-item-action. Pinaghihiwalay namin ang mga pseudo-class na ito upang matiyak na ang mga pangkat ng listahan na gawa sa mga hindi interactive na elemento (tulad ng mga <li>s o <div>s) ay hindi nagbibigay ng isang click o tap affordance.

Tiyaking hindi gagamitin ang mga karaniwang .btnklase dito .

Ang kasalukuyang link item Isang pangalawang link na item Isang pangatlong link na item Pang-apat na link na item Isang naka-disable na item sa link 
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active" aria-current="true">
    The current link item
  </a>
  <a href="#" class="list-group-item list-group-item-action">A second link item</a>
  <a href="#" class="list-group-item list-group-item-action">A third link item</a>
  <a href="#" class="list-group-item list-group-item-action">A fourth link item</a>
  <a class="list-group-item list-group-item-action disabled">A disabled link item</a>
</div>

Sa <button>s, maaari mo ring gamitin ang disabledkatangian sa halip na ang .disabledklase. Nakalulungkot, <a>hindi sinusuportahan ng s ang hindi pinaganang katangian.

<div class="list-group">
  <button type="button" class="list-group-item list-group-item-action active" aria-current="true">
    The current button
  </button>
  <button type="button" class="list-group-item list-group-item-action">A second item</button>
  <button type="button" class="list-group-item list-group-item-action">A third button item</button>
  <button type="button" class="list-group-item list-group-item-action">A fourth button item</button>
  <button type="button" class="list-group-item list-group-item-action" disabled>A disabled button item</button>
</div>

Flush

Idagdag .list-group-flushupang alisin ang ilang mga hangganan at mga bilugan na sulok upang mag-render ng mga item ng listahan ng pangkat na magkatabi sa isang lalagyan ng magulang (hal., mga card).

  • Isang bagay
  • Ang pangalawang item
  • Pangatlong item
  • Pang-apat na item
  • At ang panglima
<ul class="list-group list-group-flush">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Pahalang

Idagdag .list-group-horizontalupang baguhin ang layout ng mga item ng pangkat ng listahan mula patayo patungo sa pahalang sa lahat ng breakpoint. Bilang kahalili, pumili ng tumutugong variant .list-group-horizontal-{sm|md|lg|xl}upang gawing pahalang ang isang pangkat ng listahan simula sa breakpoint na iyon min-width. Sa kasalukuyan , ang mga pahalang na pangkat ng listahan ay hindi maaaring isama sa mga flush na pangkat ng listahan.

ProTip: Gusto ng pantay na lapad ng mga item ng pangkat ng listahan kapag pahalang? Idagdag .flex-fillsa bawat item sa listahan ng pangkat.

  • Isang bagay
  • Ang pangalawang item
  • Pangatlong item
  • Isang bagay
  • Ang pangalawang item
  • Pangatlong item
  • Isang bagay
  • Ang pangalawang item
  • Pangatlong item
  • Isang bagay
  • Ang pangalawang item
  • Pangatlong item
  • Isang bagay
  • Ang pangalawang item
  • Pangatlong item
<ul class="list-group list-group-horizontal">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-sm">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-md">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-lg">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-xl">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>

Mga klase sa konteksto

Gumamit ng mga klase sa konteksto upang mag-istilo ng mga item sa listahan na may stateful na background at kulay.

  • Isang simpleng default na item ng pangkat ng listahan
  • Isang simpleng pangunahing item ng pangkat ng listahan
  • Isang simpleng pangalawang item ng pangkat ng listahan
  • Isang simpleng item ng pangkat ng listahan ng tagumpay
  • Isang simpleng item ng pangkat ng listahan ng panganib
  • Isang simpleng item ng pangkat ng listahan ng babala
  • Isang simpleng item ng pangkat ng listahan ng impormasyon
  • Isang simpleng light list group item
  • Isang simpleng item ng dark list group
<ul class="list-group">
  <li class="list-group-item">A simple default list group item</li>

  <li class="list-group-item list-group-item-primary">A simple primary list group item</li>
  <li class="list-group-item list-group-item-secondary">A simple secondary list group item</li>
  <li class="list-group-item list-group-item-success">A simple success list group item</li>
  <li class="list-group-item list-group-item-danger">A simple danger list group item</li>
  <li class="list-group-item list-group-item-warning">A simple warning list group item</li>
  <li class="list-group-item list-group-item-info">A simple info list group item</li>
  <li class="list-group-item list-group-item-light">A simple light list group item</li>
  <li class="list-group-item list-group-item-dark">A simple dark list group item</li>
</ul>

Gumagana rin ang mga klase sa konteksto ng .list-group-item-action. Pansinin ang pagdaragdag ng mga istilo ng hover dito na wala sa nakaraang halimbawa. Sinusuportahan din ang .activeestado; ilapat ito upang ipahiwatig ang isang aktibong pagpili sa isang item ng pangkat ng listahan ng konteksto.

Isang simpleng default na item ng pangkat ng listahan Isang simpleng pangunahing item ng pangkat ng listahan Isang simpleng pangalawang item ng pangkat ng listahan Isang simpleng item ng pangkat ng listahan ng tagumpay Isang simpleng item ng pangkat ng listahan ng panganib Isang simpleng item ng pangkat ng listahan ng babala Isang simpleng item ng pangkat ng listahan ng impormasyon Isang simpleng light list group item Isang simpleng item ng dark list group 
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action">A simple default list group item</a>

  <a href="#" class="list-group-item list-group-item-action list-group-item-primary">A simple primary list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-secondary">A simple secondary list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-success">A simple success list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-danger">A simple danger list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-warning">A simple warning list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-info">A simple info list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-light">A simple light list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-dark">A simple dark list group item</a>
</div>
Naghahatid ng kahulugan sa mga pantulong na teknolohiya

Ang paggamit ng kulay upang magdagdag ng kahulugan ay nagbibigay lamang ng visual na indikasyon, na hindi ibibigay sa mga gumagamit ng mga pantulong na teknolohiya - tulad ng mga screen reader. Siguraduhin na ang impormasyong tinutukoy ng kulay ay maaaring halata mula sa nilalaman mismo (hal. ang nakikitang teksto), o kasama sa pamamagitan ng mga alternatibong paraan, tulad ng karagdagang tekstong nakatago sa .sr-onlyklase.

May mga badge

Magdagdag ng mga badge sa anumang item sa listahan ng pangkat upang ipakita ang mga hindi pa nababasang bilang, aktibidad, at higit pa sa tulong ng ilang mga utility .

  • Isang item sa listahan14
  • Ang pangalawang item sa listahan2
  • Ang ikatlong item sa listahan1 
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-center">
    A list item
    <span class="badge badge-primary badge-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    A second list item
    <span class="badge badge-primary badge-pill">2</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    A third list item
    <span class="badge badge-primary badge-pill">1</span>
  </li>
</ul>

Custom na nilalaman

Magdagdag ng halos anumang HTML sa loob, kahit para sa mga naka-link na grupo ng listahan tulad ng nasa ibaba, sa tulong ng mga flexbox utilities .

Ilista ang heading ng item ng pangkat
3 araw ang nakalipas

Ilang placeholder na nilalaman sa isang talata.

At ilang maliit na letra.
Ilista ang heading ng item ng pangkat
3 araw ang nakalipas

Ilang placeholder na nilalaman sa isang talata.

At ilang naka-mute na maliit na letra.
Ilista ang heading ng item ng pangkat
3 araw ang nakalipas

Ilang placeholder na nilalaman sa isang talata.

At ilang naka-mute na maliit na letra. 
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">List group item heading</h5>
      <small>3 days ago</small>
    </div>
    <p class="mb-1">Some placeholder content in a paragraph.</p>
    <small>And some small print.</small>
  </a>
  <a href="#" class="list-group-item list-group-item-action">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">List group item heading</h5>
      <small class="text-muted">3 days ago</small>
    </div>
    <p class="mb-1">Some placeholder content in a paragraph.</p>
    <small class="text-muted">And some muted small print.</small>
  </a>
  <a href="#" class="list-group-item list-group-item-action">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">List group item heading</h5>
      <small class="text-muted">3 days ago</small>
    </div>
    <p class="mb-1">Some placeholder content in a paragraph.</p>
    <small class="text-muted">And some muted small print.</small>
  </a>
</div>

Pag-uugali ng JavaScript

Gamitin ang plugin ng tab na JavaScript—isama ito nang isa-isa o sa pamamagitan ng pinagsama bootstrap.js-samang file—upang palawigin ang aming pangkat ng listahan upang lumikha ng mga tabable na pane ng lokal na nilalaman.

Ilang placeholder na content sa isang talata na nauugnay sa "Home". At ilang higit pang nilalaman, na ginagamit dito para lang i-pad out at punan ang tab panel na ito. Sa produksyon, malinaw na magkakaroon ka ng mas totoong nilalaman dito. At hindi lang basta text. Maaaring kahit ano, talaga. Teksto, mga larawan, mga form.

Ilang placeholder na content sa isang talata na nauugnay sa "Profile". At ilang higit pang nilalaman, na ginagamit dito para lang i-pad out at punan ang tab panel na ito. Sa produksyon, malinaw na magkakaroon ka ng mas totoong nilalaman dito. At hindi lang basta text. Maaaring kahit ano, talaga. Teksto, mga larawan, mga form.

Some placeholder content in a paragraph relating to "Messages". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

Some placeholder content in a paragraph relating to "Settings". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

<div class="row">
  <div class="col-4">
    <div class="list-group" id="list-tab" role="tablist">
      <a class="list-group-item list-group-item-action active" id="list-home-list" data-toggle="list" href="#list-home" role="tab" aria-controls="home">Home</a>
      <a class="list-group-item list-group-item-action" id="list-profile-list" data-toggle="list" href="#list-profile" role="tab" aria-controls="profile">Profile</a>
      <a class="list-group-item list-group-item-action" id="list-messages-list" data-toggle="list" href="#list-messages" role="tab" aria-controls="messages">Messages</a>
      <a class="list-group-item list-group-item-action" id="list-settings-list" data-toggle="list" href="#list-settings" role="tab" aria-controls="settings">Settings</a>
    </div>
  </div>
  <div class="col-8">
    <div class="tab-content" id="nav-tabContent">
      <div class="tab-pane fade show active" id="list-home" role="tabpanel" aria-labelledby="list-home-list">...</div>
      <div class="tab-pane fade" id="list-profile" role="tabpanel" aria-labelledby="list-profile-list">...</div>
      <div class="tab-pane fade" id="list-messages" role="tabpanel" aria-labelledby="list-messages-list">...</div>
      <div class="tab-pane fade" id="list-settings" role="tabpanel" aria-labelledby="list-settings-list">...</div>
    </div>
  </div>
</div>

Paggamit ng mga katangian ng data

Maaari mong i-activate ang isang nabigasyon ng pangkat ng listahan nang hindi nagsusulat ng anumang JavaScript sa pamamagitan lamang ng pagtukoy data-toggle="list"o sa isang elemento. Gamitin ang mga katangian ng data na ito sa .list-group-item.

<div role="tabpanel">
  <!-- List group -->
  <div class="list-group" id="myList" role="tablist">
    <a class="list-group-item list-group-item-action active" data-toggle="list" href="#home" role="tab">Home</a>
    <a class="list-group-item list-group-item-action" data-toggle="list" href="#profile" role="tab">Profile</a>
    <a class="list-group-item list-group-item-action" data-toggle="list" href="#messages" role="tab">Messages</a>
    <a class="list-group-item list-group-item-action" data-toggle="list" href="#settings" role="tab">Settings</a>
  </div>

  <!-- Tab panes -->
  <div class="tab-content">
    <div class="tab-pane active" id="home" role="tabpanel">...</div>
    <div class="tab-pane" id="profile" role="tabpanel">...</div>
    <div class="tab-pane" id="messages" role="tabpanel">...</div>
    <div class="tab-pane" id="settings" role="tabpanel">...</div>
  </div>
</div>

Sa pamamagitan ng JavaScript

Paganahin ang item sa listahan ng tabable sa pamamagitan ng JavaScript (kailangang isa-isang isaaktibo ang bawat item sa listahan):

$('#myList a').on('click', function (event) {
  event.preventDefault()
  $(this).tab('show')
})

Maaari mong i-activate ang indibidwal na item sa listahan sa maraming paraan:

$('#myList a[href="#profile"]').tab('show') // Select tab by name
$('#myList a:first-child').tab('show') // Select first tab
$('#myList a:last-child').tab('show') // Select last tab
$('#myList a:nth-child(3)').tab('show') // Select third tab

Fade effect

Upang gawing fade in ang panel ng mga tab, idagdag .fadesa bawat isa .tab-pane. Ang unang tab pane ay dapat ding .showgawin ang unang nilalaman na nakikita.

<div class="tab-content">
  <div class="tab-pane fade show active" id="home" role="tabpanel">...</div>
  <div class="tab-pane fade" id="profile" role="tabpanel">...</div>
  <div class="tab-pane fade" id="messages" role="tabpanel">...</div>
  <div class="tab-pane fade" id="settings" role="tabpanel">...</div>
</div>

Paraan

$().tab

Nag-a-activate ng elemento ng item sa listahan at lalagyan ng nilalaman. Ang tab ay dapat may alinman sa isang data-targeto isang pag- hreftarget ng isang container node sa DOM.

<div class="list-group" id="myList" role="tablist">
  <a class="list-group-item list-group-item-action active" data-toggle="list" href="#home" role="tab">Home</a>
  <a class="list-group-item list-group-item-action" data-toggle="list" href="#profile" role="tab">Profile</a>
  <a class="list-group-item list-group-item-action" data-toggle="list" href="#messages" role="tab">Messages</a>
  <a class="list-group-item list-group-item-action" data-toggle="list" href="#settings" role="tab">Settings</a>
</div>

<div class="tab-content">
  <div class="tab-pane active" id="home" role="tabpanel">...</div>
  <div class="tab-pane" id="profile" role="tabpanel">...</div>
  <div class="tab-pane" id="messages" role="tabpanel">...</div>
  <div class="tab-pane" id="settings" role="tabpanel">...</div>
</div>

<script>
  $(function () {
    $('#myList a:last-child').tab('show')
  })
</script>

.tab('show')

Pinipili ang ibinigay na item sa listahan at ipinapakita ang nauugnay na pane nito. Ang anumang iba pang item sa listahan na dati nang napili ay hindi mapipili at ang nauugnay na pane nito ay nakatago. Bumabalik sa tumatawag bago aktwal na naipakita ang tab pane (halimbawa, bago shown.bs.tabmangyari ang kaganapan).

$('#someListItem').tab('show')

Mga kaganapan

Kapag nagpapakita ng bagong tab, gagana ang mga kaganapan sa sumusunod na pagkakasunud-sunod:

  1. hide.bs.tab(sa kasalukuyang aktibong tab)
  2. show.bs.tab(sa ipapakitang tab)
  3. hidden.bs.tab(sa nakaraang aktibong tab, kapareho ng para sa hide.bs.tabkaganapan)
  4. shown.bs.tab(sa bagong-aktibong kakapakitang tab, kapareho ng para sa show.bs.tabkaganapan)

Kung wala pang tab na aktibo, ang hide.bs.tabat mga hidden.bs.tabkaganapan ay hindi papaganahin.

Uri ng kaganapan Paglalarawan
show.bs.tab Ang kaganapang ito ay gagana sa palabas sa tab, ngunit bago ipakita ang bagong tab. Gamitin event.targetat event.relatedTargeti-target ang aktibong tab at ang nakaraang aktibong tab (kung magagamit) ayon sa pagkakabanggit.
ipinapakita.bs.tab Ang kaganapang ito ay gagana sa palabas sa tab pagkatapos maipakita ang isang tab. Gamitin event.targetat event.relatedTargeti-target ang aktibong tab at ang nakaraang aktibong tab (kung magagamit) ayon sa pagkakabanggit.
hide.bs.tab Ang kaganapang ito ay gagana kapag ang isang bagong tab ay ipapakita (at sa gayon ang nakaraang aktibong tab ay itatago). Gamitin event.targetat event.relatedTargeti-target ang kasalukuyang aktibong tab at ang bagong tab na malapit nang maging aktibo, ayon sa pagkakabanggit.
hidden.bs.tab Ang kaganapang ito ay gagana pagkatapos ipakita ang isang bagong tab (at sa gayon ang nakaraang aktibong tab ay nakatago). Gamitin event.targetat event.relatedTargeti-target ang nakaraang aktibong tab at ang bagong aktibong tab, ayon sa pagkakabanggit. 
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})