JavaScript
Bir düzineden fazla özel jQuery eklentisi ile Bootstrap bileşenlerini hayata geçirin. Hepsini veya tek tek kolayca ekleyin.
Bir düzineden fazla özel jQuery eklentisi ile Bootstrap bileşenlerini hayata geçirin. Hepsini veya tek tek kolayca ekleyin.
Eklentiler tek tek (Bootstrap'in bireysel *.js
dosyalarını kullanarak) veya hepsi bir kerede (kullanarak bootstrap.js
veya küçültülmüş olarak bootstrap.min.js
) dahil edilebilir.
Her ikisi bootstrap.js
de bootstrap.min.js
tüm eklentileri tek bir dosyada içerir. Yalnızca birini dahil edin.
Bazı eklentiler ve CSS bileşenleri diğer eklentilere bağlıdır. Eklentileri tek tek eklerseniz, bu bağımlılıkları belgelerde kontrol ettiğinizden emin olun. Ayrıca tüm eklentilerin jQuery'ye bağlı olduğunu unutmayın (bu, jQuery'nin eklenti dosyalarından önce dahil edilmesi gerektiği anlamına gelir). Hangi jQuery sürümlerinin desteklendiğini görmek için bize danışın .bower.json
Tüm Bootstrap eklentilerini, tek bir JavaScript satırı yazmadan yalnızca biçimlendirme API'si aracılığıyla kullanabilirsiniz. Bu, Bootstrap'in birinci sınıf API'sidir ve bir eklenti kullanırken ilk düşünceniz olmalıdır.
Bununla birlikte, bazı durumlarda bu işlevin kapatılması istenebilir. Bu nedenle, ad alanlı belgedeki tüm olayların bağlantısını kaldırarak veri özniteliği API'sini devre dışı bırakma olanağı da sağlıyoruz data-api
. Bu şuna benziyor:
$(document).off('.data-api')
Alternatif olarak, belirli bir eklentiyi hedeflemek için, eklentinin adını aşağıdaki gibi data-api ad alanıyla birlikte ad alanı olarak eklemeniz yeterlidir:
$(document).off('.alert.data-api')
Aynı öğe üzerinde birden çok eklentiden veri öznitelikleri kullanmayın. Örneğin, bir düğme hem araç ipucuna sahip olamaz hem de bir modda geçiş yapamaz. Bunu başarmak için bir sarma elemanı kullanın.
Ayrıca, tüm Bootstrap eklentilerini yalnızca JavaScript API aracılığıyla kullanabilmeniz gerektiğine inanıyoruz. Tüm genel API'ler tek, zincirlenebilir yöntemlerdir ve üzerinde işlem yapılan koleksiyonu döndürür.
$('.btn.danger').button('toggle').addClass('fat')
Tüm yöntemler, isteğe bağlı bir seçenekler nesnesini, belirli bir yöntemi hedefleyen bir dizeyi veya hiçbir şeyi (varsayılan davranışa sahip bir eklenti başlatan) kabul etmelidir:
$('#myModal').modal() // initialized with defaults
$('#myModal').modal({ keyboard: false }) // initialized with no keyboard
$('#myModal').modal('show') // initializes and invokes show immediately
Her eklenti ayrıca ham yapıcısını bir Constructor
özellik üzerinde gösterir: $.fn.popover.Constructor
. Belirli bir eklenti örneği almak istiyorsanız, onu doğrudan bir öğeden alın: $('[rel="popover"]').data('popover')
.
Eklentinin Constructor.DEFAULTS
nesnesini değiştirerek bir eklentinin varsayılan ayarlarını değiştirebilirsiniz:
$.fn.modal.Constructor.DEFAULTS.keyboard = false // changes default for the modal plugin's `keyboard` option to false
Bazen Bootstrap eklentilerini diğer UI çerçeveleriyle birlikte kullanmak gerekir. Bu durumlarda, zaman zaman ad alanı çakışmaları meydana gelebilir. Böyle bir durumda, .noConflict
değerini geri almak istediğiniz eklentiyi arayabilirsiniz.
var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value
$.fn.bootstrapBtn = bootstrapButton // give $().bootstrapBtn the Bootstrap functionality
Bootstrap, çoğu eklentinin benzersiz eylemleri için özel etkinlikler sağlar. Genellikle bunlar mastar ve geçmiş ortaç biçiminde gelir - burada mastar (örn. show
) bir olayın başlangıcında tetiklenir ve geçmiş ortaç biçimi (örn. shown
) bir eylemin tamamlanmasıyla tetiklenir.
3.0.0'dan itibaren tüm Bootstrap olayları ad alanlıdır.
Tüm mastar olaylar preventDefault
işlevsellik sağlar. Bu, bir eylemin yürütülmesini başlamadan önce durdurma yeteneği sağlar.
$('#myModal').on('show.bs.modal', function (e) {
if (!data) return e.preventDefault() // stops modal from being shown
})
Araç ipuçları ve Popover'lar, HTML'yi kabul eden seçenekleri sterilize etmek için yerleşik dezenfektanımızı kullanır.
Varsayılan whiteList
değer aşağıdaki gibidir:
var ARIA_ATTRIBUTE_PATTERN = /^aria-[\w-]*$/i
var DefaultWhitelist = {
// Global attributes allowed on any supplied element below.
'*': ['class', 'dir', 'id', 'lang', 'role', ARIA_ATTRIBUTE_PATTERN],
a: ['target', 'href', 'title', 'rel'],
area: [],
b: [],
br: [],
col: [],
code: [],
div: [],
em: [],
hr: [],
h1: [],
h2: [],
h3: [],
h4: [],
h5: [],
h6: [],
i: [],
img: ['src', 'alt', 'title', 'width', 'height'],
li: [],
ol: [],
p: [],
pre: [],
s: [],
small: [],
span: [],
sub: [],
sup: [],
strong: [],
u: [],
ul: []
}
Bu varsayılana yeni değerler eklemek whiteList
istiyorsanız aşağıdakileri yapabilirsiniz:
var myDefaultWhiteList = $.fn.tooltip.Constructor.DEFAULTS.whiteList
// To allow table elements
myDefaultWhiteList.table = []
// To allow td elements and data-option attributes on td elements
myDefaultWhiteList.td = ['data-option']
// You can push your custom regex to validate your attributes.
// Be careful about your regular expressions being too lax
var myCustomRegex = /^data-my-app-[\w-]+/
myDefaultWhiteList['*'].push(myCustomRegex)
DOMPurify gibi özel bir kitaplık kullanmayı tercih ettiğiniz için dezenfektanımızı atlamak istiyorsanız , aşağıdakileri yapmalısınız:
$('#yourTooltip').tooltip({
sanitizeFn: function (content) {
return DOMPurify.sanitize(content)
}
})
document.implementation.createHTMLDocument
Internet Explorer 8 gibi desteklemeyen tarayıcılarda document.implementation.createHTMLDocument
, yerleşik temizleme işlevi HTML'yi olduğu gibi döndürür.
Bu durumda sanitizasyon yapmak istiyorsanız, lütfen DOMPurifysanitizeFn
gibi harici bir kitaplık belirtin ve kullanın .
VERSION
Bootstrap'in jQuery eklentilerinin her birinin sürümüne , eklentinin kurucusunun özelliği aracılığıyla erişilebilir . Örneğin, araç ipucu eklentisi için:
$.fn.tooltip.Constructor.VERSION // => "3.4.1"
Bootstrap'ın eklentileri, JavaScript devre dışı bırakıldığında özellikle zarif bir şekilde geri düşmez. Bu durumda kullanıcı deneyimini önemsiyorsanız <noscript>
, durumu (ve JavaScript'in nasıl yeniden etkinleştirileceğini) kullanıcılarınıza açıklamak ve/veya kendi özel yedeklerinizi eklemek için kullanın.
Bootstrap, Prototype veya jQuery UI gibi üçüncü taraf JavaScript kitaplıklarını resmi olarak desteklemez . Ad alanlı olaylara rağmen .noConflict
, kendi başınıza düzeltmeniz gereken uyumluluk sorunları olabilir.
Basit geçiş efektleri transition.js
için diğer JS dosyalarının yanına bir kez ekleyin. Derlenmiş (veya küçültülmüş) kullanıyorsanız bootstrap.js
, bunu eklemenize gerek yoktur - zaten oradadır.
transitionEnd
Transition.js, olaylar için temel bir yardımcı ve bir CSS geçiş öykünücüsüdür. Diğer eklentiler tarafından CSS geçiş desteğini kontrol etmek ve asılı geçişleri yakalamak için kullanılır.
Geçişler , yüklendikten sonra transition.js
(veya bootstrap.js
duruma göre ) gelmesi gereken aşağıdaki JavaScript snippet'i kullanılarak genel olarak devre dışı bırakılabilir :bootstrap.min.js
$.support.transition = false
Modal'lar, gerekli minimum işlevsellik ve akıllı varsayılanlarla basitleştirilmiş ancak esnek iletişim istemleridir.
Bir modeli hala görünürken açmadığınızdan emin olun. Aynı anda birden fazla model göstermek için özel kod gerekir.
Modelin görünümünü ve/veya işlevselliğini etkileyen diğer bileşenlerden kaçınmak için, bir modelin HTML kodunu her zaman belgenizde en üst düzeyde bir konuma yerleştirmeye çalışın.
Mobil cihazlarda modların kullanılmasıyla ilgili bazı uyarılar vardır. Ayrıntılar için tarayıcı destek belgelerimize bakın.
HTML5'in semantiğini nasıl tanımladığı nedeniyle, autofocus
HTML özniteliğinin Bootstrap modellerinde hiçbir etkisi yoktur. Aynı efekti elde etmek için bazı özel JavaScript kullanın:
$('#myModal').on('shown.bs.modal', function () {
$('#myInput').focus()
})
Altbilgide üstbilgi, gövde ve eylemler kümesiyle oluşturulmuş bir modal.
<div class="modal fade" tabindex="-1" role="dialog">
<div class="modal-dialog" role="document">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">×</span></button>
<h4 class="modal-title">Modal title</h4>
</div>
<div class="modal-body">
<p>One fine body…</p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Save changes</button>
</div>
</div><!-- /.modal-content -->
</div><!-- /.modal-dialog -->
</div><!-- /.modal -->
Aşağıdaki düğmeyi tıklayarak bir modeli JavaScript aracılığıyla değiştirin. Aşağı kayar ve sayfanın üst kısmından kaybolur.
<!-- Button trigger modal -->
<button type="button" class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">
Launch demo modal
</button>
<!-- Modal -->
<div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
<div class="modal-dialog" role="document">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">×</span></button>
<h4 class="modal-title" id="myModalLabel">Modal title</h4>
</div>
<div class="modal-body">
...
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Save changes</button>
</div>
</div>
</div>
</div>
Modal başlığına atıfta bulunarak ve role="dialog"
eklediğinizden emin olun , ' ye ve kendisine .aria-labelledby="..."
.modal
role="document"
.modal-dialog
aria-describedby
Ek olarak, on ile kalıcı iletişim kutunuzun bir tanımını verebilirsiniz .modal
.
YouTube videolarını modallere gömmek, oynatmayı otomatik olarak durdurmak ve daha fazlası için Bootstrap'ta olmayan ek JavaScript gerektirir. Daha fazla bilgi için bu faydalı Yığın Taşması gönderisine bakın.
Modalların iki isteğe bağlı boyutu vardır ve bunlar, bir .modal-dialog
.
<!-- Large modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-lg">Large modal</button>
<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="myLargeModalLabel">
<div class="modal-dialog modal-lg" role="document">
<div class="modal-content">
...
</div>
</div>
</div>
<!-- Small modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-sm">Small modal</button>
<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="mySmallModalLabel">
<div class="modal-dialog modal-sm" role="document">
<div class="modal-content">
...
</div>
</div>
</div>
Görüntülemek için solmak yerine basitçe görünen modlar için, .fade
sınıfı modsal işaretlemenizden kaldırın.
<div class="modal" tabindex="-1" role="dialog" aria-labelledby="...">
...
</div>
Bir kip içindeki Bootstrap ızgara sisteminden yararlanmak için, .row
s öğesini içine yerleştirmeniz .modal-body
ve ardından normal ızgara sistemi sınıflarını kullanmanız yeterlidir.
<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="gridSystemModalLabel">
<div class="modal-dialog" role="document">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">×</span></button>
<h4 class="modal-title" id="gridSystemModalLabel">Modal title</h4>
</div>
<div class="modal-body">
<div class="row">
<div class="col-md-4">.col-md-4</div>
<div class="col-md-4 col-md-offset-4">.col-md-4 .col-md-offset-4</div>
</div>
<div class="row">
<div class="col-md-3 col-md-offset-3">.col-md-3 .col-md-offset-3</div>
<div class="col-md-2 col-md-offset-4">.col-md-2 .col-md-offset-4</div>
</div>
<div class="row">
<div class="col-md-6 col-md-offset-3">.col-md-6 .col-md-offset-3</div>
</div>
<div class="row">
<div class="col-sm-9">
Level 1: .col-sm-9
<div class="row">
<div class="col-xs-8 col-sm-6">
Level 2: .col-xs-8 .col-sm-6
</div>
<div class="col-xs-4 col-sm-6">
Level 2: .col-xs-4 .col-sm-6
</div>
</div>
</div>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Save changes</button>
</div>
</div><!-- /.modal-content -->
</div><!-- /.modal-dialog -->
</div><!-- /.modal -->
Sadece biraz farklı içeriklerle aynı modu tetikleyen bir sürü düğmeniz var mı? Hangi düğmenin tıklandığına bağlı olarak kipin içeriğini değiştirmek için ve event.relatedTarget
HTML özniteliklerini data-*
( muhtemelen jQuery aracılığıyla ) kullanın. Ayrıntılar için Modal Events belgelerine bakın relatedTarget
,
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@mdo">Open modal for @mdo</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@fat">Open modal for @fat</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@getbootstrap">Open modal for @getbootstrap</button>
...more buttons...
<div class="modal fade" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel">
<div class="modal-dialog" role="document">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">×</span></button>
<h4 class="modal-title" id="exampleModalLabel">New message</h4>
</div>
<div class="modal-body">
<form>
<div class="form-group">
<label for="recipient-name" class="control-label">Recipient:</label>
<input type="text" class="form-control" id="recipient-name">
</div>
<div class="form-group">
<label for="message-text" class="control-label">Message:</label>
<textarea class="form-control" id="message-text"></textarea>
</div>
</form>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Send message</button>
</div>
</div>
</div>
</div>
$('#exampleModal').on('show.bs.modal', function (event) {
var button = $(event.relatedTarget) // Button that triggered the modal
var recipient = button.data('whatever') // Extract info from data-* attributes
// If necessary, you could initiate an AJAX request here (and then do the updating in a callback).
// Update the modal's content. We'll use jQuery here, but you could use a data binding library or other methods instead.
var modal = $(this)
modal.find('.modal-title').text('New message to ' + recipient)
modal.find('.modal-body input').val(recipient)
})
Kalıcı eklenti, veri öznitelikleri veya JavaScript aracılığıyla isteğe bağlı olarak gizli içeriğinizi değiştirir. Ayrıca , varsayılan kaydırma davranışını geçersiz kılmak için ekler ve .modal-open
kipin dışına tıklandığında gösterilen kipleri yok saymak için bir tıklama alanı sağlamak üzere bir a oluşturur.<body>
.modal-backdrop
JavaScript yazmadan bir modeli etkinleştirin. Geçiş yapmak için belirli bir modu hedeflemek için veya data-toggle="modal"
ile birlikte bir düğme gibi bir denetleyici öğesinde ayarlayın .data-target="#foo"
href="#foo"
<button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>
myModal
Tek bir JavaScript satırı ile kimliği olan bir model çağırın :
$('#myModal').modal(options)
Seçenekler, veri öznitelikleri veya JavaScript aracılığıyla iletilebilir. Veri öznitelikleri için, seçenek adını olduğu data-
gibi ekleyin data-backdrop=""
.
İsim | tip | varsayılan | tanım |
---|---|---|---|
zemin | boolean veya dize'static' |
doğru | Kalıcı bir arka plan öğesi içerir. Alternatif olarak, static tıklamada modu kapatmayan bir arka plan belirtin. |
tuş takımı | boole | doğru | Çıkış tuşuna basıldığında modu kapatır |
göstermek | boole | doğru | Başlatıldığında kipi gösterir. |
uzak | yol | yanlış | Bu seçenek v3.3.0'dan beri kullanımdan kaldırılmıştır ve v4'te kaldırılmıştır. Bunun yerine, istemci tarafı şablon oluşturmayı veya bir veri bağlama çerçevesi kullanmanızı veya jQuery.load'ı kendiniz çağırmanızı öneririz. Uzak bir URL sağlanırsa, içerik jQuery'nin yöntemiyle bir kez yüklenir
|
.modal(options)
İçeriğinizi modal olarak etkinleştirir. İsteğe bağlı seçenekleri kabul eder object
.
$('#myModal').modal({
keyboard: false
})
.modal('toggle')
Bir modu manuel olarak değiştirir. Modal gerçekten gösterilmeden veya gizlenmeden (yani shown.bs.modal
veya hidden.bs.modal
olayı gerçekleşmeden önce) arayana geri döner.
$('#myModal').modal('toggle')
.modal('show')
Bir modeli manuel olarak açar. Modal fiilen gösterilmeden önce (yani shown.bs.modal
olay meydana gelmeden önce) arayana geri döner.
$('#myModal').modal('show')
.modal('hide')
Bir modu el ile gizler. Modal gerçekten gizlenmeden (yani hidden.bs.modal
olay meydana gelmeden önce) arayana geri döner.
$('#myModal').modal('hide')
.modal('handleUpdate')
Modun sola atlamasını sağlayacak şekilde, birinin görünmesi durumunda bir kaydırma çubuğuna karşı koymak için modun konumunu yeniden ayarlar.
Sadece modal açıkken yüksekliği değiştiğinde gereklidir.
$('#myModal').modal('handleUpdate')
Bootstrap'in modal sınıfı, modal işlevselliğe bağlanmak için birkaç olayı ortaya çıkarır.
Tüm mod olayları, modun kendisinde (yani 'de <div class="modal">
) tetiklenir.
Etkinlik tipi | Tanım |
---|---|
show.bs.modal | Bu olay, show örnek yöntemi çağrıldığında hemen tetiklenir. Bir tıklamadan kaynaklanıyorsa, tıklanan öğe relatedTarget olayın özelliği olarak kullanılabilir. |
Gösterilen.bs.modal | Bu olay, mod kullanıcıya görünür hale getirildiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). Bir tıklamadan kaynaklanıyorsa, tıklanan öğe relatedTarget olayın özelliği olarak kullanılabilir. |
hide.bs.modal | hide Bu olay, örnek yöntemi çağrıldığında hemen tetiklenir . |
gizli.bs.modal | Bu olay, kip kullanıcıdan gizlenmeyi bitirdiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
yüklenen.bs.modal | remote Bu olay, modal seçeneği kullanarak içerik yüklediğinde tetiklenir . |
$('#myModal').on('hidden.bs.modal', function (e) {
// do something...
})
Gezinme çubuğu, sekmeler ve haplar dahil olmak üzere bu basit eklentiyle hemen hemen her şeye açılır menüler ekleyin.
.open
Veri öznitelikleri veya JavaScript aracılığıyla, açılır eklenti, sınıfı üst liste öğesinde değiştirerek gizli içeriği (açılır menüler) değiştirir .
Mobil cihazlarda bir açılır menüyü açmak .dropdown-backdrop
, menünün dışına dokunulduğunda açılır menüleri kapatmak için bir dokunma alanı olarak ekler, bu da uygun iOS desteği için bir gerekliliktir. Bu, açık bir açılır menüden farklı bir açılır menüye geçişin mobil cihazlarda fazladan bir dokunuş gerektirdiği anlamına gelir.
Not: Bu data-toggle="dropdown"
özellik, uygulama düzeyinde açılır menüleri kapatmak için kullanılır, bu nedenle her zaman kullanmak iyi bir fikirdir.
data-toggle="dropdown"
Bir açılır liste arasında geçiş yapmak için bir bağlantıya veya düğmeye ekleyin .
<div class="dropdown">
<button id="dLabel" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Dropdown trigger
<span class="caret"></span>
</button>
<ul class="dropdown-menu" aria-labelledby="dLabel">
...
</ul>
</div>
URL'leri bağlantı düğmeleriyle olduğu gibi tutmak için data-target
özniteliği yerine kullanın href="#"
.
<div class="dropdown">
<a id="dLabel" data-target="#" href="http://example.com/" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">
Dropdown trigger
<span class="caret"></span>
</a>
<ul class="dropdown-menu" aria-labelledby="dLabel">
...
</ul>
</div>
JavaScript aracılığıyla açılır listeleri arayın:
$('.dropdown-toggle').dropdown()
data-toggle="dropdown"
hala gerekliAçılır listenizi JavaScript aracılığıyla aramanıza veya bunun yerine data-api'yi kullanmanıza bakılmaksızın, açılır data-toggle="dropdown"
listenin tetikleyici öğesinde her zaman bulunması gerekir.
Hiçbiri
$().dropdown('toggle')
Belirli bir gezinme çubuğunun veya sekmeli gezinmenin açılır menüsünü değiştirir.
Tüm açılır olaylar, .dropdown-menu
'nin üst öğesinde tetiklenir.
Tüm açılır olaylar relatedTarget
, değeri geçiş yapan bağlantı öğesi olan bir özelliğe sahiptir.
Etkinlik tipi | Tanım |
---|---|
show.bs.dropdown | Bu olay, gösteri örneği yöntemi çağrıldığında hemen tetiklenir. |
Gösterilen.bs.açılır menü | Bu olay, açılır menü kullanıcıya görünür hale getirildiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
hide.bs.dropdown | Bu olay, örnek gizleme yöntemi çağrıldığında hemen tetiklenir. |
gizli.bs.dropdown | Bu olay, açılır listenin kullanıcıdan gizlenmesi bittiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
$('#myDropdown').on('show.bs.dropdown', function () {
// do something…
})
ScrollSpy eklentisi, kaydırma konumuna göre gezinme hedeflerini otomatik olarak güncellemek içindir. Gezinme çubuğunun altındaki alanı kaydırın ve aktif sınıf değişimini izleyin. Açılır alt öğeler de vurgulanacaktır.
Reklam taytları keytar, brunch id sanat partisi dolor Labore. Pitchfork yr enim lo-fi qui satılmadan önce. Tumblr tarladan masaya bisiklet hakları ne olursa olsun. Anim keffiyeh carles hırka. Velit seitan mcsweeney'in fotoğraf kabini 3 wolf moon irure. Cosby kazak lomo jean şort, williamsburg hoodie minim qui muhtemelen duymamışsınızdır ve hırka güven fonu culpa biodizel wes anderson estetik. Nihil dövmeli accusamus, inandırıcı ironi biyodizel keffiyeh artisan ullamco consequat.
Veniam marfa bıyıklı kaykay, fugiat velit dirgen sakalını adipisisiyor. Freegan sakal aliqua cupidatat mcsweeney's vero. Cupidatat dört loko nisi, bir helvetica nulla carles. Dövmeli cosby kazak yemek kamyonu, mcsweeney'nin serbest olmayan vinili. Lo-fi wes anderson +1 terzilik. Carles estetik olmayan egzersizleri soylulaştırıyor. Brooklyn adipisising zanaat bira yardımcısı keytar çöl.
Occaecat commodo aliqua delectus. Fap zanaat bira çöl kaykay ea. Lomo bisiklet hakları adipisicing banh mi, velit ea sunt next level locavore tek kökenli kahve magna veniam. Yüksek yaşam kimliği vinil, yankı parkı consequat quis aliquip banh mi dirgen. Vero VHS tahmini yağlama. Consectetur nisi Kendin Yap mini postacı çantası. Cred ex in, sürdürülebilir delectus consectetur fanny pack iphone.
In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee blog, culpa postacı çantası marfa ne olursa olsun delectus gıda kamyonu. Sapiente synth kimliği varsayıldı. Locavore sed helvetica klişe ironisi, muhtemelen duymadığınız gök gürültüsü, kapüşonlu glütensiz lo-fi fap aliquip'i takip ediyor. Tükenmeden önce Labore elit placeat, terry richardson proident brunch nesciunt quis cosby kazak pariatur keffiyeh ut helvetica artisan. Hırka zanaat bira seitan hazır velit. VHS chambray Laboris tempor veniam. Anim mollit minim commodo ullamco gök gürültüsü kedileri.
Gezinme çubuğu bağlantılarının çözümlenebilir kimlik hedefleri olmalıdır. Örneğin, a <a href="#home">home</a>
, DOM'daki gibi bir şeye karşılık gelmelidir <div id="home"></div>
.
:visible
öğeler yoksayıldı:visible
jQuery'ye uygun olmayan hedef öğeler yok sayılacak ve bunlara karşılık gelen gezinme öğeleri hiçbir zaman vurgulanmayacaktır.
Uygulama yöntemi ne olursa olsun, scrollspy, gözetlediğiniz öğede kullanılmasını gerektirir position: relative;
. Çoğu durumda bu <body>
. dışındaki öğeler üzerinde gezinirken, bir kümeye sahip olduğunuzdan ve uyguladığınızdan <body>
emin olun .height
overflow-y: scroll;
Üst çubuk navigasyonunuza kolayca scrollspy davranışı eklemek data-spy="scroll"
için, gözetlemek istediğiniz öğeye ekleyin (çoğunlukla bu, <body>
). Ardından , herhangi bir Bootstrap bileşeninin data-target
üst öğesinin kimliği veya sınıfıyla özniteliği ekleyin..nav
body {
position: relative;
}
<body data-spy="scroll" data-target="#navbar-example">
...
<div id="navbar-example">
<ul class="nav nav-tabs" role="tablist">
...
</ul>
</div>
...
</body>
position: relative;
CSS'nizi ekledikten sonra , JavaScript aracılığıyla scrollspy'ı arayın:
$('body').scrollspy({ target: '#navbar-example' })
.scrollspy('refresh')
DOM'a öğe ekleme veya çıkarma ile birlikte scrollspy kullanırken, yenileme yöntemini şu şekilde çağırmanız gerekir:
$('[data-spy="scroll"]').each(function () {
var $spy = $(this).scrollspy('refresh')
})
Seçenekler, veri öznitelikleri veya JavaScript aracılığıyla iletilebilir. Veri öznitelikleri için, seçenek adını olduğu data-
gibi ekleyin data-offset=""
.
İsim | tip | varsayılan | tanım |
---|---|---|---|
telafi etmek | sayı | 10 | Kaydırma konumu hesaplanırken üstten kaydırılacak pikseller. |
Etkinlik tipi | Tanım |
---|---|
activ.bs.scrollspy | Bu olay, scrollspy tarafından yeni bir öğe etkinleştirildiğinde tetiklenir. |
$('#myScrollspy').on('activate.bs.scrollspy', function () {
// do something…
})
Açılır menüler aracılığıyla bile yerel içerik bölmeleri arasında geçiş yapmak için hızlı, dinamik sekme işlevi ekleyin. İç içe sekmeler desteklenmez.
Ham denim, muhtemelen o jean şort Austin'i duymamışsınızdır. Nesciunt tofu stumptown aliqua, retro synth master temizliği. Bıyık klişe tempor, williamsburg carles vegan helvetica. Reprehenderit kasap retro keffiyeh dreamcatcher synth. Cosby kazak ab banh mi, irure terry richardson eski kalamar. Aliquip placeat salvia cillum iphone. Seitan aliquip quis hırka amerikan giyim, kasap voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Bu eklenti, sekmeli gezinme bileşenini sekmeli alanlar eklemek için genişletir.
JavaScript aracılığıyla sekmeli sekmeleri etkinleştirin (her sekmenin ayrı ayrı etkinleştirilmesi gerekir):
$('#myTabs a').click(function (e) {
e.preventDefault()
$(this).tab('show')
})
Tek tek sekmeleri birkaç şekilde etkinleştirebilirsiniz:
$('#myTabs a[href="#profile"]').tab('show') // Select tab by name
$('#myTabs a:first').tab('show') // Select first tab
$('#myTabs a:last').tab('show') // Select last tab
$('#myTabs li:eq(2) a').tab('show') // Select third tab (0-indexed)
Bir öğeyi basitçe belirterek data-toggle="tab"
veya üzerinde JavaScript yazmadan bir sekmeyi veya hap navigasyonunu etkinleştirebilirsiniz . Sekmeye ve sınıflarının data-toggle="pill"
eklenmesi Bootstrap sekme stilini uygularken ve sınıflarının eklenmesi hap stilini uygular .nav
nav-tabs
ul
nav
nav-pills
<div>
<!-- Nav tabs -->
<ul class="nav nav-tabs" role="tablist">
<li role="presentation" class="active"><a href="#home" aria-controls="home" role="tab" data-toggle="tab">Home</a></li>
<li role="presentation"><a href="#profile" aria-controls="profile" role="tab" data-toggle="tab">Profile</a></li>
<li role="presentation"><a href="#messages" aria-controls="messages" role="tab" data-toggle="tab">Messages</a></li>
<li role="presentation"><a href="#settings" aria-controls="settings" role="tab" data-toggle="tab">Settings</a></li>
</ul>
<!-- Tab panes -->
<div class="tab-content">
<div role="tabpanel" class="tab-pane active" id="home">...</div>
<div role="tabpanel" class="tab-pane" id="profile">...</div>
<div role="tabpanel" class="tab-pane" id="messages">...</div>
<div role="tabpanel" class="tab-pane" id="settings">...</div>
</div>
</div>
Sekmeleri soldurmak .fade
için her birine ekleyin .tab-pane
. İlk sekme bölmesinin de .in
ilk içeriği görünür hale getirmesi gerekir.
<div class="tab-content">
<div role="tabpanel" class="tab-pane fade in active" id="home">...</div>
<div role="tabpanel" class="tab-pane fade" id="profile">...</div>
<div role="tabpanel" class="tab-pane fade" id="messages">...</div>
<div role="tabpanel" class="tab-pane fade" id="settings">...</div>
</div>
$().tab
Bir sekme öğesini ve içerik kapsayıcısını etkinleştirir. Sekme, DOM'da bir kapsayıcı düğümünü hedefleyen data-target
veya bir kapsayıcı düğümüne sahip olmalıdır. href
Yukarıdaki örneklerde sekmeler, niteliklere <a>
sahip data-toggle="tab"
s'lerdir.
.tab('show')
Verilen sekmeyi seçer ve ilişkili içeriğini gösterir. Daha önce seçilen diğer sekmelerin seçimi kaldırılır ve ilişkili içeriği gizlenir. Sekme bölmesi gerçekte gösterilmeden önce (yani shown.bs.tab
olay meydana gelmeden önce) arayana geri döner.
$('#someTab').tab('show')
Yeni bir sekme gösterilirken olaylar aşağıdaki sırayla tetiklenir:
hide.bs.tab
(geçerli etkin sekmede)show.bs.tab
(gösterilecekler sekmesinde)hidden.bs.tab
(önceki etkin sekmede, hide.bs.tab
etkinlikle aynı)shown.bs.tab
(yeni etkin olan az önce gösterilen sekmede, show.bs.tab
etkinlikle aynı)Hiçbir sekme zaten etkin değilse, hide.bs.tab
and hidden.bs.tab
olayları 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.target ve 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.target ve 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.target ve 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.target ve kullanın .event.relatedTarget |
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
e.target // newly activated tab
e.relatedTarget // previous active tab
})
Jason Frame tarafından yazılmış mükemmel jQuery.tipsy eklentisinden esinlenilmiştir; Araç ipuçları, resimlere dayanmayan, animasyonlar için CSS3 ve yerel başlık depolaması için veri öznitelikleri kullanan güncellenmiş bir sürümdür.
Sıfır uzunlukta başlıklara sahip araç ipuçları hiçbir zaman görüntülenmez.
Araç ipuçlarını görmek için aşağıdaki bağlantıların üzerine gelin:
Dar pantolon sonraki seviye keffiyeh , muhtemelen onları duymadınız. Fotoğraf kabini sakallı ham kot tipo vegan postacı çantası stumptown. Tarladan sofraya seitan, mcsweeney'nin fixie sürdürülebilir kinoa 8-bit amerikan giyiminde havlu richardson vinil chambray var . Sakal stumptown, hırka banh mi lomo thundercats. Tofu biyodizel williamsburg marfa, dört loko mcsweeney'nin temizleyici vegan chambray. Gerçekten ironik bir zanaatkar ne olursa olsun keytar , Scenester çiftlikten masaya banky Austin twitter ele freegan cred raw denim tek kökenli kahve virali.
Dört seçenek mevcuttur: üst, sağ, alt ve sola hizalı.
<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="left" title="Tooltip on left">Tooltip on left</button>
<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="top" title="Tooltip on top">Tooltip on top</button>
<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="bottom" title="Tooltip on bottom">Tooltip on bottom</button>
<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="right" title="Tooltip on right">Tooltip on right</button>
Performans nedenleriyle, Araç İpucu ve Popover veri apileri isteğe bağlıdır, yani bunları kendiniz başlatmanız gerekir .
Bir sayfadaki tüm araç ipuçlarını başlatmanın bir yolu, onları data-toggle
özelliklerine göre seçmektir:
$(function () {
$('[data-toggle="tooltip"]').tooltip()
})
Araç ipucu eklentisi, isteğe bağlı olarak içerik ve işaretleme oluşturur ve varsayılan olarak araç ipuçlarını tetikleyici öğelerinden sonra yerleştirir.
Araç ipucunu JavaScript aracılığıyla tetikleyin:
$('#example').tooltip(options)
Bir araç ipucu için gerekli işaretleme yalnızca bir data
niteliktir ve title
HTML öğesinde bir araç ipucuna sahip olmak istersiniz. Bir araç ipucunun oluşturulan işaretlemesi, bir konum gerektirmesine rağmen (varsayılan olarak, top
eklenti tarafından ayarlanır) oldukça basittir.
<!-- HTML to write -->
<a href="#" data-toggle="tooltip" title="Some tooltip text!">Hover over me</a>
<!-- Generated markup by the plugin -->
<div class="tooltip top" role="tooltip">
<div class="tooltip-arrow"></div>
<div class="tooltip-inner">
Some tooltip text!
</div>
</div>
Bazen birden çok satırı saran bir köprüye bir araç ipucu eklemek istersiniz. Araç ipucu eklentisinin varsayılan davranışı, onu yatay ve dikey olarak ortalamaktır. white-space: nowrap;
Bunu önlemek için çapalarınıza ekleyin .
.btn-group
a veya an içindeki öğelerde .input-group
veya tabloyla ilgili öğelerde ( <td>
, <th>
, <tr>
, , <thead>
, <tbody>
, <tfoot>
) araç ipuçlarını kullanırken , container: 'body'
istenmeyen yan etkilerden (öğenin genişlemesi ve/ veya araç ipucu tetiklendiğinde yuvarlatılmış köşelerini kaybetme).
tabindex="0"
Bir klavyeyle gezinen kullanıcılar ve özellikle yardımcı teknolojilerin kullanıcıları için, yalnızca bağlantılar, form kontrolleri veya bir özniteliği olan herhangi bir rastgele öğe gibi klavye odaklı öğelere araç ipuçları eklemelisiniz .
disabled
Bir veya öğesine araç ipucu eklemek için .disabled
öğeyi a öğesinin içine koyun ve bunun yerine <div>
araç ipucunu uygulayın .<div>
Seçenekler, veri öznitelikleri veya JavaScript aracılığıyla iletilebilir. Veri öznitelikleri için, seçenek adını olduğu data-
gibi ekleyin data-animation=""
.
Güvenlik nedenleriyle sanitize
, sanitizeFn
ve whiteList
seçeneklerinin veri öznitelikleri kullanılarak sağlanamayacağını unutmayın.
İsim | Tip | Varsayılan | Tanım |
---|---|---|---|
animasyon | boole | doğru | Araç ipucuna bir CSS soldurma geçişi uygulayın |
konteyner | dize | yanlış | yanlış | Araç ipucunu belirli bir öğeye ekler. Örnek: |
gecikme | sayı | nesne | 0 | Araç ipucunu (ms) gösterme ve gizleme gecikmesi - manuel tetikleme türü için geçerli değildir Bir numara verilirse, her iki gizleme/gösterme için gecikme uygulanır. Nesne yapısı: |
html | boole | yanlış | Araç ipucuna HTML ekleyin. Yanlışsa text , DOM'a içerik eklemek için jQuery'nin yöntemi kullanılacaktır. XSS saldırılarından endişe ediyorsanız metin kullanın. |
atama | dize | işlev | 'tepe' | Araç ipucu nasıl konumlandırılır - üst | alt | sol | sağ | Oto. Yerleşimi belirlemek için bir işlev kullanıldığında, ilk argüman olarak araç ipucu DOM düğümü ve ikinci argüman olarak tetikleyici öğe DOM düğümü ile çağrılır. Bağlam |
seçici | sicim | yanlış | Bir seçici sağlanırsa, araç ipucu nesneleri belirtilen hedeflere devredilecektir. Pratikte bu, dinamik olarak eklenen DOM öğelerine ( jQuery.on destek) araç ipuçlarını uygulamak için de kullanılır. Buna ve bilgilendirici bir örneğe bakın . |
şablon | sicim | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Araç ipucunu oluştururken kullanılacak temel HTML. Araç ipucu
En dıştaki sarmalayıcı öğenin |
Başlık | dize | işlev | '' |
|
tetiklemek | sicim | 'vurgulu odak' | Araç ipucu nasıl tetiklenir - tıklayın | üzerine gelin | odak | Manuel. Birden çok tetikleyici iletebilirsiniz; boşlukla ayırın. manual başka bir tetikleyici ile birleştirilemez. |
görüş alanı | dize | nesne | işlev | { seçici: 'gövde', dolgu: 0 } | Araç ipucunu bu öğenin sınırları içinde tutar. Örnek: Bir işlev verilirse, tek argümanı olarak tetikleyici öğe DOM düğümü ile çağrılır. Bağlam |
sterilize etmek | boole | doğru | Temizlemeyi etkinleştirin veya devre dışı bırakın. Etkinleştirilirse 'template' , 'content' seçenekler 'title' sterilize edilecektir. |
beyaz liste | nesne | Varsayılan değer | İzin verilen öznitelikleri ve etiketleri içeren nesne |
sanitizeFn | boş | işlev | hükümsüz | Burada kendi sterilize etme işlevinizi sağlayabilirsiniz. Sanitasyon yapmak için özel bir kitaplık kullanmayı tercih ediyorsanız bu yararlı olabilir. |
Bireysel araç ipuçları için seçenekler alternatif olarak yukarıda açıklandığı gibi veri öznitelikleri kullanılarak belirlenebilir.
$().tooltip(options)
Bir öğe koleksiyonuna bir araç ipucu işleyicisi ekler.
.tooltip('show')
Bir öğenin ipucunu ortaya çıkarır. Araç ipucu fiilen gösterilmeden önce (yani shown.bs.tooltip
olay meydana gelmeden önce) arayana geri döner. Bu, araç ipucunun "manuel" tetiklenmesi olarak kabul edilir. Sıfır uzunlukta başlıklara sahip araç ipuçları hiçbir zaman görüntülenmez.
$('#element').tooltip('show')
.tooltip('hide')
Bir öğenin ipucunu gizler. Araç ipucu gerçekten gizlenmeden önce arayana döner (örn.hidden.bs.tooltip
olay gerçekleşmeden önce) arayana geri döner. Bu, araç ipucunun "manuel" tetiklenmesi olarak kabul edilir.
$('#element').tooltip('hide')
.tooltip('toggle')
Bir öğenin ipucunu değiştirir. Araç ipucu gerçekten gösterilmeden veya gizlenmeden (yani shown.bs.tooltip
veya hidden.bs.tooltip
olayı gerçekleşmeden önce) arayana geri döner. Bu, araç ipucunun "manuel" tetiklenmesi olarak kabul edilir.
$('#element').tooltip('toggle')
.tooltip('destroy')
Bir öğenin ipucunu gizler ve yok eder. Temsilci kullanan (seçenek kullanılarak oluşturulan) araç ipuçları , selector
soyundan gelen tetikleyici öğelerde tek tek yok edilemez.
$('#element').tooltip('destroy')
Etkinlik tipi | Tanım |
---|---|
show.bs.tooltip | Bu olay, show örnek yöntemi çağrıldığında hemen tetiklenir. |
Gösterilen.bs.tooltip | Bu olay, araç ipucu kullanıcıya görünür hale getirildiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
hide.bs.tooltip | hide Bu olay, örnek yöntemi çağrıldığında hemen tetiklenir . |
gizli.bs.tooltip | Bu olay, ipucu kullanıcıdan gizlenmeyi bitirdiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
eklenen.bs.tooltip | Bu olay, show.bs.tooltip araç ipucu şablonu DOM'a eklendiğinde olaydan sonra tetiklenir. |
$('#myTooltip').on('hidden.bs.tooltip', function () {
// do something…
})
İkincil bilgileri barındırmak için herhangi bir öğeye iPad'deki gibi küçük içerik katmanları ekleyin.
Hem başlığı hem de içeriği sıfır uzunlukta olan popover'lar hiçbir zaman görüntülenmez.
Popover'lar, araç ipucu eklentisinin Bootstrap sürümünüze dahil edilmesini gerektirir.
Performans nedenleriyle, Araç İpucu ve Popover veri apileri isteğe bağlıdır, yani bunları kendiniz başlatmanız gerekir .
Bir sayfadaki tüm açılır pencereleri başlatmanın bir yolu, onları data-toggle
özniteliklerine göre seçmektir:
$(function () {
$('[data-toggle="popover"]').popover()
})
a .btn-group
veya an içindeki öğelerde .input-group
veya tabloyla ilgili öğelerde ( <td>
, <th>
, <tr>
, , <thead>
, <tbody>
, <tfoot>
) açılır pencereleri kullanırken, container: 'body'
istenmeyen yan etkilerden (öğenin genişlemesi ve/ veya popover tetiklendiğinde yuvarlatılmış köşelerini kaybetme).
disabled
Bir veya öğesine bir açılır pencere eklemek için .disabled
, öğeyi a öğesinin içine koyun ve bunun yerine <div>
açılır öğeyi uygulayın .<div>
Bazen birden çok satırı saran bir köprüye bir açılır pencere eklemek istersiniz. Popover eklentisinin varsayılan davranışı, onu yatay ve dikey olarak ortalamaktır. white-space: nowrap;
Bunu önlemek için çapalarınıza ekleyin .
Dört seçenek mevcuttur: üst, sağ, alt ve sola hizalı.
Lobortis'teki Sed Posuere Consectetur est. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Lobortis'teki Sed Posuere Consectetur est. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Lobortis'teki Sed Posuere Consectetur est. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Lobortis'teki Sed Posuere Consectetur est. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="left" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on left
</button>
<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="top" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on top
</button>
<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Vivamus
sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on bottom
</button>
<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="right" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
Popover on right
</button>
focus
Kullanıcının yaptığı bir sonraki tıklamada açılır pencereleri kapatmak için tetikleyiciyi kullanın .
Uygun çapraz tarayıcı ve platformlar arası davranış için etiketi değil etiketi kullanmanız ve <a>
ayrıca ve özelliklerini de <button>
eklemeniz gerekir .role="button"
tabindex
<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
JavaScript aracılığıyla açılır pencereleri etkinleştirin:
$('#example').popover(options)
Seçenekler, veri öznitelikleri veya JavaScript aracılığıyla iletilebilir. Veri öznitelikleri için, seçenek adını olduğu data-
gibi ekleyin data-animation=""
.
Güvenlik nedenleriyle sanitize
, sanitizeFn
ve whiteList
seçeneklerinin veri öznitelikleri kullanılarak sağlanamayacağını unutmayın.
İsim | Tip | Varsayılan | Tanım |
---|---|---|---|
animasyon | boole | doğru | Popover'a bir CSS solma geçişi uygulayın |
konteyner | dize | yanlış | yanlış | Popover'ı belirli bir öğeye ekler. Örnek: |
içerik | dize | işlev | '' |
Bir fonksiyon verilirse, |
gecikme | sayı | nesne | 0 | Popover'ı (ms) gösterme ve gizleme gecikmesi - manuel tetik tipi için geçerli değildir Bir numara verilirse, her iki gizleme/gösterme için gecikme uygulanır. Nesne yapısı: |
html | boole | yanlış | Popover'a HTML ekleyin. Yanlışsa text , DOM'a içerik eklemek için jQuery'nin yöntemi kullanılacaktır. XSS saldırılarından endişe ediyorsanız metin kullanın. |
atama | dize | işlev | 'Sağ' | Popover nasıl konumlandırılır - üst | alt | sol | sağ | Oto. Yerleşimi belirlemek için bir işlev kullanıldığında, ilk argüman olarak popover DOM düğümü ve ikinci argüman olarak tetikleyici öğe DOM düğümü ile çağrılır. Bağlam |
seçici | sicim | yanlış | Bir seçici sağlanırsa, popover nesneleri belirtilen hedeflere devredilecektir. Pratikte bu, dinamik HTML içeriğinin açılır pencerelerin eklenmesini sağlamak için kullanılır. Buna ve bilgilendirici bir örneğe bakın . |
şablon | sicim | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
Popover oluştururken kullanılacak temel HTML. Popover'lar . Popover'lar .
En dıştaki sarmalayıcı öğenin |
Başlık | dize | işlev | '' |
Bir fonksiyon verilirse, |
tetiklemek | sicim | 'Tıklayın' | Popover nasıl tetiklenir - tıklayın | üzerine gelin | odak | Manuel. Birden çok tetikleyici iletebilirsiniz; boşlukla ayırın. manual başka bir tetikleyici ile birleştirilemez. |
görüş alanı | dize | nesne | işlev | { seçici: 'gövde', dolgu: 0 } | Popover'ı bu öğenin sınırları içinde tutar. Örnek: Bir işlev verilirse, tek argümanı olarak tetikleyici öğe DOM düğümü ile çağrılır. Bağlam |
sterilize etmek | boole | doğru | Temizlemeyi etkinleştirin veya devre dışı bırakın. Etkinleştirilirse 'template' , 'content' seçenekler 'title' sterilize edilecektir. |
beyaz liste | nesne | Varsayılan değer | İzin verilen öznitelikleri ve etiketleri içeren nesne |
sanitizeFn | boş | işlev | hükümsüz | Burada kendi sterilize etme işlevinizi sağlayabilirsiniz. Sanitasyon yapmak için özel bir kitaplık kullanmayı tercih ediyorsanız bu yararlı olabilir. |
Bireysel popover'lar için seçenekler alternatif olarak yukarıda açıklandığı gibi veri öznitelikleri kullanılarak belirlenebilir.
$().popover(options)
Bir öğe koleksiyonu için açılır pencereleri başlatır.
.popover('show')
Bir öğenin popover'ını ortaya çıkarır. Popover fiilen gösterilmeden önce (yani shown.bs.popover
olay meydana gelmeden önce) arayana geri döner. Bu, popover'ın "manuel" tetiklenmesi olarak kabul edilir. Hem başlığı hem de içeriği sıfır uzunlukta olan popover'lar hiçbir zaman görüntülenmez.
$('#element').popover('show')
.popover('hide')
Bir öğenin açılır penceresini gizler. Popover fiilen gizlenmeden (yani hidden.bs.popover
olay meydana gelmeden önce) arayana geri döner. Bu, popover'ın "manuel" tetiklenmesi olarak kabul edilir.
$('#element').popover('hide')
.popover('toggle')
Bir öğenin açılır penceresini değiştirir. Popover fiilen gösterilmeden veya gizlenmeden (yani shown.bs.popover
veya hidden.bs.popover
olayı gerçekleşmeden önce) arayana geri döner. Bu, popover'ın "manuel" tetiklenmesi olarak kabul edilir.
$('#element').popover('toggle')
.popover('destroy')
Bir öğenin popover'ını gizler ve yok eder. Temsilci kullanan (seçenek kullanılarak oluşturulan) popover'lar, alttan gelen selector
tetikleyici öğelerde tek tek yok edilemez.
$('#element').popover('destroy')
Etkinlik tipi | Tanım |
---|---|
show.bs.popover | Bu olay, show örnek yöntemi çağrıldığında hemen tetiklenir. |
Gösterilen.bs.popover | Bu olay, açılır pencere kullanıcıya görünür hale getirildiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
hide.bs.popover | hide Bu olay, örnek yöntemi çağrıldığında hemen tetiklenir . |
gizli.bs.popover | Bu olay, açılır pencerenin kullanıcıdan gizlenmesi bittiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
eklenen.bs.popover | Bu olay, show.bs.popover popover şablonu DOM'a eklendiğinde olaydan sonra tetiklenir. |
$('#myPopover').on('hidden.bs.popover', function () {
// do something…
})
Bu eklenti ile tüm uyarı mesajlarına kapatma işlevi ekleyin.
Bir .close
düğme kullanırken, düğmenin ilk çocuğu olmalıdır .alert-dismissible
ve işaretlemede ondan önce hiçbir metin içeriği gelmemelidir.
Bunu ve bunu değiştirip tekrar deneyin. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis conectetur purus sit amet fermentum.
data-dismiss="alert"
Otomatik olarak bir uyarı kapatma işlevi vermek için kapat düğmenize ekleyin . Bir uyarıyı kapatmak, onu DOM'den kaldırır.
<button type="button" class="close" data-dismiss="alert" aria-label="Close">
<span aria-hidden="true">×</span>
</button>
Uyarılarınızın kapanırken animasyon kullanmasını sağlamak için, .fade
ve .in
sınıflarının kendilerine uygulanmış olduğundan emin olun.
$().alert()
data-dismiss="alert"
Özniteliğe sahip alt öğelerdeki tıklama olaylarını dinleyen bir uyarı yapar . (Data-api'nin otomatik başlatmasını kullanırken gerekli değildir.)
$().alert('close')
DOM'den kaldırarak bir uyarıyı kapatır. .fade
Öğede ve sınıfları varsa, .in
uyarı kaldırılmadan önce kaybolur.
Bootstrap'in uyarı eklentisi, uyarı işlevine bağlanmak için birkaç olayı ortaya çıkarır.
Etkinlik tipi | Tanım |
---|---|
kapat.bs.uyarı | Bu olay, close örnek yöntemi çağrıldığında hemen tetiklenir. |
kapalı.bs.alert | Bu olay, uyarı kapatıldığında tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
$('#myAlert').on('closed.bs.alert', function () {
// do something…
})
Düğmelerle daha fazlasını yapın. Araç çubukları gibi daha fazla bileşen için düğme durumlarını kontrol edin veya düğme grupları oluşturun.
Firefox, sayfa yüklemeleri boyunca form kontrol durumlarını (devre dışı ve kontrol edilmiş olma) sürdürür . Bunun için bir geçici çözüm kullanmaktır autocomplete="off"
. Mozilla hatası #654072'ye bakın .
data-loading-text="Loading..."
Bir düğmede yükleme durumu kullanmak için ekleyin .
Bu özellik v3.3.5'ten beri kullanımdan kaldırılmıştır ve v4'te kaldırılmıştır.
Bu gösteri uğruna ve kullanıyoruz data-loading-text
, $().button('loading')
ancak kullanabileceğiniz tek durum bu değil. Aşağıdaki $().button(string)
belgelerde bununla ilgili daha fazla bilgi edinin .
<button type="button" id="myButton" data-loading-text="Loading..." class="btn btn-primary">
Loading state
</button>
<script>
$('#myButton').on('click', function () {
var $btn = $(this).button('loading')
// business logic...
$btn.button('reset')
})
</script>
data-toggle="button"
Tek bir düğme üzerinde geçişi etkinleştirmek için ekleyin .
.active
vearia-pressed="true"
.active
Önceden değiştirilen düğmeler için, sınıfı ve aria-pressed="true"
niteliği button
kendinize eklemelisiniz .
<button type="button" class="btn btn-primary" data-toggle="button" aria-pressed="false">
Single toggle
</button>
İlgili stillerde geçişi etkinleştirmek için içeren data-toggle="buttons"
bir onay kutusuna veya radyo girişlerine ekleyin ..btn-group
.active
.active
Önceden seçilmiş seçenekler için, sınıfı girdiye label
kendiniz eklemelisiniz .
Bir onay kutusu düğmesinin işaretli durumu, düğmede bir click
olay tetiklenmeden güncellenirse (örneğin , girişin özelliğini <input type="reset">
ayarlayarak veya aracılığıyla ), girişteki sınıfı kendiniz checked
değiştirmeniz gerekecektir ..active
label
<div class="btn-group" data-toggle="buttons">
<label class="btn btn-primary active">
<input type="checkbox" checked> Checkbox 1 (pre-checked)
</label>
<label class="btn btn-primary">
<input type="checkbox"> Checkbox 2
</label>
<label class="btn btn-primary">
<input type="checkbox"> Checkbox 3
</label>
</div>
<div class="btn-group" data-toggle="buttons">
<label class="btn btn-primary active">
<input type="radio" name="options" id="option1" checked> Radio 1 (preselected)
</label>
<label class="btn btn-primary">
<input type="radio" name="options" id="option2"> Radio 2
</label>
<label class="btn btn-primary">
<input type="radio" name="options" id="option3"> Radio 3
</label>
</div>
$().button('toggle')
İtme durumunu değiştirir. Düğmeye etkinleştirilmiş görünümü verir.
$().button('reset')
Düğme durumunu sıfırlar - metni orijinal metne değiştirir. Bu yöntem asenkrondur ve sıfırlama fiilen tamamlanmadan önce döner.
$().button(string)
Metni herhangi bir veri tanımlı metin durumuna değiştirir.
<button type="button" id="myStateButton" data-complete-text="finished!" class="btn btn-primary">
...
</button>
<script>
$('#myStateButton').on('click', function () {
$(this).button('complete') // button text will be "finished!"
})
</script>
Kolay geçiş davranışı için bir avuç sınıf kullanan esnek eklenti.
Daralt, geçiş eklentisinin Bootstrap sürümünüze dahil edilmesini gerektirir.
Sınıf değişiklikleri yoluyla başka bir öğeyi göstermek ve gizlemek için aşağıdaki düğmeleri tıklayın:
.collapse
içeriği gizler.collapsing
geçişler sırasında uygulanır.collapse.in
içeriği gösterirÖznitelik içeren bir bağlantı href
veya öznitelik içeren bir düğme kullanabilirsiniz data-target
. Her iki durumda data-toggle="collapse"
da gereklidir.
<a class="btn btn-primary" role="button" data-toggle="collapse" href="#collapseExample" 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>
<div class="collapse" id="collapseExample">
<div class="well">
...
</div>
</div>
Panel bileşeniyle bir akordeon oluşturmak için varsayılan daraltma davranışını genişletin.
<div class="panel-group" id="accordion" role="tablist" aria-multiselectable="true">
<div class="panel panel-default">
<div class="panel-heading" role="tab" id="headingOne">
<h4 class="panel-title">
<a role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
Collapsible Group Item #1
</a>
</h4>
</div>
<div id="collapseOne" class="panel-collapse collapse in" role="tabpanel" aria-labelledby="headingOne">
<div class="panel-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="panel panel-default">
<div class="panel-heading" role="tab" id="headingTwo">
<h4 class="panel-title">
<a class="collapsed" role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
Collapsible Group Item #2
</a>
</h4>
</div>
<div id="collapseTwo" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingTwo">
<div class="panel-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="panel panel-default">
<div class="panel-heading" role="tab" id="headingThree">
<h4 class="panel-title">
<a class="collapsed" role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
Collapsible Group Item #3
</a>
</h4>
</div>
<div id="collapseThree" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingThree">
<div class="panel-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>
.panel-body
s'yi s ile değiştirmek de mümkündür .list-group
.
aria-expanded
Kontrol öğesine eklediğinizden emin olun . Bu öznitelik, ekran okuyuculara ve benzer yardımcı teknolojilere daraltılabilir öğenin mevcut durumunu açıkça tanımlar. Daraltılabilir öğe varsayılan olarak kapalıysa, değeri olmalıdır aria-expanded="false"
. in
Sınıfı kullanarak daraltılabilir öğeyi varsayılan olarak açık olacak şekilde ayarladıysanız aria-expanded="true"
, bunun yerine denetimde ayarlayın. Eklenti, daraltılabilir öğenin açılıp kapanmadığına bağlı olarak bu özniteliği otomatik olarak değiştirir.
Ek olarak, kontrol öğeniz tek bir daraltılabilir öğeyi hedefliyorsa - yani data-target
nitelik bir seçiciye işaret ediyorsa - kontrol öğesine daraltılabilir öğenin öğesini içeren id
ek bir nitelik ekleyebilirsiniz . Modern ekran okuyucular ve benzer yardımcı teknolojiler, kullanıcılara doğrudan daraltılabilir öğeye gitmeleri için ek kısayollar sağlamak için bu özelliği kullanır.aria-controls
id
Daraltma eklentisi, ağır kaldırmayı halletmek için birkaç sınıf kullanır:
.collapse
içeriği gizler.collapse.in
içeriği gösterir.collapsing
geçiş başladığında eklenir ve bittiğinde kaldırılırBu sınıflar adresinde bulunabilir component-animations.less
.
Katlanabilir bir öğenin kontrolünü otomatik olarak atamak için öğeye data-toggle="collapse"
ve a'yı eklemeniz yeterlidir. data-target
Nitelik data-target
, daraltmanın uygulanacağı bir CSS seçiciyi kabul eder. collapse
Sınıfı daraltılabilir öğeye eklediğinizden emin olun . Varsayılan olarak açılmasını istiyorsanız, ek sınıfı ekleyinin
.
Daraltılabilir bir kontrole akordeon benzeri grup yönetimi eklemek için data niteliğini ekleyin data-parent="#selector"
. Bunu çalışırken görmek için demoya bakın.
Şunlarla manuel olarak etkinleştirin:
$('.collapse').collapse()
Seçenekler, veri öznitelikleri veya JavaScript aracılığıyla iletilebilir. Veri öznitelikleri için, seçenek adını olduğu data-
gibi ekleyin data-parent=""
.
İsim | tip | varsayılan | tanım |
---|---|---|---|
ebeveyn | seçici | yanlış | Bir seçici sağlanırsa, bu daraltılabilir öğe gösterildiğinde belirtilen üst öğenin altındaki tüm daraltılabilir öğeler kapatılacaktır. (geleneksel akordeon davranışına benzer - bu, panel sınıfa bağlıdır) |
geçiş | boole | doğru | Çağrı sırasında daraltılabilir öğeyi değiştirir |
.collapse(options)
İçeriğinizi daraltılabilir bir öğe olarak etkinleştirir. İsteğe bağlı seçenekleri kabul eder object
.
$('#myCollapsible').collapse({
toggle: false
})
.collapse('toggle')
Daraltılabilir bir öğeyi gösterilen veya gizli olarak değiştirir. Arayana daraltılabilir öğe fiilen gösterilmeden veya gizlenmeden önce (yani shown.bs.collapse
veya hidden.bs.collapse
olayı gerçekleşmeden önce) döner.
.collapse('show')
Katlanabilir bir öğe gösterir. Katlanabilir öğe fiilen gösterilmeden önce (yani shown.bs.collapse
olay meydana gelmeden önce) arayana geri döner.
.collapse('hide')
Bir daraltılabilir öğeyi gizler. Arayana daraltılabilir öğe fiilen gizlenmeden önce (yani hidden.bs.collapse
olay meydana gelmeden önce) döner.
Bootstrap'in daraltma sınıfı, daraltma işlevine bağlanmak için birkaç olayı ortaya çıkarır.
Etkinlik tipi | Tanım |
---|---|
show.bs.collapse | Bu olay, show örnek yöntemi çağrıldığında hemen tetiklenir. |
Gösterilen.bs.collapse | Bu olay, bir daraltma öğesi kullanıcıya görünür hale getirildiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
hide.bs.collapse | hide Bu olay, yöntem çağrıldığında hemen tetiklenir . |
gizli.bs.collapse | Bu olay, bir daraltma öğesi kullanıcıdan gizlendiğinde tetiklenir (CSS geçişlerinin tamamlanmasını bekler). |
$('#myCollapsible').on('hidden.bs.collapse', function () {
// do something…
})
Döngü gibi öğeler arasında geçiş yapmak için bir slayt gösterisi bileşeni. İç içe dönen karuseller desteklenmez.
<div id="carousel-example-generic" class="carousel slide" data-ride="carousel">
<!-- Indicators -->
<ol class="carousel-indicators">
<li data-target="#carousel-example-generic" data-slide-to="0" class="active"></li>
<li data-target="#carousel-example-generic" data-slide-to="1"></li>
<li data-target="#carousel-example-generic" data-slide-to="2"></li>
</ol>
<!-- Wrapper for slides -->
<div class="carousel-inner" role="listbox">
<div class="item active">
<img src="..." alt="...">
<div class="carousel-caption">
...
</div>
</div>
<div class="item">
<img src="..." alt="...">
<div class="carousel-caption">
...
</div>
</div>
...
</div>
<!-- Controls -->
<a class="left carousel-control" href="#carousel-example-generic" role="button" data-slide="prev">
<span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</a>
<a class="right carousel-control" href="#carousel-example-generic" role="button" data-slide="next">
<span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</a>
</div>
Dönen bileşen genellikle erişilebilirlik standartlarıyla uyumlu değildir. Uyumlu olmanız gerekiyorsa, lütfen içeriğinizi sunmak için diğer seçenekleri göz önünde bulundurun.
Bootstrap, animasyonları için yalnızca CSS3'ü kullanır, ancak Internet Explorer 8 ve 9, gerekli CSS özelliklerini desteklemez. Bu nedenle, bu tarayıcıları kullanırken slayt geçiş animasyonları yoktur. Geçişler için jQuery tabanlı yedekleri dahil etmemeye bilerek karar verdik.
Sınıfın .active
slaytlardan birine eklenmesi gerekiyor. Aksi takdirde, atlıkarınca görünmez.
Kontroller için .glyphicon .glyphicon-chevron-left
ve .glyphicon .glyphicon-chevron-right
sınıfları mutlaka gerekli değildir. Bootstrap, .icon-prev
düz .icon-next
unicode alternatifleri sunar.
.carousel-caption
Herhangi bir içindeki öğeyle slaytlarınıza kolayca altyazı ekleyin .item
. Hemen hemen tüm isteğe bağlı HTML'leri oraya yerleştirin ve otomatik olarak hizalanacak ve biçimlendirilecektir.
<div class="item">
<img src="..." alt="...">
<div class="carousel-caption">
<h3>...</h3>
<p>...</p>
</div>
</div>
Karusel denetimlerinin düzgün çalışması için id
en dıştaki kapta ( ) bir öğesinin kullanılmasını gerektirir . .carousel
Birden fazla karusel eklerken veya bir karuseli değiştirirken id
ilgili kontrolleri güncellediğinizden emin olun.
Döngü konumunu kolayca kontrol etmek için veri özniteliklerini kullanın. slayt konumunu geçerli konumuna göre değiştiren veya data-slide
anahtar sözcüklerini kabul eder . Alternatif olarak, slayt konumunu ile başlayan belirli bir dizine kaydıran atlıkarıncaya ham bir slayt indeksi iletmek için kullanın .prev
next
data-slide-to
data-slide-to="2"
0
Nitelik data-ride="carousel"
, bir atlıkarıncayı sayfa yüklendiğinden başlayarak animasyon olarak işaretlemek için kullanılır. Aynı döngünün (gereksiz ve gereksiz) açık JavaScript başlatmasıyla birlikte kullanılamaz.
Carousel'i şu şekilde manuel olarak arayın:
$('.carousel').carousel()
Seçenekler, veri öznitelikleri veya JavaScript aracılığıyla iletilebilir. Veri öznitelikleri için, seçenek adını olduğu data-
gibi ekleyin data-interval=""
.
İsim | tip | varsayılan | tanım |
---|---|---|---|
Aralık | sayı | 5000 | Bir öğenin otomatik olarak döndürülmesi arasındaki gecikme süresi. False ise, atlıkarınca otomatik olarak döngüye girmez. |
Duraklat | dize | hükümsüz | "uçur" | olarak ayarlanırsa "hover" , atlıkarınca açık çevrimini duraklatır ve atlıkarınca açık mouseenter çevrimini sürdürür mouseleave . olarak ayarlanırsa null , atlıkarınca üzerinde gezinmek onu duraklatmaz. |
paketlemek | boole | doğru | Karuselin sürekli dönmesi mi yoksa sert duruşları mı olması gerektiği. |
tuş takımı | boole | doğru | Karuselin klavye olaylarına tepki vermesi gerekip gerekmediği. |
.carousel(options)
Atlıkarıncayı isteğe bağlı seçeneklerle object
başlatır ve öğeler arasında geçiş yapmaya başlar.
$('.carousel').carousel({
interval: 2000
})
.carousel('cycle')
Döngü öğeleri arasında soldan sağa doğru geçiş yapar.
.carousel('pause')
Karuselin öğeler arasında dolaşmasını durdurur.
.carousel(number)
Döngü belirli bir kareye (0 tabanlı, bir diziye benzer) döner.
.carousel('prev')
Önceki öğeye geçiş yapar.
.carousel('next')
Bir sonraki öğeye geçiş yapar.
Bootstrap'in carousel sınıfı, carousel işlevselliğine bağlanmak için iki olayı ortaya çıkarır.
Her iki olay da aşağıdaki ek özelliklere sahiptir:
direction
: Karuselin kaydığı yön (ya "left"
veya "right"
).relatedTarget
: Etkin öğe olarak yerine kaydırılan DOM öğesi.Tüm atlıkarınca olayları atlıkarıncanın kendisine ateşlenir (yani 'de <div class="carousel">
).
Etkinlik tipi | Tanım |
---|---|
slayt.bs.carousel | Bu olay, slide örnek yöntemi çağrıldığında hemen tetiklenir. |
slid.bs.carousel | Bu olay, atlıkarınca slayt geçişini tamamladığında tetiklenir. |
$('#myCarousel').on('slide.bs.carousel', function () {
// do something…
})
Eklenti eklentisi position: fixed;
, ile bulunan efekti taklit ederek açılır ve kapanır position: sticky;
. Sağdaki alt gezinme, eklenti eklentisinin canlı bir demosudur.
Eklenti eklentisini veri öznitelikleri aracılığıyla veya kendi JavaScript'inizle manuel olarak kullanın.Her iki durumda da, eklenmiş içeriğinizin konumu ve genişliği için CSS sağlamanız gerekir.
Not: Safari oluşturma hatası nedeniyle, çekme veya itme sütunu gibi nispeten konumlanmış bir öğede bulunan bir öğede eklenti eklentisini kullanmayın .
Eklenti eklentisi, her biri belirli bir durumu temsil eden üç sınıf arasında geçiş yapar: .affix
, .affix-top
ve .affix-bottom
. Stilleri sağlamanız gerekir, bunun dışında position: fixed;
:.affix
Gerçek konumları işlemek için bu sınıflar için (bu eklentiden bağımsız olarak)
Eklenti eklentisi şu şekilde çalışır:
.affix-top
, öğenin en üst konumunda olduğunu belirtmek için ekler. Bu noktada hiçbir CSS konumlandırması gerekli değildir..affix
değiştirir .affix-top
ve ayarlar position: fixed;
(Bootstrap'ın CSS'si tarafından sağlanır)..affix
ile değiştirilmelidir .affix-bottom
. Ofsetler isteğe bağlı olduğundan, birini ayarlamak uygun CSS'yi ayarlamanızı gerektirir. Bu durumda, position: absolute;
gerektiğinde ekleyin. Eklenti, öğeyi oradan nereye konumlandıracağını belirlemek için data niteliğini veya JavaScript seçeneğini kullanır.Aşağıdaki kullanım seçeneklerinden herhangi biri için CSS'nizi ayarlamak için yukarıdaki adımları izleyin.
Herhangi bir öğeye kolayca ekleme davranışı eklemek data-spy="affix"
için, casusluk yapmak istediğiniz öğeye eklemeniz yeterlidir. Bir öğenin sabitlenmesinin ne zaman değiştirileceğini tanımlamak için ofsetleri kullanın.
<div data-spy="affix" data-offset-top="60" data-offset-bottom="200">
...
</div>
Eklenti eklentisini JavaScript aracılığıyla çağırın:
$('#myAffix').affix({
offset: {
top: 100,
bottom: function () {
return (this.bottom = $('.footer').outerHeight(true))
}
}
})
Seçenekler, veri öznitelikleri veya JavaScript aracılığıyla iletilebilir. Veri öznitelikleri için, seçenek adını olduğu data-
gibi ekleyin data-offset-top="200"
.
İsim | tip | varsayılan | tanım |
---|---|---|---|
telafi etmek | sayı | fonksiyon | nesne | 10 | Kaydırma konumu hesaplanırken ekrandan kaydırılacak pikseller. Tek bir sayı sağlanmışsa, ofset hem üst hem de alt yönlerde uygulanacaktır. Benzersiz bir alt ve üst ofset sağlamak için sadece bir nesne offset: { top: 10 } veya offset: { top: 10, bottom: 5 } . Bir ofseti dinamik olarak hesaplamanız gerektiğinde bir fonksiyon kullanın. |
hedef | seçici | düğüm | jQuery öğesi | window nesne _ |
Ekin hedef öğesini belirtir. |
.affix(options)
İçeriğinizi ekli içerik olarak etkinleştirir. İsteğe bağlı seçenekleri kabul eder object
.
$('#myAffix').affix({
offset: 15
})
.affix('checkPosition')
İlgili öğelerin boyutlarına, konumuna ve kaydırma konumuna göre ekin durumunu yeniden hesaplar. , .affix
, .affix-top
ve .affix-bottom
sınıfları, eklenen içeriğe yeni duruma göre eklenir veya kaldırılır. Eklenen içeriğin doğru konumlandırılmasını sağlamak için, eklenen içeriğin veya hedef öğenin boyutları değiştirildiğinde bu yöntemin çağrılması gerekir.
$('#myAffix').affix('checkPosition')
Bootstrap'in eklenti eklentisi, eklenti işlevine bağlanmak için birkaç olayı ortaya çıkarır.
Etkinlik tipi | Tanım |
---|---|
affix.bs.affix | Bu olay, öğe yapıştırılmadan hemen önce tetiklenir. |
yapıştırılmış.bs.affix | Bu olay, öğe eklendikten sonra tetiklenir. |
affix-top.bs.affix | Bu olay, öğe üste yapıştırılmadan hemen önce tetiklenir. |
yapıştırılmış-top.bs.affix | Bu olay, öğe üste yapıştırıldıktan sonra tetiklenir. |
affix-bottom.bs.affix | Bu olay, öğe alta yapıştırılmadan hemen önce tetiklenir. |
yapıştırılmış-bottom.bs.affix | Bu olay, öğe alta yapıştırıldıktan sonra tetiklenir. |