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 panagpannuray.
- No mangbangbangonka iti JavaScript-mi manipud iti gubuayan, kasapulanna ti
util.js
. - 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-toggle
attributeda:
$(function () {
$('[data-toggle="popover"]').popover()
})
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.
$(function () {
$('.example-popover').popover({
container: 'body'
})
})
Pagwadan
<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>
Uppat a direksion
Uppat a pagpilian ti magun-odan: ngato, kannawan, baba, ken kannigid a naitunos.
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="top" data-content="Top popover">
Popover on top
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="right" data-content="Right popover">
Popover on right
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Bottom popover">
Popover on bottom
</button>
<button type="button" class="btn btn-secondary" data-container="body" data-toggle="popover" data-placement="left" data-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-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>
$('.popover-dismiss').popover({
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>
ken i-override ti pointer-events
iti baldado nga elemento.
Para kadagiti baldado a popover a mangtignay, mabalinmo pay a kaykayat data-trigger="hover"
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" data-toggle="popover" data-content="Disabled popover">
<button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>
Panagusar
Pagbalinen dagiti popover babaen ti JavaScript:
$('#example').popover(options)
Panagpapartak ti GPU
Dagiti popovers ket no dadduma ket agparang a nalawag kadagiti Windows 10 nga alikamen gapu ti GPU a panagpapardas ken ti nabaliwan a sistema a DPI. Ti workaround para iti daytoy iti v4 ket ti panangbaldado ti GPU acceleration kas kasapulan kadagiti popovers mo.
Naisingasing a panangtarimaan:
Popper.Defaults.modifiers.computeStyle.gpuAcceleration = !(window.devicePixelRatio < 1.5 && /Win/.test(navigator.platform))
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 kadagiti whiteList
wenno 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-
, a kas iti data-animation=""
.
sanitize
,
sanitizeFn
ken
whiteList
dagiti pagpilian ket saan a maited babaen ti panagusar kadagiti kababalin ti datos.
Nagan | Tipo | Default | Panangiladawan |
---|---|---|---|
animasion nga | boolean nga | agpayso | Iyaplikar ti CSS fade transition iti popover |
pagkargaan | kuerdas nga | elemento nga | saan nga agpayso | saan nga agpayso | Inayon ti popover iti espesipiko nga elemento. Kas pagarigan: |
linaon | kuerdas nga | elemento nga | amad | '' . | Default a pateg ti linaon no No ti maysa a panagandar ket naited, daytoy ket maawaganto nga addaan ti |
itantan | numero | banag | 0 nga | 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 nga | boolean nga | saan nga agpayso | Ikabil ti HTML iti popover. No palso, ti text pamay-an ti jQuery ket mausarto a mangikabil ti linaon iti DOM. Usaren ti teksto no madanaganka kadagiti panangraut ti XSS. |
pannakaikabil | kuerdas nga | amad | 'kusto' | 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 |
agpili nga | kuerdas nga | saan nga agpayso | saan nga agpayso | 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 . |
plantilia nga | kuerdas | '<div class="popover" role="tooltip"><div class="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 |
titulo | kuerdas nga | elemento nga | amad | '' . | Default a pateg ti paulo no No ti maysa a panagandar ket naited, daytoy ket maawaganto nga addaan ti |
kalbiten | kuerdas | 'i-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. |
offset nga | numero | kuerdas | 0 nga | Offset ti popover relatibo iti puntiriana. Para iti ad-adu pay nga impormasion kitaen dagiti offset docs ni Popper . |
fallbackPanagplastar | kuerdas nga | array nga | 'ibaliktad' | Bay-an nga ikeddeng no ania a posision ti usaren ni Popper iti fallback. Para iti ad-adu pay nga impormasion kitaen dagiti dok ti kababalin ni Popper |
customKlase nga | 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. |
beddeng ti pagbeddengan | kuerdas nga | elemento | 'ag-scrollParent'. | Overflow constraint beddeng ti popover. Awaten dagiti pateg ti 'viewport' , 'window' , 'scrollParent' , wenno ti reperensia ti HTMLElement (JavaScript laeng). Para iti ad-adu pay nga impormasion kitaen dagiti dokumento ti preventOverflow ti Popper . |
sanitize nga aramiden | boolean nga | agpayso | 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 . |
puraw a Listaan | banag | Default nga pateg | Bagay a naglaon kadagiti maipalubos nga attribute ken tag |
sanitize ti Fn | null nga | amad | nawaswas | 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. |
popperKonfig | null nga | banag | nawaswas | Tapno baliwan ti default a Popper a konfigurasion ti Bootstrap, kitaen ti panagisaad ti 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.
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 .
$().popover(options)
Mangrugi kadagiti popovers para iti maysa a koleksion ti elemento.
.popover('show')
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.
$('#element').popover('show')
.popover('hide')
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.
$('#element').popover('hide')
.popover('toggle')
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.
$('#element').popover('toggle')
.popover('dispose')
Ilemmeng ken dadaelenna ti popover ti maysa nga elemento. 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.
$('#element').popover('dispose')
.popover('enable')
Mangted ti popover ti maysa nga elemento ti abilidad a maipakita. Dagiti popover ket napalubosan babaen ti default.
$('#element').popover('enable')
.popover('disable')
Ikkaten ti abilidad para iti popover ti maysa nga elemento a maipakita. Mabalin laeng a maipakita ti popover no ma-enable manen.
$('#element').popover('disable')
.popover('toggleEnabled')
I-toggles ti abilidad para iti popover ti maysa nga elemento a maipakita wenno mailemmeng.
$('#element').popover('toggleEnabled')
.popover('update')
Ipabaro ti posision ti popover ti maysa nga elemento.
$('#element').popover('update')
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 | Daytoy a pasamak ket mapaputok no ti popover ket naaramiden a makita ti agar-aramat (urayennanto dagiti panagbalbaliw ti CSS a malpas). |
ilemmeng.bs.popover | Daytoy a pasamak ket dagus a mapaputok no ti hide pamay-an ti pagarigan ket naawagan. |
nailemmeng.bs.napanglaw | Daytoy a pasamak ket mapaputok no ti popover ket nalpas a nailemmeng manipud iti agar-aramat (urayenna dagiti panagbalbaliw ti CSS a malpas). |
naikabil.bs.popover | Daytoy a pasamak ket mapaputok kalpasan ti show.bs.popover pasamak no ti plantilia ti popover ket nainayon iti DOM. |
$('#myPopover').on('hidden.bs.popover', function () {
// do something...
})