Chuyển đổi lớp phủ theo ngữ cảnh để hiển thị danh sách các liên kết và hơn thế nữa với plugin thả xuống Bootstrap.
Tổng quan
Danh sách thả xuống có thể chuyển đổi, các lớp phủ theo ngữ cảnh để hiển thị danh sách các liên kết và hơn thế nữa. Chúng được tạo tương tác với plugin JavaScript thả xuống Bootstrap đi kèm. Chúng được chuyển đổi bằng cách nhấp chuột, không phải bằng cách di chuột; đây là một quyết định thiết kế có chủ đích .
Trình đơn thả xuống được xây dựng trên thư viện của bên thứ ba, Popper.js , cung cấp khả năng định vị động và phát hiện chế độ xem. Đảm bảo bao gồm popper.min.js trước JavaScript của Bootstrap hoặc sử dụng bootstrap.bundle.min.js/ bootstrap.bundle.jscó chứa Popper.js. Popper.js không được sử dụng để định vị danh sách thả xuống trong thanh điều hướng mặc dù không yêu cầu định vị động.
Nếu bạn đang xây dựng JavaScript của chúng tôi từ nguồn, nó yêu cầuutil.js .
Khả năng tiếp cận
Tiêu chuẩn WAI ARIA xác định một role="menu"widget thực tế , nhưng điều này dành riêng cho các menu giống như ứng dụng để kích hoạt các hành động hoặc chức năng. Menu ARIA chỉ có thể chứa các mục menu, các mục menu hộp kiểm, các mục menu nút radio, nhóm nút radio và menu phụ.
Mặt khác, các trình đơn thả xuống của Bootstrap được thiết kế để chung chung và có thể áp dụng cho nhiều tình huống và cấu trúc đánh dấu khác nhau. Ví dụ: có thể tạo danh sách thả xuống chứa các đầu vào bổ sung và điều khiển biểu mẫu, chẳng hạn như trường tìm kiếm hoặc biểu mẫu đăng nhập. Vì lý do này, Bootstrap không mong đợi (cũng như không tự động thêm) bất kỳ thuộc tính rolevà aria-thuộc tính nào cần thiết cho các menu ARIA thực sự. Các tác giả sẽ phải tự bao gồm các thuộc tính cụ thể hơn này.
Tuy nhiên, Bootstrap bổ sung hỗ trợ tích hợp cho hầu hết các tương tác menu bàn phím tiêu chuẩn, chẳng hạn như khả năng di chuyển qua các .dropdown-itemphần tử riêng lẻ bằng cách sử dụng các phím con trỏ và đóng menu bằng ESCphím.
Các ví dụ
Bao bọc nút chuyển đổi của menu thả xuống (nút hoặc liên kết của bạn) và menu thả xuống bên trong .dropdownhoặc một phần tử khác khai báo position: relative;. Trình đơn thả xuống có thể được kích hoạt từ <a>hoặc <button>các yếu tố để phù hợp hơn với nhu cầu tiềm năng của bạn.
Một nút
Bất kỳ đĩa đơn .btnnào cũng có thể được chuyển thành một trình đơn thả xuống với một số thay đổi về đánh dấu. Đây là cách bạn có thể đặt chúng hoạt động với một trong hai <button>phần tử:
Tương tự, tạo danh sách thả xuống nút tách với hầu như đánh dấu giống như danh sách thả xuống nút đơn, nhưng có bổ sung thêm .dropdown-toggle-splitkhoảng cách thích hợp xung quanh dấu mũ thả xuống.
Chúng tôi sử dụng lớp bổ sung này để giảm padding25% chiều ngang ở hai bên của dấu mũ và loại bỏ lớp margin-leftđược thêm vào cho các nút thả xuống thông thường. Những thay đổi bổ sung đó giữ cho dấu mũ ở giữa trong nút tách và cung cấp một vùng nhấn có kích thước phù hợp hơn bên cạnh nút chính.
Trước đây, nội dung menu thả xuống phải là liên kết, nhưng điều đó không còn xảy ra với v4. Giờ đây, bạn có thể tùy chọn sử dụng <button>các phần tử trong danh sách thả xuống của mình thay vì chỉ <a>s.
Bạn cũng có thể tạo các mục thả xuống không tương tác với .dropdown-item-text. Thoải mái tạo kiểu thêm với các tiện ích văn bản hoặc CSS tùy chỉnh.
Theo mặc định, menu thả xuống tự động được định vị 100% từ trên cùng và dọc theo bên trái của trình đơn gốc. Thêm .dropdown-menu-rightvào a .dropdown-menuđể căn phải menu thả xuống.
Đứng lên! Các trình đơn thả xuống được định vị nhờ Popper.js (ngoại trừ khi chúng được chứa trong thanh điều hướng).
Căn chỉnh đáp ứng
Nếu bạn muốn sử dụng căn chỉnh đáp ứng, hãy tắt định vị động bằng cách thêm data-display="static"thuộc tính và sử dụng các lớp biến thể đáp ứng.
Để căn phải menu thả xuống với điểm ngắt đã cho hoặc lớn hơn, hãy thêm .dropdown-menu{-sm|-md|-lg|-xl}-right.
Để căn chỉnh bên trái menu thả xuống với điểm ngắt đã cho hoặc lớn hơn, hãy thêm .dropdown-menu-rightvà .dropdown-menu{-sm|-md|-lg|-xl}-left.
Lưu ý rằng bạn không cần thêm data-display="static"thuộc tính vào các nút thả xuống trong thanh điều hướng, vì Popper.js không được sử dụng trong thanh điều hướng.
Nội dung menu
Tiêu đề
Thêm tiêu đề vào nhãn các phần hành động trong bất kỳ menu thả xuống nào.
Đặt bất kỳ văn bản dạng tự do nào trong menu thả xuống với văn bản và sử dụng các tiện ích giãn cách . Lưu ý rằng bạn có thể sẽ cần các kiểu định cỡ bổ sung để hạn chế chiều rộng menu.
Một số văn bản mẫu tự do chảy trong menu thả xuống.
Và đây là văn bản ví dụ hơn.
Các hình thức
Đặt biểu mẫu trong menu thả xuống hoặc đưa biểu mẫu vào menu thả xuống và sử dụng các tiện ích lề hoặc đệm để tạo cho nó không gian âm mà bạn yêu cầu.
Thông qua thuộc tính dữ liệu hoặc JavaScript, plugin thả xuống chuyển đổi nội dung ẩn (menu thả xuống) bằng cách chuyển đổi .showlớp trên mục danh sách mẹ. Thuộc data-toggle="dropdown"tính được dựa vào để đóng menu thả xuống ở cấp ứng dụng, vì vậy bạn nên luôn sử dụng nó.
Trên các thiết bị hỗ trợ cảm ứng, việc mở trình đơn thả xuống sẽ thêm các trình xử lý trống ( $.noop) mouseovervào các phần tử con ngay lập tức <body>. Việc hack được thừa nhận là xấu xí này là cần thiết để giải quyết một vấn đề trong ủy quyền sự kiện của iOS , điều này sẽ ngăn không cho một lần nhấn ở bất kỳ đâu bên ngoài trình đơn thả xuống kích hoạt mã đóng trình đơn thả xuống. Sau khi trình đơn thả xuống bị đóng, những mouseovertrình xử lý trống bổ sung này sẽ bị xóa.
Qua các thuộc tính dữ liệu
Thêm data-toggle="dropdown"vào liên kết hoặc nút để chuyển đổi menu thả xuống.
Qua JavaScript
Gọi các trình đơn thả xuống qua JavaScript:
data-toggle="dropdown"vẫn được yêu cầu
Bất kể bạn gọi menu thả xuống của mình qua JavaScript hay thay vào đó sử dụng data-api, data-toggle="dropdown"luôn bắt buộc phải có trên phần tử trình kích hoạt của menu thả xuống.
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
số | chuỗi | hàm số
0
Phần bù của menu thả xuống so với mục tiêu của nó.
Khi một hàm được sử dụng để xác định độ lệch, nó được gọi với một đối tượng chứa dữ liệu độ lệch làm đối số đầu tiên của nó. Hàm phải trả về một đối tượng có cùng cấu trúc. Nút DOM của phần tử kích hoạt được chuyển làm đối số thứ hai.
Ranh giới ràng buộc tràn của menu thả xuống. Chấp nhận các giá trị của , 'viewport'hoặc một tham chiếu HTMLElement (chỉ JavaScript). Để biết thêm thông tin, hãy tham khảo tài liệu ngăn chặn dòng chảy của Popper.js .'window''scrollParent'
Lưu ý khi boundaryđược đặt thành bất kỳ giá trị nào khác 'scrollParent', kiểu position: staticđược áp dụng cho vùng .dropdownchứa.
Phương pháp
Phương pháp
Sự mô tả
$().dropdown('toggle')
Chuyển đổi menu thả xuống của một thanh điều hướng hoặc tab điều hướng nhất định.
$().dropdown('show')
Hiển thị menu thả xuống của thanh điều hướng hoặc tab điều hướng nhất định.
$().dropdown('hide')
Ẩn menu thả xuống của thanh điều hướng hoặc tab điều hướng nhất định.
$().dropdown('update')
Cập nhật vị trí của menu thả xuống của một phần tử.
$().dropdown('dispose')
Hủy bỏ danh sách thả xuống của một phần tử.
Sự kiện
Tất cả các sự kiện thả xuống đều được kích hoạt tại .dropdown-menuphần tử mẹ của 'và có một relatedTargetthuộc tính, có giá trị là phần tử neo chuyển đổi. hide.bs.dropdownvà hidden.bs.dropdowncác sự kiện có clickEventthuộc tính (chỉ khi loại sự kiện ban đầu là click) chứa Đối tượng sự kiện cho sự kiện nhấp chuột.
Biến cố
Sự mô tả
show.bs.dropdown
Sự kiện này kích hoạt ngay lập tức khi phương thức thể hiện show được gọi.
shown.bs.dropdown
Sự kiện này được kích hoạt khi menu thả xuống được hiển thị cho người dùng (sẽ đợi quá trình chuyển đổi CSS hoàn tất).
hide.bs.dropdown
Sự kiện này được kích hoạt ngay lập tức khi phương thức ẩn thể hiện đã được gọi.
hidden.bs.dropdown
Sự kiện này được kích hoạt khi danh sách thả xuống 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).