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.js
a 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
.disabled
wennodisabled
dagiti 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.
prefers-reduced-motion
panagsaludsod 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-toggle
attribute-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 auto
kenscroll
Ti posision ti Tooltip ket padasenna ti automatiko a panagbalbaliw no ti maysa a nagannak a pagkargaan ket addaan overflow: auto
wenno overflow: scroll
kas ti .table-responsive
, ngem pagtalinaedenna pay laeng ti posision ti orihinal a pannakaikabil. Tapno marisut daytoy, ikeddeng ti boundary
pagpilian (para iti flip modifier nga agus-usar ti popperConfig
pagpilian) 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 data
attribute ken title
iti 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 top
babaen 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 hover
kas 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 disabled
attribute 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"
.
sanitize
,
sanitizeFn
, ken
allowList
dagiti 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: |
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: |
html |
boolean nga | false |
Palubosan ti HTML iti tooltip. No pudno, dagiti etiketa ti HTML iti tooltip's 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 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 |
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.on suporta). 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
Ti akinruar nga elemento ti balkot ket rumbeng nga addaan iti |
title |
kuerdas nga | elemento nga | amad | '' |
Default a pateg ti paulo no No ti maysa a panagandar ket naited, daytoy ket maawaganto nga addaan ti |
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.
|
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: 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: 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: . 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.tooltip
mapasamak 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.tooltip
mapasamak 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.tooltip
wenno hidden.bs.tooltip
pasamak). 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 selector
pagpilian ) 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 show pamay-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 hide pamay-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.tooltip pasamak 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()