JavaScript
ทำให้ส่วนประกอบของ Bootstrap มีชีวิตชีวาด้วยปลั๊กอิน jQuery ที่กำหนดเองมากกว่าหนึ่งโหล รวมทั้งหมดหรือทีละรายการได้อย่างง่ายดาย
ทำให้ส่วนประกอบของ Bootstrap มีชีวิตชีวาด้วยปลั๊กอิน jQuery ที่กำหนดเองมากกว่าหนึ่งโหล รวมทั้งหมดหรือทีละรายการได้อย่างง่ายดาย
ปลั๊กอินสามารถรวมเป็นรายบุคคลได้ (โดยใช้ไฟล์แต่ละ*.js
ไฟล์ของ Bootstrap) หรือทั้งหมดพร้อมกัน (โดยใช้bootstrap.js
หรือย่อbootstrap.min.js
ขนาด )
ทั้งสองbootstrap.js
และbootstrap.min.js
มีปลั๊กอินทั้งหมดในไฟล์เดียว รวมไว้เพียงอันเดียว
ปลั๊กอินและส่วนประกอบ CSS บางตัวขึ้นอยู่กับปลั๊กอินอื่นๆ หากคุณรวมปลั๊กอินแต่ละรายการ ตรวจสอบให้แน่ใจว่าได้ตรวจสอบการขึ้นต่อกันเหล่านี้ในเอกสาร โปรดทราบว่าปลั๊กอินทั้งหมดขึ้นอยู่กับ jQuery (ซึ่งหมายความว่าต้องรวม jQuery ก่อนไฟล์ปลั๊กอิน) ปรึกษาเราbower.json
เพื่อดูว่ารองรับ jQuery เวอร์ชันใด
คุณสามารถใช้ปลั๊กอิน Bootstrap ทั้งหมดผ่าน Markup API ได้โดยไม่ต้องเขียน JavaScript แม้แต่บรรทัดเดียว นี่คือ API ระดับเฟิร์สคลาสของ Bootstrap และควรพิจารณาเป็นอันดับแรกเมื่อใช้ปลั๊กอิน
ที่กล่าวว่า ในบางสถานการณ์ อาจเป็นการดีที่จะปิดฟังก์ชันนี้ ดังนั้นเราจึงจัดเตรียมความสามารถในการปิดใช้งาน API แอตทริบิวต์ข้อมูลโดยยกเลิกการเชื่อมโยงเหตุการณ์ทั้งหมดในเนมสเปซของเอกสารdata-api
ด้วย ดูเหมือนว่านี้:
อีกวิธีหนึ่งในการกำหนดเป้าหมายปลั๊กอินเฉพาะ ให้รวมชื่อของปลั๊กอินเป็นเนมสเปซพร้อมกับเนมสเปซ data-api ดังนี้:
อย่าใช้แอตทริบิวต์ข้อมูลจากปลั๊กอินหลายตัวในองค์ประกอบเดียวกัน ตัวอย่างเช่น ปุ่มไม่สามารถมีคำแนะนำเครื่องมือและสลับเป็นโมดอลได้ ในการทำสิ่งนี้ให้สำเร็จ ให้ใช้องค์ประกอบการห่อ
เรายังเชื่อว่าคุณควรจะสามารถใช้ปลั๊กอิน Bootstrap ทั้งหมดผ่าน JavaScript API ได้อย่างหมดจด API สาธารณะทั้งหมดเป็นเมธอดเดียวที่เชื่อมต่อได้ และส่งคืนคอลเล็กชันที่ดำเนินการ
เมธอดทั้งหมดควรยอมรับอ็อบเจ็กต์ตัวเลือกที่เป็นตัวเลือก สตริงที่กำหนดเป้าหมายเมธอดเฉพาะ หรือไม่มีเลย (ซึ่งเริ่มต้นปลั๊กอินด้วยการทำงานเริ่มต้น):
ปลั๊กอินแต่ละตัวยังเปิดเผยคอนสตรัคเตอร์ดิบใน พร็อพเพ อร์Constructor
ตี้: $.fn.popover.Constructor
หากคุณต้องการรับอินสแตนซ์ของปลั๊กอินบางตัว ให้ดึงข้อมูลโดยตรงจากองค์ประกอบ$('[rel="popover"]').data('popover')
:
คุณสามารถเปลี่ยนการตั้งค่าเริ่มต้นสำหรับปลั๊กอินโดยแก้ไขConstructor.DEFAULTS
วัตถุของปลั๊กอิน:
บางครั้ง จำเป็นต้องใช้ปลั๊กอิน Bootstrap กับเฟรมเวิร์ก UI อื่นๆ ในสถานการณ์เหล่านี้ การชนกันของเนมสเปซอาจเกิดขึ้นในบางครั้ง หากเกิดเหตุการณ์นี้ขึ้น คุณสามารถเรียก.noConflict
ใช้ปลั๊กอินที่คุณต้องการคืนค่า
Bootstrap จัดเตรียมเหตุการณ์ที่กำหนดเองสำหรับการกระทำเฉพาะของปลั๊กอินส่วนใหญ่ โดยทั่วไป สิ่งเหล่านี้มาในรูปแบบกริยาแบบ infinitive และ past participle โดยที่ infinitive (เช่นshow
) จะถูกทริกเกอร์เมื่อเริ่มต้นเหตุการณ์ และรูปแบบกริยาที่ผ่านมา (ex. shown
) จะถูกทริกเกอร์เมื่อการดำเนินการเสร็จสิ้น
ณ 3.0.0 เหตุการณ์ Bootstrap ทั้งหมดมีเนมสเปซ
เหตุการณ์ infinitive ทั้งหมดมีpreventDefault
ฟังก์ชันการทำงาน สิ่งนี้ทำให้สามารถหยุดการดำเนินการก่อนที่จะเริ่ม
คำแนะนำเครื่องมือและ Popovers ใช้น้ำยาฆ่าเชื้อในตัวของเราเพื่อล้างตัวเลือกที่ยอมรับ HTML
ค่าเริ่มต้นwhiteList
มีดังต่อไปนี้:
หากคุณต้องการเพิ่มค่าใหม่ให้กับค่าเริ่มต้นนี้whiteList
คุณสามารถดำเนินการดังต่อไปนี้:
หากคุณต้องการเลี่ยงการฆ่าเชื้อของเรา เนื่องจากคุณต้องการใช้ห้องสมุดเฉพาะ เช่นDOMPurifyคุณควรดำเนินการดังต่อไปนี้:
document.implementation.createHTMLDocument
ในกรณีที่เบราว์เซอร์ไม่รองรับdocument.implementation.createHTMLDocument
เช่น Internet Explorer 8 ฟังก์ชันฆ่าเชื้อในตัวจะส่งกลับ HTML ตามที่เป็นอยู่
หากคุณต้องการดำเนินการฆ่าเชื้อในกรณีนี้ โปรดระบุsanitizeFn
และใช้ไลบรารีภายนอกเช่นDOMPurify
เวอร์ชันของปลั๊กอิน jQuery ของ Bootstrap แต่ละเวอร์ชันสามารถเข้าถึงได้ผ่านVERSION
คุณสมบัติของตัวสร้างของปลั๊กอิน ตัวอย่างเช่น สำหรับปลั๊กอินคำแนะนำเครื่องมือ:
ปลั๊กอินของ Bootstrap จะไม่ถอยกลับโดยเฉพาะอย่างยิ่งเมื่อปิดการใช้งาน JavaScript หากคุณสนใจเกี่ยวกับประสบการณ์ของผู้ใช้ในกรณีนี้ ใช้<noscript>
เพื่ออธิบายสถานการณ์ (และวิธีเปิดใช้งาน JavaScript อีกครั้ง) ให้กับผู้ใช้ของคุณ และ/หรือเพิ่มทางเลือกที่คุณกำหนดเอง
Bootstrap ไม่สนับสนุนไลบรารี JavaScript ของบุคคลที่สามเช่น Prototype หรือ jQuery UI อย่างเป็นทางการ แม้ว่า.noConflict
เหตุการณ์เนมสเปซและเนมสเปซอาจมีปัญหาความเข้ากันได้ซึ่งคุณต้องแก้ไขด้วยตัวเอง
สำหรับเอฟเฟกต์การเปลี่ยนอย่างง่าย ให้รวมtransition.js
ครั้งเดียวพร้อมกับไฟล์ JS อื่น หากคุณกำลังใช้คอมไพล์แล้ว (หรือย่อเล็กสุด) bootstrap.js
คุณไม่จำเป็นต้องรวมสิ่งนี้—มีอยู่แล้วในนั้น
Transition.js เป็นผู้ช่วยพื้นฐานสำหรับtransitionEnd
เหตุการณ์เช่นเดียวกับโปรแกรมจำลองการเปลี่ยน CSS ปลั๊กอินนี้ใช้โดยปลั๊กอินอื่นๆ เพื่อตรวจสอบการสนับสนุนการเปลี่ยน CSS และเพื่อตรวจจับการเปลี่ยนผ่านที่ค้างอยู่
การเปลี่ยนผ่านสามารถปิดใช้งานได้ทั่วโลกโดยใช้ข้อมูลโค้ด JavaScript ต่อไปนี้ ซึ่งต้องโหลดหลังจาก โหลด transition.js
(หรือbootstrap.js
หรือbootstrap.min.js
แล้วแต่กรณี):
Modals มีความคล่องตัว แต่มีความยืดหยุ่น พร้อมข้อความโต้ตอบพร้อมฟังก์ชันขั้นต่ำที่จำเป็นและค่าเริ่มต้นที่ชาญฉลาด
อย่าเปิดโมดอลในขณะที่อีกอันยังมองเห็นได้ การแสดงมากกว่าหนึ่งโมดอลในแต่ละครั้งต้องใช้โค้ดที่กำหนดเอง
พยายามวางโค้ด HTML ของโมดอลในตำแหน่งระดับบนสุดในเอกสารของคุณเสมอ เพื่อหลีกเลี่ยงองค์ประกอบอื่นๆ ที่ส่งผลต่อลักษณะที่ปรากฏและ/หรือฟังก์ชันของโมดอล
มีข้อแม้บางประการเกี่ยวกับการใช้โมดอลบนอุปกรณ์มือถือ ดูเอกสารสนับสนุนเบราว์เซอร์ของเราสำหรับรายละเอียด
เนื่องจาก HTML5 กำหนดความหมายของมันautofocus
แอตทริบิวต์ HTML จึงไม่มีผลใน Bootstrap modals เพื่อให้ได้ผลเช่นเดียวกัน ให้ใช้ JavaScript ที่กำหนดเอง:
โมดอลที่แสดงผลพร้อมส่วนหัว เนื้อหา และชุดของการดำเนินการในส่วนท้าย
สลับโมดอลผ่าน JavaScript โดยคลิกที่ปุ่มด้านล่าง มันจะเลื่อนลงและจางลงจากด้านบนของหน้า
อย่าลืมเพิ่มrole="dialog"
และaria-labelledby="..."
อ้างอิงชื่อโมดอล ถึง.modal
และrole="document"
ตัว.modal-dialog
มันเอง
นอกจากนี้ คุณอาจให้คำอธิบายของกล่องโต้ตอบโมดอลของคุณด้วยaria-describedby
on.modal
การฝังวิดีโอ YouTube ใน modals ต้องใช้ JavaScript เพิ่มเติมที่ไม่อยู่ใน Bootstrap เพื่อหยุดเล่นโดยอัตโนมัติและอีกมากมาย ดูโพสต์ Stack Overflow ที่เป็นประโยชน์สำหรับข้อมูลเพิ่มเติม
Modals มีสองขนาดให้เลือก ใช้ได้ผ่านคลาสตัวปรับแต่งที่จะวางบนไฟล์.modal-dialog
.
สำหรับโมดอลที่ปรากฏแทนที่จะดูจางๆ ให้ลบ.fade
คลาสออกจากมาร์กอัปโมดอลของคุณ
ในการใช้ประโยชน์จากระบบกริด Bootstrap ภายในโมดอล เพียงแค่ซ้อน.row
s ภายใน.modal-body
แล้วใช้คลาสระบบกริดปกติ
มีปุ่มมากมายที่เรียกใช้ modal เดียวกัน แต่มีเนื้อหาต่างกันเล็กน้อยหรือไม่? ใช้event.relatedTarget
และแอตทริบิวต์HTMLdata-*
(อาจใช้ jQuery ) เพื่อเปลี่ยนแปลงเนื้อหาของโมดอลขึ้นอยู่กับว่าคลิกปุ่มใด ดูเอกสาร Modal Events สำหรับรายละเอียดเกี่ยวกับrelatedTarget
,
ปลั๊กอินโมดอลจะสลับเนื้อหาที่ซ่อนอยู่ของคุณตามต้องการ ผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript นอกจากนี้ยังเพิ่ม.modal-open
เพื่อ<body>
แทนที่พฤติกรรมการเลื่อนเริ่มต้น และสร้าง a .modal-backdrop
เพื่อให้พื้นที่การคลิกสำหรับการยกเลิกโมดอลที่แสดงเมื่อคลิกนอกโมดอล
เปิดใช้งาน modal โดยไม่ต้องเขียน JavaScript ตั้งค่าdata-toggle="modal"
บนองค์ประกอบตัวควบคุม เช่น ปุ่ม พร้อมกับ a data-target="#foo"
หรือhref="#foo"
เพื่อกำหนดเป้าหมายเป็นโมดอลเฉพาะเพื่อสลับ
เรียก modal ด้วย id myModal
ด้วย JavaScript บรรทัดเดียว:
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-backdrop=""
.
ชื่อ | พิมพ์ | ค่าเริ่มต้น | คำอธิบาย |
---|---|---|---|
ฉากหลัง | บูลีนหรือสตริง'static' |
จริง | รวมถึงองค์ประกอบฉากหลังที่เป็นกิริยาช่วย หรือระบุstatic ฉากหลังที่ไม่ปิดโมดอลเมื่อคลิก |
แป้นพิมพ์ | บูลีน | จริง | ปิดโมดอลเมื่อกดปุ่ม Escape |
แสดง | บูลีน | จริง | แสดงโมดอลเมื่อเริ่มต้น |
ระยะไกล | เส้นทาง | เท็จ | ตัวเลือกนี้เลิกใช้ตั้งแต่ v3.3.0 และถูกลบใน v4 แล้ว เราขอแนะนำให้ใช้เทมเพลตฝั่งไคลเอ็นต์หรือเฟรมเวิร์กการเชื่อมโยงข้อมูล หรือเรียกjQuery.loadด้วยตนเอง หากมีการระบุ URL ระยะไกลเนื้อหาจะถูกโหลดครั้งเดียว |
.modal(options)
เปิดใช้งานเนื้อหาของคุณเป็นกิริยาช่วย ยอมรับตัวเลือกobject
เสริม
.modal('toggle')
สลับโมดอลด้วยตนเอง กลับไปยังผู้โทรก่อนที่โมดอลจะแสดงหรือซ่อนอยู่จริง (กล่าวคือ ก่อนที่ เหตุการณ์ shown.bs.modal
หรือhidden.bs.modal
เหตุการณ์จะเกิดขึ้น)
.modal('show')
เปิดโมดอลด้วยตนเอง กลับไปยังผู้เรียกก่อนที่จะแสดงกิริยาจริง (กล่าวคือ ก่อนที่shown.bs.modal
เหตุการณ์จะเกิดขึ้น)
.modal('hide')
ซ่อนโมดอลด้วยตนเอง กลับไปยังผู้โทรก่อนที่โมดอลจะถูกซ่อนจริง ๆ (กล่าวคือ ก่อนที่hidden.bs.modal
เหตุการณ์จะเกิดขึ้น)
.modal('handleUpdate')
ปรับตำแหน่งของโมดอลใหม่เพื่อตอบโต้แถบเลื่อนในกรณีที่ควรปรากฏขึ้น ซึ่งจะทำให้โมดัลกระโดดไปทางซ้าย
จำเป็นเฉพาะเมื่อความสูงของโมดอลเปลี่ยนแปลงขณะเปิดอยู่
โมดอลคลาสของ Bootstrap เปิดเผยเหตุการณ์สองสามเหตุการณ์สำหรับการเชื่อมต่อกับฟังก์ชันโมดอล
เหตุการณ์โมดอลทั้งหมดถูกไล่ออกจากกิริยาช่วย (เช่น ที่<div class="modal">
)
ประเภทงาน | คำอธิบาย |
---|---|
show.bs.modal | เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีshow การเรียกเมธอดของอินสแตนซ์ หากเกิดจากการคลิก องค์ประกอบที่คลิกจะพร้อมใช้งานเป็นrelatedTarget คุณสมบัติของเหตุการณ์ |
แสดง.bs.modal | เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้มองเห็นโมดอลได้ (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) หากเกิดจากการคลิก องค์ประกอบที่คลิกจะพร้อมใช้งานเป็นrelatedTarget คุณสมบัติของเหตุการณ์ |
hide.bs.modal | เหตุการณ์นี้เริ่มทำงานทันทีเมื่อhide มีการเรียกเมธอดของอินสแตนซ์ |
hidden.bs.modal | เหตุการณ์นี้เริ่มทำงานเมื่อโมดอลถูกซ่อนจากผู้ใช้เสร็จสิ้น (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
Load.bs.modal | เหตุการณ์นี้เริ่มทำงานเมื่อโมดอลโหลดเนื้อหาโดยใช้remote ตัวเลือก |
เพิ่มเมนูแบบเลื่อนลงได้เกือบทุกอย่างด้วยปลั๊กอินง่ายๆ นี้ รวมถึงแถบนำทาง แท็บ และยาเม็ด
ผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript ปลั๊กอินแบบเลื่อนลงจะสลับเนื้อหาที่ซ่อนอยู่ (เมนูแบบเลื่อนลง) โดยการสลับ.open
คลาสในรายการหลัก
บนอุปกรณ์มือถือ การเปิดดรอปดาวน์จะเพิ่ม a .dropdown-backdrop
เป็นพื้นที่สำหรับปิดเมนูดรอปดาวน์เมื่อแตะนอกเมนู ซึ่งเป็นข้อกำหนดสำหรับการสนับสนุน iOS ที่เหมาะสม ซึ่งหมายความว่าการเปลี่ยนจากเมนูดรอปดาวน์แบบเปิดเป็นเมนูดรอปดาวน์อื่นจำเป็นต้องแตะพิเศษบนอุปกรณ์เคลื่อนที่
หมายเหตุ: data-toggle="dropdown"
แอตทริบิวต์นี้ใช้สำหรับการปิดเมนูแบบเลื่อนลงที่ระดับแอปพลิเคชัน ดังนั้นจึงควรใช้แอตทริบิวต์นี้เสมอ
เพิ่มdata-toggle="dropdown"
ในลิงก์หรือปุ่มเพื่อสลับรายการแบบเลื่อนลง
หากต้องการคง URL ไว้ด้วยปุ่มลิงก์ ให้ใช้data-target
แอตทริบิวต์แทนhref="#"
.
เรียกดรอปดาวน์ผ่าน JavaScript:
data-toggle="dropdown"
ยังต้องการไม่ว่าคุณจะเรียกดรอปดาวน์ของคุณผ่าน JavaScript หรือใช้ data-api แทน คุณdata-toggle="dropdown"
จำเป็นต้องแสดงบนองค์ประกอบทริกเกอร์ของดรอปดาวน์เสมอ
ไม่มี
$().dropdown('toggle')
สลับเมนูดรอปดาวน์ของแถบนำทางที่กำหนดหรือการนำทางแบบแท็บ
เหตุการณ์แบบเลื่อนลงทั้งหมดเริ่มต้นที่.dropdown-menu
องค์ประกอบหลักของ '
เหตุการณ์แบบเลื่อนลงทั้งหมดมีrelatedTarget
คุณสมบัติ ซึ่งมีค่าเป็นองค์ประกอบการสลับจุดยึด
ประเภทงาน | คำอธิบาย |
---|---|
show.bs.dropdown | เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีการเรียกวิธีการแสดงอินสแตนซ์ |
แสดง.bs.dropdown | เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้มองเห็นเมนูแบบเลื่อนลงได้ (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
hide.bs.dropdown | เหตุการณ์นี้เริ่มทำงานทันทีเมื่อมีการเรียกวิธีการซ่อนอินสแตนซ์ |
hidden.bs.dropdown | เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้ซ่อนรายการแบบหล่นลงเสร็จแล้ว (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
ปลั๊กอิน ScrollSpy ใช้สำหรับอัปเดตเป้าหมายการนำทางโดยอัตโนมัติตามตำแหน่งการเลื่อน เลื่อนพื้นที่ด้านล่างแถบนำทางและดูการเปลี่ยนแปลงชั้นเรียนที่ใช้งานอยู่ รายการย่อยแบบเลื่อนลงจะถูกเน้นด้วย
โฆษณากางเกงเลคกิ้ง, บรันช์ id art ปาร์ตี้สุดเหวี่ยง Pitchfork yr enim lo-fi ก่อนที่พวกเขาจะขายหมด qui Tumblr จักรยานจากฟาร์มสู่โต๊ะมีสิทธิ์อะไรก็ตาม เสื้อคาร์ดิแกน Anim keffiyeh บูธภาพถ่ายของ Velit seitan mcsweeney 3 wolf moon irure เสื้อกันหนาว Cosby กางเกงยีนส์ขาสั้น เสื้อกันหนาวมีฮู้ด williamsburg ที่คุณอาจไม่เคยได้ยินชื่อมาก่อน และกองทุนคาร์ดิแกน trust fund culpa biodiesel wes anderson aesthetic. Nihil สักข้อกล่าวหา, เครดิตประชดไบโอดีเซล keffiyeh ช่างฝีมือ ullamco ผลสืบเนื่อง.
สเก็ตบอร์ดหนวด Veniam marfa, หนวดเครา adipisicing fugiat velit ฟรีแกนเครา aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. รถบรรทุกอาหารเสื้อสเวตเตอร์ลายสัก cosby, mcsweeney's quis non freegan vinyl Lo-fi เวส แอนเดอร์สัน +1 sartorial คาร์ลส์ไม่ใช่การออกกำลังกายเพื่อความงาม บรู๊คลิน adipisicing เบียร์ฝีมือรอง keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft beer deserunt สเก็ตบอร์ด ea. สิทธิจักรยาน Lomo adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. ไวนิล ID ชีวิตสูง echo park consequat quis aliquip banh mi pitchfork Vero VHS ดีที่สุดแล้ว Consectetur nisi DIY กระเป๋าสะพายข้าง minim Cred ex in แพ็ก iphone ที่ยั่งยืน deelectus consectetur
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, culpa messenger bag marfa ไม่ว่าจะรถบรรทุกอาหารอะไรก็ตาม Sapiente synth id สมมติ Locavore sed helvetica cliche ประชดประชัน, Thundercats ที่คุณอาจไม่เคยได้ยินเกี่ยวกับพวกเขาเป็นผลจาก hoodie ที่ปราศจากกลูเตน lo-fi fap aliquip ลองใช้สถานที่ก่อนที่พวกเขาจะขายหมด เทอร์รี่ ริชาร์ดสัน บรันช์ที่เชี่ยวชาญในบรันช์ nesciunt quis cosby เสื้อกันหนาว pariatur keffiyeh ut helvetica ช่างฝีมือ คาร์ดิแกน คราฟท์เบียร์ seitan ผ้ากำมะหยี่สำเร็จรูป VHS แชมเบรย์ ลาบอริส เทมปอร์ เวเนียม แอนิม มอลลิต มินิม คอมโมโด อุลแลมโก้ ธันเดอร์แคทส์
ลิงก์ Navbar ต้องมีเป้าหมาย ID ที่แก้ไขได้ ตัวอย่างเช่น<a href="#home">home</a>
ต้องสอดคล้องกับบางสิ่งใน DOM <div id="home"></div>
เช่น
:visible
เป้าหมายถูกละเว้นองค์ประกอบเป้าหมายที่ไม่:visible
เป็นไปตาม jQueryจะถูกละเว้นและรายการนำทางที่เกี่ยวข้องจะไม่ถูกเน้น
ไม่ว่าจะใช้วิธีการใช้งานอย่างไร scrollspy จำเป็นต้องใช้position: relative;
กับองค์ประกอบที่คุณกำลังสอดแนม ในกรณีส่วนใหญ่ นี่คือ<body>
. เมื่อ scrollspying บนองค์ประกอบอื่นที่ไม่ใช่<body>
ตรวจสอบให้แน่ใจว่าได้height
ตั้งค่าและoverflow-y: scroll;
นำไปใช้
หากต้องการเพิ่มลักษณะการทำงานของ scrollspy ให้กับการนำทางบนแถบด้านบนของคุณอย่างง่ายดาย ให้เพิ่มdata-spy="scroll"
องค์ประกอบที่คุณต้องการสอดแนม (โดยทั่วไปแล้วจะเป็น<body>
) จากนั้นเพิ่มdata-target
แอตทริบิวต์ด้วย ID หรือคลาสขององค์ประกอบหลักขององค์ประกอบ.nav
Bootstrap
หลังจากเพิ่มposition: relative;
ใน CSS ของคุณแล้ว ให้เรียก scrollspy ผ่าน JavaScript:
.scrollspy('refresh')
เมื่อใช้ scrollspy ร่วมกับการเพิ่มหรือลบองค์ประกอบออกจาก DOM คุณจะต้องเรียกวิธีการรีเฟรชดังนี้:
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-offset=""
.
ชื่อ | พิมพ์ | ค่าเริ่มต้น | คำอธิบาย |
---|---|---|---|
offset | ตัวเลข | 10 | พิกเซลจะชดเชยจากด้านบนเมื่อคำนวณตำแหน่งของการเลื่อน |
ประเภทงาน | คำอธิบาย |
---|---|
activate.bs.scrollspy | เหตุการณ์นี้จะเริ่มทำงานเมื่อใดก็ตามที่รายการใหม่เปิดใช้งานโดย scrollspy |
เพิ่มฟังก์ชันแท็บแบบไดนามิกที่รวดเร็วเพื่อเปลี่ยนผ่านบานหน้าต่างเนื้อหาในเครื่อง แม้กระทั่งผ่านเมนูแบบเลื่อนลง ไม่รองรับแท็บที่ซ้อนกัน
ผ้ายีนส์ดิบที่คุณอาจไม่เคยได้ยินชื่อกางเกงยีนส์ออสติน Nesciunt Tofu stumptown aliqua, น้ำยาทำความสะอาดซินธ์มาสเตอร์แบบย้อนยุค หนวด cliche ชั่วคราว วิลเลียมส์เบิร์ก คาร์ล วีแกน เฮลเวติกา Reprehenderit คนขายเนื้อ retro keffiyeh dreamcatcher synth เสื้อกันหนาว Cosby eu banh mi, qui irure terry richardson ex squid Aliquip placeat ซัลเวีย cillum iphone. Seitan aliquip quis คาร์ดิแกน American apparel, 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.
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.
ปลั๊กอินนี้ขยายองค์ประกอบการนำทางแบบแท็บเพื่อเพิ่มพื้นที่แท็บได้
เปิดใช้งานแท็บแบบแท็บได้ผ่าน JavaScript (ต้องเปิดใช้งานแต่ละแท็บแยกกัน):
คุณสามารถเปิดใช้งานแต่ละแท็บได้หลายวิธี:
คุณสามารถเปิดใช้งานการนำทางแท็บหรือยาเม็ดโดยไม่ต้องเขียน JavaScript ใด ๆ โดยเพียงแค่ระบุdata-toggle="tab"
หรือdata-toggle="pill"
บนองค์ประกอบ การเพิ่มnav
และnav-tabs
คลาสลงในแท็บ จะใช้การ จัดสไตล์แท็บul
Bootstrap ขณะที่การเพิ่มคลาสและ จะใช้ การจัดสไตล์ยาเม็ดnav
nav-pills
หากต้องการให้แท็บจางลง ให้เพิ่ม.fade
แต่ละ.tab-pane
ไฟล์ บานหน้าต่างแท็บแรกยังต้อง.in
ทำให้เนื้อหาเริ่มต้นมองเห็นได้
$().tab
เปิดใช้งานองค์ประกอบแท็บและคอนเทนเนอร์เนื้อหา แท็บควรมี a data-target
หรือ การhref
กำหนดเป้าหมายโหนดคอนเทนเนอร์ใน DOM ในตัวอย่างข้างต้น แท็บต่างๆ คือแท็บที่<a>
มีdata-toggle="tab"
แอตทริบิวต์
.tab('show')
เลือกแท็บที่กำหนดและแสดงเนื้อหาที่เกี่ยวข้อง แท็บอื่นๆ ที่เลือกไว้ก่อนหน้านี้จะไม่ถูกเลือกและเนื้อหาที่เกี่ยวข้องจะถูกซ่อนไว้ กลับไปยังผู้โทรก่อนที่บานหน้าต่างแท็บจะแสดงขึ้นจริง (เช่น ก่อนที่shown.bs.tab
เหตุการณ์จะเกิดขึ้น)
เมื่อแสดงแท็บใหม่ เหตุการณ์จะเริ่มขึ้นตามลำดับต่อไปนี้:
hide.bs.tab
(บนแท็บที่ใช้งานอยู่ในปัจจุบัน)show.bs.tab
(บนแท็บที่จะแสดง)hidden.bs.tab
(ในแท็บที่ใช้งานก่อนหน้านี้ อันเดียวกับhide.bs.tab
เหตุการณ์)shown.bs.tab
(บนแท็บเพิ่งแสดงที่เพิ่งเปิดใช้งาน อันเดียวกับshow.bs.tab
เหตุการณ์)หากไม่มีแท็บใดเปิดใช้งานอยู่ เหตุการณ์ hide.bs.tab
และhidden.bs.tab
จะไม่เริ่มทำงาน
ประเภทงาน | คำอธิบาย |
---|---|
show.bs.tab | เหตุการณ์นี้เริ่มทำงานในการแสดงแท็บ แต่ก่อนที่จะมีการแสดงแท็บใหม่ ใช้event.target และevent.relatedTarget เพื่อกำหนดเป้าหมายแท็บที่ใช้งานอยู่และแท็บที่ใช้งานอยู่ก่อนหน้า (ถ้ามี) ตามลำดับ |
แสดง.bs.tab | เหตุการณ์นี้เริ่มทำงานในการแสดงแท็บหลังจากแสดงแท็บแล้ว ใช้event.target และevent.relatedTarget เพื่อกำหนดเป้าหมายแท็บที่ใช้งานอยู่และแท็บที่ใช้งานอยู่ก่อนหน้า (ถ้ามี) ตามลำดับ |
hide.bs.tab | เหตุการณ์นี้เริ่มทำงานเมื่อมีการแสดงแท็บใหม่ (และทำให้แท็บที่ใช้งานอยู่ก่อนหน้านี้ถูกซ่อนไว้) ใช้event.target และevent.relatedTarget เพื่อกำหนดเป้าหมายแท็บที่ใช้งานอยู่ในปัจจุบันและแท็บใหม่ที่จะใช้งานเร็วๆ นี้ ตามลำดับ |
hidden.bs.tab | เหตุการณ์นี้เริ่มทำงานหลังจากแสดงแท็บใหม่ (และทำให้แท็บที่ใช้งานอยู่ก่อนหน้านี้ถูกซ่อนไว้) ใช้event.target และevent.relatedTarget เพื่อกำหนดเป้าหมายแท็บที่ใช้งานอยู่ก่อนหน้าและแท็บใหม่ที่ใช้งานอยู่ตามลำดับ |
แรงบันดาลใจจากปลั๊กอิน jQuery.tipsy ที่ยอดเยี่ยมที่เขียนโดย Jason Frame; คำแนะนำเครื่องมือเป็นเวอร์ชันที่อัปเดตซึ่งไม่ต้องใช้รูปภาพ ใช้ CSS3 สำหรับภาพเคลื่อนไหว และแอตทริบิวต์ข้อมูลสำหรับพื้นที่จัดเก็บชื่อในเครื่อง
คำแนะนำเครื่องมือที่มีชื่อความยาวเป็นศูนย์จะไม่แสดงขึ้น
วางเมาส์เหนือลิงก์ด้านล่างเพื่อดูคำแนะนำเครื่องมือ:
กางเกงรัดรูป ระดับต่อไป keffiyeh คุณอาจไม่เคยได้ยินเกี่ยวกับพวกเขา บูธภาพถ่ายเคราผ้ายีนส์ดิบ letterpress กระเป๋าถือวีแก้น stumptown เครื่องแต่งกายแบบอเมริกันแบบ 8 บิตของ mcsweeney fixie ที่ยั่งยืนจากฟาร์มสู่โต๊ะมีผ้าแชมเบรย์ไวนิลริชาร์ดสันเทอร์รี่ Beard stumptown, เสื้อสเวตเตอร์ถัก banh mi lomo Thundercats เต้าหู้ไบโอดีเซล วิลเลี่ยมส์เบิร์ก มาร์ฟา, แชมเบรย์วีแก้นคลีนส์สี่โลโค แมคสวีนีย์ ช่างฝีมือที่น่าขันจริงๆไม่ว่า จะเป็นคีย์ตาร์ใดก็ตาม ทวิตเตอร์ ของ Austin จากฟาร์มถึงโต๊ะซึ่งจัดการไวรัสกาแฟต้นกำเนิดเดียวจากแหล่งเดียวของ freegan cred ฟรีแกน
มีสี่ตัวเลือก: จัดตำแหน่งบน ขวา ล่าง และซ้าย
ด้วยเหตุผลด้านประสิทธิภาพ Tooltip และ Popover data-apis เป็นแบบเลือกใช้ ซึ่งหมายความว่าคุณต้องเริ่มต้นด้วยตนเอง
วิธีหนึ่งในการเริ่มต้นคำแนะนำเครื่องมือทั้งหมดบนหน้าคือการเลือกตามdata-toggle
แอตทริบิวต์:
ปลั๊กอินคำแนะนำเครื่องมือสร้างเนื้อหาและมาร์กอัปตามต้องการ และโดยค่าเริ่มต้นจะวางคำแนะนำเครื่องมือหลังองค์ประกอบทริกเกอร์
ทริกเกอร์คำแนะนำเครื่องมือผ่าน JavaScript:
มาร์กอัปที่จำเป็นสำหรับคำแนะนำเครื่องมือเป็นเพียงdata
แอตทริบิวต์และtitle
ในองค์ประกอบ HTML ที่คุณต้องการให้มีคำแนะนำเครื่องมือ มาร์กอัปของคำแนะนำเครื่องมือที่สร้างขึ้นนั้นค่อนข้างง่าย แม้ว่าจะต้องมีตำแหน่ง (โดยค่าเริ่มต้น กำหนดtop
โดยปลั๊กอิน)
บางครั้งคุณต้องการเพิ่มคำแนะนำเครื่องมือไปยังไฮเปอร์ลิงก์ที่ตัดหลายบรรทัด ลักษณะการทำงานเริ่มต้นของปลั๊กอินคำแนะนำเครื่องมือคือการจัดกึ่งกลางในแนวนอนและแนวตั้ง เพิ่มwhite-space: nowrap;
จุดยึดของคุณเพื่อหลีกเลี่ยงสิ่งนี้
เมื่อใช้คำแนะนำเครื่องมือกับองค์ประกอบภายใน a .btn-group
หรือ an .input-group
หรือในองค์ประกอบที่เกี่ยวข้องกับตาราง ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
) คุณจะต้องระบุตัวเลือกcontainer: 'body'
(เอกสารด้านล่าง) เพื่อหลีกเลี่ยงผลข้างเคียงที่ไม่ต้องการ (เช่น องค์ประกอบที่ขยายกว้างขึ้นและ/ หรือสูญเสียมุมโค้งมนเมื่อเปิดใช้งานคำแนะนำเครื่องมือ)
สำหรับผู้ใช้ที่นำทางด้วยแป้นพิมพ์ และโดยเฉพาะอย่างยิ่งผู้ใช้เทคโนโลยีอำนวยความสะดวก คุณควรเพิ่มคำแนะนำเครื่องมือให้กับองค์ประกอบที่เน้นคีย์บอร์ดเท่านั้น เช่น ลิงก์ ตัวควบคุมฟอร์ม หรือองค์ประกอบใดๆ ที่มีtabindex="0"
แอตทริบิวต์ ตามอำเภอใจ
ในการเพิ่มคำแนะนำเครื่องมือให้กับ a disabled
หรือ.disabled
องค์ประกอบ ให้ใส่องค์ประกอบภายใน a <div>
และใช้คำแนะนำเครื่องมือกับสิ่งนั้น<div>
แทน
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-animation=""
.
โปรดทราบว่าด้วยเหตุผลด้านความปลอดภัยsanitize
, sanitizeFn
และwhiteList
ตัวเลือกไม่สามารถระบุได้โดยใช้แอตทริบิวต์ข้อมูล
ชื่อ | พิมพ์ | ค่าเริ่มต้น | คำอธิบาย |
---|---|---|---|
แอนิเมชั่น | บูลีน | จริง | ใช้ CSS Fade Transition กับคำแนะนำเครื่องมือ |
คอนเทนเนอร์ | สตริง | เท็จ | เท็จ | เพิ่มคำแนะนำเครื่องมือต่อท้ายองค์ประกอบเฉพาะ ตัวอย่าง: |
ล่าช้า | หมายเลข | วัตถุ | 0 | ความล่าช้าในการแสดงและซ่อนคำแนะนำเครื่องมือ (ms) - ใช้ไม่ได้กับประเภททริกเกอร์ด้วยตนเอง หากมีการระบุตัวเลข การหน่วงเวลาจะใช้กับทั้งซ่อน/แสดง โครงสร้างวัตถุคือ: |
html | บูลีน | เท็จ | แทรก HTML ลงในคำแนะนำเครื่องมือ text หากเป็นเท็จ จะใช้วิธีของ jQuery เพื่อแทรกเนื้อหาลงใน DOM ใช้ข้อความหากคุณกังวลเกี่ยวกับการโจมตี XSS |
ตำแหน่ง | สตริง | การทำงาน | 'สูงสุด' | วิธีวางตำแหน่งคำแนะนำเครื่องมือ - บนสุด | ด้านล่าง | ซ้าย | ขวา | อัตโนมัติ เมื่อใช้ฟังก์ชันเพื่อกำหนดตำแหน่ง ฟังก์ชันนี้จะถูกเรียกโดยมีโหนด DOM ของคำแนะนำเครื่องมือเป็นอาร์กิวเมนต์แรก และโหนด DOM ที่ทริกเกอร์องค์ประกอบเป็นโหนดที่สอง |
ตัวเลือก | สตริง | เท็จ | หากมีตัวเลือก อ็อบเจ็กต์คำแนะนำเครื่องมือจะถูกส่งไปยังเป้าหมายที่ระบุ ในทางปฏิบัติ จะใช้เพื่อใช้คำแนะนำเครื่องมือกับองค์ประกอบ DOM ที่เพิ่มแบบไดนามิก ( jQuery.on การสนับสนุน) ดูสิ่งนี้และตัวอย่างข้อมูล |
แม่แบบ | สตริง | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
HTML พื้นฐานที่จะใช้เมื่อสร้างคำแนะนำเครื่องมือ คำแนะนำเครื่องมือ
องค์ประกอบ wrapper นอกสุดควรมี |
ชื่อ | สตริง | การทำงาน | '' | ค่าเริ่มต้นของชื่อหากไม่มี หากมีการกำหนดฟังก์ชัน ฟังก์ชันนั้นจะถูกเรียกโดย |
สิ่งกระตุ้น | สตริง | 'เลื่อนโฟกัส' | วิธีการเรียกคำแนะนำเครื่องมือ - คลิก | โฉบ | โฟกัส | คู่มือ. คุณอาจส่งทริกเกอร์หลายตัว แยกพวกเขาด้วยช่องว่าง manual ไม่สามารถรวมกับทริกเกอร์อื่นได้ |
วิวพอร์ต | สตริง | วัตถุ | การทำงาน | { ตัวเลือก: 'body', padding: 0 } | เก็บคำแนะนำเครื่องมือไว้ภายในขอบเขตขององค์ประกอบนี้ ตัวอย่าง: หากมีการกำหนดฟังก์ชัน ฟังก์ชันจะถูกเรียกด้วยโหนด DOM องค์ประกอบที่ทริกเกอร์เป็นอาร์กิวเมนต์เดียว |
ฆ่าเชื้อ | บูลีน | จริง | เปิดหรือปิดการฆ่าเชื้อ หากเปิดใช้งาน'template' และ'content' ตัว'title' เลือกต่างๆ จะถูกฆ่าเชื้อ |
whiteList | วัตถุ | ค่าเริ่มต้น | ออบเจ็กต์ที่มีแอตทริบิวต์และแท็กที่อนุญาต |
ฆ่าเชื้อFn | null | การทำงาน | โมฆะ | ที่นี่คุณสามารถจัดหาฟังก์ชันฆ่าเชื้อของคุณเองได้ สิ่งนี้มีประโยชน์หากคุณต้องการใช้ห้องสมุดเฉพาะเพื่อทำการฆ่าเชื้อ |
ตัวเลือกสำหรับคำแนะนำเครื่องมือแต่ละรายการสามารถระบุได้โดยใช้แอตทริบิวต์ข้อมูล ตามที่อธิบายข้างต้น
$().tooltip(options)
แนบตัวจัดการคำแนะนำเครื่องมือกับคอลเล็กชันองค์ประกอบ
.tooltip('show')
แสดงคำแนะนำเครื่องมือขององค์ประกอบ กลับไปยังผู้เรียกก่อนที่จะแสดงคำแนะนำเครื่องมือจริง (กล่าวคือ ก่อนที่shown.bs.tooltip
เหตุการณ์จะเกิดขึ้น) นี่ถือเป็นการเรียกใช้ "คู่มือ" ของคำแนะนำเครื่องมือ คำแนะนำเครื่องมือที่มีชื่อความยาวเป็นศูนย์จะไม่แสดงขึ้น
.tooltip('hide')
ซ่อนคำแนะนำเครื่องมือขององค์ประกอบ กลับไปที่ผู้โทรก่อนที่คำแนะนำเครื่องมือจะถูกซ่อนจริง ๆ (เช่นก่อนหน้าhidden.bs.tooltip
เหตุการณ์จะเกิดขึ้น) นี่ถือเป็นการเรียกใช้ "คู่มือ" ของคำแนะนำเครื่องมือ
.tooltip('toggle')
สลับคำแนะนำเครื่องมือขององค์ประกอบ กลับไปยังผู้เรียกก่อนที่จะแสดงหรือซ่อนคำแนะนำเครื่องมือจริง (เช่น ก่อนที่ เหตุการณ์ shown.bs.tooltip
หรือhidden.bs.tooltip
เหตุการณ์จะเกิดขึ้น) นี่ถือเป็นการเรียกใช้ "คู่มือ" ของคำแนะนำเครื่องมือ
.tooltip('destroy')
ซ่อนและทำลายคำแนะนำขององค์ประกอบ คำแนะนำเครื่องมือที่ใช้การมอบหมาย (ซึ่งสร้างขึ้นโดยใช้ตัวselector
เลือก ) ไม่สามารถทำลายทีละรายการในองค์ประกอบทริกเกอร์ที่สืบทอดได้
ประเภทงาน | คำอธิบาย |
---|---|
show.bs.tooltip | เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีshow การเรียกเมธอดของอินสแตนซ์ |
แสดง.bs.tooltip | เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้มองเห็นคำแนะนำเครื่องมือ (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
hide.bs.tooltip | เหตุการณ์นี้เริ่มทำงานทันทีเมื่อhide มีการเรียกเมธอดของอินสแตนซ์ |
hidden.bs.tooltip | เหตุการณ์นี้เริ่มทำงานเมื่อคำแนะนำเครื่องมือถูกซ่อนจากผู้ใช้เสร็จสิ้น (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
inserted.bs.tooltip | เหตุการณ์นี้เริ่มทำงานหลังจากshow.bs.tooltip เหตุการณ์เมื่อมีการเพิ่มเทมเพลตคำแนะนำเครื่องมือใน DOM |
เพิ่มเนื้อหาซ้อนทับขนาดเล็ก เช่น บน iPad ลงในองค์ประกอบใดๆ เพื่อใช้เป็นข้อมูลรอง
ป๊อปโอเวอร์ที่มีทั้งชื่อและเนื้อหามีความยาวเป็นศูนย์จะไม่ปรากฏ
Popovers ต้องการปลั๊กอินคำแนะนำเครื่องมือที่จะรวมอยู่ใน Bootstrap เวอร์ชันของคุณ
ด้วยเหตุผลด้านประสิทธิภาพ Tooltip และ Popover data-apis เป็นแบบเลือกใช้ ซึ่งหมายความว่าคุณต้องเริ่มต้นด้วยตนเอง
วิธีหนึ่งในการเริ่มต้น popovers ทั้งหมดบนหน้าคือการเลือกตามdata-toggle
แอตทริบิวต์:
เมื่อใช้ป๊อปอัปกับองค์ประกอบภายใน a .btn-group
หรือ a หรือ .input-group
องค์ประกอบที่เกี่ยวข้องกับตาราง ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
) คุณจะต้องระบุตัวเลือกcontainer: 'body'
(เอกสารด้านล่าง) เพื่อหลีกเลี่ยงผลข้างเคียงที่ไม่ต้องการ (เช่น องค์ประกอบที่ขยายกว้างขึ้นและ/ หรือสูญเสียมุมมนเมื่อป๊อปโอเวอร์ถูกกระตุ้น)
หากต้องการเพิ่มป๊อปโอเวอร์ให้กับ a disabled
หรือ.disabled
องค์ประกอบ ให้ใส่องค์ประกอบภายใน a <div>
และใช้ป๊อปโอเวอร์กับองค์ประกอบนั้น<div>
แทน
บางครั้งคุณต้องการเพิ่มป๊อปโอเวอร์ไปยังไฮเปอร์ลิงก์ที่ตัดหลายบรรทัด ลักษณะการทำงานเริ่มต้นของปลั๊กอินป๊อปโอเวอร์คือการจัดกึ่งกลางในแนวนอนและแนวตั้ง เพิ่มwhite-space: nowrap;
จุดยึดของคุณเพื่อหลีกเลี่ยงสิ่งนี้
มีสี่ตัวเลือก: จัดตำแหน่งบน ขวา ล่าง และซ้าย
Sed posuere consectetur est ที่ lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est ที่ lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est ที่ lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est ที่ lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
ใช้focus
ทริกเกอร์เพื่อปิดป๊อปอัปในคลิกถัดไปที่ผู้ใช้ทำ
สำหรับพฤติกรรมข้ามเบราว์เซอร์และข้ามแพลตฟอร์มที่เหมาะสม คุณต้องใช้<a>
แท็กไม่ใช่แท็<button>
ก และคุณต้องรวมแอตทริบิวต์role="button"
และ ด้วยtabindex
เปิดใช้งานป๊อปอัปผ่าน JavaScript:
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-animation=""
.
โปรดทราบว่าด้วยเหตุผลด้านความปลอดภัยsanitize
, sanitizeFn
และwhiteList
ตัวเลือกไม่สามารถระบุได้โดยใช้แอตทริบิวต์ข้อมูล
ชื่อ | พิมพ์ | ค่าเริ่มต้น | คำอธิบาย |
---|---|---|---|
แอนิเมชั่น | บูลีน | จริง | ใช้ CSS Fade Transition กับป๊อปโอเวอร์ |
คอนเทนเนอร์ | สตริง | เท็จ | เท็จ | ต่อท้ายป๊อปโอเวอร์กับองค์ประกอบเฉพาะ ตัวอย่าง: |
เนื้อหา | สตริง | การทำงาน | '' | ค่าเนื้อหาเริ่มต้น if หากมีการกำหนดฟังก์ชัน ฟังก์ชันนั้นจะถูกเรียกโดย |
ล่าช้า | หมายเลข | วัตถุ | 0 | ความล่าช้าในการแสดงและซ่อนป๊อปโอเวอร์ (ms) - ใช้ไม่ได้กับประเภททริกเกอร์ด้วยตนเอง หากมีการระบุตัวเลข การหน่วงเวลาจะใช้กับทั้งซ่อน/แสดง โครงสร้างวัตถุคือ: |
html | บูลีน | เท็จ | แทรก HTML ลงในป๊อปโอเวอร์ text หากเป็นเท็จ จะใช้วิธีของ jQuery เพื่อแทรกเนื้อหาลงใน DOM ใช้ข้อความหากคุณกังวลเกี่ยวกับการโจมตี XSS |
ตำแหน่ง | สตริง | การทำงาน | 'ขวา' | วิธีวางตำแหน่งป๊อปโอเวอร์ - ด้านบน | ด้านล่าง | ซ้าย | ขวา | อัตโนมัติ เมื่อใช้ฟังก์ชันเพื่อกำหนดตำแหน่ง ฟังก์ชันจะถูกเรียกโดยมีโหนด DOM แบบป๊อปโอเวอร์เป็นอาร์กิวเมนต์แรก และโหนด DOM ที่ทริกเกอร์องค์ประกอบเป็นโหนดที่สอง บริบทถูกตั้ง ค่า |
ตัวเลือก | สตริง | เท็จ | หากมีตัวเลือก ออบเจ็กต์ป๊อปโอเวอร์จะถูกส่งไปยังเป้าหมายที่ระบุ ในทางปฏิบัติ ใช้เพื่อเปิดใช้งานเนื้อหา HTML แบบไดนามิกเพื่อเพิ่มป๊อปอัป ดูสิ่งนี้และตัวอย่างข้อมูล |
แม่แบบ | สตริง | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
HTML พื้นฐานที่จะใช้เมื่อสร้างป๊อปโอเวอร์ ป๊อปโอเวอร์ ป๊อปโอเวอร์
องค์ประกอบ wrapper นอกสุดควรมี |
ชื่อ | สตริง | การทำงาน | '' | ค่าเริ่มต้นของชื่อหากไม่มี หากมีการกำหนดฟังก์ชัน ฟังก์ชันนั้นจะถูกเรียกโดย |
สิ่งกระตุ้น | สตริง | 'คลิก' | วิธีเรียกป๊อปโอเวอร์ - คลิก | โฉบ | โฟกัส | คู่มือ. คุณอาจส่งทริกเกอร์หลายตัว แยกพวกเขาด้วยช่องว่าง manual ไม่สามารถรวมกับทริกเกอร์อื่นได้ |
วิวพอร์ต | สตริง | วัตถุ | การทำงาน | { ตัวเลือก: 'body', padding: 0 } | ให้ป๊อปโอเวอร์อยู่ภายในขอบเขตขององค์ประกอบนี้ ตัวอย่าง: หากมีการกำหนดฟังก์ชัน ฟังก์ชันจะถูกเรียกด้วยโหนด DOM องค์ประกอบที่ทริกเกอร์เป็นอาร์กิวเมนต์เดียว บริบทถูกตั้ง ค่า |
ฆ่าเชื้อ | บูลีน | จริง | เปิดหรือปิดการฆ่าเชื้อ หากเปิดใช้งาน'template' และ'content' ตัว'title' เลือกต่างๆ จะถูกฆ่าเชื้อ |
whiteList | วัตถุ | ค่าเริ่มต้น | ออบเจ็กต์ที่มีแอตทริบิวต์และแท็กที่อนุญาต |
ฆ่าเชื้อFn | null | การทำงาน | โมฆะ | ที่นี่คุณสามารถจัดหาฟังก์ชันฆ่าเชื้อของคุณเองได้ สิ่งนี้มีประโยชน์หากคุณต้องการใช้ห้องสมุดเฉพาะเพื่อทำการฆ่าเชื้อ |
ตัวเลือกสำหรับป๊อปอัปแต่ละรายการสามารถระบุได้โดยใช้แอตทริบิวต์ข้อมูล ตามที่อธิบายข้างต้น
$().popover(options)
เริ่มต้น popovers สำหรับคอลเล็กชันองค์ประกอบ
.popover('show')
เผยให้เห็นป๊อปโอเวอร์ขององค์ประกอบ กลับไปยังผู้โทรก่อนที่ป๊อปโอเวอร์จะปรากฏขึ้นจริง (เช่น ก่อนshown.bs.popover
เหตุการณ์จะเกิดขึ้น) นี่ถือเป็นการกระตุ้น "ด้วยตนเอง" ของป๊อปโอเวอร์ ป๊อปอัปที่มีทั้งชื่อและเนื้อหามีความยาวเป็นศูนย์จะไม่ปรากฏ
.popover('hide')
ซ่อนป๊อปโอเวอร์ขององค์ประกอบ กลับไปที่ผู้โทรก่อนที่ป๊อปโอเวอร์จะถูกซ่อนจริง ๆ (เช่นก่อนhidden.bs.popover
เหตุการณ์จะเกิดขึ้น) นี่ถือเป็นการกระตุ้น "ด้วยตนเอง" ของป๊อปโอเวอร์
.popover('toggle')
สลับป๊อปโอเวอร์ขององค์ประกอบ กลับไปยังผู้โทรก่อนที่ป๊อปโอเวอร์จะแสดงหรือซ่อนอยู่จริง (กล่าวคือ ก่อนที่ เหตุการณ์ shown.bs.popover
หรือhidden.bs.popover
เหตุการณ์จะเกิดขึ้น) นี่ถือเป็นการกระตุ้น "ด้วยตนเอง" ของป๊อปโอเวอร์
.popover('destroy')
ซ่อนและทำลายป๊อปโอเวอร์ขององค์ประกอบ ป๊อปโอเวอร์ที่ใช้การมอบหมาย (ซึ่งสร้างขึ้นโดยใช้ตัวselector
เลือก ) ไม่สามารถทำลายทีละรายการในองค์ประกอบทริกเกอร์ที่สืบทอดได้
ประเภทงาน | คำอธิบาย |
---|---|
show.bs.popover | เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีshow การเรียกเมธอดของอินสแตนซ์ |
แสดง.bs.popover | เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้มองเห็นป๊อปโอเวอร์ (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
hide.bs.popover | เหตุการณ์นี้เริ่มทำงานทันทีเมื่อhide มีการเรียกเมธอดของอินสแตนซ์ |
hidden.bs.popover | เหตุการณ์นี้เริ่มทำงานเมื่อป๊อปโอเวอร์ถูกซ่อนจากผู้ใช้เสร็จสิ้น (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
แทรก.bs.popover | เหตุการณ์นี้เริ่มทำงานหลังจากshow.bs.popover เหตุการณ์เมื่อมีการเพิ่มเทมเพลตป๊อปโอเวอร์ใน DOM |
เพิ่มฟังก์ชันการยกเลิกให้กับข้อความแจ้งเตือนทั้งหมดด้วยปลั๊กอินนี้
เมื่อใช้.close
ปุ่ม ต้องเป็นลูกคนแรกของ the .alert-dismissible
และไม่มีเนื้อหาข้อความใดนำหน้าในมาร์กอัป
เปลี่ยนสิ่งนี้และสิ่งนั้นแล้วลองอีกครั้ง Duis mollis, est ไม่ใช่ commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit Cras mattis consectetur purus นั่ง amet fermentum.
เพียงเพิ่มdata-dismiss="alert"
ปุ่มปิดเพื่อให้ฟังก์ชันปิดการแจ้งเตือนโดยอัตโนมัติ การปิดการแจ้งเตือนจะเป็นการนำออกจาก DOM
หากต้องการให้การแจ้งเตือนของคุณใช้ภาพเคลื่อนไหวเมื่อปิด ให้ตรวจสอบว่ามี คลาส .fade
และ.in
คลาสที่ใช้อยู่แล้ว
$().alert()
ทำให้การแจ้งเตือนฟังเหตุการณ์การคลิกบนองค์ประกอบลูกหลานที่มีdata-dismiss="alert"
แอตทริบิวต์ (ไม่จำเป็นเมื่อใช้การกำหนดค่าเริ่มต้นอัตโนมัติของ data-api)
$().alert('close')
ปิดการแจ้งเตือนโดยลบออกจาก DOM ถ้า.fade
และ.in
อยู่บนองค์ประกอบ การแจ้งเตือนจะจางหายไปก่อนที่จะถูกลบ
ปลั๊กอินการแจ้งเตือนของ Bootstrap เปิดเผยเหตุการณ์บางอย่างสำหรับการเชื่อมต่อกับฟังก์ชันการแจ้งเตือน
ประเภทงาน | คำอธิบาย |
---|---|
ปิด.bs.alert | เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีclose การเรียกเมธอดของอินสแตนซ์ |
ปิด.bs.alert | เหตุการณ์นี้เริ่มทำงานเมื่อมีการปิดการแจ้งเตือน (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
ทำสิ่งต่างๆ ได้มากขึ้นด้วยปุ่มต่างๆ สถานะปุ่มควบคุมหรือสร้างกลุ่มปุ่มสำหรับส่วนประกอบเพิ่มเติม เช่น แถบเครื่องมือ
Firefox ยังคงมีสถานะการควบคุมฟอร์ม (ความพิการและการตรวจสอบ) ในการโหลดหน้าเว็บ วิธีแก้ปัญหาสำหรับสิ่งนี้คือการใช้autocomplete="off"
. ดู ข้อผิดพลาด Mozilla #654072
เพิ่มdata-loading-text="Loading..."
เพื่อใช้สถานะการโหลดบนปุ่ม
คุณลักษณะนี้เลิกใช้งานตั้งแต่ v3.3.5 และถูกลบใน v4
เพื่อการสาธิตนี้ เราใช้data-loading-text
และ$().button('loading')
แต่นั่นไม่ใช่สถานะเดียวที่คุณสามารถใช้ได้ ดูเพิ่มเติมเกี่ยวกับสิ่งนี้ด้านล่างใน$().button(string)
เอกสารประกอบ
เพิ่มdata-toggle="button"
เพื่อเปิดใช้งานการสลับบนปุ่มเดียว
.active
และaria-pressed="true"
สำหรับปุ่มที่สลับล่วงหน้า คุณต้องเพิ่ม.active
คลาสและaria-pressed="true"
แอตทริบิวต์ให้กับbutton
ตัวคุณเอง
เพิ่มdata-toggle="buttons"
ลงใน.btn-group
ช่องทำเครื่องหมายหรืออินพุตวิทยุที่มีเพื่อเปิดใช้งานการสลับในสไตล์ที่เกี่ยวข้อง
.active
สำหรับตัวเลือกที่เลือกไว้ล่วงหน้า คุณต้องเพิ่ม.active
คลาสเข้ากับอินพุตlabel
ด้วยตนเอง
หากสถานะที่ทำเครื่องหมายไว้ของปุ่มช่องทำเครื่องหมายได้รับการอัปเดตโดยไม่ทำให้click
เกิดเหตุการณ์บนปุ่ม (เช่น ผ่าน<input type="reset">
หรือผ่านการตั้งค่าchecked
คุณสมบัติของอินพุต) คุณจะต้องสลับ.active
คลาสกับอินพุตlabel
ด้วยตนเอง
$().button('toggle')
สลับสถานะการกด ให้ปุ่มมีลักษณะที่เปิดใช้งาน
$().button('reset')
รีเซ็ตสถานะปุ่ม - สลับข้อความเป็นข้อความต้นฉบับ เมธอดนี้เป็นแบบอะซิงโครนัสและส่งคืนก่อนที่การรีเซ็ตจะเสร็จสิ้นจริง
$().button(string)
สลับข้อความเป็นสถานะข้อความที่กำหนดไว้ของข้อมูล
ปลั๊กอินที่ยืดหยุ่นซึ่งใช้คลาสจำนวนหนึ่งเพื่อให้สลับการทำงานได้ง่าย
การยุบต้องใช้ปลั๊กอินการเปลี่ยนเพื่อรวมไว้ใน Bootstrap เวอร์ชันของคุณ
คลิกปุ่มด้านล่างเพื่อแสดงและซ่อนองค์ประกอบอื่นผ่านการเปลี่ยนแปลงคลาส:
.collapse
ซ่อนเนื้อหา.collapsing
ถูกนำไปใช้ในระหว่างช่วงการเปลี่ยนภาพ.collapse.in
แสดงเนื้อหาคุณสามารถใช้ลิงก์ที่มีhref
แอตทริบิวต์หรือปุ่มที่มีdata-target
แอตทริบิวต์ได้ ในทั้งสองกรณีdata-toggle="collapse"
จำเป็นต้องมี
ขยายลักษณะการยุบเริ่มต้นเพื่อสร้างหีบเพลงกับส่วนประกอบแผง
นอกจากนี้ยังสามารถเปลี่ยน.panel-body
s กับ.list-group
s ได้อีกด้วย
อย่าลืมเพิ่มaria-expanded
องค์ประกอบการควบคุม แอตทริบิวต์นี้กำหนดสถานะปัจจุบันขององค์ประกอบที่ยุบได้อย่างชัดเจนให้กับโปรแกรมอ่านหน้าจอและเทคโนโลยีช่วยเหลือที่คล้ายคลึงกัน หากองค์ประกอบที่ยุบได้ถูกปิดโดยค่าเริ่มต้น องค์ประกอบนั้นควรมีค่าaria-expanded="false"
เป็น หากคุณได้ตั้งค่าให้เปิดองค์ประกอบที่ยุบได้โดยค่าเริ่มต้นโดยใช้in
คลาส ให้ตั้งค่าaria-expanded="true"
บนตัวควบคุมแทน ปลั๊กอินจะสลับแอตทริบิวต์นี้โดยอัตโนมัติโดยพิจารณาจากการเปิดหรือปิดองค์ประกอบที่ยุบได้
นอกจากนี้ หากองค์ประกอบควบคุมของคุณกำหนดเป้าหมายไปยังองค์ประกอบที่ยุบได้เพียงองค์ประกอบเดียว นั่นคือdata-target
แอตทริบิวต์ชี้ไปที่ anid
ตัวเลือก คุณอาจเพิ่มaria-controls
แอตทริบิวต์เพิ่มเติมลงในองค์ประกอบการควบคุม ซึ่งประกอบด้วยid
องค์ประกอบที่ยุบได้ โปรแกรมอ่านหน้าจอสมัยใหม่และเทคโนโลยีช่วยเหลือที่คล้ายคลึงกันใช้ประโยชน์จากแอตทริบิวต์นี้เพื่อให้ผู้ใช้มีทางลัดเพิ่มเติมเพื่อนำทางไปยังองค์ประกอบที่ยุบได้โดยตรง
ปลั๊กอินยุบใช้คลาสสองสามคลาสเพื่อจัดการกับงานหนัก:
.collapse
ซ่อนเนื้อหา.collapse.in
แสดงเนื้อหา.collapsing
ถูกเพิ่มเมื่อการเปลี่ยนแปลงเริ่มต้น และลบออกเมื่อเสร็จสิ้นคลาสเหล่านี้สามารถพบได้ในcomponent-animations.less
.
เพียงเพิ่มdata-toggle="collapse"
และ a data-target
ให้กับองค์ประกอบเพื่อกำหนดการควบคุมองค์ประกอบที่ยุบได้โดยอัตโนมัติ แอตทริบิวต์data-target
ยอมรับตัวเลือก CSS เพื่อปรับใช้การยุบ อย่าลืมเพิ่มคลาสcollapse
ลงในองค์ประกอบที่ยุบได้ หากคุณต้องการให้เปิดโดยค่าเริ่มต้น ให้เพิ่มคลาสin
เพิ่มเติม
หากต้องการเพิ่มการจัดการกลุ่มแบบหีบเพลงให้กับตัวควบคุมที่ยุบได้ ให้เพิ่มแอตทริบิวต์data-parent="#selector"
ข้อมูล อ้างถึงการสาธิตเพื่อดูการดำเนินการนี้
เปิดใช้งานด้วยตนเองด้วย:
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-parent=""
.
ชื่อ | ���ิมพ์ | ค่าเริ่มต้น | คำอธิบาย |
---|---|---|---|
พ่อแม่ | ตัวเลือก | เท็จ | หากมีการระบุตัวเลือก องค์ประกอบที่ยุบได้ทั้งหมดภายใต้พาเรนต์ที่ระบุจะถูกปิดเมื่อแสดงรายการที่ยุบได้นี้ (คล้ายกับพฤติกรรมหีบเพลงแบบดั้งเดิม - ขึ้นอยู่กับpanel ชั้นเรียน) |
สลับ | บูลีน | จริง | สลับองค์ประกอบที่ยุบได้ในการเรียกใช้ |
.collapse(options)
เปิดใช้งานเนื้อหาของคุณเป็นองค์ประกอบที่ยุบได้ ยอมรับตัวเลือกobject
เสริม
.collapse('toggle')
สลับองค์ประกอบที่ยุบได้เพื่อแสดงหรือซ่อน กลับไปยังผู้เรียกก่อนที่องค์ประกอบที่ยุบได้จะถูกแสดงหรือซ่อนอยู่จริง (กล่าวคือ ก่อนที่ เหตุการณ์ shown.bs.collapse
or hidden.bs.collapse
จะเกิดขึ้น)
.collapse('show')
แสดงองค์ประกอบที่ยุบได้ กลับไปยังผู้เรียกก่อนที่จะแสดงองค์ประกอบที่ยุบได้จริง (เช่น ก่อนที่shown.bs.collapse
เหตุการณ์จะเกิดขึ้น)
.collapse('hide')
ซ่อนองค์ประกอบที่ยุบได้ กลับไปยังผู้เรียกก่อนที่องค์ประกอบที่ยุบได้จะถูกซ่อนจริง ๆ (กล่าวคือ ก่อนที่hidden.bs.collapse
เหตุการณ์จะเกิดขึ้น)
คลาสการยุบของ Bootstrap แสดงเหตุการณ์สองสามเหตุการณ์สำหรับการเชื่อมต่อกับฟังก์ชันการยุบ
ประเภทงาน | คำอธิบาย |
---|---|
show.bs.collapse | เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีshow การเรียกเมธอดของอินสแตนซ์ |
แสดง.bs.ยุบ | เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้มองเห็นองค์ประกอบการยุบ (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
hide.bs.collapse | เหตุการณ์นี้เริ่มทำงานทันทีเมื่อhide มีการเรียกเมธอด |
hidden.bs.collapse | เหตุการณ์นี้เริ่มทำงานเมื่อองค์ประกอบการยุบถูกซ่อนจากผู้ใช้ (จะรอให้การเปลี่ยน CSS เสร็จสมบูรณ์) |
ส่วนประกอบสไลด์โชว์สำหรับการปั่นจักรยานผ่านองค์ประกอบต่างๆ เช่น ม้าหมุน ไม่รองรับภาพหมุนที่ซ้อนกัน
ส่วนประกอบแบบหมุนโดยทั่วไปไม่เป็นไปตามมาตรฐานการช่วยสำหรับการเข้าถึง หากคุณต้องการปฏิบัติตาม โปรดพิจารณาตัวเลือกอื่นๆ สำหรับการนำเสนอเนื้อหาของคุณ
Bootstrap ใช้ CSS3 สำหรับภาพเคลื่อนไหวโดยเฉพาะ แต่ Internet Explorer 8 และ 9 ไม่รองรับคุณสมบัติ CSS ที่จำเป็น ดังนั้นจึงไม่มีภาพเคลื่อนไหวการเปลี่ยนสไลด์เมื่อใช้เบราว์เซอร์เหล่านี้ เราได้ตัดสินใจโดยเจตนาที่จะไม่รวมทางเลือกที่ใช้ jQuery สำหรับการเปลี่ยน
.active
ต้องเพิ่มชั้นเรียนลงในสไลด์ตัวใดตัวหนึ่ง มิฉะนั้น ภาพหมุนจะไม่ปรากฏให้เห็น
ไม่จำเป็นต้องใช้คลาสและคลาสสำหรับการ.glyphicon .glyphicon-chevron-left
ควบคุม .glyphicon .glyphicon-chevron-right
Bootstrap จัดเตรียม.icon-prev
และ.icon-next
เป็นทางเลือก Unicode ธรรมดา
เพิ่มคำอธิบายภาพให้กับสไลด์ของคุณได้อย่างง่ายดายด้วย.carousel-caption
องค์ประกอบภายใน.item
ไฟล์ . วาง HTML ที่เป็นตัวเลือกไว้ภายในนั้น และมันจะถูกจัดตำแหน่งและจัดรูปแบบโดยอัตโนมัติ
ภาพหมุนต้องใช้ an id
ที่คอนเทนเนอร์ด้านนอกสุด (the .carousel
) เพื่อให้ตัวควบคุมแบบหมุนทำงานได้อย่างถูกต้อง เมื่อเพิ่มภาพหมุนหลายภาพ หรือเมื่อเปลี่ยนภาพหมุนid
โปรดอัปเดตการควบคุมที่เกี่ยวข้อง
ใช้แอตทริบิวต์ข้อมูลเพื่อควบคุมตำแหน่งของวงล้อได้อย่างง่ายดาย data-slide
ยอมรับคำหลักprev
หรือnext
ซึ่งเปลี่ยนตำแหน่งสไลด์ที่สัมพันธ์กับตำแหน่งปัจจุบัน อีกทางหนึ่ง ใช้data-slide-to
เพื่อส่งดัชนีสไลด์ดิบไปยังภาพหมุนdata-slide-to="2"
ซึ่งจะเลื่อนตำแหน่งสไลด์ไปที่ดัชนีเฉพาะที่ขึ้นต้นด้วย0
ด้วย
แอตทริบิวต์data-ride="carousel"
นี้ใช้เพื่อทำเครื่องหมายภาพหมุนเป็นภาพเคลื่อนไหวโดยเริ่มต้นเมื่อโหลดหน้าเว็บ ไม่สามารถใช้ร่วมกับการเริ่มต้น JavaScript ที่ชัดเจน (ซ้ำซ้อนและไม่จำเป็น) ของภาพหมุนเดียวกัน
โทรแบบหมุนด้วยตนเองด้วย:
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-interval=""
.
ชื่อ | พิมพ์ | ค่าเริ่มต้น | คำอธิบาย |
---|---|---|---|
ช่วงเวลา | ตัวเลข | 5000 | ระยะเวลาที่จะหน่วงเวลาระหว่างการปั่นจักรยานรายการโดยอัตโนมัติ หากเป็นเท็จ ภาพหมุนจะไม่หมุนโดยอัตโนมัติ |
หยุด | สตริง | โมฆะ | "โฮเวอร์" | หากตั้งค่าเป็น จะ"hover" หยุดการวนรอบของวงล้อชั่วคราวmouseenter และเปิดการวนต่อของวงล้อmouseleave ต่อ หากตั้งค่าเป็น การnull วางเมาส์เหนือภาพหมุนจะไม่หยุดชั่วคราว |
ห่อ | บูลีน | จริง | ว่าวงล้อควรวนอย่างต่อเนื่องหรือหยุดยากหรือไม่ |
แป้นพิมพ์ | บูลีน | จริง | ว่าภาพหมุนควรตอบสนองต่อเหตุการณ์แป้นพิมพ์หรือไม่ |
.carousel(options)
เริ่มต้นวงล้อด้วยตัวเลือกเสริมobject
และเริ่มวนรอบรายการต่างๆ
.carousel('cycle')
หมุนเวียนผ่านรายการแบบหมุนจากซ้ายไปขวา
.carousel('pause')
หยุดม้าหมุนจากการปั่นจักรยานผ่านรายการ
.carousel(number)
หมุนวงล้อไปที่เฟรมใดเฟรมหนึ่ง (อิงตาม 0 คล้ายกับอาร์เรย์)
.carousel('prev')
วนไปยังรายการก่อนหน้า
.carousel('next')
วนไปยังรายการถัดไป
คลาสม้าหมุนของ Bootstrap เปิดเผยสองเหตุการณ์สำหรับการเชื่อมต่อกับฟังก์ชันหมุน
ทั้งสองเหตุการณ์มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:
direction
: ทิศทางที่วงล้อเลื่อน ( "left"
หรือ"right"
)relatedTarget
: องค์ประกอบ DOM ที่กำลังถูกเลื่อนเข้าที่ในฐานะรายการที่ใช้งานอยู่เหตุการณ์ภาพหมุนทั้งหมดจะถูกไล่ออกที่ตัวหมุนเอง (เช่น ที่<div class="carousel">
)
ประเภทงาน | คำอธิบาย |
---|---|
slide.bs.carousel | เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีslide การเรียกใช้เมธอดของอินสแตนซ์ |
slid.bs.carousel | เหตุการณ์นี้เริ่มทำงานเมื่อภาพหมุนเสร็จสิ้นการเปลี่ยนสไลด์ |
ปลั๊กอินเสริมจะสลับposition: fixed;
เปิดและปิด โดยเลียนแบบเอฟเฟกต์ที่พบด้วยposition: sticky;
. การนำทางย่อยทางด้านขวาเป็นการสาธิตสดของปลั๊กอินเสริม
ใช้ปลั๊กอินเสริมผ่านแอตทริบิวต์ข้อมูลหรือด้วยตนเองด้วย JavaScript ของคุณเอง ในทั้งสองสถานการณ์ คุณต้องระบุ CSS สำหรับการวางตำแหน่งและความกว้างของเนื้อหาที่ติดอยู่
หมายเหตุ: อย่าใช้ปลั๊กอินเสริมบนองค์ประกอบที่มีอยู่ในองค์ประกอบที่ค่อนข้างวางตำแหน่ง เช่น คอลัมน์ที่ดึงหรือผลัก เนื่องจาก ข้อผิดพลาดในการเรนเด อร์ของSafari
ปลั๊กอินเสริมจะสลับไปมาระหว่างสามคลาส แต่ละคลาสแสดงถึงสถานะเฉพาะ: .affix
, , .affix-top
และ .affix-bottom
คุณต้องระบุสไตล์ ยกเว้นposition: fixed;
on .affix
สำหรับคลาสเหล่านี้ด้วยตนเอง (ไม่ขึ้นกับปลั๊กอินนี้) เพื่อจัดการตำแหน่งจริง
นี่คือวิธีการทำงานของปลั๊กอินเสริม:
.affix-top
เพื่อระบุว่าองค์ประกอบอยู่ในตำแหน่งบนสุด ณ จุดนี้ไม่จำเป็นต้องมีการวางตำแหน่ง CSS.affix
แทนที่.affix-top
และตั้งค่าposition: fixed;
(จัดทำโดย CSS ของ Bootstrap).affix
ด้วย .affix-bottom
เนื่องจากออฟเซ็ตเป็นทางเลือก คุณจึงจำเป็นต้องตั้งค่า CSS ที่เหมาะสม ในกรณีนี้ ให้เพิ่มposition: absolute;
เมื่อจำเป็น ปลั๊กอินใช้แอตทริบิวต์ข้อมูลหรือตัวเลือก JavaScript เพื่อกำหนดตำแหน่งที่จะวางองค์ประกอบจากที่นั่นทำตามขั้นตอนด้านบนเพื่อตั้งค่า CSS ของคุณสำหรับตัวเลือกการใช้งานด้านล่าง
หากต้องการเพิ่มพฤติกรรมการติดไปยังองค์ประกอบใดๆ อย่างง่ายดาย เพียงเพิ่มdata-spy="affix"
องค์ประกอบที่คุณต้องการสอดแนม ใช้ออฟเซ็ตเพื่อกำหนดว่าเมื่อใดควรสลับการตรึงองค์ประกอบ
เรียกปลั๊กอินเสริมผ่าน JavaScript:
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-offset-top="200"
.
ชื่อ | พิมพ์ | ค่าเริ่มต้น | คำอธิบาย |
---|---|---|---|
offset | หมายเลข | ฟังก์ชั่น | วัตถุ | 10 | พิกเซลที่จะชดเชยจากหน้าจอเมื่อคำนวณตำแหน่งของการเลื่อน หากระบุหมายเลขเดียว ระบบจะใช้การชดเชยทั้งทางด้านบนและด้านล่าง ในการจัดเตรียมออฟเซ็ตด้านล่างและด้านบนที่ไม่เหมือนใคร เพียงแค่ระบุออบเจกต์offset: { top: 10 } หรือoffset: { top: 10, bottom: 5 } . ใช้ฟังก์ชันเมื่อคุณต้องการคำนวณออฟเซ็ตแบบไดนามิก |
เป้า | ตัวเลือก | โหนด | องค์ประกอบ jQuery | window วัตถุ_ |
ระบุองค์ประกอบเป้าหมายของส่วนต่อท้าย |
.affix(options)
เปิดใช้งานเนื้อหาของคุณเป็นเนื้อหาที่ติดอยู่ ยอมรับตัวเลือกobject
เสริม
.affix('checkPosition')
คำนวณสถานะของส่วนต่อท้ายใหม่ตามขนาด ตำแหน่ง และตำแหน่งเลื่อนขององค์ประกอบที่เกี่ยวข้อง คลาส.affix
, .affix-top
, และ.affix-bottom
ถูกเพิ่มหรือลบออกจากเนื้อหาที่ติดอยู่ตามสถานะใหม่ ต้องเรียกวิธีนี้ทุกครั้งที่มีการเปลี่ยนแปลงขนาดของเนื้อหาที่ติดอยู่หรือองค์ประกอบเป้าหมาย เพื่อให้แน่ใจว่าการวางตำแหน่งที่ถูกต้องของเนื้อหาที่ติดอยู่
ปลั๊กอินส่วนต่อท้ายของ Bootstrap เปิดเผยเหตุการณ์บางอย่างสำหรับการเชื่อมต่อกับฟังก์ชันการต่อท้าย
ประเภทงาน | คำอธิบาย |
---|---|
affix.bs.affix | เหตุการณ์นี้จะเริ่มทำงานทันทีก่อนที่จะติดองค์ประกอบ |
ติด.bs.affix | เหตุการณ์นี้เริ่มทำงานหลังจากติดตั้งองค์ประกอบแล้ว |
affix-top.bs.affix | เหตุการณ์นี้จะเริ่มทำงานทันทีก่อนที่องค์ประกอบจะติดอยู่ด้านบน |
affixed-top.bs.affix | เหตุการณ์นี้เริ่มทำงานหลังจากองค์ประกอบได้รับการติดด้านบนแล้ว |
affix-bottom.bs.affix | เหตุการณ์นี้จะเริ่มทำงานทันทีก่อนที่องค์ประกอบจะติดอยู่ด้านล่าง |
ติด-bottom.bs.affix | เหตุการณ์นี้เริ่มทำงานหลังจากองค์ประกอบได้รับการติดด้านล่าง |