Dipopovers
Ditokomane le mehlala ya go oketša di-popover tša Bootstrap, go swana le tšeo di hwetšwago go iOS, go elemente efe goba efe mo saeteng ya gago.
Kakaretšo
Dilo tšeo o swanetšego go di tseba ge o diriša plugin ya popover:
- Popovers itšetlehile ka 3rd mokga bokgobapuku Popper bakeng sa positioning. O swanetše go akaretša popper.min.js pele ga bootstrap.js goba o šomiše
bootstrap.bundle.min.js
/bootstrap.bundle.js
yeo e nago le Popper gore di-popovers di šome! - Popovers hloka tooltip plugin e le itšetlehile.
- Popovers ke opt-in ka mabaka a tshebetso, kahoo o lokela ho initialize bona ka bowena .
- Zero-bolelele
title
lecontent
boleng ba ke ke ba bontša popover. - Laetša
container: 'body'
go efoga mathata a go tšweletša ka dikarolo tše di raraganego kudu (go swana le dihlopha tša rena tša go tsenya, dihlopha tša dikonope, bj.bj.). - Go hlohleletša di-popovers go dielemente tše di utilwego go ka se šome.
- Dipopo tša
.disabled
gobadisabled
dielemente di swanetše go hlohleletša godimo ga elemente ya go phuthela. - Ge di hlohleletšwa go tšwa go ditshetledi tšeo di phuthelago go putla mela e mentši, di-popover di tla tsepama magareng ga bophara bja kakaretšo bja ditshetledi. Diriša
.text-nowrap
go s ya gago<a>
go efoga boitshwaro bjo. - Dipopovers di swanetše go utilwe pele ga ge dielemente tša tšona tše di swanetšego di tlošitšwe go tšwa go DOM.
- Popovers ka hlohleletšwa ka lebaka la elemente ka gare ga DOM ya moriti.
prefers-reduced-motion
potšišo ya methopo ya ditaba. Bona
karolo ya tšhišinyego ye e fokoditšwego ya ditokomane tša rena tša phihlelelo .
Tšwela pele o bala go bona kamoo di-popover di šomago ka gona ka mehlala e mengwe.
Mohlala: Kgontšha di-popovers gohle
Tsela e nngwe ya go thoma di-popover ka moka letlakaleng e be e tla ba go di kgetha ka data-bs-toggle
seka sa tšona:
var popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]'))
var popoverList = popoverTriggerList.map(function (popoverTriggerEl) {
return new bootstrap.Popover(popoverTriggerEl)
})
Mohlala: Go šomiša container
kgetho
Ge o na le ditaele tše dingwe go elemente ya motswadi tšeo di šitišago popover, o tla nyaka go laetša tlwaelo container
gore HTML ya popover e tšwelele ka gare ga elemente yeo go e na le moo.
var popover = new bootstrap.Popover(document.querySelector('.example-popover'), {
container: 'body'
})
Mohlala
<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>
Ditaelo tše nne
Dikgetho tše nne di a hwetšagala: di logagantšwe ka godimo, ka go le letona, ka tlase le ka go le letshadi. Ditaelo di bonagatšwa ge o diriša Bootstrap ka go 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>
Raka ka tobetsa e latelang
Šomiša focus
sešušumeletši go lahla di-popover go klika ye e latelago ya mosediriši ya elemente ye e fapanego go feta elemente ya go fetoša.
Go nyakega go swaya mo go itšego bakeng sa go raka-go-klika-go-kgotla-kgotla-kgotla-kgotla-le-kgotla-le-kgotla-kgotla-kgotla-kgotla-kgotla-kgotla-kgotla
Bakeng sa boitshwaro bjo bo swanetšego bja sefapano sa sephephediši le sefapano sa sefala, o swanetše go šomiša <a>
leswao, e sego<button>
leswao, gomme gape o swanetše go akaretša tabindex
seka.
<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'
})
Dielemente tše di golofetšego
Dielemente tše di nago le disabled
seka ga di na tirišano, go ra gore badiriši ba ka se kgone go hover goba go di klika go hlohleletša popover (goba tooltip). Bjalo ka tharollo, o tla nyaka go hlohleletša popover go tšwa go sephuthedi <div>
goba <span>
, ka mo go swanetšego e dirilwe e le yeo e tsepeletšego go khiiboto ka go diriša tabindex="0"
.
Bakeng sa dihlohleletši tša popover tše di golofetšego, o ka rata gape data-bs-trigger="hover focus"
gore popover e tšwelele bjalo ka ditshwaotshwao tša pono tša ka pela go badiriši ba gago ka ge ba ka no se letele go kgotla elemente ye e golofetšego.
<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
Diphetogo
$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);
Tšhomišo
Kgontšha di-popover ka JavaScript:
var exampleEl = document.getElementById('example')
var popover = new bootstrap.Popover(exampleEl, options)
Go dira gore dipopovers di šome go badiriši ba khiiboto le theknolotši ya go thuša
Go dumelela badiriši ba khiiboto go tsenya tirišong dipopover tša gago, o swanetše go di oketša fela go dielemente tša HTML tšeo ka setšo di lebanego le khiiboto le go dirišana (go swana le dikgokagano goba ditaolo tša foromo). Le ge e le gore dielemente tša HTML tša boithatelo (tše bjalo ka <span>
s) di ka dirwa gore di tsepamiše kgopolo ka go oketša tabindex="0"
seka, se se tla oketša go ema ga dithepo tšeo di ka bago tše di tenago le tše di gakantšhago go dielemente tšeo e sego tša tirišano bakeng sa badiriši ba khiiboto, gomme bontši bja theknolotši ya go thuša ga bjale ga e tsebiše diteng tša popover boemong bjo . Go tlaleletša, o se ke wa ithekga feela ka hover
bjalo ka selo seo se hlohleletšago di-popover tša gago, ka ge se se tla dira gore di se kgonege go di hlohleletša bakeng sa badiriši ba khiiboto.
Le ge o ka tsenya HTML ye e humilego, ye e rulagantšwego ka go dipopover ka html
kgetho, re kgothaletša ka maatla gore o efoge go oketša palo ye e feteletšego ya diteng. Tsela yeo di-popover di šomago ka yona gabjale ke gore, ge di šetše di bontšhitšwe, diteng tša tšona di tlemilwe go elemente ya go hlohleletša ka aria-describedby
seka. Ka lebaka leo, dikagare ka moka tša popover di tla tsebišwa go badiriši ba theknolotši ya go thuša bjalo ka moela o tee wo motelele, wo o sa šitišwego.
Go tlaleletša, le ge go kgonega go akaretša gape le ditaolo tša tirišano (bjalo ka dielemente tša foromo goba dikgokagano) ka go popover ya gago (ka go oketša dielemente tše go ya allowList
ya dika tše di dumeletšwego le dithepo), ela hloko gore ga bjale popover ga e laole tatelano ya go tsepamiša kgopolo ya khiiboto. Ge modiriši wa khiiboto a bula popover, go tsepamiša kgopolo go dula go elemente yeo e hlohleletšago, gomme ka ge popover gantši e sa latele sešušumetšo ka pela ka sebopegong sa tokomane, ga go na tiišetšo ya gore go tšwela pele/go tobetšaTABe tla šuthiša mosebedisi wa khiiboto ka gare ga popover ka boyona. Ka boripana, go fo oketša ditaolo tša tirišano go popover go na le kgonagalo ya go dira gore ditaolo tše di se fihlelelege/di se šomišwe go badiriši ba khiiboto le badiriši ba theknolotši ya go thuša, goba bonyenyane go dira gore go be le taelo ya go tsepamiša kgopolo ka kakaretšo yeo e sa kwagalego. Maemong a, nagana ka go šomiša poledišano ya modal go e na le moo.
Dikgetho
Dikgetho di ka fetišwa ka dika tša datha goba JavaScript. Bakeng sa dika tša datha, tlaleletša leina la kgetho go data-bs-
, bjalo ka go data-bs-animation=""
. Kgonthiša gore o fetoša mohuta wa molato wa leina la kgetho go tšwa go camelCase go ya go kebab-case ge o fetiša dikgetho ka dika tša datha. Ka mohlala, go e na le go diriša data-bs-customClass="beautifier"
, diriša data-bs-custom-class="beautifier"
.
sanitize
,
sanitizeFn
, le
allowList
di ka se fiwe ka go šomiša dika tša datha.
Leina | Mohuta | Hlokomologa | Tlhalošo |
---|---|---|---|
animation |
boolean ya go swana | true |
Diriša phetogo ya go fifala ya CSS go popover |
container |
thapo ya | elemente | maaka | false |
E tlaleletša popover go elemente ye e itšego. Mohlala: |
content |
thapo ya | elemente | mošomo | '' |
Boleng bja diteng bja maitirelo ge e Ge mošomo o filwe, o tla bitšwa ka |
delay |
nomoro ya | selo | 0 |
Tiego ya go bontšha le go uta popover (ms) - ga e šome go mohuta wa go hlohleletša ka seatla Ge e le gore nomoro e filwe, go diega go dirišwa go bobedi go uta/bontšha Sebopego sa selo ke: |
html |
boolean ya go swana | false |
Tsenya HTML ka gare ga popover. Ge e le maaka, innerText thepa e tla šomišwa go tsenya diteng ka gare ga DOM. Diriša sengwalwa ge e ba o tshwenyegile ka ditlhaselo tša XSS. |
placement |
thapo ya | mošomo | 'right' |
Tsela ya go bea popover - auto | godimo | tlase | le letšehali | nepagetše. Ge mošomo o šomišwa go bona go bewa, o bitšwa ka noutu ya DOM ya popover bjalo ka ngangišano ya yona ya mathomo le noutu ya DOM ya elemente ye e hlohleletšago bjalo ka noutu ya yona ya bobedi. Seemo |
selector |
thapo ya | maaka | false |
Ge e le gore mokgethi o filwe, dilo tša popover di tla abelwa diphetho tše di laeditšwego. Ka go diragatša, se se šomišwa go kgontšha diteng tša HTML tše di fetogago go ba le dipopovers tše di okeditšwego. Bona se le mohlala o rutago . |
template |
thapo | '<div class="popover" role="tooltip"><div class="popover-arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
Thea HTML go šomiša ge o hlama popover. Popover's e Popover's e
The ka ntle ka ho fetisisa wrapper elements lokela ho ba le |
title |
thapo ya | elemente | mošomo | '' |
Boleng bja thaetlele bja maitirelo ge e Ge mošomo o filwe, o tla bitšwa ka |
trigger |
thapo | 'click' |
Kamoo popover e hlohleletšwago ka gona - tobetsa | hover | go tsepamiša kgopolo | manyuale. O ka feta dihlohleletši tše dintši; di aroganye ka sekgoba. manual e ka se kopanywe le selo le ge e le sefe se sengwe seo se hlohleletšago. |
fallbackPlacements |
hlophisitsoeng | ['top', 'right', 'bottom', 'left'] |
Hlaloša dipeelo tša go wa morago ka go fa lenaneo la dipeelo ka lenaneong (ka tatelano ya kgetho). Bakeng sa tshedimošo ye ntši lebelela ditokomane tša boitshwaro tša Popper |
boundary |
thapo ya | ntlha | 'clippingParents' |
Mollwane wa thibelo ya go tlala wa popover (o šoma fela go sefetoši sa preventOverflow sa Popper). Ka go ikemela ke 'clippingParents' gomme e ka amogela tšhupetšo ya HTMLElement (ka JavaScript fela). Bakeng sa tshedimošo ye ntši lebelela ditokomane tša detectOverflow tša Popper . |
customClass |
thapo ya | mošomo | '' |
Oketša diklase go popover ge e bontšhwa. Hlokomela gore diklase tše di tla okeletšwa go tlaleletša go diklase dife goba dife tše di laeditšwego ka go thempleite. Go oketša diklase tše dintši, di aroganye ka dikgoba: O ka fetiša gape mošomo wo o swanetšego go bušetša thapo e tee yeo e nago le maina a tlaleletšo a dihlopha. |
sanitize |
boolean ya go swana | true |
Kgontšha goba go šitiša go hlwekiša. If activated 'template' , 'content' le 'title' dikgetho tla sanitized. Bona karolo ya sanitizer go ditokomane tša rena tša JavaScript . |
allowList |
selo | Boleng bja go se fetoge | Selo seo se nago le dika tše di dumeletšwego le dithepo |
sanitizeFn |
lefeela | mošomo | null |
Mona o ka fana ka mosebetsi wa gago wa sanitize. Se se ka ba le mohola ge o rata go šomiša bokgobapuku bjo bo kgethegilego go dira tlhwekišo. |
offset |
array | thapo ya | mošomo | [0, 8] |
Offset ya popover leloko le sepheo lona. O ka fetiša thapo ka go dika tša datha ka boleng bjo bo arotšwego ka koma go swana le: Ge mošomo o šomišwa go laetša offset, o bitšwa ka selo seo se nago le go bewa ga popper, tšhupetšo, le popper rects bjalo ka ngangišano ya yona ya mathomo. The qholotsa elements DOM noutu e fetisoa e le ngangišano ya bobedi. Mošomo o swanetše go bušetša lenaneo leo le nago le dinomoro tše pedi: . Bakeng sa tshedimošo ye ntši lebelela ditokomane tša offset tša Popper . |
popperConfig |
lefeela | selo sa | mošomo | null |
Go fetoša peakanyo ya Popper ya maitirelo ya Bootstrap, bona peakanyo ya Popper . Ge mošomo o šomišwa go hlama peakanyo ya Popper, e bitšwa ka selo seo se nago le peakanyo ya Popper ya maitirelo ya Bootstrap. E go thuša go šomiša le go kopanya ya go se fetoge le peakanyo ya gago. Mošomo o swanetše go bušetša selo sa peakanyo sa Popper. |
Data litšobotsi bakeng sa popovers motho ka mong
Dikgetho tša dipopovers ka botee di ka laetšwa ka tsela ye nngwe ka tšhomišo ya dika tša datha, bjalo ka ge go hlalošitšwe ka godimo.
Go šomiša mošomo kapopperConfig
var popover = new bootstrap.Popover(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
Mekgwa ya go šoma
Mekgwa ya asynchronous le diphetogo
Mekgwa ka moka ya API ga e na asynchronous gomme e thoma phetogo . Ba boela go motho yo a leletšago mogala gateetee ge phetogo e thomilwe eupša pele e fela . Go tlaleletša, pitšo ya mokgwa go karolo ya phetogo e tla hlokomologwa .
Bona ditokomane tša rena tša JavaScript bakeng sa tshedimošo e oketšegilego .
bontšha
E utolla popover ya elemente. E boela go mogala pele ga ge popover e bontšhitšwe e le ka kgonthe (ke gore pele ga ge shown.bs.popover
tiragalo e direga). Se se lebelelwa e le go hlohleletša “ka seatla” ga popover. Dipopo tšeo sehlogo sa tšona le diteng tša tšona ka bobedi e lego tša botelele bja lefela ga di ke di bontšhwa.
myPopover.show()
fihla
Pata popover ya elemente. E boela go mogala pele ga ge popover e tloga e utilwe (ke gore pele ga ge hidden.bs.popover
tiragalo e direga). Se se lebelelwa e le go hlohleletša “ka seatla” ga popover.
myPopover.hide()
go fetola
Toggles popover ya elemente. E boela go mogala pele ga ge popover e tloga e bontšhitšwe goba e utilwe (ke gore pele ga ge tiragalo ya shown.bs.popover
goba hidden.bs.popover
e direga). Se se lebelelwa e le go hlohleletša “ka seatla” ga popover.
myPopover.toggle()
lahla
Pata le go senya popover ya elemente (E tloša ya data ye e bolokilwego go elemente ya DOM). Popovers hore sebelisa kabo (tseo di bōptjoa sebelisa kgetho selector
) ke ke ka bomong senya ka setloholo qholotsa elements.
myPopover.dispose()
kgontšha
E fa popover ya elemente bokgoni bja go bontšhwa. Popovers di kgontšhwa ka go ikemela.
myPopover.enable()
šitiša
E tloša bokgoni bja gore popover ya elemente e bontšhwe. Popover e tla kgona go bontšhwa fela ge e kgontšhitšwe gape.
myPopover.disable()
toggleE kgontšhitšwe
Toggles bokgoni bja gore popover ya elemente e bontšhwe goba e utilwe.
myPopover.toggleEnabled()
mpshafatša
E mpshafatša maemo a popover ya elemente.
myPopover.update()
hwetšaMohlala
Mokgwa wa go se fetoge wo o go dumelelago go hwetša mohlala wa popover wo o amanago le elemente ya DOM
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
hwetšaGobaHlamaMohlala
Mokgwa wa go se fetoge wo o go dumelelago go hwetša mohlala wa popover wo o amanago le elemente ya DOM, goba go hlama ye mpsha ge go ka direga gore e be e sa thongwa
var exampleTriggerEl = document.getElementById('example')
var popover = bootstrap.Popover.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap popover instance
Ditiragalo
Mohuta wa tiragalo | Tlhalošo |
---|---|
bontša.bs.popover | Tiragalo ye e thunya ka pela ge show mokgwa wa mohlala o bitšwa. |
e bontšhitšwe.bs.bodiidi | Tiragalo ye e thuntšhwa ge popover e dirilwe gore e bonagale go modiriši (e tla emela gore diphetogo tša CSS di phethe). |
pata.bs.bodiidi | Tiragalo ye e thuntšhwa ka pela ge hide mokgwa wa mohlala o biditšwe. |
e utilwego.bs.bodiidi | Tiragalo ye e thuntšhwa ge popover e feditše go utollwa go modiriši (e tla emela gore diphetogo tša CSS di phethe). |
e tsentšwe.bs.bodiidi | Tiragalo ye e thuntšhwa ka morago ga show.bs.popover tiragalo ge thempleite ya popover e okeditšwe go DOM. |
var myPopoverTrigger = document.getElementById('myPopover')
myPopoverTrigger.addEventListener('hidden.bs.popover', function () {
// do something...
})