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'achiybootstrap.bundle.js
mayqinchus 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.
.disabled
icha elementokunapaq llamkanakuna huk p'istudisabled
elementopi 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.
prefers-reduced-motion
medios 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-toggle
atributonkuman 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 auto
yscroll
Tooltip posición kikinmanta tikrayta munan mayk'aq huk tayta waqaychana ñuqaykupaq overflow: auto
utaq overflow: scroll
hina .table-responsive
, ichaqa chaywanpas ñawpaq churaypa churayninta waqaychan. Kayta allichanapaq, boundary
akllanata 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 data
chaymanta title
HTML elementopi huk yanapakuypa yanapakuyniyuq kayta munanki. Huk yanapakuypa paqarichisqan markasqa aswan sasan, ichaqa huk posiciónta munan (ñawpaqmanta, top
plugin 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 hover
llamkanakuna 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 disabled
mana 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"
.
sanitize
,
sanitizeFn
, chaymanta
allowList
akllanakuna 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: |
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: |
html |
boolean nisqa | false |
HTML nisqa yanapakuypa yanapakuyninpi saqiy. Chiqap kaptinqa, yanapakuypa yanapakuyninpi HTML etiquetakuna yanapakuypa yanapakuyninpi Qillqata llamk'achiy sichus XSS ataquekunamanta llakisqa kanki. |
placement |
q'aytu | ruway | 'top' |
Imaynatataq yanapakuypa yuyaychayninta churana - auto | patamanta | urayninpi | lluq'i | paña. Huk llamkana churayta riqsinapaq llamk'achisqa kaqtinqa, llamkanakunap umalliqnin DOM nodowan ñawpaq argumenton hina chaymanta elemento desencadenante DOM nodo iskay kaq hina waqyasqa. Contexto |
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.on yanapakuy) 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
Aswan hawa p'istu elementoqa |
title |
q'aytu | elemento | ruway | '' |
Ñawpaqmanta churasqa titulu chani sichus Sichus huk llamk'ana qusqa, waqyasqa kanqa |
trigger |
qaytu | 'hover focus' |
Imayna yanapakuypa yuyaychaynin qallarikun - | ñit'iy hover | enfoque | makiwan. Achka gatillokunatam pasawaq; chaykunata huk ch’usaqwan t’aqay.
|
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: 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: 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: . 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 .
qawachiy
Huk elementopa yanapakuypa yuyaychaynintam qawachin. Llamaqman kutimun manaraq yanapakuypa yanapakuy chiqap rikuchisqa kachkaptin (icha manaraq shown.bs.tooltip
ruway 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.tooltip
ruway 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.tooltip
utaq hidden.bs.tooltip
ruway 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 selector
akllanawan 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 show instancia 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 hide instancia 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.tooltip mayk'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()