სიის ჯგუფი
სიის ჯგუფები არის მოქნილი და ძლიერი კომპონენტი შინაარსის სერიის საჩვენებლად. შეცვალეთ და გააფართოვეთ ისინი მხარდასაჭერად თითქმის ნებისმიერი შინაარსის ფარგლებში.
ძირითადი მაგალითი
სიის ყველაზე ძირითადი ჯგუფი არის დაუგეგმავი სია სიის ელემენტებით და შესაბამისი კლასებით. დაეყრდნობით მას შემდეგი ვარიანტებით, ან საჭიროების შემთხვევაში საკუთარი CSS-ით.
- Ნივთი
- მეორე ნივთი
- მესამე ნივთი
- მეოთხე ელემენტი
- და მეხუთე
<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>
აქტიური ნივთები
დაამატეთ .active
a-ს .list-group-item
, რათა მიუთითოთ მიმდინარე აქტიური არჩევანი.
- აქტიური ნივთი
- მეორე ნივთი
- მესამე ნივთი
- მეოთხე ელემენტი
- და მეხუთე
<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>
გამორთული ნივთები
დაამატეთ .disabled
a- .list-group-item
ში, რათა ის გამორთული იყოს . გაითვალისწინეთ, რომ ზოგიერთ ელემენტს .disabled
ასევე დასჭირდება მორგებული JavaScript მათი დაწკაპუნების მოვლენების სრულად გამორთვისთვის (მაგ., ბმულები).
- გამორთული ელემენტი
- მეორე ნივთი
- მესამე ნივთი
- მეოთხე ელემენტი
- და მეხუთე
<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>
ბმულები და ღილაკები
გამოიყენეთ <a>
s ან <button>
s, რათა შექმნათ მოქმედი სიის ჯგუფის ელემენტები მაუსის, გამორთული და აქტიური მდგომარეობების დამატებით .list-group-item-action
. ჩვენ გამოვყოფთ ამ ფსევდო კლასებს, რათა უზრუნველვყოთ არაინტერაქტიული ელემენტებისაგან (როგორიცაა <li>
s ან <div>
s) შექმნილი სიის ჯგუფები არ უზრუნველყოფენ დაწკაპუნების ან შეხების შესაძლებლობას.
დარწმუნდით, რომ არ გამოიყენოთ აქ სტანდარტული .btn
კლასები .
<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>
s- ით <button>
, ასევე შეგიძლიათ გამოიყენოთ ატრიბუტი კლასის disabled
ნაცვლად . .disabled
სამწუხაროდ, <a>
არ არის მხარდაჭერილი გამორთული ატრიბუტი.
<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>
ფლეში
დაამატეთ .list-group-flush
ზოგიერთი საზღვრებისა და მომრგვალებული კუთხის ამოსაღებად სიის ჯგუფის ერთეულების პირიდან კიდემდე გამოსაყვანად მშობლის კონტეინერში (მაგ., ბარათები).
- Ნივთი
- მეორე ნივთი
- მესამე ნივთი
- მეოთხე ელემენტი
- და მეხუთე
<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>
Ჰორიზონტალური
დაამატეთ .list-group-horizontal
სიის ჯგუფის ელემენტების განლაგების შესაცვლელად ვერტიკალურიდან ჰორიზონტალურზე ყველა წყვეტის წერტილში. ალტერნატიულად, აირჩიეთ პასუხისმგებელი ვარიანტი .list-group-horizontal-{sm|md|lg|xl}
, რათა სიის ჯგუფი ჰორიზონტალური იყოს დაწყებული ამ წყვეტის წერტილიდან min-width
. ამჟამად ჰორიზონტალური სიის ჯგუფები არ შეიძლება გაერთიანდეს flush list ჯგუფებთან.
ProTip: გსურთ თანაბარი სიგანის ჯგუფის ელემენტები ჰორიზონტალურად? დაამატეთ .flex-fill
თითოეული სიის ჯგუფის ელემენტი.
- Ნივთი
- მეორე ნივთი
- მესამე ნივთი
- Ნივთი
- მეორე ნივთი
- მესამე ნივთი
- Ნივთი
- მეორე ნივთი
- მესამე ნივთი
- Ნივთი
- მეორე ნივთი
- მესამე ნივთი
- Ნივთი
- მეორე ნივთი
- მესამე ნივთი
<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>
კონტექსტური კლასები
გამოიყენეთ კონტექსტური კლასები, რათა ჩამოაყალიბოთ ელემენტების ჩამონათვალში სახელმწიფო ფონი და ფერი.
- მარტივი ნაგულისხმევი სიის ჯგუფის ელემენტი
- მარტივი პირველადი სიის ჯგუფის ელემენტი
- მარტივი მეორადი სიის ჯგუფის ელემენტი
- მარტივი წარმატების სიის ჯგუფის ელემენტი
- მარტივი საფრთხის სიის ჯგუფის ელემენტი
- მარტივი გამაფრთხილებელი სიის ჯგუფის ელემენტი
- მარტივი ინფორმაციის სიის ჯგუფის ელემენტი
- მარტივი მსუბუქი სიის ჯგუფის ელემენტი
- მარტივი მუქი სიის ჯგუფის ელემენტი
<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>
კონტექსტუალური კლასები ასევე მუშაობს .list-group-item-action
. გაითვალისწინეთ ჰოვერის სტილის დამატება, რომელიც არ არის წარმოდგენილი წინა მაგალითში. ასევე მხარს უჭერს .active
სახელმწიფო; გამოიყენეთ ის, რათა მიუთითოთ აქტიური არჩევანი კონტექსტური სიის ჯგუფის ერთეულზე.
<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>
დამხმარე ტექნოლოგიების მნიშვნელობის გადმოცემა
მნიშვნელობის დასამატებლად ფერის გამოყენება მხოლოდ ვიზუალურ მითითებას იძლევა, რომელიც არ იქნება გადაცემული დამხმარე ტექნოლოგიების მომხმარებლებს - როგორიცაა ეკრანის წამკითხველები. დარწმუნდით, რომ ფერით აღნიშული ინფორმაცია ან აშკარაა თავად შინაარსიდან (მაგ. ხილული ტექსტი), ან შეტანილია ალტერნატიული საშუალებებით, როგორიცაა დამატებითი ტექსტი, რომელიც დამალულია .sr-only
კლასში.
სამკერდე ნიშნებით
დაამატეთ ბეჯები სიის ჯგუფის ნებისმიერ ერთეულს, რათა აჩვენოთ წაუკითხავი რაოდენობა, აქტივობა და სხვა, ზოგიერთი კომუნალური პროგრამის დახმარებით .
- სიის ელემენტი14
- სიის მეორე ელემენტი2
- სიის მესამე ელემენტი1
<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>
მორგებული კონტენტი
დაამატეთ თითქმის ნებისმიერი HTML შიგნით, თუნდაც დაკავშირებული სიის ჯგუფებისთვის, როგორიცაა ქვემოთ მოცემული, flexbox utilities- ის დახმარებით .
სიის ჯგუფის ელემენტის სათაური
3 დღის წინჩანაცვლების ზოგიერთი კონტენტი აბზაცში.
და რამდენიმე პატარა ნაბეჭდი.სიის ჯგუფის ელემენტის სათაური
3 დღის წინჩანაცვლების ზოგიერთი კონტენტი აბზაცში.
და ზოგიერთი მდუმარე წვრილმანი.სიის ჯგუფის ელემენტის სათაური
3 დღის წინჩანაცვლების ზოგიერთი კონტენტი აბზაცში.
და ზოგიერთი მდუმარე წვრილმანი.<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>
JavaScript ქცევა
გამოიყენეთ ჩანართის JavaScript მოდული — ჩართეთ იგი ინდივიდუალურად ან შედგენილი bootstrap.js
ფაილის მეშვეობით — ჩვენი სიის ჯგუფის გასაფართოვებლად, რათა შეიქმნას ადგილობრივი შინაარსის ჩანართების პანელები.
<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>
მონაცემთა ატრიბუტების გამოყენება
თქვენ შეგიძლიათ გაააქტიუროთ სიის ჯგუფური ნავიგაცია JavaScript-ის დაწერის გარეშე უბრალოდ data-toggle="list"
ელემენტის მითითებით ან მასზე. გამოიყენეთ ეს მონაცემთა ატრიბუტები .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>
JavaScript-ის საშუალებით
ჩანართის სიის ელემენტის ჩართვა JavaScript-ის საშუალებით (სიის თითოეული ელემენტი ინდივიდუალურად უნდა გააქტიურდეს):
$('#myList a').on('click', function (event) {
event.preventDefault()
$(this).tab('show')
})
თქვენ შეგიძლიათ გაააქტიუროთ სიის ინდივიდუალური ელემენტი რამდენიმე გზით:
$('#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
თითოეულს .tab-pane
. პირველი ჩანართის პანელს ასევე უნდა ჰქონდეს .show
თავდაპირველი შინაარსი ხილული.
<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>
მეთოდები
$().tab
ააქტიურებს სიის ელემენტის ელემენტს და შინაარსის კონტეინერს. ჩანართს უნდა ჰქონდეს DOM-ში ან კონტეინერის კვანძი data-target
ან სამიზნე.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 ("ჩვენება")
ირჩევს მოცემულ სიის ერთეულს და აჩვენებს მის დაკავშირებულ პანელს. სიის ნებისმიერი სხვა ელემენტი, რომელიც ადრე იყო არჩეული, გაუქმდება და მასთან დაკავშირებული პანელი იმალება. უბრუნდება აბონენტს ჩანართების პანელის რეალურად ჩვენებამდე (მაგალითად, shown.bs.tab
მოვლენის დაწყებამდე).
$('#someListItem').tab('show')
Ივენთი
ახალი ჩანართის ჩვენებისას, მოვლენები ჩნდება შემდეგი თანმიმდევრობით:
hide.bs.tab
(მიმდინარე აქტიურ ჩანართზე)show.bs.tab
(გამოსაჩენ ჩანართზე)hidden.bs.tab
(წინა აქტიურ ჩანართზე, იგივე რაცhide.bs.tab
ღონისძიებისთვის)shown.bs.tab
(ახლად აქტიურ ახლად ნაჩვენები ჩანართზე, იგივე რაცshow.bs.tab
ღონისძიებისთვის)
თუ არცერთი ჩანართი არ იყო აქტიური, hide.bs.tab
და hidden.bs.tab
მოვლენები არ გააქტიურდება.
ღონისძიების ტიპი | აღწერა |
---|---|
show.bs.tab | ეს ღონისძიება ჩართულია ჩანართის ჩვენებაზე, მაგრამ სანამ ახალი ჩანართი გამოჩნდება. გამოიყენეთ event.target და event.relatedTarget მიზნად აქტიური ჩანართი და წინა აქტიური ჩანართი (თუ შესაძლებელია) შესაბამისად. |
ნაჩვენები.ბს.ჩანართი | ეს ღონისძიება ჩართულია ჩანართის ჩვენებაში მას შემდეგ, რაც გამოჩნდება ჩანართი. გამოიყენეთ event.target და event.relatedTarget მიზნად აქტიური ჩანართი და წინა აქტიური ჩანართი (თუ შესაძლებელია) შესაბამისად. |
დამალვა.ბს.ჩანართი | ეს მოვლენა ირთვება, როდესაც უნდა იყოს ნაჩვენები ახალი ჩანართი (და ამით წინა აქტიური ჩანართი უნდა დაიმალოს). გამოიყენეთ event.target და event.relatedTarget მიზნად ისახავს მიმდინარე აქტიური ჩანართი და ახალი მალე აქტიური ჩანართი, შესაბამისად. |
დამალული.bs.tab | ეს მოვლენა ირთვება მას შემდეგ, რაც გამოჩნდება ახალი ჩანართი (და ამით წინა აქტიური ჩანართი დამალულია). გამოიყენეთ event.target და event.relatedTarget მიზნად ისახავს წინა აქტიური ჩანართი და ახალი აქტიური ჩანართი, შესაბამისად. |
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
event.target // newly activated tab
event.relatedTarget // previous active tab
})