Dagiti Popovers
Dokumentasion ken dagiti pagarigan para iti pananginayon kadagiti Bootstrap popovers, kas kadagidiay masarakan iti iOS, iti ania man nga elemento iti site-mo.
Panangkita iti pakabuklan
Dagiti banag nga ammuen no agusar ti popover plugin:
- Agpannuray dagiti Popovers iti 3rd party library Popper para iti panagposision. Masapul nga iramanmo ti popper.min.js sakbay ti bootstrap.js wenno usarem ti
bootstrap.bundle.min.js
/bootstrap.bundle.js
a naglaon iti Popper tapno agtrabaho dagiti popovers! - Dagiti Popovers ket agkasapulan ti tooltip plugin a kas maysa a panagpanpanunot.
- Dagiti popovers ket opt-in para kadagiti rason ti panagaramid, isu a masapul nga irugim a mismo dagitoy .
- Zero-length
title
kencontent
values ket pulos a di mangipakita iti popover. - Ibaga
container: 'body'
tapno maliklikan dagiti parikut ti panagiparang kadagiti ad-adu a komplikado a paset (kas dagiti grupo ti panagserrektayo, dagiti grupo ti buton, kdpy). - Saan nga agtrabaho ti panangtignay kadagiti popover kadagiti nailemmeng nga elemento.
- Dagiti popovers para
.disabled
wennodisabled
dagiti elemento ket masapul a mai-trigger iti maysa nga elemento ti balkot. - No mai-trigger manipud kadagiti angkla a mangbalkot iti adu a linia, dagiti popover ket maisentro iti nagbaetan ti pakabuklan a kalawa dagiti angkla. Usaren
.text-nowrap
ti<a>
s-mo tapno maliklikan daytoy a kababalin. - Masapul a mailemmeng dagiti popovers sakbay a maikkat dagiti katupagda nga elemento manipud iti DOM.
- Mabalin a mai-trigger dagiti popovers gapu iti elemento iti uneg ti shadow DOM.
prefers-reduced-motion
panagsaludsod ti media. Kitaen ti
benneg ti naikkat a panaggunay ti dokumentasionmi ti pannakagun-od .
Itultuloymo ti agbasa tapno makitam no kasano nga agtrabaho dagiti popover babaen ti sumagmamano a pagarigan.
Pagarigan: Pagbalinen dagiti popovers iti sadinoman
Ti maysa a wagas a mangirugi kadagiti amin a popover iti maysa a panid ket isu koma ti panangpili kadagitoy babaen ti data-bs-toggle
attributeda:
var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'))
var popoverList = popoverTriggerList.map(function (popoverTriggerEl) {
return new bootstrap.Popover(popoverTriggerEl)
})
Pagarigan: Panangusar iti container
pagpilian
No addaanka kadagiti sumagmamano nga estilo iti nagannak nga elemento a mangsinga iti popover, kayatmo nga ikeddeng ti maysa a kostumbre container
tapno ti HTML ti popover ket agparang ketdi iti uneg dayta nga elemento.
var popover = new bootstrap.Popover(document.querySelector('.example-popover'), {
container: 'body'
})
Pagwadan
<button type="button" class="btn btn-lg btn-danger" data-bs-toggle="popover" title="Popover title" data-bs-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
Uppat a direksion
Uppat a pagpilian ti magun-odan: ngato, kannawan, baba, ken kannigid a naitunos. Dagiti direksion ket maisarming no agus-usar ti Bootstrap iti RTL.
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="top" data-bs-content="Top popover">
Popover on top
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="right" data-bs-content="Right popover">
Popover on right
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="bottom" data-bs-content="Bottom popover">
Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-container="body" data-bs-toggle="popover" data-bs-placement="left" data-bs-content="Left popover">
Popover on left
</button>
Dismiss iti sumaruno nga i-click
Usaren ti focus
gatilio tapno mailaksid dagiti popover iti sumaganad a panagpidut ti agar-aramat iti sabali nga elemento ngem ti elemento ti panagbalbaliw.
Espesipiko a panagmarka ti kasapulan para iti dismiss-on-next-click
Para iti umno a kababalin ti krus-browser ken krus-plataporma, masapul nga usarem ti <a>
etiketa, saan a ti <button>
etiketa, ken masapul met nga iramanmo ti maysa a tabindex
kababalin.
<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-bs-toggle="popover" data-bs-trigger="focus" title="Dismissible popover" data-bs-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
var popover = new bootstrap.Popover(document.querySelector('.popover-dismiss'), {
trigger: 'focus'
})
Dagiti baldado nga elemento
Dagiti elemento nga addaan iti disabled
attribute ket saan nga interaktibo, kayatna a sawen a dagiti agar-aramat ket dida mabalin ti ag-hover wenno ag-klik kadagitoy tapno mangtignay ti popover (wenno tooltip). Kas maysa a panagliklik, kayatmo a mangtignay ti popover manipud iti maysa a wrapper <div>
wenno <span>
, nasayaat a naaramid a teklado-a-maipamaysa babaen ti panagusar ti tabindex="0"
.
Para kadagiti baldado a popover a mangtignay, mabalinmo pay a kaykayat data-bs-trigger="hover focus"
tapno ti popover ket agparang a kas ti dagus a biswal a sungbat kadagiti agar-aramatmo a kas mabalin a dida namnamaen a mangi -klik iti maysa a baldado nga elemento.
<span class="d-inline-block" tabindex="0" data-bs-toggle="popover" data-bs-trigger="hover focus" data-bs-content="Disabled popover">
<button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>
Sass nga
Dagiti Variable
$popover-font-size: $font-size-sm;
$popover-bg: $white;
$popover-max-width: 276px;
$popover-border-width: $border-width;
$popover-border-color: rgba($black, .2);
$popover-border-radius: $border-radius-lg;
$popover-inner-border-radius: subtract($popover-border-radius, $popover-border-width);
$popover-box-shadow: $box-shadow;
$popover-header-bg: shade-color($popover-bg, 6%);
$popover-header-color: $headings-color;
$popover-header-padding-y: .5rem;
$popover-header-padding-x: $spacer;
$popover-body-color: $body-color;
$popover-body-padding-y: $spacer;
$popover-body-padding-x: $spacer;
$popover-arrow-width: 1rem;
$popover-arrow-height: .5rem;
$popover-arrow-color: $popover-bg;
$popover-arrow-outer-color: fade-in($popover-border-color, .05);
Panagusar
Pagbalinen dagiti popover babaen ti JavaScript:
var exampleEl = document.getElementById('example')
var popover = new bootstrap.Popover(exampleEl, options)
Ti panangaramid kadagiti popover nga agtrabaho para kadagiti agus-usar iti keyboard ken assistive technology
Tapno mapalubosan dagiti agar-aramat ti teklado a mangpaaktibo kadagiti popover-mo, rumbeng laeng nga inayonmo dagitoy kadagiti elemento ti HTML a tradisional a maipamaysa iti teklado ken interaktibo (kas dagiti silpo wenno dagiti kontrol ti porma). Urayno dagiti arbitrario nga elemento ti HTML (kas ti <span>
s) ket mabalin a maaramid a maipamaysa babaen ti pananginayon ti tabindex="0"
attribute, daytoy ket manginayon kadagiti mabalin a makarimon ken makariro a panagsardeng ti tab kadagiti saan nga interaktibo nga elemento para kadagiti agar-aramat ti teklado, ken kaaduan kadagiti makatulong a teknolohia ket agdama a dida ipakaammo ti linaon ti popover iti daytoy a kasasaad . Mainayon pay, dika agpannuray laeng a hover
kas ti mangtignay kadagiti popover-mo, ta daytoy ket mangaramidto kadakuada nga imposible a mangtignay para kadagiti agar-aramat ti teklado.
Bayat a mabalinmo nga ikabil ti nabaknang, naistruktura nga HTML kadagiti popover nga addaan iti html
pagpilian, irekomendarmi unay a liklikam ti pananginayon iti nalabes a kaadu ti linaon. Ti wagas ti agdama nga agtrabaho dagiti popover ket, apaman a maiparang, ti linaonda ket naisilpo iti elemento ti mangtignay nga addaan ti aria-describedby
attribute. Kas resultana, maipakaammo ti intero a linaon ti popover kadagiti agus-usar iti makatulong a teknolohia kas maysa nga atiddog, di nasinga nga ayus.
Iti pay maipatinayon, bayat a mabalin pay nga iraman dagiti interaktibo a kontrol (kas dagiti elemento ti porma wenno dagiti silpo) iti popover-mo (babaen ti pananginayon kadagitoy nga elemento iti allowList
dagiti maipalubos a kababalin ken dagiti etiketa), ammom nga iti agdama ti popover ket saan a mangiturturay ti urnos ti pokus ti teklado. No ti maysa nga agar-aramat ti teklado ket manglukat ti popover, ti pokus ket agtalinaed iti mangtignay nga elemento, ken kas ti popover ket kadawyan a saan a dagus a sumurot ti mangtignay iti estruktura ti dokumento, awan ti garantia nga umabante/panagprentaTABiyakarna ti maysa nga agus-usar iti teklado iti popover a mismo. Iti ababa a pannao, ti laeng pananginayon kadagiti interaktibo a kontrol iti maysa a popover ket mabalin a mangaramid kadagitoy a kontrol a saan a madanon/saan a mausar para kadagiti agar-aramat ti teklado ken dagiti agar-aramat kadagiti makatulong a teknolohia, wenno iti kabassitan ket mangaramid para iti saan a lohikal a sapasap a panagurnos ti pokus. Kadagitoy a kaso, ibilang ti panagusar ti modal a dialogo imbes a.
Dagiti Pagpilian
Dagiti pagpilian ket mabalin a maipasa babaen dagiti attribute ti datos wenno JavaScript. Para kadagiti kababalin ti datos, inayon ti nagan ti pagpilian iti data-bs-
, a kas iti data-bs-animation=""
. Siguraduen a baliwan ti kita ti kaso ti nagan ti pagpilian manipud iti camelCase iti kebab-case no ipasa dagiti pagpilian babaen dagiti attribute ti datos. Kas pagarigan, imbes nga usarem ti data-bs-customClass="beautifier"
, usarem ti data-bs-custom-class="beautifier"
.
sanitize
,
sanitizeFn
, ken
allowList
dagiti pagpilian ket saan a maited babaen ti panagusar kadagiti kababalin ti datos.
Nagan | Tipo | Default | Panangiladawan |
---|---|---|---|
animation |
boolean nga | true |
Iyaplikar ti CSS fade transition iti popover |
container |
kuerdas nga | elemento nga | saan nga agpayso | false |
Inayon ti popover iti espesipiko nga elemento. Kas pagarigan: |
content |
kuerdas nga | elemento nga | amad | '' |
Default a pateg ti linaon no No ti maysa a panagandar ket naited, daytoy ket maawaganto nga addaan ti |
delay |
numero | banag | 0 |
Ti panangitantan ti panangipakita ken panangilemmeng ti popover (ms) - saan nga agaplikar iti manual a kita ti trigger No naited ti numero, maipakat ti delay agpadpada iti hide/show Ti estruktura ti banag ket: |
html |
boolean nga | false |
Ikabil ti HTML iti popover. No palso, innerText ti sanikua ket mausarto a mangikabil ti linaon iti DOM. Usaren ti teksto no madanaganka kadagiti panangraut ti XSS. |
placement |
kuerdas nga | amad | 'right' |
Kasano nga iposision ti popover - auto | ngato | baba | kanigid | kusto. No ti maysa a panagandar ket maus-usar a mangikeddeng ti pannakaikabil, daytoy ket maawagan nga addaan ti popover DOM a nodo a kas ti umuna nga argumentona ken ti mangtignay nga elemento a DOM a nodo a kas ti maikadua. Ti |
selector |
kuerdas nga | saan nga agpayso | false |
No ti maysa a mangpili ket naited, dagiti banag ti popover ket maitedto kadagiti naikeddeng a puntiria. Iti praktis, daytoy ket maus-usar tapno mapalubosan ti dinamiko a linaon ti HTML nga addaan kadagiti popover a nainayon. Kitaen daytoy ken ti makaisuro a pagarigan . |
template |
kuerdas | '<div class="popover" role="tooltip"><div class="popover-arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
Base ti HTML nga usaren no mangpartuat ti popover. Ti popover's Ti popover's
Ti makinruar unay nga elemento ti balkot ket rumbeng nga addaan iti |
title |
kuerdas nga | elemento nga | amad | '' |
Default a pateg ti paulo no No ti maysa a panagandar ket naited, daytoy ket maawaganto nga addaan ti |
trigger |
kuerdas | 'click' |
Kasano a mai-trigger ti popover - i-click ti | ag-hover nga | pokus | giya. Mabalin a lumasatka iti adu a trigger; pagsinaen ida babaen ti maysa nga espasio. manual saan a mabalin a maitipon iti aniaman a sabali a trigger. |
fallbackPlacements |
array nga | ['top', 'right', 'bottom', 'left'] |
Depinaren dagiti fallback a pannakaikabil babaen ti panangipaay ti listaan dagiti pannakaikabil iti array (iti panagsasaruno ti kaykayat). Para iti ad-adu pay nga impormasion kitaen dagiti dok ti kababalin ni Popper |
boundary |
kuerdas nga | elemento | 'clippingParents' |
Beddeng ti limitasion ti panaglablabes ti popover (agaplikar laeng iti preventOverflow a mangbalbaliw ti Popper). Babaen ti default daytoy 'clippingParents' ket mabalin nga umawat ti reperensia ti HTMLElement (babaen laeng ti JavaScript). Para iti ad-adu pay nga impormasion kitaen dagiti dokumento ti detectOverflow ni Popper . |
customClass |
kuerdas nga | amad | '' |
Inayon dagiti klase iti popover no maipakita dayta. Imutektekanyo a dagitoy a klase ket mainayonto a mainayon kadagiti ania man a klase a naikeddeng iti plantilia. Tapno mainayon ti adu a klase, pagsinaen dagitoy babaen kadagiti espasyo: Mabalinmo pay nga ipasa ti maysa a panagandar a rumbeng nga agsubli ti maymaysa a kuerdas a naglaon kadagiti kanayonan a nagan ti klase. |
sanitize |
boolean nga | true |
Pagbalinen wenno balbaliwan ti sanitization. No activated 'template' , 'content' ken 'title' dagiti pagpilian ket ma-sanitize. Kitaen ti benneg ti sanitizer iti dokumentasionmi iti JavaScript . |
allowList |
banag | Default nga pateg | Bagay a naglaon kadagiti maipalubos nga attribute ken tag |
sanitizeFn |
null nga | amad | null |
Ditoy a mabalinmo nga i-supply ti bukodmo a sanitize function. Mabalin a makatulong daytoy no kaykayatmo ti agusar iti naisangsangayan a libraria tapno maaramid ti sanitization. |
offset |
array nga | kuerdas nga | amad | [0, 8] |
Offset ti popover relatibo iti puntiriana. Mabalinmo nga ipasa ti maysa a kuerdas kadagiti kababalin ti datos nga addaan kadagiti pateg a naisina babaen ti koma a kas ti: No ti maysa a panagandar ket maus-usar a mangikeddeng ti offset, daytoy ket maawagan babaen ti maysa a banag a naglaon ti pannakaikabil ti popper, ti reperensia, ken dagiti popper rects a kas ti umuna nga argumentona. Ti mangtignay nga elemento a DOM a nodo ket maipasa a kas ti maikadua nga argumento. Ti function ket masapul nga agsubli ti maysa nga array nga addaan iti dua a numero: . Para iti ad-adu pay nga impormasion kitaen dagiti offset docs ni Popper . |
popperConfig |
null nga | banag | amad | null |
Tapno baliwan ti default a Popper a konfigurasion ti Bootstrap, kitaen ti panagisaad ti Popper . No ti maysa a panagandar ket maus-usar a mangpartuat ti panagisaad ti Popper, daytoy ket maawagan babaen ti maysa a banag a naglaon ti kasisigud a panagisaad ti Popper ti Bootstrap. Tulongannaka nga agusar ken mangitipon ti default iti bukodmo a panagisaad. Ti panagandar ket masapul nga isublina ti maysa a banag ti panagisaad para iti Popper. |
Dagiti attribute ti datos para kadagiti indibidual a popovers
Dagiti pagpilian para kadagiti indibidual a popover ket mabalin nga alternatibo a maikeddeng babaen ti panagusar kadagiti kababalin ti datos, a kas naipalawag iti ngato.
Usar ti function nga addaanpopperConfig
var popover = new bootstrap.Popover(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
Dagiti Pamay-an
Dagiti asynchronous a pamay-an ken panagbalbaliw
Amin a pamay-an ti API ket asynchronous ken mangrugi ti panagbalbaliw . Agsublida iti tumawag apaman a mairugi ti panagbalbaliw ngem sakbay nga agpatingga . Iti pay maipatinayon, ti maysa nga awag ti pamay-an iti maysa a panagbalbaliw a paset ket mailaksidto .
Kitaen ti dokumentasionmi iti JavaScript para iti ad-adu pay nga impormasion .
ipakita
Ipalgakna ti popover ti maysa nga elemento. Agsubli iti tumawag sakbay nga aktual a naipakita ti popover (kayatna a sawen sakbay a shown.bs.popover
mapasamak ti pasamak). Maibilang daytoy a “manual” a panangtignay iti popover. Dagiti popover a ti paulo ken linaonda ket agpada a zero-length ket saan a pulos a maiparang.
myPopover.show()
aglemmeng
Ilemmengna ti popover ti maysa nga elemento. Agsubli iti tumawag sakbay nga aktual a nailemmeng ti popover (kayatna a sawen sakbay a hidden.bs.popover
mapasamak ti pasamak). Maibilang daytoy a “manual” a panangtignay iti popover.
myPopover.hide()
ag-toggle nga
I-toggles ti popover ti maysa nga elemento. Agsubli iti tumawag sakbay nga aktual a naipakita wenno nailemmeng ti popover (kayatna a sawen sakbay a mapasamak ti shown.bs.popover
wenno hidden.bs.popover
pasamak). Maibilang daytoy a “manual” a panangtignay iti popover.
myPopover.toggle()
ibelleng
Ilemmeng ken dadaelen ti popover ti maysa nga elemento (Ikkaten ti naidulin a datos iti elemento ti DOM). Dagiti popover nga agus-usar ti delegasion (a naparsua babaen ti panagusar ti selector
pagpilian ) ket saan a mabalin a saggaysa a madadael kadagiti kaputotan a mangtignay nga elemento.
myPopover.dispose()
pagbalinen
Mangted ti popover ti maysa nga elemento ti abilidad a maipakita. Dagiti popover ket napalubosan babaen ti default.
myPopover.enable()
awan ti kabaelan
Ikkaten ti abilidad para iti popover ti maysa nga elemento a maipakita. Mabalin laeng a maipakita ti popover no ma-enable manen.
myPopover.disable()
toggleNaipalubosan
I-toggles ti abilidad para iti popover ti maysa nga elemento a maipakita wenno mailemmeng.
myPopover.toggleEnabled()
pabaroen
Ipabaro ti posision ti popover ti maysa nga elemento.
myPopover.update()
makaala tiInstansia
Estatiko a pamay-an a mangipalubos kenka a makaala ti popover a pagarigan a nainaig iti maysa nga elemento ti DOM
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
makaalaWennoAgaramid itiInstansia
Estatiko a pamay-an a mangipalubos kenka a makaala ti popover a pagarigan a nainaig iti maysa nga elemento ti DOM, wenno mangpartuat ti baro no kas pagarigan saan a nairugi
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
Dagiti Pasamak
Kita ti pasamak | Panangiladawan |
---|---|
ipakita.bs.popover | Daytoy a pasamak ket agputok a dagus no ti show pamay-an ti pagarigan ket maawagan. |
naipakita.bs.popover | This event is fired when the popover has been made visible to the user (will wait for CSS transitions to complete). |
hide.bs.popover | This event is fired immediately when the hide instance method has been called. |
hidden.bs.popover | This event is fired when the popover has finished being hidden from the user (will wait for CSS transitions to complete). |
inserted.bs.popover | This event is fired after the show.bs.popover event when the popover template has been added to the DOM. |
var myPopoverTrigger = document.getElementById('myPopover')
myPopoverTrigger.addEventListener('hidden.bs.popover', function () {
// do something...
})