Tlolela go diteng tše kgolo Tlolela go docs navigation
in English

Dikeletšo tša didirišwa

Ditokomane le mehlala ya go oketša didirišwa tša tlwaelo tša Bootstrap ka CSS le JavaScript ka go šomiša CSS3 bakeng sa ditshwantšho tša dipopaye le diponagalo tša data-bs-ya polokelo ya thaetlele ya selegae.

Kakaretšo

Dilo tšeo o swanetšego go di tseba ge o diriša polaka ya keletšo ya sedirišwa:

  • Tooltips 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.jsyeo e nago le Popper gore ditšhišinyo tša didirišwa di šome!
  • Dikeletšo tša didirišwa ke tša go kgetha go tsena ka mabaka a tshepedišo, ka fao o swanetše go di thoma ka bowena .
  • Dikeletšo tša didirišwa tšeo di nago le dihlogo tša botelele bja lefela ga di ke di bontšhwa.
  • 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 maele a didirišwa go dielemente tše di utilwego go ka se šome.
  • Dikeletšo tša didirišwa tša .disabledgoba disableddielemente di swanetše go hlohleletša godimo ga elemente ya sephuthelwana.
  • Ge e hlohleletšwa go tšwa go dikgokagano tša godimo tšeo di akaretšago mela ye mentši, ditšhupetšo tša didirišwa di tla ba bogareng. Diriša white-space: nowrap;go s ya gago <a>go efoga boitshwaro bjo.
  • Dikeletšo tša didirišwa 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.
  • Tooltips ka hlohleletšwa ka lebaka la elemente ka gare ga moriti DOM.
Ka go ikemela, karolo ye e šomiša sehlatswa diteng seo se agetšwego ka gare, seo se hlobolago dielemente dife goba dife tša HTML tšeo di sa dumelelwago ka go lebanya. Bona karolo ya sanitizer ka go ditokomane tša rena tša JavaScript bakeng sa dintlha tše dingwe.
Phello ya dipopaye ya karolo ye e ithekgile ka prefers-reduced-motionpotšišo ya methopo ya ditaba. Bona karolo ya tšhišinyego ye e fokoditšwego ya ditokomane tša rena tša phihlelelo .

O na le tšeo ka moka? E kgolo, a re boneng kamoo ba šomago ka gona ka mehlala e mengwe.

Mohlala: Kgontšha ditšhišinyo tša didirišwa gohle

Tsela e nngwe ya go thoma ditšhišinyo ka moka tša didirišwa letlakaleng e tla ba go di kgetha ka data-bs-toggleseka sa tšona:

var tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
var tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) {
  return new bootstrap.Tooltip(tooltipTriggerEl)
})

Mehlala

Beakanya godimo ga dikgokagano tše di lego ka mo tlase go bona ditšhišinyo tša didirišwa:

Sengwalwa sa seswari go laetša dikgokagano tše dingwe tša ka gare ga mothaladi ka ditšhišinyo tša didirišwa. Ye bjale ke filler fela, ga go na mmolai. Diteng tšeo di beilwego mo e le feela go ekiša go ba gona ga sengwalwa sa kgonthe . Gomme tšeo ka moka e no ba go go fa kgopolo ya ka fao ditšhišinyo tša didirišwa di bego di tla lebelega ka gona ge di šomišwa maemong a kgonthe a lefase. Ka fao ka kholofelo bjale o bone ka fao ditšhišinyo tše tša didirišwa go dikgokagano di ka šomago ka gona ka tirišo, ge o šetše o di šomišitše mo saeteng ya gago goba porojekeng.

Beakanya godimo ga dikonope tše di lego ka mo tlase go bona ditaelo tše nne tša dikeletšo tša didirišwa: godimo, ka go le letona, 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-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>

Gomme ka HTML ya tlwaelo yeo e okeditšwego:

<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>

Ka SVG: .

Sass

Diphetogo

$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;

Tšhomišo

Plugin ya keletšo ya didirišwa e tšweletša dikagare le go swaya ka nyakego, gomme ka go ikemela e bea dintlha tša didirišwa ka morago ga elemente ya bona ya go hlohleletša.

Hlohleletša keletšo ya sedirišwa ka JavaScript:

var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, options)
Go tlala autolescroll

Boemo bja Tooltip bo leka go fetoga ka go iketla ge setshelo sa motswadi se na le overflow: autogoba se overflow: scrollswana le sa rena .table-responsive, eupša se sa dutše se boloka boemo bja mathomo bja go bewa. Go rarolla se, beakanya boundarykgetho (bakeng sa sefetoši sa go phetla ka go šomiša popperConfigkgetho) go HTMLElement efe goba efe go tloša boleng bja go se fetoge, 'clippingParents', go swana le document.body:

var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, {
  boundary: document.body // or document.querySelector('#boundary')
})

Go swaya

Tswao ye e nyakegago ya keletšo ya sedirišwa ke dataseka fela gomme titlegodimo ga elemente ya HTML o nyaka go ba le keletšo ya sedirišwa. The generated markup ya tooltip e e-na le bonolo, le hoja e etsa hloka boemo (ka default, beha ho topke plugin).

Go dira gore maele a didirišwa a šome go badiriši ba khiiboto le theknolotši ya go thuša

O swanetše go oketša fela dikeletšo tša didirišwa go dielemente tša HTML tšeo ka setšo di lebanego le khiiboto le tše di dirišanago (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 keletšo ya sedirišwa boemong bjo. Go tlaleletša, o se ke wa ithekga fela ka hoverbjalo ka sešušumeletši sa keletšo ya gago ya sedirišwa, ka ge se se tla dira gore dikeletšo tša gago tša didirišwa di se kgonege go hlohleletša go badiriši ba khiiboto.

<!-- 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>

Dielemente tše di golofetšego

Dielemente tše di nago le disabledseka ga di na tirišano, go ra gore badiriši ba ka se tsepamiše kgopolo, go di hover, goba go di klika go hlohleletša keletšo ya sedirišwa (goba popover). Bjalo ka tharollo, o tla nyaka go hlohleletša keletšo ya sedirišwa go tšwa go sephuthedi <div>goba <span>, ka mo go swanetšego e dirilwe gore e tsepamiše khiiboto ka go šomiša 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>

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".

Hlokomela gore ka mabaka a tšhireletšo dikgetho tša sanitize, sanitizeFn, le allowListdi 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 keletšo ya sedirišwa
container thapo ya | elemente | maaka false

E tlaleletša keletšo ya sedirišwa go elemente ye e itšego. Mohlala: container: 'body'. Kgetho ye e na le mohola kudu ka gore e go dumelela go bea ntlha ya sedirišwa ka go elela ga tokumente kgauswi le elemente ya go hlohleletša - yeo e tlago thibela ntlha ya sedirišwa go phaphamala go tloga go elemente ya go hlohleletša nakong ya go fetoša bogolo bja lefasetere.

delay nomoro ya | selo 0

Tiego ya go bontšha le go uta keletšo ya sedirišwa (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:delay: { "show": 500, "hide": 100 }

html boolean ya go swana false

Dumelela HTML ka go keletšo ya sedirišwa.

Ge e le nnete, dithepo tša HTML ka go tooltip's titledi tla tšweletšwa ka go tooltip. Ge e le maaka, innerTextthepa 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 'top'

Tsela ya go bea tooltip - auto | godimo | tlase | le letšehali | nepagetše.
Ge autoe laeditšwe, e tla lebiša gape ka go fetoga keletšo ya sedirišwa.

Ge mošomo o šomišwa go bona go bewa, o bitšwa ka noutu ya DOM ya ntlha ya sedirišwa 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 thisse beakantšwe go mohlala wa keletšo ya sedirišwa.

selector thapo ya | maaka false Ge e le gore mokgethi o filwe, dilo tša keletšo ya sedirišwa di tla abelwa diphetho tše di laeditšwego. Ka go diragatša, se se šomišwa go diriša gape malebela a didirišwa go dielemente tša DOM tšeo di okeditšwego ka maatla ( jQuery.onthekgo). Bona se le mohlala o rutago .
template thapo '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

Thea HTML go šomiša ge o hlama keletšo ya sedirišwa.

Di- tooltip's titledi tla hlabja ka gare ga .tooltip-inner.

.tooltip-arrowe tla ba motsu wa tooltip.

Elemente ya sephuthedi sa ka ntle e swanetše go ba le .tooltipsehlopha le role="tooltip".

title thapo ya | elemente | mošomo ''

Boleng bja thaetlele bja maitirelo ge e titlele gore seka se se gona.

Ge e le gore mošomo o filwe, o tla bitšwa ka thissete ya wona ya tšhupetšo go elemente yeo keletšo ya sedirišwa e kgomareditšwego go yona.

trigger thapo 'hover focus'

Kamoo tooltip e hlohleletšwago ka gona - klika | hover | go tsepamiša kgopolo | manyuale. O ka feta dihlohleletši tše dintši; di aroganya ka sekgoba.

'manual'e bontša hore tooltip tla qholotsa programmatically ka .show(), .hide()le .toggle()mekgwa ya tshebetso; boleng bjo bo ka se kopanywe le sešušumeletši se sengwe le se sengwe.

'hover'ka boyona e tla feletša ka ditšhišinyo tša didirišwa tšeo di ka se hlohleletšwego ka khiiboto, gomme di swanetše go šomišwa fela ge mekgwa ye mengwe ya go fetišetša tshedimošo ye e swanago go badiriši ba khiiboto e le gona.

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 keletšo ya sedirišwa (e š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 keletšo ya sedirišwa 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: 'class-1 class-2'.

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. Haeba kenya tshebetsong 'template'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, 0]

Offset ya tooltip 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:data-bs-offset="10,20"

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: .[skidding, distance]

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.

Dika tša datha tša didirišwa tša motho ka o tee ka o tee

Dikgetho tša maele a didirišwa ka botee ka tsela ye nngwe di ka laetšwa 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 tooltip = new bootstrap.Tooltip(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 keletšo ya sedirišwa ya elemente. E boela go mogala pele ga ge keletšo ya sedirišwa e bontšhitšwe e le ka kgonthe (ke gore pele ga ge shown.bs.tooltiptiragalo e direga). Se se tšewa e le go hlohleletša ga “ka seatla” ga keletšo ya sedirišwa. Dikeletšo tša didirišwa tšeo di nago le dihlogo tša botelele bja lefela ga di ke di bontšhwa.

tooltip.show()

fihla

E uta keletšo ya sedirišwa ya elemente. E boela go mogala pele ga ge keletšo ya sedirišwa e tloga e utilwe (ke gore pele ga ge hidden.bs.tooltiptiragalo e direga). Se se tšewa e le go hlohleletša ga “ka seatla” ga keletšo ya sedirišwa.

tooltip.hide()

go fetola

E fetola keletšo ya sedirišwa ya elemente. E boela go mogala pele ga ge keletšo ya sedirišwa e tloga e bontšhitšwe goba e utilwe (ke gore pele ga ge tiragalo ya shown.bs.tooltipgoba hidden.bs.tooltipe direga). Se se tšewa e le go hlohleletša ga “ka seatla” ga keletšo ya sedirišwa.

tooltip.toggle()

lahla

E uta le go senya keletšo ya sedirišwa ya elemente (E tloša datha ye e bolokilwego go elemente ya DOM). Dikeletšo tša didirišwa tšeo di šomišago kabo (tšeo di hlotšwego ka go šomiša kgetho selector) di ka se senywe ka botee go dielemente tša go hlohleletša tša setlogolo.

tooltip.dispose()

kgontšha

E fa sedirišwa sa elemente bokgoni bja go bontšhwa. Dikeletšo tša didirišwa di kgontšhwa ka go ikemela.

tooltip.enable()

šitiša

E tloša bokgoni bja gore keletšo ya sedirišwa ya elemente e bontšhwe. Keletšo ya sedirišwa e tla kgona go bontšhwa fela ge e kgontšhitšwe gape.

tooltip.disable()

toggleE kgontšhitšwe

E fetola bokgoni bja gore keletšo ya sedirišwa ya elemente e bontšhwe goba e utilwe.

tooltip.toggleEnabled()

mpshafatša

E mpshafatša maemo a keletšo ya sedirišwa ya elemente.

tooltip.update()

hwetšaMohlala

Mokgwa wa go se fetoge wo o go dumelelago go hwetša mohlala wa tooltip wo o amanago le elemente ya DOM

var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance

hwetšaGobaHlamaMohlala

Mokgwa wa go se fetoge wo o go dumelelago go hwetša mohlala wa keletšo ya sedirišwa 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 tooltip = bootstrap.Tooltip.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance

Ditiragalo

Mohuta wa tiragalo Tlhalošo
show.bs.tooltip Tiragalo ye e thunya ka pela ge showmokgwa wa mohlala o bitšwa.
shown.bs.tooltip Tiragalo ye e thuntšhwa ge keletšo ya sedirišwa e dirilwe gore e bonagale go modiriši (e tla emela gore diphetogo tša CSS di phethe).
hide.bs.tooltip Tiragalo ye e thuntšhwa ka pela ge hidemokgwa wa mohlala o biditšwe.
hidden.bs.tooltip Tiragalo ye e thuntšhwa ge keletšo ya sedirišwa e feditše go utollwa go tšwa go modiriši (e tla emela gore diphetogo tša CSS di phethe).
inserted.bs.tooltip Tiragalo ye e thuntšhwa ka morago ga show.bs.tooltiptiragalo ge thempleite ya keletšo ya sedirišwa e okeditšwe go DOM.
var myTooltipEl = document.getElementById('myTooltip')
var tooltip = new bootstrap.Tooltip(myTooltipEl)

myTooltipEl.addEventListener('hidden.bs.tooltip', function () {
  // do something...
})

tooltip.hide()