Source

Liste grubu

Liste grupları, bir dizi içeriği görüntülemek için esnek ve güçlü bir bileşendir. Bunları, içindeki hemen hemen her içeriği destekleyecek şekilde değiştirin ve genişletin.

Temel örnek

En temel liste grubu, liste öğelerini ve uygun sınıfları içeren sırasız bir listedir. Takip eden seçeneklerle veya gerektiğinde kendi CSS'nizle bunun üzerine inşa edin.

  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
  • Porta ac conectetur ac
  • Vestibulum ve eros
<ul class="list-group">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
  <li class="list-group-item">Porta ac consectetur ac</li>
  <li class="list-group-item">Vestibulum at eros</li>
</ul>

Aktif öğeler

Geçerli etkin seçimi belirtmek için a'ya .activeekleyin ..list-group-item

  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
  • Porta ac conectetur ac
  • Vestibulum ve eros
<ul class="list-group">
  <li class="list-group-item active">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
  <li class="list-group-item">Porta ac consectetur ac</li>
  <li class="list-group-item">Vestibulum at eros</li>
</ul>

Devre dışı bırakılan öğeler

Devre dışı görünmesi için .disableda'ya ekleyin . Bazı öğelerin , tıklama olaylarını (ör. bağlantılar) tamamen devre dışı bırakmak için özel JavaScript gerektireceğini unutmayın..list-group-item.disabled

  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
  • Porta ac conectetur ac
  • Vestibulum ve eros
<ul class="list-group">
  <li class="list-group-item disabled" aria-disabled="true">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
  <li class="list-group-item">Porta ac consectetur ac</li>
  <li class="list-group-item">Vestibulum at eros</li>
</ul>

Ekleyerek üzerine gelindiğinde, devre dışı bırakıldığında ve etkin durumlarla eyleme geçirilebilir liste grubu öğeleri oluşturmak için <a>s veya s kullanın . Etkileşimli olmayan öğelerden ( s veya s gibi) oluşan liste gruplarının tıklama veya dokunma uygunluğu sağlamadığından emin olmak için bu sözde sınıfları ayırırız.<button>.list-group-item-action<li><div>

Burada standart sınıfları kullanmadığınızdan.btn emin olun .

<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active">
    Cras justo odio
  </a>
  <a href="#" class="list-group-item list-group-item-action">Dapibus ac facilisis in</a>
  <a href="#" class="list-group-item list-group-item-action">Morbi leo risus</a>
  <a href="#" class="list-group-item list-group-item-action">Porta ac consectetur ac</a>
  <a href="#" class="list-group-item list-group-item-action disabled" tabindex="-1" aria-disabled="true">Vestibulum at eros</a>
</div>

s ile sınıf yerine özniteliği <button>de kullanabilirsiniz . Ne yazık ki, s devre dışı özniteliği desteklemiyor.disabled.disabled<a>

<div class="list-group">
  <button type="button" class="list-group-item list-group-item-action active">
    Cras justo odio
  </button>
  <button type="button" class="list-group-item list-group-item-action">Dapibus ac facilisis in</button>
  <button type="button" class="list-group-item list-group-item-action">Morbi leo risus</button>
  <button type="button" class="list-group-item list-group-item-action">Porta ac consectetur ac</button>
  <button type="button" class="list-group-item list-group-item-action" disabled>Vestibulum at eros</button>
</div>

floş

.list-group-flushListe grubu öğelerini bir üst kapsayıcıda (örneğin kartlar) uçtan uca işlemek için bazı kenarlıkları ve yuvarlatılmış köşeleri kaldırmak için ekleyin .

  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
  • Porta ac conectetur ac
  • Vestibulum ve eros
<ul class="list-group list-group-flush">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
  <li class="list-group-item">Porta ac consectetur ac</li>
  <li class="list-group-item">Vestibulum at eros</li>
</ul>

Yatay

.list-group-horizontalTüm kesme noktalarında liste grubu öğelerinin düzenini dikeyden yataya değiştirmek için ekleyin . .list-group-horizontal-{sm|md|lg|xl}Alternatif olarak, o kesme noktasından başlayarak bir liste grubunu yatay hale getirmek için duyarlı bir değişken seçin min-width. Şu anda yatay liste grupları, gömme liste gruplarıyla birleştirilemez.

Uzman İpucu: Yatay olduğunda eşit genişlikte liste grubu öğeleri mi istiyorsunuz? Her liste grubu öğesine ekleyin .flex-fill.

  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
<ul class="list-group list-group-horizontal">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
</ul>
  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
<ul class="list-group list-group-horizontal-sm">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
</ul>
  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
<ul class="list-group list-group-horizontal-md">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
</ul>
  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
<ul class="list-group list-group-horizontal-lg">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
</ul>
  • cras justo odio
  • Dapibus ac tesisi
  • morbi aslan burcu
<ul class="list-group list-group-horizontal-xl">
  <li class="list-group-item">Cras justo odio</li>
  <li class="list-group-item">Dapibus ac facilisis in</li>
  <li class="list-group-item">Morbi leo risus</li>
</ul>

bağlamsal sınıflar

Durum bilgisi olan bir arka plan ve renkle liste öğelerine stil vermek için bağlamsal sınıfları kullanın.

  • Dapibus ac tesisi
  • Basit bir birincil liste grubu öğesi
  • Basit bir ikincil liste grubu öğesi
  • Basit bir başarı listesi grubu öğesi
  • Basit bir tehlike listesi grubu öğesi
  • Basit bir uyarı listesi grubu öğesi
  • Basit bir bilgi listesi grubu öğesi
  • Basit bir hafif liste grubu öğesi
  • Basit bir karanlık liste grubu öğesi
<ul class="list-group">
  <li class="list-group-item">Dapibus ac facilisis in</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>

Bağlamsal sınıflar ayrıca .list-group-item-action. Önceki örnekte bulunmayan vurgulu stillerin eklenmesine dikkat edin. Ayrıca desteklenen .activedevlettir; bağlamsal bir liste grubu öğesinde etkin bir seçimi belirtmek için uygulayın.

<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action">Dapibus ac facilisis in</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>
Yardımcı teknolojilere anlam taşıma

Renkleri anlam eklemek için kullanmak yalnızca görsel bir gösterge sağlar ve ekran okuyucular gibi yardımcı teknolojilerin kullanıcılarına iletilmez. Renkle gösterilen bilgilerin ya içeriğin kendisinden (örn. görünen metin) açık olduğundan ya da .sr-onlysınıfla gizlenmiş ek metin gibi alternatif yollarla dahil edildiğinden emin olun.

rozetleri ile

Bazı yardımcı programların yardımıyla okunmamış sayıları, etkinlikleri ve daha fazlasını göstermek için herhangi bir liste grubu öğesine rozetler ekleyin .

  • cras justo odio14
  • Dapibus ac tesisi2
  • morbi aslan burcu1
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Cras justo odio
    <span class="badge badge-primary badge-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Dapibus ac facilisis in
    <span class="badge badge-primary badge-pill">2</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Morbi leo risus
    <span class="badge badge-primary badge-pill">1</span>
  </li>
</ul>

Özel içerik

Flexbox yardımcı programlarının yardımıyla, aşağıdaki gibi bağlantılı liste grupları için bile hemen hemen her HTML'yi ekleyin .

<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">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
    <small>Donec id elit non mi porta.</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">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
    <small class="text-muted">Donec id elit non mi porta.</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">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
    <small class="text-muted">Donec id elit non mi porta.</small>
  </a>
</div>

JavaScript davranışı

bootstrap.jsListe grubumuzu yerel içeriğin sekmeli bölmelerini oluşturacak şekilde genişletmek için JavaScript eklentisi sekmesini kullanın (tek tek veya derlenmiş dosya aracılığıyla ekleyin).

<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>

Veri özniteliklerini kullanma

data-toggle="list"Bir öğeyi basitçe belirterek veya üzerinde herhangi bir JavaScript yazmadan bir liste grubu gezinmesini etkinleştirebilirsiniz . Bu veri özniteliklerini üzerinde kullanın .list-group-item.

<!-- 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>

JavaScript aracılığıyla

JavaScript aracılığıyla sekmeli liste öğesini etkinleştirin (her liste öğesinin ayrı ayrı etkinleştirilmesi gerekir):

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

Tek tek liste öğesini birkaç şekilde etkinleştirebilirsiniz:

$('#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

solma efekti

Sekmeler panelinin kararmasını sağlamak .fadeiçin her birine ekleyin .tab-pane. İlk sekme bölmesinin de .showilk içeriği görünür hale getirmesi gerekir.

<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>

yöntemler

$().sekme

Bir liste öğesi öğesini ve içerik kapsayıcısını etkinleştirir. Sekme, DOM'da bir kapsayıcı düğümünü hedefleyen data-targetveya bir kapsayıcı düğümüne sahip olmalıdır.href

<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('göster')

Verilen liste öğesini seçer ve ilişkili bölmesini gösterir. Daha önce seçilen diğer liste öğelerinin seçimi kaldırılır ve ilişkili bölmesi gizlenir. Sekme bölmesi gerçekte gösterilmeden önce (örneğin, shown.bs.tabolay meydana gelmeden önce) arayana döner.

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

Olaylar

Yeni bir sekme gösterilirken olaylar aşağıdaki sırayla tetiklenir:

  1. hide.bs.tab(geçerli etkin sekmede)
  2. show.bs.tab(gösterilecekler sekmesinde)
  3. hidden.bs.tab(önceki etkin sekmede, hide.bs.tabetkinlikle aynı)
  4. shown.bs.tab(yeni etkin olan az önce gösterilen sekmede, show.bs.tabetkinlikle aynı)

Hiçbir sekme zaten etkin değilse hide.bs.tabve hidden.bs.tabolayları tetiklenmez.

Etkinlik tipi Tanım
göster.bs.sekmesi Bu olay, sekme gösterisinde, ancak yeni sekme gösterilmeden önce tetiklenir. Sırasıyla etkin sekmeyi ve önceki etkin sekmeyi (varsa) hedeflemek için event.targetve düğmelerini kullanın .event.relatedTarget
gösterilen.bs.sekmesi Bu olay, bir sekme gösterildikten sonra sekme gösterisinde tetiklenir. Sırasıyla etkin sekmeyi ve önceki etkin sekmeyi (varsa) hedeflemek için event.targetve düğmelerini kullanın .event.relatedTarget
hide.bs.tab Bu olay, yeni bir sekme gösterileceğinde (ve dolayısıyla önceki etkin sekme gizleneceğinde) tetiklenir. Sırasıyla, mevcut etkin sekmeyi ve yakında etkin olacak yeni sekmeyi hedeflemek için event.targetve kullanın .event.relatedTarget
gizli.bs.sekmesi Bu olay, yeni bir sekme gösterildikten sonra tetiklenir (ve bu nedenle önceki etkin sekme gizlenir). Sırasıyla önceki etkin sekmeyi ve yeni etkin sekmeyi hedeflemek için event.targetve kullanın .event.relatedTarget
$('a[data-toggle="list"]').on('shown.bs.tab', function (e) {
  e.target // newly activated tab
  e.relatedTarget // previous active tab
})