Tembipururã ñe’ẽmondo
Kuatiahaipyre ha techapyrã oñembojoapy hag̃ua tembipururã Bootstrap jeporupyre CSS ha JavaScript ndive ojeporúvo CSS3 taꞌãngamýi ha data-bs-atributo-pe g̃uarã título ñeñongatuha tendápe g̃uarã.
Tembiecharã
Mba’e ojekuaava’erã ojepuru jave tembipuru’i ñemohendaha:
- Umi tembipuru’i ñe’ẽmondo ojerovia 3er parte biblioteca Popper rehe oñemohenda hag̃ua. Emoinge va’erã popper.min.js bootstrap.js mboyve térã eipuru
bootstrap.bundle.min.js
/bootstrap.bundle.js
oguerekóva Popper ikatu hag̃uáicha tembiaporã ñe’ẽmondo omba’apo! - Tembipuru’i ñe’ẽmondo ha’e opt-in rendimiento rehegua, upévare ndete voi remoñepyrũva’erã .
- Umi tembipuru’i ñe’ẽmondo oguerekóva título ipukukue cero araka’eve ndojehechaukái.
- Emombeꞌu
container: 'body'
ani hag̃ua ojejapo apañuãi renderización rehegua umi componente ikomplikadovévape (ñande aty jeikerãicha, aty botón rehegua, ha mbaꞌe). - Oñemboguata hag̃ua tembipuru’i ñe’ẽmondo umi elemento kañymby rehe ndoikomo’ãi.
- Umi tembipururã ñe’ẽmondo
.disabled
térãdisabled
elemento-kuérape g̃uarã oñembohapeva’erã peteĩ elemento envoltura rehegua. - Oñemboguata jave umi hipervínculo-gui oñemosarambíva heta línea rehe, umi tembipuru’i ñe’ẽmondo oñembohapéta. Eipuru
white-space: nowrap;
nde<a>
s ári ani hagua oiko ko jepokuaa. - Umi tembipuru’i ñe’ẽmondo oñeñomiva’erã ojeipe’a mboyve DOM-gui umi elemento okorrespondéva.
- Umi tembipuru’i ñe’ẽmondo ikatu oñemboguata peteĩ elemento rupive peteĩ DOM sombra ryepýpe.
prefers-reduced-motion
consulta medio rehegua rehe. Ehecha pe
sección movimiento reducido ore kuatia accesibilidad rehegua .
¿Reguerekópa opa umíva? Tuicha mba'e, jahecha mba'éichapa omba'apo hikuái algunos ejemplos reheve.
Techapyrã: Emboguata tembipuru’i ñe’ẽmondo oparupiete
Peteĩ tape oñemboguapy hag̃ua opaite tembipuru’i ñe’ẽmondo peteĩ páhinape ha’éta ojeporavo hag̃ua data-bs-toggle
atributo rupive:
var tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
var tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) {
return new bootstrap.Tooltip(tooltipTriggerEl)
})
Tembiecharã
Emoĩ nde po umi enlace oĩva ko’ápe rehecha hag̃ua tembipuru’i ñe’ẽmondo:
Jehaipyre tenda’i rehegua ohechauka hag̃ua peteĩva joajuha línea ryepýpe tembipuru’i ñe’ẽmondo reheve. Kóva ko'ágã relleno-nte, ndaipóri asesino. Contenido oñemoĩva koʼápe oimitá hag̃uánte pe téxto añetegua oĩha . Ha opa umíva ome’ẽ haĝuánte ndéve peteĩ temiandu mba’éichapa ojehecháta umi tembipuru’i ñe’ẽmondo ojeporúramo umi situación mundo real-pe. Upévare oimeva’erã ko’áĝa rehecha mba’éichapa ko’ã tembipuru’i ñe’ẽmondo enlace-pe ikatu omba’apo práctica-pe, reipuru rire nde sitio térã proyecto-pe.
Emoinge nde po umi botón iguýpe rehecha hag̃ua irundy tembipuru’i ñe’ẽmondo: yvate, akatúa, iguy ha asu gotyo. Umi dirección ojehechauka espejo-pe ojepuru jave Bootstrap RTL-pe.
<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>
Ha HTML jeporupyre reheve oñembojoapy:
<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>
Peteĩ SVG reheve:
Sass rehegua
Variables rehegua
$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;
Jeporu rehegua
Pe tembipuru’i ñemohendaha omoheñói contenido ha marcado ojejerurévo, ha por defecto omoĩ tembipuru’i ñe’ẽmondo elemento desencadenante rire.
Emoñepyrũ tembipuru’i ñe’ẽmondo JavaScript rupive:
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, options)
Desbordamiento auto
hascroll
Tembipuru’i ñemohendaha oñeha’ã oñemoambue ijeheguiete peteĩ mba’e’oka túva oguerekóramo térã overflow: auto
ogusta overflow: scroll
jave ñande .table-responsive
, ha katu oñongatu gueteri ñemohenda ypykue ñemohenda. Kóva oñemyatyrõ hag̃ua, emohenda boundary
opción (flip modificador-pe g̃uarã oipurúva popperConfig
opción) oimeraẽ HTMLElement-pe omboyke hag̃ua valor por defecto, 'clippingParents'
, haꞌeháicha document.body
:
var exampleEl = document.getElementById('example')
var tooltip = new bootstrap.Tooltip(exampleEl, {
boundary: document.body // or document.querySelector('#boundary')
})
Marcado rehegua
Pe marcado oñeikotevẽva peteĩ tembipuru’i ñe’ẽmondope g̃uarã ha’e peteĩ data
atributo añoite ha title
elemento HTML rehe reguerekoséva peteĩ tembipuru’i ñe’ẽmondo. Pe marcado oñembohekopyréva peteĩ tembipuru’i ñe’ẽmondo rehegua isãsove, jepémo oikotevẽ peteĩ tenda (por defecto, oñemohenda top
plugin rupive).
Ojejapo hag̃ua tembipuru’i ñe’ẽmondo omba’apo hag̃ua teclado ha tecnología pytyvõhára puruhárape g̃uarã
Emoĩva’erã tembipuru’i ñe’ẽmondo añoite umi elemento HTML-pe, ymaite guive oñembohapéva teclado-pe ha oñembojoajúva (ha’eháicha joajuha térã formulario control). Jepémo umi elemento HTML arbitrario ( <span>
s-icha) ikatu ojejapo enfoque oñembojoapývo tabindex="0"
atributo, kóva omoĩta umi ficha jejopy potencialmente molesto ha confuso umi elemento ndahaꞌeiva interactivo rehe umi teclado puruhárape g̃uarã, ha hetavéva tecnología oipytyvõva koꞌág̃aite nomoherakuãi tembipururã ñeꞌeñemi ko situación-pe. Avei, ani rejerovia hese añoite hover
ne tembipuru’i ñe’ẽmondo ñepyrũrã ramo, kóva ojapótagui ne tembipuru’i ñe’ẽmondo ndaikatumo’ãiha oñembohape teclado puruhárape g̃uarã.
<!-- 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>
Umi elemento oñemboykéva
Umi elemento oguerekóva disabled
atributo ndaha’éi interactivo, he’iséva umi puruhára ndaikatuiha oñecentra, ojepyso térã ojepyso hesekuéra omoñepyrũ hag̃ua peteĩ tembipuru’i ñe’ẽmondo (térã popover). Peteĩ tembiaporãicha, emoñepyrũse tembipuru’i ñe’ẽmondo peteĩ envoltura-gui <div>
térã <span>
, iporãvéva ojejapo teclado-pe oñembohapéva ojeporúvo 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>
Opciones rehegua
Umi opción ikatu oñembohasa atributo de datos térã JavaScript rupive. Umi atributo dato rehegua, emoĩ opción réra data-bs-
, -peguáicha data-bs-animation=""
. Ejesareko emoambue hag̃ua káso tipo opción réra camelCase-gui kebab-case-pe embohasávo umi opción atributo de datos rupive. Techapyrã, eipuru rangue data-bs-customClass="beautifier"
, eipuru data-bs-custom-class="beautifier"
.
sanitize
,
sanitizeFn
, ha
allowList
opción ndaikatúi oñeme’ẽ ojeporúvo umi atributo dato rehegua.
Téra | Hesegua | Upevakuére | Techaukaha |
---|---|---|---|
animation |
booleano rehegua | true |
Emoĩ peteĩ CSS ñemboguejy ñembohasa tembipuru’i ñe’ẽmondope |
container |
cadena rehegua | elemento | japu | false |
Ombojoaju tembipuru’i ñe’ẽmondo peteĩ elemento específico-pe. Tembiecharã: |
delay |
papapy | mba'e | 0 |
Retraso ojehechauka ha oñeñomi hag̃ua tembipuru’i ñe’ẽmondo (ms) - ndojeporúi tipo de disparo manual-pe Oñeme’ẽramo peteĩ papapy, ojejapo retardo mokõivévape kañy/jehechauka Objeto estructura ha’e: . |
html |
booleano rehegua | false |
Eheja HTML tembipuru’i ñe’ẽmondope. Añete ramo, umi etiqueta HTML oĩva tembipuru’i ñe’ẽmondope Eipuru jehaipyre rejepy’apýramo umi ataque XSS rehe. |
placement |
cadena rehegua | hembiapo | 'top' |
Mba'éichapa ikatu ñamohenda tembipuru'i ñe'ẽmondo - auto | yvate | yvy gotyo | izquierda | akatúa. Ojepuru jave peteĩ tembiaporã ojekuaa hag̃ua ñemohenda, oñehenói tembipururã vore DOM nodo peteĩha argumento ramo ha elemento disparador nodo DOM mokõiha ramo. Pe |
selector |
cadena rehegua | japu | false |
Oñeme’ẽramo peteĩ jeporavoha, umi mba’e’oka tembipuru’i ñe’ẽmondo rehegua oñeme’ẽta umi mba’e’oka oje’évape. En práctica, kóva ojepuru ojeporu hag̃ua avei tembipururã ñeꞌepykuaa umi elemento DOM oñembojoapýva dinámicamente ( jQuery.on pytyvõ). Ehecha kóva ha peteĩ techapyrã informativo . |
template |
sã | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Base HTML ojepuru hag̃ua ojejapo jave tembipuru’i ñe’ẽmondo. Pe tembipuru'i
Pe elemento envoltura okápegua oguerekova'erã |
title |
cadena rehegua | elemento | hembiapo | '' |
Título valor por defecto Oñemeꞌeramo peteĩ función, oñehenóita |
trigger |
sã | 'hover focus' |
Mba’éichapa oñemboguata tembipuru’i ñe’ẽmondo - eity | hover rehegua | enfoque | popeguáva. Ikatu rembohasa heta disparador; omboja’o chupekuéra peteĩ espacio reheve.
|
fallbackPlacements |
matriz rehegua | ['top', 'right', 'bottom', 'left'] |
Emohenda umi ñemohenda jere rehegua eme’ẽvo peteĩ lista ñemohenda rehegua matriz-pe (orden de preferencia-pe). Ojeikuaave hag̃ua ehecha Popper rekoha docs |
boundary |
cadena rehegua | mba'e rehegua | 'clippingParents' |
Límite restricción de desbordamiento rehegua tembipuru’i ñe’ẽmondo rehegua (ojeporu Popper preventOverflow modificador-pe añoite). Por defecto ha’e 'clippingParents' ha ikatu omoneĩ peteĩ HTMLElement ñe’ẽmondo (JavaScript rupive añoite). Ojeikuaave hag̃ua ehecha Popper detectOverflow docs . |
customClass |
cadena rehegua | hembiapo | '' |
Emoĩ mbo’esyry tembipuru’i ñe’ẽmondope ojehechauka jave. Ñañamindu’u ko’ã mbo’esyry oñembojoapýta oimeraẽ mbo’esyry oje’éva plantilla-pe ári. Oñemoĩ hag̃ua heta mbo’esyry, ojesepara va’erã espacio reheve: Ikatu avei embohasa peteĩ tembiaporã ombojevyvaꞌerãva peteĩ cadena añoite oguerekóva mboꞌepy réra ambuéva. |
sanitize |
booleano rehegua | true |
Emboguata térã embogue pe saneamiento. Ojeactiva ramo 'template' ha 'title' opciones oñesanifika va'erã. Ehecha pe sección desinfectante ore kuatiañe’ẽ JavaScript-pe . |
allowList |
mba'e | Valor por defecto rehegua | Objeto oguerekóva atributo ha etiqueta ojehejáva |
sanitizeFn |
nulo rehegua | hembiapo | null |
Ko'ápe ikatu reabastece nde función de desinfectación nde propia. Kóva ikatu ideprovécho reiporusevéramo peteĩ biblioteca dedicada rejapo hag̃ua desinfecto. |
offset |
matriz | cadena rehegua | hembiapo | [0, 0] |
Desplazamiento tembipuru’i ñe’ẽmondo rehegua iñemohendapyre rehegua. Ikatu embohasa peteĩ cadena umi atributo dato rehegua orekóva valor ojeseparáva coma-gui haꞌeháicha: Ojepuru jave peteĩ función ojekuaa hag̃ua desplazamiento, oñehenói peteĩ mbaꞌe reheve oguerekóva popper ñemohenda, referencia ha popper rects peteĩha argumento ramo. Pe elemento desencadenante nodo DOM oñembohasa mokõiha argumento ramo. Pe función ombojevyvaꞌerã peteĩ matriz oguerekóva mokõi papapy: . Ojeikuaave hag̃ua ehecha Popper offset docs . |
popperConfig |
nulo rehegua | mba'e | hembiapo | null |
Oñemoambue hag̃ua Bootstrap Popper ñemboheko tee, ehecha Popper ñemboheko . Ojepuru jave peteĩ tembiaporã ojejapo hag̃ua Popper ñemboheko, oñehenói peteĩ mbaꞌe reheve oguerekóva Bootstrap Popper ñemboheko tee. Oipytyvõ eipuru ha embojoaju hag̃ua pe ñepyrũrã ne ñemboheko tee ndive. Pe tembiaporã ombojevyva’erã peteĩ mba’e’oka configuración rehegua Popper-pe g̃uarã. |
Umi atributo dato rehegua tembipuru’i peteĩteĩvape g̃uarã
Umi opción tembipuru’i peteĩteĩvape g̃uarã ikatu alternativamente oñemboheko umi atributo dato rehegua jepuru rupive, oñemyesakã haguéicha yvateve.
Oipurúvo función orekóvapopperConfig
var tooltip = new bootstrap.Tooltip(element, {
popperConfig: function (defaultBsPopperConfig) {
// var newPopperConfig = {...}
// use defaultBsPopperConfig if needed...
// return newPopperConfig
}
})
Método-kuéra rehegua
Método ha transición asíncrono rehegua
Opaite API rembiaporã haꞌehína asíncrono ha oñepyrũ peteĩ jehasapa . Ojevy hikuái ohenóivape oñepyrũvove pe transición ha katu opa mboyve . Avei, oñemboykéta peteĩ ñehenói método rehegua peteĩ componente oñembohasáva rehe .
hechauka
Oikuaauka peteĩ elemento tembipururã ñe’ẽmondo. Ojevy ohenóivape ojehechauka mboyve añetehápe tembipuru’i ñe’ẽmondo (he’iséva oiko mboyve pe shown.bs.tooltip
mba’e ojehúva). Kóva ojehecha peteĩ “manual” disparo herramienta rehegua. Umi tembipuru’i ñe’ẽmondo oguerekóva título ipukukue cero araka’eve ndojehechaukái.
tooltip.show()
mongañy
Oñomi peteĩ elemento tembipuru’i ñe’ẽmondo. Ojevy ohenóivape oñeñomi mboyve añetehápe tembipuru’i ñe’ẽmondo (he’iséva oiko mboyve pe hidden.bs.tooltip
mba’e ojehúva). Kóva ojehecha peteĩ “manual” disparo herramienta rehegua.
tooltip.hide()
toggle rehegua
Ombohasa peteĩ elemento tembipuru’i ñe’ẽmondo. Ojevy ohenóivape ojehechauka térã oñeñomi mboyve añetehápe tembipuru’i ñe’ẽmondo (he’iséva oiko mboyve shown.bs.tooltip
térã hidden.bs.tooltip
mba’e’oka). Kóva ojehecha peteĩ “manual” disparo herramienta rehegua.
tooltip.toggle()
omboyke haguã
Oñomi ha ohundi peteĩ elemento tembipururã ñeꞌepykuaa (Oipeꞌa umi dato oñeñongatúva elemento DOM-pe). Umi tembipuru’i oipurúva delegación (ojejapóva ojeporúvo opciónselector
) ndaikatúi oñehundi peteĩteĩ umi elemento disparador ñemoñare rehe .
tooltip.dispose()
mbopu'aka
Omeꞌe peteĩ elemento tembipururã vore ikatuha ojehechauka hag̃ua. Tembipururã ñe’ẽmondo oñembohapéva ñepyrũrãme.
tooltip.enable()
mbogue
Oipeꞌa mbaꞌekuaarã peteĩ elemento tembipururã vore ojehechauka hag̃ua. Tembipuru’i ñe’ẽmondo ikatúta ojehechauka oñembohapéramo añoite.
tooltip.disable()
toggleOjejapokuaa
Ombohasa mbaꞌekuaarã peteĩ elemento tembipuru’i ñe’ẽmondo ojehechauka térã oñeñomi hag̃ua.
tooltip.toggleEnabled()
mbopyahu
Ombopyahu peteĩ elemento tembipuru’i ñemohendaha.
tooltip.update()
ohupytyInstancia
Método estático ohejáva ndéve rehupyty hag̃ua instancia tembipuru’i rehegua ojoajúva peteĩ elemento DOM rehe
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
ohupytyTérãEjapoInstancia
Método estático ohejáva ndéve rehupyty hag̃ua tembipuru’i ñe’ẽmondo instancia ojoajúva peteĩ elemento DOM ndive, térã emoheñói peteĩ pyahu oiméramo noñemoñepyrũi
var exampleTriggerEl = document.getElementById('example')
var tooltip = bootstrap.Tooltip.getOrCreateInstance(exampleTriggerEl) // Returns a Bootstrap tooltip instance
Umi mba’e oikóva
Tipo de evento rehegua | Techaukaha |
---|---|
show.bs.tooltip |
Ko mbaꞌe ojehúva oñembopu pyaꞌe oñehenói jave show método instancia rehegua. |
shown.bs.tooltip |
Ko mba’e’oka oñembogue ojejapo rire tembipuru’i ñemboheko ojehecha hag̃ua puruhárape (oha’arõta CSS jehaipyre oñembotývo). |
hide.bs.tooltip |
Ko mbaꞌe ojehúva oñembogue pyaꞌe oñehenói rire pe hide método instancia rehegua. |
hidden.bs.tooltip |
Ko mba’e ojehúva oñembogue oñemokañypa rire tembipuru’i ñe’ẽmondo puruháragui (oha’arõta CSS jehaipyre oñembotývo). |
inserted.bs.tooltip |
Ko mbaꞌe ojehúva oñembogue pe show.bs.tooltip mbaꞌe ojehúva rire oñembojoapy rire tembipururã ñemohendaha DOM-pe. |
var myTooltipEl = document.getElementById('myTooltip')
var tooltip = new bootstrap.Tooltip(myTooltipEl)
myTooltipEl.addEventListener('hidden.bs.tooltip', function () {
// do something...
})
tooltip.hide()