Saltar al contenido principal Salta a docs navegación
in English

Yanapakuykuna

Qillqakuna chaymanta ejemplokuna sapanchasqa Bootstrap yanapakuypa yanapakuyninkuna yapanapaq CSS kaqwan chaymanta JavaScript kaqwan CSS3 kaqwan kawsachiykunapaq chaymanta data-bs-atributos kaqwan kiti titulo waqaychaypaq.

Hatun qhawariy

Imakuna yachanapaq yanapakuypa yanapakuynin plugin kaqwan llamk'achkaspa:

  • Llamkanakuna yuyaychaykuna 3 kaq parti biblioteca Popper kaqpi hapipakunku churanapaq. Popper.min.js manaraq bootstrap.js kaqmanta churanayki tiyan utaq bootstrap.bundle.min.js/ llamk'achiy bootstrap.bundle.jsmayqinchus Popper kaqta hap'in chaymanta yanapakuy yuyaychaykuna llamk'ananpaq!
  • Llamkanakuna yuyaychaykuna ruwaypaq akllana kanku, chayrayku qam kikiyki qallarinayki tiyan .
  • Cero sayayniyuq tituluyuq llamkanakunap yuyaychayninkunaqa manam hayk'appas rikuchisqachu.
  • container: 'body'Aswan sasa componentekunapi (yaykuna huñuyku, ñit'ina huñukuna, hukkuna hina) sasachakuykunata mana ruwaypaq willay .
  • Pakasqa elementokunapi yanapakuypa yanapakuyninkunata qallarichiyqa manam llamkanqachu.
  • .disabledicha elementokunapaq llamkanakuna huk p'istu disabledelementopi llamk'achisqa kanan tiyan.
  • Achka chirukunata mast'ariq hipervínculokunamanta llamk'achisqa kaqtin, yanapakuypa yuyaychaykuna chawpichasqa kanqa. Utilizar white-space: nowrap;en tu <a>s para evitar este comportamiento.
  • Llamkanakuna yuyaychaykuna pakasqa kanan tiyan manaraq tupaqnin elementokuna DOM kaqmanta hurqusqa kachkaptin.
  • Tooltips nisqaqa huk llantu DOM ukhupi huk elementoman gracias nisqawanmi llamk'achisqa kanman.
Ñawpaqmanta, kay componente ruwasqa contenido desinfectante kaqwan llamk'achin, mayqinchus mayqin HTML elementokuna mana sut'imanta saqisqa kaqta qichun. Aswan willakuypaq JavaScript qillqaykupi desinfectante t'aqapi qhaway .
Kay componentepa animación efectonqa prefers-reduced-motionmedios tapuymanta hapirin. Yaykuna qillqaykumanta pisiyachisqa kuyuy t'aqapi qhaway .

¿Tukuy chaykunatachu hap’irqanki? Hatun, qhawarisunchis imaynatas llank’anku wakin ejemplokunawan.

Ejemplo: Tukuy hinantinpi yanapakuykunata atichiy

Huk ñan huk p'anqapi llapa yanapakuykunata qallariypaq kanman, data-bs-toggleatributonkuman hina akllay:

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

Ejemplos

Uraypi t'inkikuna patapi makiwan ñit'iy yanapakuykunata qhawanaykipaq:

Wakin chiru ukhupi t'inkikunata yanapakuykunawan rikuchinapaq tiyana qillqa . Kayqa kunanqa hunt’achiqlla, mana wañuchiqchu. Contenido colocado aquí solo para imitar la presencia de texto real . Hinallataq tukuy chaykuna huk yuyayta qusunaykipaqlla imayna yanapakuypa yanapakuyninkuna chiqap pacha situacionkunapi llamk'achisqa kaqtin. Chaymi suyakuy kunan rikurqanki imaynatachus kay yanapakuykuna t'inkikunapi llamk'ayta atinku ruwaypi, huk kuti kikin sitioykipi utaq proyectoykipi llamk'achinki.

Uraypi kaq botones patapi makiwan ñit’iy tawa yanapakuypa ñanninkunata qhawanaykipaq: pata, paña, uray, lluq’i ima. RTL kaqpi Bootstrap llamk'achkaspa ñankuna espejo kaqpi ruwasqa kanku.

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

Hinallataq HTML ruwasqa yapasqawan:

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

Huk SVG nisqawan:

Sass

Variables nisqakuna

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

Uso

Yanapakuypa yanapakuynin plugin ruwanakuna chaymanta markakuna mañakuypi ruwan, chaymanta ñawpaqmanta yanapakuypa yanapakuyninkunata elemento gatillo kaqninkumanta qhipaman churan.

JavaScript nisqawan yanapakuypa yuyaychayninta llamk'achiy:

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

Tooltip posición kikinmanta tikrayta munan mayk'aq huk tayta waqaychana ñuqaykupaq overflow: autoutaq overflow: scrollhina .table-responsive, ichaqa chaywanpas ñawpaq churaypa churayninta waqaychan. Kayta allichanapaq, boundaryakllanata churay (akllanata llamk'achispa flip tikraqpaq popperConfig) mayqin HTMLElement kaqmanpas ñawpaqmanta chanita llallinanpaq, 'clippingParents', kayhina document.body:

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

Markup

Huk yanapakuypa yanapakuypaq munasqa markaqa huk layallam datachaymanta titleHTML elementopi huk yanapakuypa yanapakuyniyuq kayta munanki. Huk yanapakuypa paqarichisqan markasqa aswan sasan, ichaqa huk posiciónta munan (ñawpaqmanta, topplugin kaqwan churasqa).

Teclado chaymanta yanapakuy tecnologia llamk'aqkunapaq yanapakuypa yanapakuyninkuna llamk'ayta ruway

HTML elementokunaman yanapakuykunalla yapanayki tiyan mayqinkunachus ñawpaqmanta teclado-enfocables chaymanta interactivos kanku (kayhina t'inkikuna utaq formulario kamachiykuna). Aunque arbitrario HTML elementokuna (kayhina <span>s) ruwayta atikunku enfoquepaq atributo yapaspa tabindex="0", kayqa yapanqa potencialmente phiñachiq chaymanta pantasqa tabla sayaykunata mana interactivo elementokunapi teclado kaqmanta ruwaqkunapaq, chaymanta aswan yanapakuq tecnologiakuna kunan mana willankuchu yanapakuypa yuyaychayninta kay situacionpi. Chaymanta, ama sapallapi hapipakuychu llamkanakunaykipaq hoverllamkanakuna hina llamkanakunaykipaq, imaynachus kay yanapakuyniykikuna mana atikuq llamkanakuna teclado ruwaqkunapaq ruwanqa.

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

Mana atiq elementokuna

Atributoyuq elementokuna disabledmana interactivochu kanku, niyta munan llamk'aqkuna mana enfoqueta, hover utaq ñit'iyta atinkuchu huk yanapakuypa (utaq popover) llamk'achinapaq. Huk allichay hina, huk p'istumanta yanapakuypa yuyaychayninta llamk'achiyta munanki <div>utaq <span>, allin ruwasqa teclado-enfocable kaqwan llamk'achispa 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>

Akllanakuna

Akllanakuna willay layakuna utaq JavaScript kaqnintakama pasayta atikun. Willayta layakunapaq, akllana sutita yapay data-bs-, imaynachus data-bs-animation="". Aswan allinta qhaway akllana sutipa caso laya camelCase kaqmanta kebab-case kaqman tikrayta mayk'aq akllanakunata willay atributokuna kaqninta pasanki. Ejemplopaq data-bs-customClass="beautifier", utilizanaykimantaqa data-bs-custom-class="beautifier".

Reparay, harkasqa razonkunarayku sanitize, sanitizeFn, chaymanta allowListakllanakuna mana willay layakuna llamk'achispa quyta atikunkuchu.
Suti Niraq Ñawpaqchasqa Willay
animation boolean nisqa true Huk CSS chinkachiy tikrayta yanapakuypa yanapakuyninman churay
container q'aytu | elemento | pantasqa false

Huk elemento específico kaqman yanapakuypa yuyaychayninta yapan. Ejemplo: container: 'body'. Kay akllana aswan allin kan kaypi llamkanakunap willayninta qillqap puriyninpi churayta atikunki llamk'achiq elemento qayllapi - mayqinchus hark'anqa yanapakuypa yuyaychayninta llamk'achiq elementomanta karuman phawaykachayta huk ventana sayayninta tikraypi.

delay yupay | ima 0

Tardanza rikuchiy chaymanta pakay yanapakuypa yuyaychayninta (ms) - mana makiwan gatillo layapaqchu ruwakun

Sichus huk yupay qusqa, tardiy iskaynin pakay/rikuchiypi churasqa

Imakunap rurasqanqa kaymi:delay: { "show": 500, "hide": 100 }

html boolean nisqa false

HTML nisqa yanapakuypa yanapakuyninpi saqiy.

Chiqap kaptinqa, yanapakuypa yanapakuyninpi HTML etiquetakuna yanapakuypa yanapakuyninpi titleruwasqa kanqa. Pantasqa kaptinqa, innerTextpropiedad llamk'achisqa kanqa DOM kaqman willayta churanapaq.

Qillqata llamk'achiy sichus XSS ataquekunamanta llakisqa kanki.

placement q'aytu | ruway 'top'

Imaynatataq yanapakuypa yuyaychayninta churana - auto | patamanta | urayninpi | lluq'i | paña.
Mayk'aq autowillasqa kachkan, chaymanta llamkanakunap yuyaychayninta dinamicamente musuqmanta pusanqa.

Huk llamkana churayta riqsinapaq llamk'achisqa kaqtinqa, llamkanakunap umalliqnin DOM nodowan ñawpaq argumenton hina chaymanta elemento desencadenante DOM nodo iskay kaq hina waqyasqa. Contexto thisnisqaqa yanapakuypa instancianmanmi churasqa kachkan.

selector q'aytu | pantasqa false Sichus huk akllana qusqa, yanapakuypa yanapakuynin imakuna kamachisqa metakunaman qusqa kanqa. Ruwaypi, kayqa llamk'achisqataqmi yanapakuypa yanapakuyninkunata DOM elementokuna dinamicamente yapasqakunaman ( jQuery.onyanapakuy) churanapaq. Kayta hinaspa huk willakuypaq ejemplota qaway .
template qaytu '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'

HTML nisqapi llamk'anapaq llamkanakunap yuyaychayninta ruwachkaspa llamk'achiy.

Chay herramientapa puntanmi titleinyectasqa kanqa chay .tooltip-inner.

.tooltip-arrowchay herramientakunaq flechanmanmi tukupunqa.

Aswan hawa p'istu elementoqa .tooltipclase nisqayuqmi kanan chaymanta role="tooltip".

title q'aytu | elemento | ruway ''

Ñawpaqmanta churasqa titulu chani sichus titlelaya mana kanchu.

Sichus huk llamk'ana qusqa, waqyasqa kanqa thisreferencia churasqanwan chay elementoman mayqinmanchus llamkanakuna k'askasqa kachkan.

trigger qaytu 'hover focus'

Imayna yanapakuypa yuyaychaynin qallarikun - | ñit'iy hover | enfoque | makiwan. Achka gatillokunatam pasawaq; chaykunata huk ch’usaqwan t’aqay.

'manual'.show()rikuchin chay yanapakuypa yanapakuynin programaticamente , .hide()chaymanta .toggle()métodos kaqnintakama llamk'achisqa kananta ; kay chaniqa manam huk llamk'achiqwan kuskanchasqachu kanman.

'hover'sapallanmanta yanapakuypa yanapakuyninkunata ruwanqa mana teclado kaqnintakama llamk'achiyta atikunmanchu, chaymanta llamk'achinan tiyan sichus huk ñankuna kikin willayta teclado kaqmanta ruwaqkunapaq apachiypaq kanku.

fallbackPlacements matriz ['top', 'right', 'bottom', 'left'] Fallback churanakunata riqsichiy huk lista churanakuna matrizpi quspa (munasqa ordenpi). Aswan willakuypaq Popperpa comportamiento docs nisqapi qhaway
boundary q'aytu | imakuna 'clippingParents' Llamkanakunap yanapakuyninpa desbordamiento harkayninpa linderon (Popperpa preventOverflow tikraqninllapaqmi). Ñawpaqmanta 'clippingParents'huk HTMLElement willayta chaskiyta atin chaymanta (JavaScript kaqlla kaqnintakama). Aswan willakuypaq qhaway Popperpa detectOverflow qillqakuna .
customClass q'aytu | ruway ''

Yanapakuypa yanapakuyninman clasekunata yapay rikuchisqa kaptin. Reparay kay clasekuna yapasqa kanqa ima clasekuna plantillapi nisqamanta yapasqa. Achka clasekunata yapanaykipaqqa, ch'usaqkunawan t'aqay: 'class-1 class-2'.

Huk llamk'aytapas pasayta atinki, chaytaq huk watiqallata kutichinan tiyan, yapa clase sutikunayuq.

sanitize boolean nisqa true Saneamiento nisqa ruwayta atichiy utaq mana llamk’achiy. Si activado 'template'y 'title'opciones se sanitizarán. JavaScript qillqaykupi desinfectante t'aqapi qhaway .
allowList ima Ñawpaqmanta churasqa chani Objeto que contiene atributos permitidos y etiquetas
sanitizeFn nullq | ruway null Kaypiqa qam kikiykipa desinfectar función nisqatam suministrawaq. Kayqa allin kanman sichus huk dedicada biblioteca llamk’ayta munanki saneamiento ruwanapaq.
offset matriz | q'aytu | ruway [0, 0]

Desplazamiento de la punta de herramientas relativamente a su meta. Huk watiqata willay layakunapi chikuwan t'aqasqa chanikunawan kayhinata pasayta atinki:data-bs-offset="10,20"

Huk llamk'ayta offset nisqa riqsinapaq llamk'achisqa kaqtinqa, huk imayaywanmi waqyakun, chaypiqa popper churana, referencia, popper rects nisqakuna ñawpaq argumenton hina. Chay elemento desencadenante DOM nodo iskay kaq argumento hina pasakun. Rurayqa iskay yupayniyuq matriztam kutichinan: .[skidding, distance]

Aswan willakuypaq qhaway Popperpa offset docs .

popperConfig nullq | objeto | ruway null

Bootstrap kaqpa ñawpaqmanta Popper wakichiyninta tikranaykipaq, qhaway Popperpa wakichiyninta .

Huk ruwana Popper ruwana ruwanapaq llamk'achisqa kaqtin, huk imayaywan waqyasqa mayqinchus Bootstrap ñawpaqmanta Popper ruwanayuq kachkan. Yanapasunki llamk'achiyta chaymanta hukllanapaq ñawpaqmanta ruwasqa kikin ruwanaykiwan. Ruwayqa Popperpaq huk wakichiy imayayta kutichinan tiyan.

Sapanchasqa yanapakuykunapaq willakuypa layakuna

Sapanchasqa yanapakuypa yanapakuyninkunapaq akllanakuna hukmanta willaypa layakuna llamk'achiyninwan willayta atikunku, ñawpaqpi sut'inchasqa hina.

Utilizar función conpopperConfig

var tooltip = new bootstrap.Tooltip(element, {
  popperConfig: function (defaultBsPopperConfig) {
    // var newPopperConfig = {...}
    // use defaultBsPopperConfig if needed...
    // return newPopperConfig
  }
})

Métodos

Métodos y transiciones asíncronas

Llapan API ruwanakuna mana sink'uyuq kanku chaymanta huk tikrayta qallarinku . Paykunaqa kutinku waqyaqman chaylla transición qallarisqa ichaqa manaraq tukukuchkaptin . Chaymantapas, huk tikray componente kaqpi huk método waqyay mana qhawasqachu kanqa .

Aswan willakuypaq JavaScript qillqaykuta qhaway .

qawachiy

Huk elementopa yanapakuypa yuyaychaynintam qawachin. Llamaqman kutimun manaraq yanapakuypa yanapakuy chiqap rikuchisqa kachkaptin (icha manaraq shown.bs.tooltipruway ruwakuchkaptin). Kayqa huk “manual” llamk’anapaq yanapakuypa llamk’aynin hina qhawasqa. Cero sayayniyuq tituluyuq llamkanakunap yuyaychayninkunaqa manam hayk'appas rikuchisqachu.

tooltip.show()

pakay

Huk elementopa yanapakuypa yuyaychayninta pakan. Llamaqman kutimun manaraq yanapakuypa yuyaychaynin chiqamanta pakasqa kachkaptin (icha manaraq hidden.bs.tooltipruway ruwakuchkaptin). Kayqa huk “manual” llamk’anapaq yanapakuypa llamk’aynin hina qhawasqa.

tooltip.hide()

toggle nisqa

Huk elementopa yanapakuypa yuyaychaynintam tikran. Llamaqman kutimun manaraq yanapakuypa yuyaychaynin chiqamanta rikuchisqa utaq pakasqa kachkaptin (icha manaraq shown.bs.tooltiputaq hidden.bs.tooltipruway ruwakuchkaptin). Kayqa huk “manual” llamk’anapaq yanapakuypa llamk’aynin hina qhawasqa.

tooltip.toggle()

wischuy

Huk elementopa yanapakuypa yuyaychayninta pakan hinaspa chinkachin (DOM elementopi waqaychasqa willakuykunata hurqun). Delegacionta llamk'achiq yanapakuykuna ( kay selectorakllanawan ruwasqa ) mana sapalla chinkachiyta atikunmanchu miray llamk'achiq elementokunapi.

tooltip.dispose()

kawsarichisqa

Huk elementopa yanapakuypa yanapakuyninman qawachinapaq atiyta qun. Llamkanakuna yuyaychaykuna ñawpaqmanta atichisqa kachkan.

tooltip.enable()

wañuchisqa

Huk elementopa yanapakuypa yuyaychayninta qawachinapaq atiyta hurqun. Llamkanakunap yuyaychayninqa musuqmanta atichisqa kaptinllam rikuchiyta atikunqa.

tooltip.disable()

toggleAtichisqa

Huk elementopa yanapakuypa yuyaychayninta qawachinapaq utaq pakasqa kananpaq atiynintam tikran.

tooltip.toggleEnabled()

kunanyachiy

Huk elementopa yanapakuypa yanapakuyninpa maypi kayninta musuqchan.

tooltip.update()

GetInstancia

Método estático mayqinchus huk DOM elementowan tinkisqa yanapakuypa instancian chaskiyta atikun

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

Instanciata tariyUtaq Ruway

Método estático mayqinchus huk DOM elementowan tinkisqa yanapakuypa instanciata hapiyta atikun, utaq musuq ruwayta sichus mana qallarisqachu karqa

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

Eventos nisqakuna

Tipo de evento Willay
show.bs.tooltip Kay ruwayqa chaylla rawrarin showinstancia método waqyasqa kaqtin.
shown.bs.tooltip Kay ruwayqa llamkanakuna llamk'achiqman rikukuq ruwasqa kaptin llamk'achisqa (CSS tikraykunata tukunanta suyanqa).
hide.bs.tooltip Kay ruwayqa chaylla llamk'achisqa kachkan mayk'aq hideinstancia método waqyasqa kachkan.
hidden.bs.tooltip Kay ruwayqa llamkanakuna llamk'achiqmanta pakasqa kayta tukuptin (CSS tikraykunata tukunanta suyanqa).
inserted.bs.tooltip Kay ruwayqa ruwaymanta qhipaman llamk'achisqa kachkan show.bs.tooltipmayk'aq plantilla yanapakuypa willaynin DOM kaqman yapasqa.
var myTooltipEl = document.getElementById('myTooltip')
var tooltip = new bootstrap.Tooltip(myTooltipEl)

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

tooltip.hide()