Sourceดรอปดาวน์
สลับการวางซ้อนตามบริบทเพื่อแสดงรายการลิงก์และอื่นๆ ด้วยปลั๊กอินดรอปดาวน์ Bootstrap
ภาพรวม
ดรอปดาวน์สามารถสลับได้ การวางซ้อนตามบริบทสำหรับแสดงรายการลิงก์และอื่นๆ มีการโต้ตอบกับปลั๊กอิน JavaScript แบบเลื่อนลง Bootstrap ที่รวมอยู่ พวกเขากำลังสลับโดยการคลิก ไม่ใช่โดยการวางเมาส์เหนือ; นี่คือการตัดสินใจออกแบบโดยเจตนา
ดรอปดาวน์สร้างขึ้นจากไลบรารีของบุคคลที่สามPopper.jsซึ่งจัดเตรียมตำแหน่งแบบไดนามิกและการตรวจจับวิวพอร์ต อย่าลืมใส่popper.min.jsก่อน JavaScript ของ Bootstrap หรือใช้bootstrap.bundle.min.js
/ bootstrap.bundle.js
ซึ่งมี Popper.js Popper.js ไม่ได้ใช้เพื่อวางตำแหน่งดรอปดาวน์ใน navbars แม้ว่าจะไม่จำเป็นต้องมีการจัดตำแหน่งแบบไดนามิกก็ตาม
หากคุณกำลังสร้าง JavaScript จากแหล่งที่มา มันต้องการutil.js
.
การเข้าถึง
มาตรฐานWAI ARIAกำหนดrole="menu"
วิดเจ็ต จริง แต่นี่เฉพาะสำหรับเมนูที่เหมือนแอปพลิเคชันซึ่งทริกเกอร์การทำงานหรือฟังก์ชัน เมนู ARIAมีได้เฉพาะรายการเมนู รายการเมนูช่องทำเครื่องหมาย รายการเมนูปุ่มตัวเลือก กลุ่มปุ่มตัวเลือก และเมนูย่อยเท่านั้น
ในทางกลับกัน ดรอปดาวน์ของ Bootstrap ได้รับการออกแบบมาให้เป็นแบบทั่วไปและใช้ได้กับสถานการณ์และโครงสร้างมาร์กอัปที่หลากหลาย ตัวอย่างเช่น สามารถสร้างดรอปดาวน์ที่มีอินพุตเพิ่มเติมและการควบคุมแบบฟอร์ม เช่น ช่องค้นหาหรือแบบฟอร์มการเข้าสู่ระบบ ด้วยเหตุนี้ Bootstrap จึงไม่คาดหวัง (หรือเพิ่มโดยอัตโนมัติ) role
และaria-
แอตทริบิวต์ที่จำเป็นสำหรับเมนูARIA ที่แท้จริง ผู้เขียนจะต้องรวมคุณลักษณะเฉพาะเหล่านี้ไว้ด้วย
อย่างไรก็ตาม Bootstrap จะเพิ่มการรองรับในตัวสำหรับการโต้ตอบกับเมนูคีย์บอร์ดมาตรฐานส่วนใหญ่ เช่น ความสามารถในการย้ายผ่านแต่ละ.dropdown-item
องค์ประกอบโดยใช้ปุ่มเคอร์เซอร์และปิดเมนูด้วยESCปุ่ม
ตัวอย่าง
รวมการสลับของดรอปดาวน์ (ปุ่มหรือลิงก์ของคุณ) และเมนูดรอปดาวน์ภายใน หรือองค์ประกอบอื่น ที่.dropdown
ประกาศ position: relative;
ดรอปดาวน์สามารถเรียกใช้จาก<a>
หรือ<button>
องค์ประกอบเพื่อให้เหมาะสมกับความต้องการที่เป็นไปได้ของคุณมากขึ้น
.btn
สามารถเปลี่ยนซิงเกิ้ลใด ๆ ให้เป็นปุ่มสลับแบบเลื่อนลงได้โดยมีการเปลี่ยนแปลงมาร์กอัป ต่อไปนี้คือวิธีที่คุณสามารถนำไปใช้กับองค์ประกอบใด<button>
องค์ประกอบหนึ่งได้:
และด้วย<a>
องค์ประกอบ:
ส่วนที่ดีที่สุดคือคุณสามารถทำเช่นนี้กับปุ่มต่างๆ ได้เช่นกัน:
ในทำนองเดียวกัน สร้างดรอปดาวน์ของปุ่มแยกโดยมีมาร์กอัปเหมือนกันกับดรอปดาวน์ของปุ่มเดียว แต่มีการเพิ่ม.dropdown-toggle-split
ระยะห่างที่เหมาะสมรอบๆ เครื่องหมายรูปหมวกแบบเลื่อนลง
เราใช้คลาสพิเศษนี้เพื่อลดแนวนอนpadding
ที่ด้านใดด้านหนึ่งของคาเร็ตลง 25% และลบmargin-left
ที่เพิ่มสำหรับดรอปดาวน์ของปุ่มปกติ การเปลี่ยนแปลงเพิ่มเติมเหล่านั้นทำให้คาเร็ตอยู่ตรงกลางปุ่มแยก และให้พื้นที่โจมตีที่มีขนาดเหมาะสมกว่าถัดจากปุ่มหลัก
ขนาด
ดรอปดาวน์ของปุ่มใช้งานได้กับปุ่มทุกขนาด รวมถึงปุ่มดรอปดาวน์เริ่มต้นและปุ่มแบบแยก
ทิศทาง
Dropup
ทริกเกอร์เมนูแบบเลื่อนลงเหนือองค์ประกอบโดยเพิ่ม.dropup
ไปยังองค์ประกอบหลัก
Dropright
เมนูแบบเลื่อนลงทริกเกอร์ที่ด้านขวาขององค์ประกอบโดยการเพิ่ม.dropright
องค์ประกอบหลัก
Dropleft
เมนูแบบเลื่อนลงทริกเกอร์ทางด้านซ้ายขององค์ประกอบโดยการเพิ่ม.dropleft
องค์ประกอบหลัก
เนื้อหาเมนูดรอปดาวน์ในอดีตต้องเป็นลิงก์ แต่กรณีนี้ไม่ใช่ v4 อีกต่อไป ตอนนี้คุณสามารถเลือกใช้<button>
องค์ประกอบในรายการดรอปดาวน์ของคุณ แทนที่จะใช้เพียง<a>
s
คุณยังสามารถสร้างรายการดรอปดาวน์ที่ไม่โต้ตอบด้วย.dropdown-item-text
. รู้สึกอิสระที่จะจัดสไตล์เพิ่มเติมด้วย CSS หรือยูทิลิตี้ข้อความที่กำหนดเอง
คล่องแคล่ว
เพิ่ม.active
ไปยังรายการในดรอปดาวน์เพื่อจัดรูปแบบเป็นใช้งานอยู่
พิการ
เพิ่ม.disabled
ในรายการแบบเลื่อนลงเพื่อจัดรูปแบบเป็นปิดใช้งาน
โดยค่าเริ่มต้น เมนูแบบเลื่อนลงจะอยู่ในตำแหน่ง 100% จากด้านบนและด้านซ้ายของระดับบนสุดโดยอัตโนมัติ เพิ่ม.dropdown-menu-right
เพื่อ.dropdown-menu
จัดตำแหน่งเมนูดรอปดาวน์ให้ชิดขวา
หัวขึ้น! ดรอปดาวน์อยู่ในตำแหน่งที่ต้องขอบคุณ Popper.js (ยกเว้นเมื่ออยู่ในแถบนำทาง)
เพิ่มส่วนหัวเพื่อติดป้ายกำกับส่วนของการดำเนินการในเมนูแบบเลื่อนลง
วงเวียน
แยกกลุ่มรายการเมนูที่เกี่ยวข้องด้วยตัวแบ่ง
ข้อความ
วางข้อความรูปแบบอิสระใดๆ ภายในเมนูดรอปดาวน์ที่มีข้อความ และใช้ ยูทิลิตี้ การเว้นวรรค โปรดทราบว่าคุณอาจต้องใช้รูปแบบการปรับขนาดเพิ่มเติมเพื่อจำกัดความกว้างของเมนู
ใส่แบบฟอร์มในเมนูดรอปดาวน์ หรือทำให้เป็นเมนูดรอปดาวน์ และใช้ยูทิลิตี้ระยะขอบหรือช่องว่างภายในเพื่อให้มีพื้นที่ว่างในเชิงลบที่คุณต้องการ
ตัวเลือกแบบเลื่อนลง
ใช้data-offset
หรือdata-reference
เพื่อเปลี่ยนตำแหน่งของรายการแบบเลื่อนลง
การใช้งาน
ผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript ปลั๊กอินแบบเลื่อนลงจะสลับเนื้อหาที่ซ่อนอยู่ (เมนูแบบเลื่อนลง) โดยการสลับ.show
คลาสในรายการหลัก แอตทริบิวต์data-toggle="dropdown"
นี้ใช้สำหรับการปิดเมนูแบบเลื่อนลงที่ระดับแอปพลิเคชัน ดังนั้นจึงควรใช้แอตทริบิวต์นี้เสมอ
บนอุปกรณ์ที่เปิดใช้งานระบบสัมผัส การเปิดดรอปดาวน์จะเพิ่มตัวจัดการที่ว่างเปล่า ( $.noop
) mouseover
ให้กับลูกที่อยู่ใกล้เคียงของ<body>
องค์ประกอบ การแฮ็กที่น่าเกลียดที่ยอมรับได้นี้เป็นสิ่งจำเป็นเพื่อแก้ไขจุดบกพร่องในการมอบสิทธิ์เหตุการณ์ของ iOSซึ่งมิฉะนั้นจะป้องกันไม่ให้แตะที่ใดก็ได้นอกดรอปดาวน์จากการเรียกรหัสที่ปิดรายการแบบเลื่อนลง เมื่อปิดรายการแบบเลื่อนลง ตัวจัดการว่างเพิ่มเติมเหล่านี้mouseover
จะถูกลบออก
ผ่านแอตทริบิวต์ข้อมูล
เพิ่มdata-toggle="dropdown"
ในลิงก์หรือปุ่มเพื่อสลับรายการแบบเลื่อนลง
ผ่านจาวาสคริปต์
เรียกดรอปดาวน์ผ่าน JavaScript:
data-toggle="dropdown"
ยังต้องการ
ไม่ว่าคุณจะเรียกดรอปดาวน์ของคุณผ่าน JavaScript หรือใช้ data-api แทน คุณdata-toggle="dropdown"
จำเป็นต้องแสดงบนองค์ประกอบทริกเกอร์ของดรอปดาวน์เสมอ
ตัวเลือก
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอตทริบิวต์ข้อมูล ให้ผนวกชื่อตัวเลือกเข้ากับdata-
เช่นในdata-offset=""
.
ชื่อ |
พิมพ์ |
ค่าเริ่มต้น |
คำอธิบาย |
offset |
หมายเลข | สตริง | การทำงาน |
0 |
ออฟเซ็ตของดรอปดาวน์ที่สัมพันธ์กับเป้าหมาย สำหรับข้อมูลเพิ่มเติม โปรดดู เอกสารออฟเซ็ตของPopper.js |
พลิก |
บูลีน |
จริง |
อนุญาตให้ดรอปดาวน์พลิกในกรณีที่องค์ประกอบอ้างอิงทับซ้อนกัน สำหรับข้อมูลเพิ่มเติม โปรดดู เอกสารพลิกของPopper.js |
เขตแดน |
สตริง | ธาตุ |
'เลื่อนผู้ปกครอง' |
ขอบเขตข้อจำกัดล้นของเมนูดรอปดาวน์ ยอมรับค่าของ'viewport' , 'window' , 'scrollParent' , หรือการอ้างอิง HTMLElement (JavaScript เท่านั้น) สำหรับข้อมูลเพิ่มเติม โปรดดู เอกสาร preventOverflow ของPopper.js |
อ้างอิง |
สตริง | ธาตุ |
'สลับ' |
องค์ประกอบอ้างอิงของเมนูแบบเลื่อนลง ยอมรับค่าของ'toggle' , 'parent' หรือการอ้างอิง HTMLElement สำหรับข้อมูลเพิ่มเติม โปรดดู เอกสาร referenceObjectของPopper.js |
แสดง |
สตริง |
'พลวัต' |
โดยค่าเริ่มต้น เราใช้ Popper.js สำหรับการจัดตำแหน่งแบบไดนามิก ปิดใช้งานสิ่งนี้ด้วยstatic . |
โปรดทราบว่าเมื่อboundary
ตั้งค่าเป็นค่าอื่น'scrollParent'
ที่ไม่ใช่ สไตล์position: static
จะถูกนำไปใช้กับ.dropdown
คอนเทนเนอร์
วิธีการ
วิธี |
คำอธิบาย |
$().dropdown('toggle') |
สลับเมนูดรอปดาวน์ของแถบนำทางที่กำหนดหรือการนำทางแบบแท็บ |
$().dropdown('update') |
อัปเดตตำแหน่งของรายการแบบเลื่อนลงขององค์ประกอบ |
$().dropdown('dispose') |
ทำลายรายการดรอปดาวน์ขององค์ประกอบ |
กิจกรรม
เหตุการณ์แบบเลื่อนลงทั้งหมดเริ่มต้นที่.dropdown-menu
องค์ประกอบหลักของ ' และมีrelatedTarget
คุณสมบัติซึ่งมีค่าเป็นองค์ประกอบการสลับจุดยึด hide.bs.dropdown
และhidden.bs.dropdown
เหตุการณ์มีclickEvent
คุณสมบัติ (เฉพาะเมื่อประเภทเหตุการณ์ดั้งเดิมคือclick
) ที่มี Event Object สำหรับเหตุการณ์การคลิก
เหตุการณ์ |
คำอธิบาย |
show.bs.dropdown |
เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีการเรียกวิธีการแสดงอินสแตนซ์ |
shown.bs.dropdown |
เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้มองเห็นเมนูแบบเลื่อนลงได้ (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
hide.bs.dropdown |
เหตุการณ์นี้เริ่มทำงานทันทีเมื่อมีการเรียกวิธีการซ่อนอินสแตนซ์ |
hidden.bs.dropdown |
เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้ซ่อนรายการแบบหล่นลงเสร็จแล้ว (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |