Ntuziaka ngwaọrụ
Akwụkwọ na ihe atụ maka ịgbakwunye ngwa ngwa Bootstrap omenala na CSS na JavaScript iji CSS3 maka animation na data-bs-agwa maka nchekwa aha mpaghara.
Nchịkọta
Ihe ị ga-amata mgbe ị na-eji ngwa mgbakwunye Tooltip:
- Ntuziaka ngwaọrụ dabere na ọba akwụkwọ ndị otu nke atọ Popper maka itinye ya. Ị ga-agụnye popper.min.js tupu bootstrap.js ma ọ bụ jiri
bootstrap.bundle.min.js
/bootstrap.bundle.js
nke nwere Popper iji mee ka ndụmọdụ ọrụ rụọ ọrụ! - A na-abanye na ntuziaka ngwaọrụ maka ebumnuche arụmọrụ, yabụ ị ga-ebido ya n'onwe gị .
- Agaghị egosipụta ndụmọdụ ndụmọdụ nwere aha ogologo efu.
- Ezipụta
container: 'body'
ka ịzenarị nsogbu n'ime ihe ndị dị mgbagwoju anya (dị ka otu ntinye anyị, otu bọtịnụ, wdg). - Ndụmọdụ akụrụngwa na-akpalite na ihe zoro ezo agaghị arụ ọrụ.
- A ghaghị ịkpalite ndụmọdụ maka
.disabled
ma ọ bụdisabled
ihe n'ime ihe mkpuchi. - Mgbe a kpalitere site na hyperlinks na-agbatị ọtụtụ ahịrị, ndụmọdụ ngwaọrụ ga-adị n'etiti. Jiri
white-space: nowrap;
na<a>
s gị zere omume a. - A ghaghị izobe ndụmọdụ ngwaọrụ tupu ewepụrụ ihe ndị kwekọrọ na DOM.
- Enwere ike ịkpalite ndụmọdụ ngwaọrụ site na mmewere dị n'ime onyinyo DOM.
prefers-reduced-motion
ajụjụ mgbasa ozi. Hụ akụkụ
ngagharị ewelatala nke akwụkwọ nnweta anyị .
Enwetara ihe ahụ niile? Ọ dị mma, ka anyị hụ ka ha si arụ ọrụ na ihe atụ ụfọdụ.
Ọmụmaatụ: Kwado ndụmọdụ ngwaọrụ ebe niile
Otu ụzọ isi bido ndụmọdụ ngwaọrụ niile na ibe ga-abụ ịhọrọ ha site na data-bs-toggle
njirimara ha:
var tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
var tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) {
return new bootstrap.Tooltip(tooltipTriggerEl)
})
Ihe atụ
Gaa na njikọ dị n'okpuru ka ịhụ ndụmọdụ ndụmọdụ:
Ederede ebe nchekwa iji gosi ụfọdụ njikọ dị n'ahịrị nwere ndụmọdụ ngwaọrụ . Nke a bụ naanị ihe na-ejuputa, ọ dịghị egbu egbu. Edere ọdịnaya ebe a naanị iji ṅomie ọnụnọ nke ezigbo ederede . Na ihe niile naanị iji nye gị echiche otu ndụmọdụ ngwaọrụ ga-adị mgbe ejiri ya na ọnọdụ ụwa. Ya mere enwere olile anya na ị hụla ka ndụmọdụ ndụmọdụ ndị a dị na njikọ nwere ike isi rụọ ọrụ na omume, ozugbo i jiri ha na saịtị ma ọ bụ ọrụ gị.
Figharịa n'elu bọtịnụ dị n'okpuru ka ịhụ ntụzịaka ngwa ọrụ anọ: elu, aka nri, ala na aka ekpe. A na-egosipụta ntụzịaka mgbe ị na-eji Bootstrap na RTL.
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="top" title="Tooltip on top">
Tooltip on top
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="right" title="Tooltip on right">
Tooltip on right
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Tooltip on bottom">
Tooltip on bottom
</button>
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="left" title="Tooltip on left">
Tooltip on left
</button>
Na agbakwunyere HTML omenala:
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-html="true" title="<em>Tooltip</em> <u>with</u> <b>HTML</b>">
Tooltip with HTML
</button>
Site na SVG:
Sass
Mgbanwe
$tooltip-font-size: $font-size-sm;
$tooltip-max-width: 200px;
$tooltip-color: $white;
$tooltip-bg: $black;
$tooltip-border-radius: $border-radius;
$tooltip-opacity: .9;
$tooltip-padding-y: $spacer * .25;
$tooltip-padding-x: $spacer * .5;
$tooltip-margin: 0;
$tooltip-arrow-width: .8rem;
$tooltip-arrow-height: .4rem;
$tooltip-arrow-color: $tooltip-bg;
Ojiji
Ngwa mgbakwunye Tooltip na-ewepụta ọdịnaya na akara n'ọchịchọ, yana site na ndabara na-etinye ndụmọdụ ngwaọrụ mgbe ihe mkpalite ha gasịrị.
Kpalite ntụnye aka site na Javascript:
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, options)
Ijubiga ókè auto
nascroll
Ọnọdụ Tooltip na-anwa ịgbanwe na-akpaghị aka mgbe akpa nne na nna nwere overflow: auto
ma ọ bụ nwee overflow: scroll
mmasị na nke anyị .table-responsive
, mana ka na-edobe n'ọnọdụ mbụ. Iji dozie nke a, tọọ boundary
nhọrọ (maka ihe ntụgharị ntụgharị site na iji popperConfig
nhọrọ) na HTMLElement ọ bụla iji mebie uru ndabara, 'clippingParents'
, dị ka document.body
:
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, {
boundary: document.body // or document.querySelector('#boundary')
})
Akara akara
Ihe nrịbama achọrọ maka ngwa ọrụ bụ naanị njiri mara data
yana title
na mmewere HTML ịchọrọ ịnwe ntụnye aka. Ihe nrịbama emepụtara nke ngwa ọrụ dị mfe, n'agbanyeghị na ọ chọrọ ọnọdụ (site na ndabara, top
nke ngwa mgbakwunye setịpụrụ).
Ime ka ndụmọdụ ngwaọrụ rụọ ọrụ maka ahụigodo yana ndị ọrụ teknụzụ enyemaka
Ị ga-agbakwunye naanị ndụmọdụ ngwaọrụ na ihe HTML bụ omenala keyboard-lekwado anya na mmekọrịta (dị ka njikọ ma ọ bụ njikwa ụdị). Ọ bụ ezie na ihe HTML aka ike (dị ka <span>
s) nwere ike ime ka a na-elekwasị anya site n'ịgbakwunye tabindex="0"
àgwà ahụ, nke a ga-agbakwunye nkwụsị nke nwere ike iwe iwe na mgbagwoju anya na ihe ndị na-adịghị emekọrịta ihe maka ndị ọrụ keyboard, na ọtụtụ teknụzụ enyemaka anaghị ekwupụta ngwa ọrụ n'ọnọdụ a. Na mgbakwunye, adaberela naanị dị hover
ka ihe na-akpalite ntụpọ ngwaọrụ gị, n'ihi na nke a ga-eme ka ndụmọdụ ngwaọrụ gị ghara ịmalite ndị na-eji keyboard.
<!-- HTML to write -->
<a href="#" data-bs-toggle="tooltip" title="Some tooltip text!">Hover over me</a>
<!-- Generated markup by the plugin -->
<div class="tooltip bs-tooltip-top" role="tooltip">
<div class="tooltip-arrow"></div>
<div class="tooltip-inner">
Some tooltip text!
</div>
</div>
Ihe ndị nwere nkwarụ
Ihe ndị nwere disabled
njirimara ahụ anaghị emekọrịta ihe, nke pụtara na ndị ọrụ enweghị ike ilekwasị anya, tugharịa, ma ọ bụ pịa ha ka ha kpalite nghazi ngwaọrụ (ma ọ bụ popover). Dị ka ebe a na-arụ ọrụ, ị ga-achọ ịkpalite ngwa ọrụ site na ihe mkpuchi <div>
ma ọ bụ <span>
, nke emebere nke ọma na ahụigodo-elekwasị anya site na iji tabindex="0"
.
<span class="d-inline-block" tabindex="0" data-bs-toggle="tooltip" title="Disabled tooltip">
<button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>
Nhọrọ
Enwere ike ịfefe nhọrọ site na njirimara data ma ọ bụ Javascript. Maka njirimara data, tinye aha nhọrọ na data-bs-
, dị ka ọ dị na data-bs-animation=""
. Gbaa mbọ hụ na ị gbanwee ụdị ikpe nke aha nhọrọ site na camelCase gaa na kebab-case mgbe ị na-agafe nhọrọ site na njirimara data. Dịka ọmụmaatụ, kama iji data-bs-customClass="beautifier"
, jiri data-bs-custom-class="beautifier"
.
sanitize
,
sanitizeFn
, na
nhọrọ site na iji njirimara data.allowList
Aha | Ụdị | Ọdabara | Nkọwa |
---|---|---|---|
animation |
boolean | true |
Tinye mgbanwe CSS na-agwụ n'isi ngwaọrụ |
container |
eriri | mmewere | ụgha | false |
Na-agbakwunye ntụnye aka na otu mmewere. Ọmụmaatụ |
delay |
nọmba | ihe | 0 |
Ngosipụta na izochi ngwa ọrụ (ms) - anaghị emetụta ụdị mkpalite aka Ọ bụrụ na ewepụtara nọmba, a na-etinye igbu oge na ma zoo/egosi Nhazi ihe bụ: |
html |
boolean | false |
Kwe ka HTML banye n'ọnụ ngwaọrụ. Ọ bụrụ na ọ bụ eziokwu, mkpado HTML dị na Tooltip's Jiri ederede ma ọ bụrụ na ị na-echegbu onwe gị maka mwakpo XSS. |
placement |
eriri | ọrụ | 'top' |
Otu esi edobe ngwa ọrụ - akpaaka | n'elu | ala | aka ekpe | nri. Mgbe a na-eji ọrụ iji chọpụta ntinye, a na-akpọ ya na ngwá ọrụ DOM node dị ka arụmụka mbụ ya na ihe na-akpali akpali DOM node dị ka nke abụọ ya. A |
selector |
eriri | ụgha | false |
Ọ bụrụ na enyere onye nhọpụta, a ga-ekenye ihe nrịbama ngwaọrụ na ebumnuche ndị akọwapụtara. Na omume, a na-eji nke a tinyekwa ndụmọdụ ngwaọrụ na ihe DOM agbakwunyere ike ( jQuery.on nkwado). Hụ nke a na ihe atụ na-enye nkọwa . |
template |
eriri | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Base HTML ka ị ga-eji mgbe ị na-eke ihe nrụtụ aka. A
Ihe mkpuchi ihe kachasị elu kwesịrị inwe |
title |
eriri | mmewere | ọrụ | '' |
Uru aha ndabara ma ọ bụrụ Ọ bụrụ na enyere ọrụ, a ga-akpọ ya na |
trigger |
eriri | 'hover focus' |
Olee otú Tooltip na-akpalite - pịa | hover | lekwasịrị anya | akwụkwọ ntuziaka. Ị nwere ike ịgafe ọtụtụ ihe mkpali; kewaa ha na oghere.
|
fallbackPlacements |
n'usoro | ['top', 'right', 'bottom', 'left'] |
Kọwaa ebe ndaghachi azụ site n'inye ndepụta ntinye n'usoro (n'usoro masịrị gị). Maka ozi ndị ọzọ rụtụ aka na akwụkwọ omume Popper |
boundary |
eriri | mmewere | 'clippingParents' |
Oke oke mmachi oke nke ngwa ngwa (na-emetụta naanị Popper's preventOverflow modifier). Site na ndabara ọ 'clippingParents' nwere ike nabata ntụaka HTMLElement (site na Javascript naanị). Maka ozi ndị ọzọ rụtụ aka na docs detectOverflow nke Popper . |
customClass |
eriri | ọrụ | '' |
Tinye klaasị na akuku ngwaọrụ mgbe egosiri ya. Rịba ama na a ga-agbakwunye klaasị ndị a na mgbakwunye na klaasị ọ bụla akọwapụtara na ndebiri. Ka ịgbakwunye ọtụtụ klaasị, kewaa ha na oghere: Ị nwekwara ike ịgafe ọrụ kwesịrị iweghachi otu eriri nwere aha klaasị agbakwunyere. |
sanitize |
boolean | true |
Kwado ma ọ bụ gbanyụọ nhichapụ ahụ. Ọ bụrụ na agbanyere 'template' ya, 'title' a ga-ehichapụ nhọrọ. Hụ ngalaba sanitizer na akwụkwọ Javascript anyị . |
allowList |
ihe | Uru ndabara | Ihe nke nwere njirimara na mkpado ekwenyere |
sanitizeFn |
efu | ọrụ | null |
N'ebe a, ị nwere ike ịnye ọrụ ịdị ọcha nke gị. Nke a nwere ike ịba uru ma ọ bụrụ na-amasị gị iji ọbá akwụkwọ raara onwe ya nye iji rụpụta ịdị ọcha. |
offset |
n'usoro | eriri | ọrụ | [0, 0] |
Nkwụsị nke ngwa ọrụ n'ihe metụtara ebumnuche ya. Ị nwere ike ịnyefe eriri n'ime njirimara data yana ụkpụrụ kewapụrụ rịkọm dị ka: Mgbe a na-eji ọrụ chọpụta nkwụghachi ụgwọ, a na-akpọ ya na ihe nwere ntinye popper, akwụkwọ ntụaka, na popper rects dị ka arụmụka mbụ ya. A na-agafe oghere DOM na-akpalite dị ka arụmụka nke abụọ. Ọrụ ahụ ga-eweghachite n'usoro nwere ọnụọgụ abụọ: . Maka ozi ndị ọzọ rụtụ aka na docs offset Popper . |
popperConfig |
efu | ihe | ọrụ | null |
Ka ịgbanwee ndabara Bootstrap Popper config, hụ nhazi nke Popper . Mgbe a na-eji ọrụ mepụta nhazi Popper, a na-akpọ ya na ihe nwere nhazi ndabara nke Bootstrap. Ọ na-enyere gị aka iji ma jikọta ndabara na nhazi nke gị. Ọrụ ahụ ga-eweghachite ihe nhazi maka Popper. |
Njirimara data maka ndụmọdụ ngwaọrụ n'otu n'otu
Enwere ike ịkọwa nhọrọ maka ndụmọdụ ngwaọrụ n'otu n'otu site na iji njirimara data, dịka akọwara n'elu.
Iji ọrụ napopperConfig
var tooltip = new bootstrap.Tooltip(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
Ụzọ
Ụzọ asynchronous na ntụgharị
Ụzọ API niile enweghị atụ wee malite mgbanwe . Ha na-alaghachikwuru onye na-akpọ oku ozugbo mgbanwe ahụ malitere mana tupu ya akwụsị . Na mgbakwunye, a ga-eleghara oku usoro na mpaghara mgbanwe anya .
gosi
Na-ekpughe ngwa ọrụ mmewere. Na-alaghachikwute onye na-akpọ oku tupu egosipụta ngwa ọrụ (ya bụ tupu shown.bs.tooltip
mmemme emee). A na-ewere nke a dị ka "akwụkwọ ntuziaka" na-akpalite stụ aka. Agaghị egosipụta ndụmọdụ ndụmọdụ nwere aha ogologo efu.
tooltip.show()
zoo
Na-ezobe ntụaka ngwa ọrụ mmewere. Na-alaghachikwute onye na-akpọ oku tupu ezobe ngwa ọrụ n'ezie (ya bụ tupu hidden.bs.tooltip
mmemme emee). A na-ewere nke a dị ka "akwụkwọ ntuziaka" na-akpalite stụ aka.
tooltip.hide()
tụgharịa
Na-atụgharị ihe ntụnye aka nke mmewere. Na-alaghachikwute onye na-akpọ oku tupu egosipụta ma ọ bụ ezoro ezo emetụ aka (ya bụ tupu ihe shown.bs.tooltip
omume hidden.bs.tooltip
ahụ emee). A na-ewere nke a dị ka "akwụkwọ ntuziaka" na-akpalite stụ aka.
tooltip.toggle()
tufuo
Na-ezo ma bibie ngwa ọrụ mmewere (na-ewepụ data echekwara na mmewere DOM). Enweghị ike ibibi ndụmọdụ ndị na-eji ndị nnọchi anya (nke emepụtara site na iji selector
nhọrọ ) n'otu n'otu na ihe na-akpali akpali.
tooltip.dispose()
mee ka
Na-enye ntụzịaka ngwa ọrụ mmewere ike igosi ya. Agbanyere ndụmọdụ ngwaọrụ site na ndabara.
tooltip.enable()
gbanyụọ
Na-ewepụ ikike igosi ihe nrịbama ihe mmewere. A ga-enwe ike igosi ntụnye aka ma ọ bụrụ na agbanyere ya ọzọ.
tooltip.disable()
Agbanyere ngbanwe
Na-atụgharị ikike igosi ma ọ bụ zobe ihe nrịbama ngwa ihe.
tooltip.toggleEnabled()
imelite
Na-emelite ọnọdụ ntụaka ngwaọrụ elementrị.
tooltip.update()
nweta ihe atụ
Usoro static nke na-enye gị ohere ịnweta ihe atụ Tooltip jikọtara ya na mmewere DOM
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
nwetaOrCreateInstance
Usoro static nke na-enye gị ohere ịnweta ihe atụ Tooltip jikọtara ya na ihe DOM, ma ọ bụ mepụta nke ọhụrụ ma ọ bụrụ na ebidoghị ya.
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
Ihe omume
Ụdị mmemme | Nkọwa |
---|---|
show.bs.tooltip |
Ihe omume a na-agba ọkụ ozugbo show a na-akpọ usoro ihe atụ. |
shown.bs.tooltip |
A na-agbapụ ihe omume a mgbe onye ọrụ mere ka ọ hụ ihe nrịbama ngwaọrụ ahụ (ga-echere mgbanwe CSS ka agwụchaa). |
hide.bs.tooltip |
A na-agbapụ ihe omume a ozugbo hide a kpọrọ usoro ihe atụ. |
hidden.bs.tooltip |
A na-agbapụ ihe omume a mgbe ezoro ezoro ya n'aka onye ọrụ (ga-echere mgbanwe CSS ka agwụchaa). |
inserted.bs.tooltip |
A na-achụpụ ihe omume a mgbe ihe show.bs.tooltip omume ahụ gasịrị mgbe agbakwunyere template Tooltip na DOM. |
var myTooltipEl = document.getElementById('myTooltip')
var tooltip = new bootstrap.Tooltip(myTooltipEl)
myTooltipEl.addEventListener('hidden.bs.tooltip', function () {
// do something...
})
tooltip.hide()