Laktawan ti kangrunaan a linaon Laktawan ti docs navigation
in English

Dagiti tip ti remienta

Dokumentasion ken dagiti pagarigan para iti pananginayon kadagiti kostumbre a tooltip ti Bootstrap nga addaan iti CSS ken JavaScript babaen ti panagusar ti CSS3 para kadagiti animasion ken dagiti data-bs-attribute para iti lokal a pagipempenan ti paulo.

Panangkita iti pakabuklan

Dagiti banag nga ammuen no agusar ti tooltip plugin:

  • Agpannuray dagiti Tooltip 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.jsa naglaon iti Popper tapno agtrabaho dagiti toltips!
  • Dagiti Tooltip ket opt-in para kadagiti rason ti panagaramid, isu a masapul nga irugim a mismo dagitoy .
  • Dagiti Tooltip nga addaan kadagiti zero-length a paulo ket saan a pulos a maiparang.
  • 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 tooltip kadagiti nailemmeng nga elemento.
  • Dagiti tip ti ramit para iti .disabledwenno disableddagiti elemento ket masapul a mai-trigger iti maysa nga elemento ti balkot.
  • No mai-trigger manipud kadagiti hyperlink a mangsaklaw kadagiti adu a linia, dagiti tooltip ket maisentro. Usaren white-space: nowrap;ti <a>s-mo tapno maliklikan daytoy a kababalin.
  • Dagiti tip ti ramit ket masapul a mailemmeng sakbay a dagiti maitunos nga elementoda ket naikkat manipud iti DOM.
  • Dagiti Tooltip ket mabalin a mai-trigger gapu ti maysa nga elemento iti uneg ti anniniwan a DOM.
Babaen ti kasisigud, daytoy a paset ket agus-usar ti naibangon a sanitizer ti linaon, a mangikkat kadagiti ania man nga elemento ti HTML a saan a nalawag a maipalubos. Kitaen ti benneg ti sanitizer iti dokumentasionmi iti JavaScript para iti ad-adu pay a detalye.
Ti epekto ti animasion daytoy a paset ket agpannuray iti prefers-reduced-motionpanagsaludsod ti media. Kitaen ti benneg ti naikkat a panaggunay ti dokumentasionmi ti pannakagun-od .

Naalamon amin dagita? Nasayaat, kitaentayo no kasano ti panagtrabahoda babaen ti sumagmamano a pagarigan.

Pagarigan: Pagbalinen dagiti tooltip iti sadinoman

Ti maysa a wagas a mangirugi kadagiti amin a toltip iti maysa a panid ket ti panangpili kadagitoy babaen ti data-bs-toggleattribute-da:

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

Dagiti pagarigan

I-hover dagiti link iti baba tapno makitam dagiti tooltip:

Teksto ti placeholder tapno maipakita ti sumagmamano nga inline a silpo nga addaan kadagiti tooltip. Filler laeng itan daytoy, awan ti mammapatay. Linaon a naikabil ditoy tapno laeng matulad ti kaadda ti pudno a teksto . Ket amin dagita tapno laeng mangted kenka iti ideya no kasano ti langa dagiti toltips no mausar kadagiti pudno a kasasaad. Isu a sapay koma ta nakitamon itan no kasano a dagitoy a tooltip kadagiti silpo ket mabalin nga agtrabaho iti praktis, apaman nga usarem dagitoy iti bukodmo a site wenno proyekto.

I-hover dagiti buton iti baba tapno makitam ti uppat a direksion ti toltips: ngato, kannawan, baba, ken kannigid. Dagiti direksion ket maisarming no agus-usar ti Bootstrap iti 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>

Ket addaan iti nainayon a kostumbre nga HTML:

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

Iti maysa nga SVG:

Sass nga

Dagiti Variable

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

Panagusar

Ti plugin ti tooltip ket mangpataud ti linaon ken panagmarka no kasapulan, ken babaen ti kasisigud ket mangikabil kadagiti tooltip kalpasan ti elementoda a mangtignay.

I-trigger ti tooltip babaen ti JavaScript:

var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, options)
Overflow autokenscroll

Ti posision ti Tooltip ket padasenna ti automatiko a panagbalbaliw no ti maysa a nagannak a pagkargaan ket addaan overflow: autowenno overflow: scrollkas ti .table-responsive, ngem pagtalinaedenna pay laeng ti posision ti orihinal a pannakaikabil. Tapno marisut daytoy, ikeddeng ti boundarypagpilian (para iti flip modifier nga agus-usar ti popperConfigpagpilian) iti ania man nga HTMLElement tapno maibalbaliw ti kasisigud a pateg, 'clippingParents', a kas ti document.body:

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

Panagmarka

Ti kasapulan a marka para iti tooltip ket maysa laeng nga dataattribute ken titleiti elemento ti HTML kayatmo nga addaan iti tooltip. Ti napataud a marka ti maysa a tooltip ket imbes a simple, urayno daytoy ket agkasapulan ti posision (babaen ti kasisigud, naikeddeng iti topbabaen ti plugin).

Ti panangaramid kadagiti tooltip nga agtrabaho para kadagiti agus-usar iti teklado ken katulongan a teknolohia

Rumbeng laeng nga inayonmo dagiti tooltip 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 tooltip iti daytoy a kasasaad. Mainayon pay, dika agpannuray laeng a hoverkas ti mangtignay para iti tooltipmo, ta daytoy ket mangaramid kadagiti tooltipmo nga imposible a mangtignay para kadagiti agar-aramat ti teklado.

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

Dagiti baldado nga elemento

Dagiti elemento nga addaan iti disabledattribute ket saan nga interaktibo, kayatna a sawen dagiti agar-aramat ket dida mabalin ti agpokus, ag-hover, wenno ag-klik kadagitoy tapno mangtignay ti tooltip (wenno popover). Kas maysa a panagliklik, kayatmo a mangtignay ti tooltip manipud iti maysa a balkot <div>wenno <span>, nasayaat a naaramid a teklado-a-maipamaysa babaen ti panagusar ti 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>

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

Imutektekanyo a gapu kadagiti rason ti seguridad ti sanitize, sanitizeFn, ken allowListdagiti pagpilian ket saan a maited babaen ti panagusar kadagiti kababalin ti datos.
Nagan Tipo Default Panangiladawan
animation boolean nga true Iyaplikar ti panagbalbaliw ti panagkupas ti CSS iti tooltip
container kuerdas nga | elemento nga | saan nga agpayso false

Inayon ti tooltip iti espesipiko nga elemento. Kas pagarigan: container: 'body'. Daytoy a pagpilian ket nangruna a makatulong gapu ta daytoy ket mangipalubos kenka a mangiposision ti tooltip iti panagayus ti dokumento iti asideg ti mangtignay nga elemento - a manglapped ti tooltip manipud iti panagtaytayab nga adayo manipud iti mangtignay nga elemento bayat ti panagbalbaliw ti kadakkel ti tawa.

delay numero | banag 0

Ti pannakataktak ti panangipakita ken panangilemmeng ti tooltip (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:delay: { "show": 500, "hide": 100 }

html boolean nga false

Palubosan ti HTML iti tooltip.

No pudno, dagiti etiketa ti HTML iti tooltip's titleket maiparangto iti tooltip. No palso, innerTextti sanikua ket mausarto a mangikabil ti linaon iti DOM.

Usaren ti teksto no madanaganka kadagiti panangraut ti XSS.

placement kuerdas nga | amad 'top'

Kasano ti mangiposision ti tooltip - auto | ngato | baba | kanigid | kusto.
No autonaikeddeng, daytoy ket dinamiko nga iturongna manen ti tooltip.

No ti maysa a panagandar ket maus-usar a mangikeddeng ti pannakaikabil, daytoy ket maawagan nga addaan ti tooltip a DOM a nodo a kas ti umuna nga argumentona ken ti mangtignay nga elemento a DOM a nodo a kas ti maikadua. Ti thiskonteksto ket naikeddeng iti instansia ti tooltip.

selector kuerdas nga | saan nga agpayso false No ti maysa a mangpili ket naited, dagiti banag ti tooltip ket maitedto kadagiti naikeddeng a puntiria. Iti praktis, daytoy ket maus-usar a mangyaplikar pay kadagiti tooltip kadagiti dinamiko a nainayon nga elemento ti DOM ( jQuery.onsuporta). Kitaen daytoy ken ti makaisuro a pagarigan .
template kuerdas '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

Base ti HTML nga usaren no mangpartuat ti tooltip.

Ti tooltip's titleket mai-inject iti .tooltip-inner.

.tooltip-arrowagbalinto a pana ti tooltip.

Ti akinruar nga elemento ti balkot ket rumbeng nga addaan iti .tooltipklase ken role="tooltip".

title kuerdas nga | elemento nga | amad ''

Default a pateg ti paulo no titleawan ti attribute.

No ti maysa a panagandar ket naited, daytoy ket maawaganto nga addaan ti thisreperensiana a naikabil iti elemento a nakaikapet ti tooltip.

trigger kuerdas 'hover focus'

Kasano a mai-trigger ti tooltip - i-klik ti | ag-hover nga | pokus | giya. Mabalin a lumasatka iti adu a trigger; pagsinaen ida babaen ti maysa nga espasio.

'manual'ipamatmatna a ti tooltip ket maitignayto a programatiko babaen ti .show(), .hide()ken dagiti pamay- .toggle()an; daytoy a pateg ket saan a mabalin a maitipon iti ania man a sabali a trigger.

'hover'iti bukodna ket agresulta kadagiti tooltip a saan a mai-trigger babaen ti teklado, ken rumbeng laeng a mausar no adda dagiti alternatibo a pamay-an para iti panangipatulod ti isu met laeng nga impormasion para kadagiti agar-aramat ti teklado.

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 tooltip (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 ''

Manginayon kadagiti klase iti tooltip 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: 'class-1 class-2'.

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 ma-activate 'template'ken 'title'ma-sanitize dagiti pagpilian. 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, 0]

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

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

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 toltip

Dagiti pagpilian para kadagiti indibidual a toltip ket mabalin a alternatibo a maikeddeng babaen ti panagusar kadagiti kababalin ti datos, a kas naipalawag iti ngato.

Usar ti function nga addaanpopperConfig

var tooltip = new bootstrap.Tooltip(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 tooltip ti maysa nga elemento. Agsubli iti tumawag sakbay nga aktual a naipakita ti tooltip (kayatna a sawen sakbay a shown.bs.tooltipmapasamak ti pasamak). Maibilang daytoy a “manual” a panangtignay iti tooltip. Dagiti Tooltip nga addaan kadagiti zero-length a paulo ket saan a pulos a maiparang.

tooltip.show()

aglemmeng

Ilemmeng ti tooltip ti maysa nga elemento. Agsubli iti tumawag sakbay nga aktual a nailemmeng ti tooltip (kayatna a sawen sakbay a hidden.bs.tooltipmapasamak ti pasamak). Maibilang daytoy a “manual” a panangtignay iti tooltip.

tooltip.hide()

ag-toggle nga

I-toggle ti tooltip ti maysa nga elemento. Agsubli iti tumawag sakbay nga aktual a naipakita wenno nailemmeng ti tooltip (kayatna a sawen sakbay a mapasamak ti shown.bs.tooltipwenno hidden.bs.tooltippasamak). Maibilang daytoy a “manual” a panangtignay iti tooltip.

tooltip.toggle()

ibelleng

Ilemmeng ken dadaelen ti tooltip ti maysa nga elemento (Ikkaten ti naidulin a datos iti elemento ti DOM). Dagiti tip ti ramit nga agus-usar ti delegasion (a naparsua babaen ti panagusar ti selectorpagpilian ) ket saan a mabalin a saggaysa a madadael kadagiti kaputotan a mangtignay nga elemento.

tooltip.dispose()

pagbalinen

Mangted ti tooltip ti maysa nga elemento ti abilidad a maipakita. Dagiti Tooltip ket napalubosan babaen ti default.

tooltip.enable()

awan ti kabaelan

Ikkaten ti abilidad para iti tooltip ti maysa nga elemento a maipakita. Ti tooltip ket mabalin laeng a maipakita no daytoy ket na-enable manen.

tooltip.disable()

toggleNaipalubosan

I-toggles ti abilidad para iti tooltip ti maysa nga elemento a maipakita wenno mailemmeng.

tooltip.toggleEnabled()

pabaroen

Ipabaro ti posision ti tooltip ti maysa nga elemento.

tooltip.update()

makaala tiInstansia

Estatiko a pamay-an a mangipalubos kenka a makaala ti tooltip nga instansia a nainaig iti maysa nga elemento ti DOM

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

makaalaWennoAgaramid itiInstansia

Estatiko a pamay-an a mangipalubos kenka a makaala ti pagarigan ti tooltip a nainaig iti maysa nga elemento ti DOM, wenno mangpartuat ti baro no kas pagarigan saan a nairugi

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

Dagiti Pasamak

Kita ti pasamak Panangiladawan
show.bs.tooltip Daytoy a pasamak ket agputok a dagus no ti showpamay-an ti pagarigan ket maawagan.
shown.bs.tooltip Daytoy a pasamak ket mapaputok no ti tooltip ket naaramiden a makita ti agar-aramat (urayenna dagiti panagbalbaliw ti CSS a malpas).
hide.bs.tooltip Daytoy a pasamak ket dagus a mapaputok no ti hidepamay-an ti pagarigan ket naawagan.
hidden.bs.tooltip Daytoy a pasamak ket mapaputok no ti tooltip ket nalpas a nailemmeng manipud iti agar-aramat (urayenna dagiti panagbalbaliw ti CSS a makompleto).
inserted.bs.tooltip Daytoy a pasamak ket mapaputok kalpasan ti show.bs.tooltippasamak no ti plantilia ti tooltip ket nainayon iti DOM.
var myTooltipEl = document.getElementById('myTooltip')
var tooltip = new bootstrap.Tooltip(myTooltipEl)

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

tooltip.hide()