JavaScript

Làm cho các thành phần của Bootstrap trở nên sống động — giờ đây với 13 plugin jQuery tùy chỉnh.

Đứng lên! Các tài liệu này dành cho v2.3.2, không còn được hỗ trợ chính thức. Kiểm tra phiên bản mới nhất của Bootstrap!

Cá nhân hoặc tổng hợp

Các plugin có thể được bao gồm riêng lẻ (mặc dù một số có phụ thuộc bắt buộc) hoặc tất cả cùng một lúc. Cả bootstrap.jsbootstrap.min.js đều chứa tất cả các plugin trong một tệp duy nhất.

Thuộc tính dữ liệu

Bạn có thể sử dụng tất cả các plugin Bootstrap hoàn toàn thông qua API đánh dấu mà không cần viết một dòng JavaScript nào. Đây là API lớp đầu tiên của Bootstrap và bạn nên cân nhắc đầu tiên khi sử dụng một plugin.

Điều đó nói rằng, trong một số trường hợp, bạn có thể muốn tắt chức năng này. Do đó, chúng tôi cũng cung cấp khả năng vô hiệu hóa API thuộc tính dữ liệu bằng cách hủy liên kết tất cả các sự kiện trên phần thân có tên miền bằng `` data-api ''. Nó trông như thế này:

  1. $ ( 'body' ). tắt ( '.data-api' )

Ngoài ra, để nhắm mục tiêu một plugin cụ thể, chỉ cần bao gồm tên của plugin làm không gian tên cùng với không gian tên data-api như sau:

  1. $ ( 'body' ). tắt ( '.alert.data-api' )

API có lập trình

Chúng tôi cũng tin rằng bạn có thể sử dụng tất cả các plugin Bootstrap hoàn toàn thông qua API JavaScript. Tất cả các API công khai đều là các phương thức đơn lẻ, có thể điều khiển được và trả về bộ sưu tập đã hoạt động.

  1. $ ( ".btn.danger" ). nút ( "chuyển đổi" ). addClass ( "chất béo" )

Tất cả các phương thức phải chấp nhận một đối tượng tùy chọn tùy chọn, một chuỗi nhắm mục tiêu một phương thức cụ thể hoặc không có gì (khởi chạy một plugin với hành vi mặc định):

  1. $ ( "#myModal" ). modal () // được khởi tạo với giá trị mặc định
  2. $ ( "#myModal" ). modal ({ keyboard : false }) // được khởi tạo không có bàn phím
  3. $ ( "#myModal" ). modal ( 'show' ) // khởi tạo và gọi chương trình ngay lập tức

Mỗi plugin cũng hiển thị hàm tạo thô của nó trên thuộc tính `Constructor` $.fn.popover.Constructor:. Nếu bạn muốn nhận một phiên bản plugin cụ thể, hãy truy xuất nó trực tiếp từ một phần tử $('[rel=popover]').data('popover'):.

Không có xung đột

Đôi khi cần sử dụng các plugin Bootstrap với các khung giao diện người dùng khác. Trong những trường hợp này, đôi khi có thể xảy ra xung đột không gian tên. Nếu điều này xảy ra, bạn có thể gọi .noConflictplugin mà bạn muốn hoàn nguyên giá trị.

  1. var bootstrapButton = $ . fn . nút . noConflict () // trả về $ .fn.button về giá trị được gán trước đó
  2. $ . fn . bootstrapBtn = bootstrapButton // cung cấp cho $ (). bootstrapBtn chức năng bootstrap

Sự kiện

Bootstrap cung cấp các sự kiện tùy chỉnh cho hầu hết các hành động độc đáo của plugin. Nói chung, chúng có dạng phân từ nguyên thể và quá khứ - trong đó nguyên thể (ví dụ show) được kích hoạt khi bắt đầu một sự kiện và dạng phân từ trong quá khứ của nó (ví dụ shown) được kích hoạt khi hoàn thành một hành động.

Tất cả các sự kiện nguyên bản đều cung cấp chức năng PreventDefault. Điều này cung cấp khả năng dừng thực hiện một hành động trước khi nó bắt đầu.

  1. $ ( '#myModal' ). on ( 'show' , function ( e ) {
  2. if (! data ) trả về e . PreventDefault () // dừng phương thức được hiển thị
  3. })

Giới thiệu về quá trình chuyển đổi

Đối với các hiệu ứng chuyển tiếp đơn giản, hãy bao gồm bootstrap-transfer.js một lần cùng với các tệp JS khác. Nếu bạn đang sử dụng bootstrap.js đã biên dịch (hoặc được rút gọn) , thì không cần phải bao gồm cái này — nó đã ở đó.

Trường hợp sử dụng

Một vài ví dụ về plugin chuyển đổi:

  • Trượt hoặc mờ dần trong các chế độ
  • Làm mờ các tab
  • Làm mờ dần các cảnh báo
  • Bảng băng chuyền trượt

Các ví dụ

Các chế độ được sắp xếp hợp lý, nhưng linh hoạt, lời nhắc hộp thoại với chức năng bắt buộc tối thiểu và các giá trị mặc định thông minh.

Ví dụ tĩnh

Một phương thức được hiển thị với tiêu đề, nội dung và tập hợp các hành động trong chân trang.

  1. <div class = "modal hide fade" >
  2. <div class = "modal-header" >
  3. <button type = "button" class = "close" data-allow = "modal" aria-hidden = "true" > & times; </button>
  4. <h3> Tiêu đề phương thức </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> Một cơ thể đẹp… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn"> Đóng </a> _
  11. <a href = "#" class = "btn btn-primary"> Lưu thay đổi </a>
  12. </div>
  13. </div>

Bản thử trực tiếp

Chuyển đổi một phương thức qua JavaScript bằng cách nhấp vào nút bên dưới. Nó sẽ trượt xuống và mờ dần từ đầu trang.

  1. <! - Nút để kích hoạt phương thức ->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal"> Khởi chạy phương thức demo </a>
  3.  
  4. <! - Phương thức ->
  5. <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "hộp thoại" aria-labellingby = "myModalLabel" aria-hidden = "true" >
  6. <div class = "modal-header" >
  7. <button type = "button" class = "close" data-dict = "modal" aria-hidden = "true" > × </button>
  8. <h3 id = "myModalLabel" > Tiêu đề phương thức </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> Một cơ thể đẹp… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dict = "modal" aria-hidden = "true" > Đóng </button>
  15. <button class = "btn btn-primary" > Lưu thay đổi </button>
  16. </div>
  17. </div>

Cách sử dụng

Qua các thuộc tính dữ liệu

Kích hoạt một phương thức mà không cần viết JavaScript. Đặt data-toggle="modal"trên một phần tử bộ điều khiển, như một nút, cùng với data-target="#foo"hoặc href="#foo"để nhắm mục tiêu một phương thức cụ thể để chuyển đổi.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > Khởi chạy modal </button>

Qua JavaScript

Gọi một phương thức có id myModalvới một dòng JavaScript:

  1. $ ( '#myModal' ). phương thức ( tùy chọn )

Tùy chọn

Các tùy chọn có thể được chuyển qua các thuộc tính dữ liệu hoặc JavaScript. Đối với các thuộc tính dữ liệu, hãy nối tên tùy chọn vào data-, như trong data-backdrop="".

Tên loại hình mặc định sự mô tả
phông nền boolean thật Bao gồm một yếu tố phương thức-phông nền. Ngoài ra, chỉ định staticphông nền không đóng phương thức khi nhấp chuột.
bàn phím boolean thật Đóng phương thức khi nhấn phím thoát
buổi bieu diễn boolean thật Hiển thị phương thức khi khởi tạo.
Xa xôi đường dẫn sai

Nếu một url từ xa được cung cấp, nội dung sẽ được tải qua loadphương thức của jQuery và được đưa vào .modal-body. Nếu bạn đang sử dụng api dữ liệu, bạn có thể sử dụng hrefthẻ để chỉ định nguồn từ xa. Ví dụ về điều này được hiển thị bên dưới:

  1. <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>

Phương pháp

.modal (tùy chọn)

Kích hoạt nội dung của bạn như một phương thức. Chấp nhận một tùy chọn tùy chọn object.

  1. $ ( '#myModal' ). phương thức ({
  2. bàn phím : false
  3. })

.modal ('chuyển đổi')

Chuyển đổi một phương thức theo cách thủ công.

  1. $ ( '#myModal' ). modal ( 'chuyển đổi' )

.modal ('hiển thị')

Mở một phương thức theo cách thủ công.

  1. $ ( '#myModal' ). modal ( 'show' )

.modal ('ẩn')

Ẩn một phương thức theo cách thủ công.

  1. $ ( '#myModal' ). modal ( 'ẩn' )

Sự kiện

Lớp phương thức của Bootstrap cho thấy một vài sự kiện để kết nối vào chức năng phương thức.

Biến cố Sự mô tả
buổi bieu diễn Sự kiện này kích hoạt ngay lập tức khi showphương thức thể hiện được gọi.
cho xem Sự kiện này được kích hoạt khi phương thức đã được hiển thị cho người dùng (sẽ đợi quá trình chuyển đổi css hoàn tất).
ẩn giấu Sự kiện này được kích hoạt ngay lập tức khi hidephương thức thể hiện đã được gọi.
ẩn giấu Sự kiện này được kích hoạt khi phương thức hoàn tất bị ẩn khỏi người dùng (sẽ đợi quá trình chuyển đổi css hoàn tất).
  1. $ ( '#myModal' ). on ( 'hidden' , function () {
  2. // làm việc gì đó…
  3. })

Ví dụ trong thanh điều hướng

Plugin ScrollSpy dùng để tự động cập nhật các mục tiêu điều hướng dựa trên vị trí cuộn. Cuộn khu vực bên dưới thanh điều hướng và xem sự thay đổi lớp đang hoạt động. Các mục phụ thả xuống cũng sẽ được đánh dấu.

@mập mạp

Bàn phím quảng cáo xà cạp, bữa tiệc nửa buổi id nghệ thuật dolor labore. Pitchfork yr enim lo-fi trước khi họ bán hết. Tumblr quyền xe đạp nông-to-table bất cứ điều gì. Anim keffiyeh carles cardigan. Gian hàng ảnh 3 con sói mặt trăng của Velit seitan mcsweeney. Cosby áo len lomo quần short jean, williamsburg hoodie minim qui có thể bạn chưa nghe nói về chúng et cardigan quỹ tín thác quần áo culpa biodiesel wes anderson thẩm mỹ. Nihil hình xăm tố cáo, tín dụng mỉa mai biodiesel keffiyeh nghệ nhân ullamcoequat.

@mdo

Veniam marfa ria mép ván trượt, adipisicing fugiat velit pitchfork râu. Freegan râu aliqua cupidatat mcsweeney's vero. Cupidatat bốn loko nisi, ea helvetica nulla carles. Xe chở đồ ăn bằng áo len hình xăm cosby, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles tập thể dục không thẩm mỹ quis gentrify. Brooklyn adipisicing bia thủ công phó bàn thờ chính.

một

Occaecat goodso aliqua delectus. Fap bia thủ công cần ván trượt ea. Lomo xe đạp quyền adipisicing banh mi, velit ea sunt cấp tiếp theo locavore cà phê một nguồn gốc ở magna veniam. Cuộc sống cao id vinyl, echo park resultat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Túi nhỏ nhắn tự làm Consectetur nisi. Cred ex in, bền vững delectus consectetur fanny pack iphone.

hai

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.

three

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 messenger bag marfa bất cứ thứ gì xe tải đồ ăn ngon. Sapiente synth id giả định. Locavore sed helvetica mỉa mai châm biếm, những chiếc áo khoác sấm sét mà bạn có thể chưa từng nghe về chúng do áo hoodie không chứa gluten lo-fi fap aliquip. Labore elit placeat trước khi họ bán hết hàng, terry richardson proident brunch nesciunt quis cosby sweater nghệ nhân nghệ nhân. Cardigan bia thủ công seitan velit làm sẵn. VHS chambray labris tempor veniam. Hoạt hình mollit minimine hàng hóa nhỏ ullamco Thundercats.


Cách sử dụng

Qua các thuộc tính dữ liệu

Để dễ dàng thêm hành vi cuộn lên vào điều hướng thanh trên cùng của bạn, chỉ cần thêm data-spy="scroll"vào phần tử bạn muốn theo dõi (thông thường nhất là phần thân) và data-target=".navbar"chọn điều hướng sẽ sử dụng. Bạn sẽ muốn sử dụng scrollspy với một .navthành phần.

  1. <body data-spy = "scroll" data-target = ".navbar" > ... </body>

Qua JavaScript

Gọi cuộn giấy qua JavaScript:

  1. $ ( '#navbar' ). scrollspy ()
Đứng lên! Các liên kết trên thanh điều hướng phải có các mục tiêu id có thể phân giải được. Ví dụ, a <a href="#home">home</a>phải tương ứng với một cái gì đó trong dom như <div id="home"></div>.

Phương pháp

.scrollspy ('làm mới')

Khi sử dụng scrollspy kết hợp với việc thêm hoặc xóa các phần tử khỏi DOM, bạn sẽ cần gọi phương thức làm mới như sau:

  1. $ ( '[data-spy = "scroll"]' ). each ( function () {
  2. var $ spy = $ ( this ). scrollspy ( 'làm mới' )
  3. });

Tùy chọn

Các tùy chọn có thể được chuyển qua các thuộc tính dữ liệu hoặc JavaScript. Đối với các thuộc tính dữ liệu, hãy nối tên tùy chọn vào data-, như trong data-offset="".

Tên loại hình mặc định sự mô tả
bù lại con số 10 Điểm ảnh để bù đắp từ trên xuống khi tính toán vị trí của cuộn.

Sự kiện

Biến cố Sự mô tả
hoạt động Sự kiện này kích hoạt bất cứ khi nào một mục mới được kích hoạt bởi con lăn.

Các tab mẫu

Thêm chức năng tab động, nhanh chóng để chuyển đổi qua các ngăn nội dung cục bộ, ngay cả qua menu thả xuống.

Chất liệu denim thô có thể bạn chưa từng nghe nói về chúng quần short jean Austin. Nesciunt đậu phụ stumptown aliqua, làm sạch tổng thể retro synth. Ria mép khuôn mẫu, williamsburg carles vegan helvetica. Reploynderit đồ tể retro keffiyeh dreamcatcher synth. Áo len Cosby eu banh mi, qui irure terry richardson ex ink. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan may mặc của mỹ, butcher 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.


Cách sử dụng

Bật các tab có thể chuyển thành tab qua JavaScript (mỗi tab cần được kích hoạt riêng lẻ):

  1. $ ( '#myTab a' ). nhấp vào ( hàm ( e ) {
  2. e . PreventDefault ();
  3. $ ( cái này ). tab ( 'show' );
  4. })

Bạn có thể kích hoạt các tab riêng lẻ theo một số cách:

  1. $ ( '#myTab a [href = "# hồ sơ"]' ). tab ( 'show' ); // Chọn tab theo tên
  2. $ ( '#myTab a: first' ). tab ( 'show' ); // Chọn tab đầu tiên
  3. $ ( '#myTab a: last' ). tab ( 'show' ); // Chọn tab cuối cùng
  4. $ ( '#myTab li: eq (2) a' ). tab ( 'show' ); // Chọn tab thứ ba (được lập chỉ mục 0)

Đánh dấu

Bạn có thể kích hoạt điều hướng tab hoặc viên thuốc mà không cần viết bất kỳ JavaScript nào bằng cách chỉ định data-toggle="tab"hoặc data-toggle="pill"trên một phần tử. Thêm navnav-tabscác lớp vào tab ulsẽ áp dụng kiểu dáng tab Bootstrap.

  1. <ul class = "nav nav-tabs" >
  2. <li> <a href = "#home" data-toggle = "tab"> Trang chủ </a> </li >
  3. <li> <a href = "#profile" data-toggle = "tab"> Hồ sơ </a> </li >
  4. <li> <a href = "#messages" data-toggle = "tab"> Tin nhắn </a> </li >
  5. <li> <a href = "#settings" data-toggle = "tab"> Cài đặt </a> </li >
  6. </ul>

Phương pháp

tab $ ().

Kích hoạt phần tử tab và vùng chứa nội dung. Tab phải có một data-targethoặc một hrefnhắm mục tiêu một nút vùng chứa trong DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" > <a href = "#home"> Trang chủ </a> </li>
  3. <li> <a href = "#profile"> Hồ </a> </li>
  4. <li> <a href = "#messages"> Tin nhắn </a> </li>
  5. <li> <a href = "#settings"> Cài đặt </a> </li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <div class = "tab-pane active" id = "home" > ... </div>
  10. <div class = "tab-pane" id = "profile" > ... </div>
  11. <div class = "tab-pane" id = "messages" > ... </div>
  12. <div class = "tab-pane" id = "settings" > ... </div>
  13. </div>
  14.  
  15. <script>
  16. $ ( function () {
  17. $ ( '#myTab a: last' ). tab ( 'show' );
  18. })
  19. </script>

Sự kiện

Biến cố Sự mô tả
buổi bieu diễn Sự kiện này kích hoạt trên chương trình tab, nhưng trước khi tab mới được hiển thị. Sử dụng event.targetevent.relatedTargetđể nhắm mục tiêu tab đang hoạt động và tab đang hoạt động trước đó (nếu có) tương ứng.
cho xem Sự kiện này kích hoạt trên tab hiển thị sau khi tab được hiển thị. Sử dụng event.targetevent.relatedTargetđể nhắm mục tiêu tab đang hoạt động và tab đang hoạt động trước đó (nếu có) tương ứng.
  1. $ ( 'a [data-toggle = "tab"]' ). on ( 'shows' , function ( e ) {
  2. e . mục tiêu // tab đã kích hoạt
  3. e . RelatedTarget // tab trước
  4. })

Các ví dụ

Lấy cảm hứng từ plugin jQuery.tipsy tuyệt vời được viết bởi Jason Frame; Chú giải công cụ là phiên bản cập nhật, không dựa vào hình ảnh, sử dụng CSS3 cho hoạt ảnh và thuộc tính dữ liệu để lưu trữ tiêu đề cục bộ.

Vì lý do hiệu suất, chú giải công cụ và apis dữ liệu cửa sổ bật lên được chọn tham gia, nghĩa là bạn phải tự khởi tạo chúng .

Di chuột qua các liên kết bên dưới để xem các chú giải công cụ:

Những chiếc quần bó sát cấp độ tiếp theo có thể bạn chưa từng nghe nói về chúng. Ảnh gian hàng râu vải thô denim letterpress túi đưa tin thuần chay stumptown. Trang phục từ trang trại đến bàn ăn, quần áo Mỹ 8-bit quinoa bền vững fixie của mcsweeney có một chambray vinyl richardson terry. Beard stumptown, cardigans banh mi lomo Thundercats. Đậu phụ diesel sinh học williamsburg marfa, bánh chambray thuần chay làm sạch 4 loko mcsweeney. Một nghệ nhân thực sự mỉa mai bất cứ thứ gì keytar , scenester farm-to-table banky Austin twitter xử lý freegan credit thô denim single-origin coffee lan truyền.

Bốn hướng

Chú giải công cụ trong nhóm đầu vào

Khi sử dụng chú giải công cụ và cửa sổ bật lên với các nhóm đầu vào Bootstrap, bạn sẽ phải đặt containertùy chọn (được nêu dưới đây) để tránh các tác dụng phụ không mong muốn.


Cách sử dụng

Kích hoạt chú giải công cụ qua JavaScript:

  1. $ ( '#example' ). chú giải công cụ ( tùy chọn )

Tùy chọn

Các tùy chọn có thể được chuyển qua các thuộc tính dữ liệu hoặc JavaScript. Đối với các thuộc tính dữ liệu, hãy nối tên tùy chọn vào data-, như trong data-animation="".

Tên loại hình mặc định sự mô tả
hoạt hình boolean thật áp dụng một chuyển đổi mờ dần css cho chú giải công cụ
html boolean sai Chèn html vào chú giải công cụ. Nếu sai, phương thức của jquery textsẽ được sử dụng để chèn nội dung vào dom. Sử dụng văn bản nếu bạn lo lắng về các cuộc tấn công XSS.
vị trí chuỗi | hàm số 'đứng đầu' cách đặt chú giải công cụ - trên cùng | đáy | trái | bên phải
bộ chọn sợi dây sai Nếu một bộ chọn được cung cấp, các đối tượng chú giải công cụ sẽ được ủy quyền cho các mục tiêu được chỉ định.
Tiêu đề chuỗi | hàm số '' giá trị tiêu đề mặc định nếu không có thẻ `title`
Kích hoạt sợi dây 'di chuột tiêu điểm' cách kích hoạt chú giải công cụ - nhấp vào | di chuột qua | tiêu điểm | thủ công. Lưu ý rằng bạn có thể thay đổi kích hoạt vượt qua chữ hoa chữ thường, phân tách khoảng cách, các loại trình kích hoạt.
sự chậm trễ số | sự vật 0

độ trễ hiển thị và ẩn chú giải công cụ (mili giây) - không áp dụng cho loại trình kích hoạt thủ công

Nếu một số được cung cấp, độ trễ được áp dụng cho cả ẩn / hiện

Cấu trúc đối tượng là:delay: { show: 500, hide: 100 }

thùng đựng hàng chuỗi | sai sai

Thêm chú giải công cụ vào một phần tử cụ thểcontainer: 'body'

Đứng lên! Ngoài ra, các tùy chọn cho chú giải công cụ riêng lẻ có thể được chỉ định thông qua việc sử dụng các thuộc tính dữ liệu.

Đánh dấu

  1. <a href = "#" data-toggle = "tooltip" title = "first tooltip"> di chuột qua tôi </a>

Phương pháp

$ (). chú giải công cụ (tùy chọn)

Đính kèm trình xử lý chú giải công cụ vào tập hợp phần tử.

.tooltip ('hiển thị')

Tiết lộ chú giải công cụ của phần tử.

  1. $ ( '#element' ). chú giải công cụ ( 'hiển thị' )

.tooltip ('ẩn')

Ẩn chú giải công cụ của phần tử.

  1. $ ( '#element' ). chú giải công cụ ( 'ẩn' )

.tooltip ('chuyển đổi')

Chuyển đổi chú giải công cụ của phần tử.

  1. $ ( '#element' ). chú giải công cụ ( 'chuyển đổi' )

.tooltip ('tiêu diệt')

Ẩn và hủy chú giải công cụ của phần tử.

  1. $ ( '#element' ). chú giải công cụ ( 'tiêu diệt' )

Các ví dụ

Thêm các lớp phủ nhỏ của nội dung, như trên iPad, vào bất kỳ phần tử nào để có thông tin phụ về nhà ở. Di chuột qua nút để kích hoạt cửa sổ bật lên. Yêu cầu chú giải công cụ được bao gồm.

Cửa sổ bật lên tĩnh

Có bốn tùy chọn: căn trên, phải, dưới và căn trái.

Popover top

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Bìm bìm bìm biếc.

Bật lên bên phải

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Bìm bìm bìm biếc.

Cửa sổ bật lên phía dưới

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Bìm bìm bìm biếc.

Cửa sổ bật lên bên trái

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Bìm bìm bìm biếc.

Không có đánh dấu nào được hiển thị là các cửa sổ bật lên được tạo từ JavaScript và nội dung trong một datathuộc tính.

Bản thử trực tiếp

Bốn hướng


Cách sử dụng

Bật cửa sổ bật lên qua JavaScript:

  1. $ ( '#example' ). popover ( tùy chọn )

Tùy chọn

Các tùy chọn có thể được chuyển qua các thuộc tính dữ liệu hoặc JavaScript. Đối với các thuộc tính dữ liệu, hãy nối tên tùy chọn vào data-, như trong data-animation="".

Tên loại hình mặc định sự mô tả
hoạt hình boolean thật áp dụng một chuyển đổi mờ dần css cho chú giải công cụ
html boolean sai Chèn html vào cửa sổ bật lên. Nếu sai, phương thức của jquery textsẽ được sử dụng để chèn nội dung vào dom. Sử dụng văn bản nếu bạn lo lắng về các cuộc tấn công XSS.
vị trí chuỗi | hàm số 'bên phải' làm thế nào để định vị cửa sổ bật lên - trên cùng | đáy | trái | bên phải
bộ chọn sợi dây sai nếu một bộ chọn được cung cấp, các đối tượng chú giải công cụ sẽ được ủy quyền cho các mục tiêu được chỉ định
Kích hoạt sợi dây 'nhấp chuột' cách kích hoạt cửa sổ bật lên - nhấp vào | di chuột qua | tiêu điểm | thủ công
Tiêu đề chuỗi | hàm số '' giá trị tiêu đề mặc định nếu thuộc tính `title` không có
Nội dung chuỗi | hàm số '' giá trị nội dung mặc định nếu thuộc tính `data-content` không có
sự chậm trễ số | sự vật 0

độ trễ hiển thị và ẩn cửa sổ bật lên (mili giây) - không áp dụng cho loại kích hoạt thủ công

Nếu một số được cung cấp, độ trễ được áp dụng cho cả ẩn / hiện

Cấu trúc đối tượng là:delay: { show: 500, hide: 100 }

thùng đựng hàng chuỗi | sai sai

Thêm cửa sổ bật lên vào một phần tử cụ thểcontainer: 'body'

Đứng lên! Ngoài ra, các tùy chọn cho các cửa sổ bật lên riêng lẻ có thể được chỉ định thông qua việc sử dụng các thuộc tính dữ liệu.

Đánh dấu

Vì lý do hiệu suất, Tooltip và Popover data-apis được chọn tham gia. Nếu bạn muốn sử dụng chúng, chỉ cần chỉ định một tùy chọn bộ chọn.

Phương pháp

$ (). popover (tùy chọn)

Khởi tạo các cửa sổ bật lên cho một tập hợp phần tử.

.popover ('show')

Tiết lộ một phần tử bật lên.

  1. $ ( '#element' ). popover ( 'show' )

.popover ('ẩn')

Ẩn một phần tử bật lên.

  1. $ ( '#element' ). popover ( 'ẩn' )

.popover ('chuyển đổi')

Chuyển đổi cửa sổ bật lên phần tử.

  1. $ ( '#element' ). popover ( 'chuyển đổi' )

.popover ('tiêu diệt')

Ẩn và phá hủy cửa sổ bật lên của một phần tử.

  1. $ ( '#element' ). popover ( 'tiêu diệt' )

Cảnh báo mẫu

Thêm chức năng loại bỏ cho tất cả các thông báo cảnh báo với plugin này.

Guacamole thánh! Tốt nhất bạn nên tự kiểm tra, trông bạn không quá ổn.

Oh snap! Bạn có một lỗi!

Thay đổi cái này cái kia và thử lại. Duis mollis, est non rowo luctus, nisi erat porttitor ligula, eget lacinia odio sem perf elit. Cras mattis consectetur purus sit amet fermentum.

Thực hiện hành động này Hoặc làm điều này


Cách sử dụng

Cho phép loại bỏ cảnh báo qua JavaScript:

  1. $ ( ".alert" ). alert ()

Đánh dấu

Chỉ cần thêm data-dismiss="alert"vào nút đóng của bạn để tự động cung cấp chức năng đóng cảnh báo.

  1. <a class = "close" data-dismiss = "alert" href = "#"> & lần ; </a>

Phương pháp

$ (). alert ()

Kết hợp tất cả các cảnh báo với chức năng đóng. Để cảnh báo của bạn hiển thị hoạt ảnh khi đóng cửa, hãy đảm bảo rằng chúng đã áp dụng loại .fade.inlớp cho chúng.

.alert ('đóng')

Đóng một cảnh báo.

  1. $ ( ".alert" ). alert ( 'đóng' )

Sự kiện

Lớp cảnh báo của Bootstrap cho thấy một vài sự kiện để kết nối với chức năng cảnh báo.

Biến cố Sự mô tả
gần Sự kiện này kích hoạt ngay lập tức khi closephương thức thể hiện được gọi.
đóng cửa Sự kiện này được kích hoạt khi cảnh báo đã được đóng (sẽ đợi quá trình chuyển đổi css hoàn tất).
  1. $ ( '# my-alert' ). bind ( 'đóng' , function () {
  2. // làm việc gì đó…
  3. })

Ví dụ sử dụng

Làm được nhiều việc hơn với các nút. Các trạng thái nút điều khiển hoặc tạo nhóm nút cho nhiều thành phần hơn như thanh công cụ.

Trạng thái

Thêm data-loading-text="Loading..."để sử dụng trạng thái tải trên một nút.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Loading ..." > Trạng thái đang tải </button>

Chuyển đổi đơn

Thêm data-toggle="button"để kích hoạt bật tắt trên một nút duy nhất.

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" > Chuyển đổi một lần </button>

Hộp kiểm

Thêm data-toggle="buttons-checkbox"cho chuyển đổi kiểu hộp kiểm trên btn-group.

  1. <div class = "btn-group" data-toggle = "button-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > Left </button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Right </button>
  5. </div>

Đài

Thêm data-toggle="buttons-radio"cho chuyển đổi kiểu radio trên btn-group.

  1. <div class = "btn-group" data-toggle = "button-radio" >
  2. <button type = "button" class = "btn btn-primary" > Left </button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Right </button>
  5. </div>

Cách sử dụng

Bật các nút qua JavaScript:

  1. $ ( '.nav-tabs' ). nút ()

Đánh dấu

Thuộc tính dữ liệu là không thể thiếu đối với plugin nút. Kiểm tra mã ví dụ bên dưới để biết các loại đánh dấu khác nhau.

Tùy chọn

Không có

Phương pháp

Nút $ (). ('chuyển đổi')

Chuyển đổi trạng thái đẩy. Cung cấp cho nút giao diện như nó đã được kích hoạt.

Đứng lên! Bạn có thể bật tính năng tự động bật / tắt nút bằng cách sử dụng data-togglethuộc tính.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

Nút $ (). ('đang tải')

Đặt trạng thái nút thành tải - tắt nút và hoán đổi văn bản thành tải văn bản. Việc tải văn bản phải được xác định trên phần tử nút bằng cách sử dụng thuộc tính dữ liệu data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "loading thứ ..." > ... </button>
Đứng lên! Firefox vẫn tồn tại trạng thái bị vô hiệu hóa qua các lần tải trang . Một giải pháp cho điều này là sử dụng autocomplete="off".

Nút $ (). ('đặt lại')

Đặt lại trạng thái nút - hoán đổi văn bản thành văn bản gốc.

Nút $ (). (chuỗi)

Đặt lại trạng thái nút - hoán đổi văn bản thành bất kỳ trạng thái văn bản nào do dữ liệu xác định.

  1. <button type = "button" class = "btn" data-complete-text = "xong!" > ... </button>
  2. <script>
  3. $ ( '.btn' ). nút ( 'hoàn thành' )
  4. </script>

Về

Nhận các kiểu cơ sở và hỗ trợ linh hoạt cho các thành phần có thể thu gọn như đàn accordion và điều hướng.

* Yêu cầu bao gồm plugin Chuyển đổi.

Ví dụ đàn accordion

Sử dụng plugin thu gọn, chúng tôi đã xây dựng một tiện ích phong cách đàn accordion đơn giản:

Phim hoạt hình chuyên nghiệp sáo ngữ, enim eiusmod cuộc sống cao cấp accamus terry richardson quảng cáo mực. 3 Wolf moon officia aute, bữa nửa buổi dolor trượt ván không cupidatat. Xe tải thực phẩm quinoa nesciunt labourum eiusmod. Brunch 3 Wolf moon tempor, sunt aliqua đặt một con chim trên đó mực cà phê nguồn gốc đơn nulla assnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labre wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher Vice lomo. Leggings occaecat craft beer farm-to-table, raw denim synth nesciunt thẩm mỹ có thể bạn chưa từng nghe về chúng tố cáo VHS bền vững lao động.
Phim hoạt hình chuyên nghiệp sáo ngữ, enim eiusmod cuộc sống cao cấp accamus terry richardson quảng cáo mực. 3 Wolf moon officia aute, bữa nửa buổi dolor trượt ván không cupidatat. Xe tải thực phẩm quinoa nesciunt labourum eiusmod. Brunch 3 Wolf moon tempor, sunt aliqua đặt một con chim trên đó mực cà phê nguồn gốc đơn nulla assnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labre wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher Vice lomo. Leggings occaecat craft beer farm-to-table, raw denim synth nesciunt thẩm mỹ có thể bạn chưa từng nghe về chúng tố cáo VHS bền vững lao động.
Phim hoạt hình chuyên nghiệp sáo ngữ, enim eiusmod cuộc sống cao cấp accamus terry richardson quảng cáo mực. 3 Wolf moon officia aute, bữa nửa buổi dolor trượt ván không cupidatat. Xe tải thực phẩm quinoa nesciunt labourum eiusmod. Brunch 3 Wolf moon tempor, sunt aliqua đặt một con chim trên đó mực cà phê nguồn gốc đơn nulla assnda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labre wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher Vice lomo. Leggings occaecat craft beer farm-to-table, raw denim synth nesciunt thẩm mỹ có thể bạn chưa từng nghe về chúng tố cáo VHS bền vững lao động.
  1. <div class = "accordion" id = "accordion2" >
  2. <div class = "accordion-group" >
  3. <div class = "accordion-header" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne"> _
  5. Mục nhóm có thể thu gọn # 1
  6. </a>
  7. </div>
  8. <div id = "sậpOne" class = "đàn accordion-body thu gọn trong" >
  9. <div class = "accordion-inner" >
  10. Phim hoạt hình ...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "accordion-group" >
  15. <div class = "accordion-header" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo"> _
  17. Mục nhóm có thể thu gọn # 2
  18. </a>
  19. </div>
  20. <div id = "sậpTwo" class = "đàn accordion-body sập" >
  21. <div class = "accordion-inner" >
  22. Phim hoạt hình ...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

Bạn cũng có thể sử dụng plugin mà không cần đánh dấu accordion. Thực hiện một nút để chuyển đổi việc mở rộng và thu gọn của một phần tử khác.

  1. <button type = "button" class = "btn btn-risk" data-toggle = "sập" data-target = "#demo" >
  2. đóng mở đơn giản
  3. </button>
  4.  
  5. <div id = "demo" class = "thu gọn trong" > </div>

Cách sử dụng

Qua các thuộc tính dữ liệu

Chỉ cần thêm data-toggle="collapse"và một data-targetphần tử vào để tự động gán quyền kiểm soát phần tử có thể thu gọn. Thuộc data-targettính chấp nhận một bộ chọn css để áp dụng thu gọn. Đảm bảo thêm lớp collapsevào phần tử có thể thu gọn. Nếu bạn muốn nó mở mặc định, hãy thêm lớp bổ sung in.

Để thêm quản lý nhóm giống như đàn accordion vào một điều khiển có thể thu gọn, hãy thêm thuộc tính dữ liệu data-parent="#selector". Tham khảo bản demo để thấy điều này trong hoạt động.

Qua JavaScript

Bật theo cách thủ công với:

  1. $ ( ".collapse" ). sụp đổ ()

Tùy chọn

Các tùy chọn có thể được chuyển qua các thuộc tính dữ liệu hoặc JavaScript. Đối với các thuộc tính dữ liệu, hãy nối tên tùy chọn vào data-, như trong data-parent="".

Tên loại hình mặc định sự mô tả
cha mẹ bộ chọn sai If selector thì tất cả các phần tử có thể thu gọn dưới phần tử gốc được chỉ định sẽ bị đóng khi mục có thể thu gọn này được hiển thị. (tương tự như hành vi đàn accordion truyền thống)
chuyển đổi boolean thật Chuyển đổi phần tử có thể thu gọn khi gọi

Phương pháp

.collapse (tùy chọn)

Kích hoạt nội dung của bạn dưới dạng phần tử có thể thu gọn. Chấp nhận một tùy chọn tùy chọn object.

  1. $ ( '#myCollapsible' ). sụp đổ ({
  2. chuyển đổi : sai
  3. })

.collapse ('chuyển đổi')

Chuyển đổi phần tử có thể thu gọn thành hiển thị hoặc ẩn.

.collapse ('hiển thị')

Hiển thị một phần tử có thể thu gọn.

.collapse ('ẩn')

Ẩn một phần tử có thể thu gọn.

Sự kiện

Lớp thu gọn của Bootstrap cho thấy một vài sự kiện để kết nối vào chức năng thu gọn.

Biến cố Sự mô tả
buổi bieu diễn Sự kiện này kích hoạt ngay lập tức khi showphương thức thể hiện được gọi.
cho xem Sự kiện này được kích hoạt khi một phần tử thu gọn được hiển thị cho người dùng (sẽ đợi quá trình chuyển đổi css hoàn tất).
ẩn giấu Sự kiện này được kích hoạt ngay lập tức khi hidephương thức đã được gọi.
ẩn giấu Sự kiện này được kích hoạt khi một phần tử thu gọn đã bị ẩn khỏi người dùng (sẽ đợi quá trình chuyển đổi css hoàn tất).
  1. $ ( '#myCollapsible' ). on ( 'hidden' , function () {
  2. // làm việc gì đó…
  3. })

Thí dụ

Một plugin cơ bản, dễ dàng mở rộng để nhanh chóng tạo các kiểu chữ trang nhã với bất kỳ kiểu nhập văn bản biểu mẫu nào.

  1. <input type = "text" data-cung = "typeahead" >

Bạn sẽ muốn đặt autocomplete="off"để ngăn các menu trình duyệt mặc định xuất hiện trên menu thả xuống của Bootstrap typeahead.


Cách sử dụng

Qua các thuộc tính dữ liệu

Thêm thuộc tính dữ liệu để đăng ký một phần tử có chức năng đánh máy như thể hiện trong ví dụ trên.

Qua JavaScript

Gọi cho người đánh máy theo cách thủ công với:

  1. $ ( '.typeahead' ). người đánh máy ()

Tùy chọn

Các tùy chọn có thể được chuyển qua các thuộc tính dữ liệu hoặc JavaScript. Đối với các thuộc tính dữ liệu, hãy nối tên tùy chọn vào data-, như trong data-source="".

Tên loại hình mặc định sự mô tả
nguồn mảng, hàm [] Nguồn dữ liệu để truy vấn. Có thể là một mảng chuỗi hoặc một hàm. Hàm được truyền hai đối số, querygiá trị trong trường đầu vào và lệnh processgọi lại. Hàm có thể được sử dụng đồng bộ bằng cách trả về nguồn dữ liệu trực tiếp hoặc không đồng bộ thông qua processđối số đơn của lệnh gọi lại.
mặt hàng con số số 8 Số lượng mục tối đa để hiển thị trong menu thả xuống.
Độ dài nhỏ nhất con số 1 Độ dài ký tự tối thiểu cần thiết trước khi kích hoạt đề xuất tự động hoàn thành
người kết hợp hàm số trường hợp không nhạy cảm Phương pháp được sử dụng để xác định xem một truy vấn có khớp với một mục hay không. Chấp nhận một đối số duy nhất itemđể kiểm tra truy vấn. Truy cập truy vấn hiện tại với this.query. Trả về boolean truenếu truy vấn phù hợp.
người sắp xếp hàm số đối sánh chính xác , phân biệt chữ hoa chữ thường
,
không phân biệt chữ hoa chữ thường
Phương pháp được sử dụng để sắp xếp kết quả tự động hoàn thành. Chấp nhận một đối số duy nhất itemsvà có phạm vi của ví dụ điển hình. Tham chiếu truy vấn hiện tại với this.query.
người cập nhật hàm số trả lại mặt hàng đã chọn Phương thức được sử dụng để trả về mục đã chọn. Chấp nhận một đối số duy nhất, itemvà có phạm vi của trường hợp typeahead.
bút đánh dấu hàm số đánh dấu tất cả các kết quả phù hợp mặc định Phương pháp được sử dụng để đánh dấu kết quả tự động hoàn thành. Chấp nhận một đối số duy nhất itemvà có phạm vi của ví dụ điển hình. Nên trả về html.

Phương pháp

.typeahead (tùy chọn)

Khởi tạo đầu vào có lỗi chính tả.

Thí dụ

Điều khoản phụ ở bên trái là bản demo trực tiếp của plugin đính kèm.


Cách sử dụng

Qua các thuộc tính dữ liệu

Để dễ dàng thêm hành vi liên kết vào bất kỳ phần tử nào, chỉ cần thêm data-spy="affix"vào phần tử bạn muốn theo dõi. Sau đó, sử dụng các hiệu số để xác định thời điểm bật và tắt ghim của một phần tử.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
Đứng lên! Bạn phải quản lý vị trí của một phần tử được ghim và hành vi của phần tử gốc trực tiếp của nó. Vị trí được kiểm soát bởi affix, affix-topaffix-bottom. Hãy nhớ kiểm tra phụ huynh có khả năng bị sập khi liên kết bắt đầu hoạt động vì nó xóa nội dung khỏi dòng bình thường của trang.

Qua JavaScript

Gọi plugin đính kèm qua JavaScript:

  1. $ ( '#navbar' ). đóng dấu ()

Tùy chọn

Các tùy chọn có thể được chuyển qua các thuộc tính dữ liệu hoặc JavaScript. Đối với các thuộc tính dữ liệu, hãy nối tên tùy chọn vào data-, như trong data-offset-top="200".

Tên loại hình mặc định sự mô tả
bù lại số | chức năng | sự vật 10 Điểm ảnh để bù đắp từ màn hình khi tính toán vị trí của cuộn. Nếu một số duy nhất được cung cấp, phần bù sẽ được áp dụng theo cả hai hướng trên và trái. Để lắng nghe một hướng hoặc nhiều hiệu số duy nhất, chỉ cần cung cấp một đối tượng offset: { x: 10 }. Sử dụng một hàm khi bạn cần cung cấp động một khoảng bù (hữu ích cho một số thiết kế đáp ứng).