Поповерууд
Танай сайтын аль ч элементэд iOS-д байдаг шиг Bootstrap поповер нэмэх баримт бичиг, жишээнүүд.
Popover залгаасыг ашиглахдаа анхаарах зүйлс:
- Поповерууд байрлал тогтоохдоо гуравдагч талын Popper.js номын санд тулгуурладаг . Та bootstrap.js-н өмнө popper.min.js -г оруулах эсвэл поповер ажиллахын тулд Popper.js-г агуулсан
bootstrap.bundle.min.js
/ ашиглах ёстой!bootstrap.bundle.js
- Поповерууд нь хараат байдлаар tooltip залгаасыг шаарддаг.
- Хэрэв та манай JavaScript-г эх сурвалжаас бүтээж байгаа бол
util.js
. - Поповерууд нь гүйцэтгэлийн шалтгааны улмаас сонгогддог тул та өөрөө эхлүүлэх хэрэгтэй .
- Тэг урт
title
баcontent
утгууд нь поповыг хэзээ ч харуулахгүй. container: 'body'
Илүү төвөгтэй бүрэлдэхүүн хэсгүүдэд (манай оролтын бүлгүүд, товчлуурын бүлгүүд гэх мэт) асуудал гаргахгүйн тулд зааж өгнө үү .- Нууцлагдмал элементүүд дээр поповеруудыг өдөөх нь ажиллахгүй.
- Поповер
.disabled
эсвэлdisabled
элементүүдийг боодлын элемент дээр өдөөх ёстой. - Олон мөрөнд ороосон зангуунаас өдөөх үед поповерууд зангууны нийт өргөний хооронд төвлөрөх болно. Энэ зан үйлээс зайлсхийхийн тулд
white-space: nowrap;
өөрийн s дээр ашиглаарай .<a>
- DOM-аас харгалзах элементүүдийг устгахаас өмнө поповуудыг нуусан байх ёстой.
Зарим жишээн дээр поповерууд хэрхэн ажилладагийг харахын тулд үргэлжлүүлэн уншина уу.
Хуудас дээрх бүх поповыг эхлүүлэх нэг арга бол тэдгээрийг data-toggle
шинж чанараар нь сонгох явдал юм:
Хэрэв таны эх элемент дээр поповерт саад болох зарим загвар байгаа бол container
поповерын HTML нь тухайн элемент дотор харагдахын тулд өөрчлөн тохируулахыг хүсэх болно.
<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
Дөрвөн сонголт боломжтой: дээд, баруун, доод, зүүн зэрэгцүүлсэн.
focus
Хэрэглэгч сэлгэх элементээс өөр элемент дээр дараагийн товшилтоор поповеруудыг хаахын тулд гохыг ашиглана уу.
Дараагийн товшилтыг хаахад тусгай тэмдэглэгээ хийх шаардлагатай
Хөтөч хоорондын болон платформ хоорондын зөв ажиллахын тулд та шошгыг биш харин тагийг ашиглах ёстой <a>
бөгөөд мөн шинж <button>
чанарыг агуулсан байх ёстой tabindex
.
<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
Атрибуттай элементүүд нь disabled
интерактив биш тул хэрэглэгчид хулганаа аваачиж эсвэл товшиж popover (эсвэл хэрэгслийн зөвлөмж)-ийг идэвхжүүлэх боломжгүй гэсэн үг юм. Үүнийг шийдэхийн тулд та боодолоос поповыг өдөөх <div>
эсвэл идэвхгүй болсон элемент дээрхийг <span>
хүчингүй болгохыг хүсэх болно.pointer-events
Идэвхгүй болсон поповер триггерүүдийн хувьд та поповер нь идэвхгүй болсон элемент дээр дарнаdata-trigger="hover"
гэж бодохгүй байгаа тул хэрэглэгчдэд шууд харааны санал болгож харуулахыг илүүд үзэж болно.
<span class="d-inline-block" data-toggle="popover" data-content="Disabled popover">
<button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>
JavaScript-ээр поповеруудыг идэвхжүүлэх:
Сонголтуудыг өгөгдлийн шинж чанарууд эсвэл JavaScript-ээр дамжуулж болно. Өгөгдлийн шинж чанаруудын хувьд сонголтын нэрийг -д data-
хавсаргана data-animation=""
.
Нэр | Төрөл | Өгөгдмөл | Тодорхойлолт |
---|---|---|---|
хөдөлгөөнт дүрс | логик | үнэн | Popover руу CSS бүдгэрүүлэх шилжилтийг ашиглана уу |
сав | мөр | элемент | худлаа | худлаа | Тодорхой элементэд поповыг хавсаргана. Жишээ нь: |
агуулга | мөр | элемент | функц | '' |
Хэрэв функц өгөгдсөн бол түүнийг |
саатал | тоо | обьект | 0 | Поповерыг харуулах, нуух саатал (ms) - гарын авлагын гох төрөлд хамаарахгүй Хэрэв дугаар өгсөн бол нуух/шоулуулах хоёуланд нь саатал хэрэглэнэ Объектын бүтэц нь: |
html | логик | худлаа | Popover руу HTML оруулна уу. Хэрэв худал бол jQuery-ийн text аргыг DOM-д контент оруулахад ашиглана. Хэрэв та XSS халдлагын талаар санаа зовж байгаа бол текстийг ашиглана уу. |
байрлуулах | мөр | функц | 'зөв' | Поповерыг хэрхэн байрлуулах вэ - auto | дээд | доод | зүүн | зөв. Байршлыг тодорхойлоход функцийг ашиглах үед түүнийг эхний аргумент болгон popover DOM зангилаа, хоёр дахь нь DOM зангилаагаар дууддаг. Контекстийг поповын |
сонгогч | мөр | худлаа | худлаа | Хэрэв сонгогчийг өгсөн бол popover объектуудыг заасан зорилтууд руу шилжүүлнэ. Практикт энэ нь динамик HTML контентыг поповер нэмэхэд ашигладаг. Үүнийг болон мэдээллийн жишээг үзнэ үү . |
загвар | мөр | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
Popover үүсгэх үед ашиглах үндсэн HTML. Поповерыг . Поповерыг .
Хамгийн гадна талын боодлын элемент нь |
гарчиг | мөр | элемент | функц | '' |
Хэрэв функц өгөгдсөн бол түүнийг |
гох | мөр | 'товших' | Поповер хэрхэн идэвхждэг вэ - | дээр дарна уу хулганаа аваач | төвлөрөл | гарын авлага. Та олон өдөөгчийг дамжуулж болно; тэдгээрийг зайгаар тусгаарла. `гарын авлага`-г өөр ямар ч триггертэй нэгтгэх боломжгүй. |
офсет | тоо | мөр | 0 | Зорилтоттойгоо харьцуулахад поповын офсет. Дэлгэрэнгүй мэдээллийг Popper.js-ийн офсет баримтаас үзнэ үү . |
backbackPlacement | мөр | массив | 'эргэх' | Поппер буцах үед ямар байрлалыг ашиглахыг зааж өгөхийг зөвшөөр. Дэлгэрэнгүй мэдээллийг Popper.js-ийн зан үйлийн баримт бичгүүдээс үзнэ үү |
хил хязгаар | мөр | элемент | 'scrollParent' | Поповерын халих хязгаарлалтын хил. 'viewport' , 'window' , 'scrollParent' , эсвэл HTMLElement лавлагааны утгуудыг (зөвхөн JavaScript) хүлээн авна. Дэлгэрэнгүй мэдээллийг Popper.js-ийн preventOverflow баримтаас үзнэ үү . |
Хувь хүний поповеруудад зориулсан өгөгдлийн шинж чанарууд
Дээр тайлбарласны дагуу өгөгдлийн шинж чанаруудыг ашиглан хувь хүний поповеруудын сонголтыг зааж өгч болно.
Асинхрон аргууд ба шилжилтүүд
Бүх API аргууд асинхрон бөгөөд шилжилтийг эхлүүлнэ . Шилжилт эхэлмэгц дуусаагүй байхад тэд залгагч руу буцаж ирдэг . Нэмж хэлэхэд, шилжилтийн бүрэлдэхүүн хэсэг дэх аргын дуудлагыг үл тоомсорлох болно.
Элементийн цуглуулгад зориулсан поповеруудыг эхлүүлнэ.
Элементийн поповыг харуулна. Поповер харагдахаас өмнө (өөрөөр хэлбэл shown.bs.popover
үйл явдал болохоос өмнө) дуудагч руу буцна. Энэ нь поповыг "гараар" өдөөдөг гэж үздэг. Гарчиг болон агуулга нь 0 урттай поповеруудыг хэзээ ч харуулахгүй.
Элементийн поповыг нууна. Поповерыг нуухаас өмнө (өөрөөр хэлбэл hidden.bs.popover
үйл явдал болохоос өмнө) дуудагч руу буцна. Энэ нь поповыг "гараар" өдөөдөг гэж үздэг.
Элементийн поповыг асаадаг. Поповыг харуулах эсвэл нуухаас өмнө (өөрөөр хэлбэл үйл явдал болохоос өмнө) дуудагч руу буцна. Энэ нь поповыг "гараар" өдөөдөг гэж үздэг.shown.bs.popover
hidden.bs.popover
Элементийн поповыг нууж, устгана. Төлөөлөгчийг ашигладаг поповеруудыг ( сонголтыг ашиглан үүсгэсэнselector
) удамшлын триггер элементүүд дээр тус тусад нь устгах боломжгүй.
Элементийн поповыг харуулах боломжийг олгоно. Popovers нь анхдагчаар идэвхждэг.
Элементийн поповыг харуулах боломжийг арилгана. Дахин идэвхжүүлсэн тохиолдолд л поповыг харуулах боломжтой.
Элементийн поповыг харуулах эсвэл нуух боломжийг сэлгэдэг.
Элементийн поповерын байрлалыг шинэчилнэ.
Үйл явдлын төрөл | Тодорхойлолт |
---|---|
show.bs.popover | show Инстанцийн аргыг дуудах үед энэ үйл явдал шууд идэвхждэг . |
үзүүлсэн.bs.popover | Поповерыг хэрэглэгчдэд харагдуулах үед энэ үйл явдал идэвхждэг (CSS шилжилтийг дуусгахыг хүлээх болно). |
hide.bs.popover | hide Инстанцийн аргыг дуудсан үед энэ үйл явдал шууд идэвхждэг . |
hidden.bs.popover | Поповерыг хэрэглэгчээс нууж дууссаны дараа энэ үйл явдал идэвхждэг (CSS шилжилт дуусахыг хүлээх болно). |
оруулсан.bs.popover | show.bs.popover DOM-д поповын загварыг нэмсэн тохиолдолд энэ үйл явдал идэвхгүй болно . |