Sourceขนมปังปิ้ง
ส่งการแจ้งเตือนไปยังผู้เยี่ยมชมของคุณด้วยขนมปังปิ้ง ข้อความเตือนที่มีน้ำหนักเบาและปรับแต่งได้ง่าย
ขนมปังปิ้งเป็นการแจ้งเตือนแบบเบาที่ออกแบบมาเพื่อเลียนแบบการแจ้งเตือนแบบพุชที่ระบบปฏิบัติการมือถือและเดสก์ท็อปได้รับความนิยม สร้างด้วย flexbox จึงสามารถจัดตำแหน่งและจัดตำแหน่งได้ง่าย
ภาพรวม
สิ่งที่ต้องรู้เมื่อใช้ปลั๊กอินขนมปังปิ้ง:
- หากคุณกำลังสร้าง JavaScript จากแหล่งที่มา มันต้องการ
util.js
.
- ขนมปังปิ้งเป็นตัวเลือกสำหรับเหตุผลด้านประสิทธิภาพ ดังนั้นคุณต้องเริ่มต้นด้วยตนเอง
- โปรดทราบว่าคุณต้องรับผิดชอบในการวางตำแหน่งขนมปังปิ้ง
- ขนมปังปิ้งจะซ่อนโดยอัตโนมัติหากคุณไม่
autohide: false
ระบุ
ตัวอย่าง
ขั้นพื้นฐาน
เพื่อส่งเสริมการปิ้งขนมปังที่ขยายได้และคาดเดาได้ เราขอแนะนำส่วนหัวและส่วนเนื้อหา ส่วนหัวของ Toast ใช้display: flex
ช่วยให้จัดแนวเนื้อหาได้ง่ายด้วยยูทิลิตี้ margin และ flexbox ของเรา
ขนมปังปิ้งมีความยืดหยุ่นเท่าที่คุณต้องการและมีมาร์กอัปที่จำเป็นเพียงเล็กน้อย อย่างน้อยที่สุด เราต้องการองค์ประกอบเดียวเพื่อให้มีเนื้อหาที่ "ปิ้ง" ของคุณและสนับสนุนอย่างยิ่งให้กดปุ่มปิด
สวัสดีชาวโลก! นี่คือข้อความอวยพร
โปร่งแสง
ขนมปังปิ้งมีความโปร่งแสงเล็กน้อยเช่นกัน ดังนั้นพวกเขาจึงกลมกลืนกับสิ่งที่อาจปรากฏอยู่ สำหรับเบราว์เซอร์ที่สนับสนุนbackdrop-filter
คุณสมบัติ CSS เราจะพยายามเบลอองค์ประกอบภายใต้ข้อความแสดงข้อความ
สวัสดีชาวโลก! นี่คือข้อความอวยพร
ซ้อน
เมื่อคุณมีขนมปังปิ้งหลายแผ่น เราจะตั้งค่าเริ่มต้นให้เรียงซ้อนกันในแนวตั้งในลักษณะที่อ่านได้
ระวัง ขนมปังปิ้งจะซ้อนกันโดยอัตโนมัติ
ตำแหน่ง
วางขนมปังปิ้งด้วย CSS ที่กำหนดเองตามที่คุณต้องการ ด้านขวาบนมักใช้สำหรับการแจ้งเตือน เช่นเดียวกับด้านบนตรงกลาง หากคุณจะแสดงขนมปังปิ้งครั้งละหนึ่งรายการ ให้ใส่รูปแบบการวางตำแหน่งบนไฟล์.toast
.
สวัสดีชาวโลก! นี่คือข้อความอวยพร
สำหรับระบบที่สร้างการแจ้งเตือนเพิ่มเติม ให้พิจารณาใช้องค์ประกอบการตัดคำเพื่อให้สามารถสแต็คได้ง่าย
ระวัง ขนมปังปิ้งจะซ้อนกันโดยอัตโนมัติ
คุณยังสามารถใช้โปรแกรมอรรถประโยชน์ flexbox เพื่อจัดวางขนมปังปิ้งในแนวนอนและ/หรือแนวตั้งได้อีกด้วย
สวัสดีชาวโลก! นี่คือข้อความอวยพร
การเข้าถึง
ขนมปังปิ้งมีจุดประสงค์เพื่อรบกวนผู้เยี่ยมชมหรือผู้ใช้ของคุณเพียงเล็กน้อย ดังนั้นเพื่อช่วยเหลือผู้ที่มีโปรแกรมอ่านหน้าจอและเทคโนโลยีช่วยเหลือที่คล้ายคลึงกัน คุณควรห่อขนมปังปิ้งของคุณไว้ในaria-live
ภูมิภาค การเปลี่ยนแปลงไปยังภูมิภาคที่ใช้งานจริง (เช่น การฉีด/อัปเดตส่วนประกอบขนมปังปิ้ง) จะได้รับการประกาศโดยอัตโนมัติโดยโปรแกรมอ่านหน้าจอโดยไม่จำเป็นต้องย้ายโฟกัสของผู้ใช้หรือขัดจังหวะผู้ใช้ นอกจากนี้ ให้รวมaria-atomic="true"
เพื่อให้แน่ใจว่าขนมปังปิ้งทั้งหมดได้รับการประกาศเป็นหน่วยเดียว (อะตอม) เสมอ แทนที่จะประกาศสิ่งที่เปลี่ยนแปลง (ซึ่งอาจนำไปสู่ปัญหาหากคุณอัปเดตเนื้อหาของขนมปังเพียงบางส่วน หรือหากแสดงเนื้อหาขนมปังเดียวกันที่ ในเวลาต่อมา) หากข้อมูลที่จำเป็นมีความสำคัญต่อกระบวนการ เช่น รายการข้อผิดพลาดในแบบฟอร์ม ให้ใช้องค์ประกอบการแจ้งเตือนแทนขนมปังปิ้ง
โปรดทราบว่าต้องมีพื้นที่ถ่ายทอดสดในมาร์กอัปก่อนที่จะสร้างหรืออัปเดตขนมปัง หากคุณสร้างทั้งสองอย่างพร้อมกันแบบไดนามิกและแทรกลงในเพจ โดยทั่วไปแล้วเทคโนโลยีอำนวยความสะดวกจะไม่ประกาศเทคโนโลยีดังกล่าว
คุณต้องปรับrole
และaria-live
ระดับขึ้นอยู่กับเนื้อหา หากเป็นข้อความสำคัญ เช่น ข้อผิดพลาด ให้ใช้role="alert" aria-live="assertive"
มิฉะนั้น ใช้role="status" aria-live="polite"
แอตทริบิวต์
เนื่องจากเนื้อหาที่คุณกำลังแสดงเปลี่ยนแปลง โปรดอัปเดตdelay
ระยะหมดเวลาเพื่อให้แน่ใจว่าผู้คนมีเวลาเพียงพอในการอ่านขนมปังปิ้ง
เมื่อใช้autohide: false
คุณต้องเพิ่มปุ่มปิดเพื่อให้ผู้ใช้ปิดขนมปังปิ้งได้
สวัสดีชาวโลก! นี่คือข้อความอวยพร
พฤติกรรมจาวาสคริปต์
การใช้งาน
เริ่มต้นขนมปังปิ้งผ่าน JavaScript:
ตัวเลือก
ตัวเลือกสามารถส่งผ่านแอตทริบิวต์ข้อมูลหรือ JavaScript สำหรับแอ็ตทริบิวต์ data ให้ผนวกชื่ออ็อพชันต่อท้ายdata-
เช่นเดียวกับในdata-animation=""
.
ชื่อ |
พิมพ์ |
ค่าเริ่มต้น |
คำอธิบาย |
แอนิเมชั่น |
บูลีน |
จริง |
ใช้ CSS Fade Transition กับขนมปังปิ้ง |
ซ่อนอัตโนมัติ |
บูลีน |
จริง |
ซ่อนขนมปังอัตโนมัติ |
ล่าช้า |
ตัวเลข |
500 |
หน่วงเวลาซ่อนขนมปังปิ้ง (มิลลิวินาที) |
วิธีการ
วิธีการและการเปลี่ยนแบบอะซิงโครนัส
เมธอด API ทั้งหมดเป็นแบบอะซิงโครนัสและเริ่มต้นการเปลี่ยนแปลง พวกเขาจะกลับไปที่ผู้โทรทันทีที่เริ่มเปลี่ยน แต่ ก่อน ที่จะสิ้นสุด นอกจากนี้ การเรียกเมธอดบนคอมโพเนนต์การเปลี่ยนจะถูกละเว้น
ดูเอกสาร JavaScript ของเราสำหรับข้อมูลเพิ่มเติม
$().toast(options)
แนบตัวจัดการขนมปังปิ้งกับคอลเลกชันองค์ประกอบ
.toast('show')
เผยให้เห็นขนมปังปิ้งขององค์ประกอบ กลับไปยังผู้โทรก่อนที่จะแสดงขนมปังปิ้งจริง (กล่าวคือ ก่อนที่shown.bs.toast
เหตุการณ์จะเกิดขึ้น) คุณต้องเรียกวิธีนี้ด้วยตนเอง แทนขนมปังของคุณจะไม่แสดง
.toast('hide')
ซ่อนขนมปังปิ้งขององค์ประกอบ กลับไปยังผู้โทรก่อนที่ขนมปังปิ้งจะถูกซ่อนจริงๆ (กล่าวคือ ก่อนที่hidden.bs.toast
เหตุการณ์จะเกิดขึ้น) คุณต้องเรียกวิธีนี้ด้วยตนเองหากคุณautohide
ทำfalse
.toast('dispose')
ซ่อนขนมปังปิ้งขององค์ประกอบ ขนมปังปิ้งของคุณจะยังคงอยู่บน DOM แต่จะไม่แสดงอีกต่อไป
เหตุการณ์
ประเภทงาน |
คำอธิบาย |
show.bs.toast |
เหตุการณ์นี้จะเริ่มทำงานทันทีเมื่อมีshow การเรียกเมธอดของอินสแตนซ์ |
แสดง.bs.toast |
เหตุการณ์นี้เริ่มทำงานเมื่อผู้ใช้มองเห็นขนมปังปิ้ง |
hide.bs.toast |
เหตุการณ์นี้เริ่มทำงานทันทีเมื่อhide มีการเรียกเมธอดของอินสแตนซ์ |
hidden.bs.toast |
เหตุการณ์นี้เริ่มทำงานเมื่อขนมปังปิ้งถูกซ่อนจากผู้ใช้เสร็จแล้ว |