Ejupi contenido principal-pe Eike docs jeguatahápe
in English

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.jsoguerekó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 .disabledtérã disabledelemento-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.
Por defecto, ko componente oipuru desinfectante de contenido incorporado, oipeꞌavaꞌekue oimeraẽ elemento HTML ndojehejáiva explícitamente. Ehecha pe sección desinfectante ore kuatia JavaScript -pe reikuaave hag̃ua.
Pe efecto animación rehegua ko componente rehegua odepende pe prefers-reduced-motionconsulta 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-toggleatributo 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 autohascroll

Tembipuru’i ñemohendaha oñeha’ã oñemoambue ijeheguiete peteĩ mba’e’oka túva oguerekóramo térã overflow: autoogusta overflow: scrolljave ñande .table-responsive, ha katu oñongatu gueteri ñemohenda ypykue ñemohenda. Kóva oñemyatyrõ hag̃ua, emohenda boundaryopción (flip modificador-pe g̃uarã oipurúva popperConfigopció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ĩ dataatributo añoite ha titleelemento 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 topplugin 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 hoverne 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 disabledatributo 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".

Eñamindu’u seguridad rehehápe umi sanitize, sanitizeFn, ha allowListopció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ã: container: 'body'. Ko jeporavopyre ideprovéchoiterei ohejágui ndéve emohenda tembipuru’i ñe’ẽmondo kuatia osyryhápe elemento desencadenante ypýpe - ojokótava tembipuru’i ñe’ẽmondo ani hag̃ua oveve mombyry elemento desencadenante-gui peteĩ ventána tuichakue ñemoambue aja.

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: .delay: { "show": 500, "hide": 100 }

html booleano rehegua false

Eheja HTML tembipuru’i ñe’ẽmondope.

Añete ramo, umi etiqueta HTML oĩva tembipuru’i ñe’ẽmondope titleoñembohasáta tembipuru’i ñe’ẽmondope. Japúramo, innerTextojeporúta propiedad oñemoinge hag̃ua contenido DOM-pe.

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.
Ojeꞌe jave auto, oorienta jeýta dinámicamente tembipuru’i ñe’ẽmondo.

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 thiscontexto oñemohenda tembipuru’i ñe’ẽñemi instancia-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.onpytyvõ). Ehecha kóva ha peteĩ techapyrã informativo .
template '<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 titleoñeinyecta va'erã pe .tooltip-inner.

.tooltip-arrowoikóta chugui pe tembipuru’i flecha.

Pe elemento envoltura okápegua oguerekova'erã .tooltipclase ha role="tooltip".

title cadena rehegua | elemento | hembiapo ''

Título valor por defecto titleatributo ndaipóriramo.

Oñemeꞌeramo peteĩ función, oñehenóita thisirreferencia ñemohenda reheve pe elemento oñembojoajúvape tembipururã vore rehe.

trigger '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.

'manual'ohechauka tembipuru’i ñe’ẽmondo oñemboguatataha programáticamente .show(), .hide()ha umi .toggle()método rupive; ko mba’ekuaarã ndaikatúi oñembojoaju ambue mba’e’apoha ndive.

'hover'ijeheguiete osẽta tembipuru’i ñe’ẽmondo ndaikatúiva oñemboguata teclado rupive, ha ojepuruva’erã oĩramo añoite umi método alternativo oñembohasa hag̃ua peteĩchagua marandu teclado puruhárape g̃uarã.

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: 'class-1 class-2'.

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

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

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 .

Ehecha ore kuatiañe’ẽ JavaScript rehegua reikuaave hag̃ua .

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.tooltipmba’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.tooltipmba’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.tooltiptérã hidden.bs.tooltipmba’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 showmé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 hidemé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.tooltipmbaꞌ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()