Verkfæraráð

Skjöl og dæmi til að bæta við sérsniðnum Bootstrap verkfæraleiðbeiningum með CSS og JavaScript með því að nota CSS3 fyrir hreyfimyndir og gagnaeiginleika fyrir staðbundna titlageymslu.

Yfirlit

Hlutir sem þarf að vita þegar þú notar tooltip viðbótina:

• Verkfæraráð treysta á þriðja aðila bókasafnið Popper.js fyrir staðsetningu. Þú verður að hafa popper.min.js fyrir bootstrap.js eða nota bootstrap.bundle.min.js/ bootstrap.bundle.jssem inniheldur Popper.js til að verkfæraábendingar virki!
• Ef þú ert að byggja JavaScript okkar frá uppruna, krefstutil.js það .
• Verkfæraráð eru valin af frammistöðuástæðum, svo þú verður að frumstilla þær sjálfur .
• Verkfæraleiðbeiningar með núlllengdar titlum birtast aldrei.
• Tilgreindu container: 'body'til að forðast að skila vandamálum í flóknari hlutum (eins og inntakshópum okkar, hnappahópum osfrv.).
• Það virkar ekki að kveikja á ábendingum um falda þætti.
• Verkfæraleiðbeiningar fyrir .disabledeða disabledþætti verða að vera virkjaðar á umbúðaeiningu.
• Þegar kveikt er á tenglum sem spanna margar línur verða verkfæraábendingar miðaðar. Notaðu white-space: nowrap;á þinn <a>s til að forðast þessa hegðun.
• Ábendingar verða að vera falin áður en samsvarandi þættir þeirra hafa verið fjarlægðir úr DOM.
• Hægt er að kveikja á verkfærum þökk sé frumefni inni í skugga DOM.

Áttu allt það? Frábært, við skulum sjá hvernig þeir virka með nokkrum dæmum.

Dæmi: Virkjaðu verkfæraábendingar alls staðar

Ein leið til að frumstilla allar verkfæraábendingar á síðu væri að velja þær eftir data-toggleeiginleikum þeirra:

$(function () {
  $('[data-toggle="tooltip"]').tooltip()
})

Dæmi

Farðu yfir tenglana hér að neðan til að sjá verkfæraleiðbeiningar:

Færðu bendilinn yfir hnappana hér að neðan til að sjá fjórar leiðbeiningar á tólum: efst, hægri, neðst og til vinstri.

<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="top" title="Tooltip on top">
  Tooltip on top
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="right" title="Tooltip on right">
  Tooltip on right
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="bottom" title="Tooltip on bottom">
  Tooltip on bottom
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="left" title="Tooltip on left">
  Tooltip on left
</button>

Og með sérsniðnum HTML bætt við:

<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-html="true" title="<em>Tooltip</em> <u>with</u> <b>HTML</b>">
  Tooltip with HTML
</button>

Notkun

The tooltip tappi býr til efni og álagningu á eftirspurn og setur sjálfgefið verkfæraábendingar á eftir kveikjuhlutanum.

Kveiktu á tóli í gegnum JavaScript:

$('#example').tooltip(options)

$('#example').tooltip({ boundary: 'window' })

Markup

Nauðsynleg merking fyrir verkfæraleiðbeiningar er aðeins dataeiginleiki og titleá HTML-einingunni viltu hafa verkfæraleiðbeiningar. Mynduð merking tækjaráðs er frekar einföld, þó hún krefjist stöðu (sjálfgefið, stillt á topaf viðbótinni).

<!-- HTML to write -->
<a href="#" data-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="arrow"></div>
  <div class="tooltip-inner">
    Some tooltip text!
  </div>
</div>

Óvirkir þættir

Þættir með disabledeigindinni eru ekki gagnvirkir, sem þýðir að notendur geta ekki einbeitt sér, sveiflað eða smellt á þá til að kveikja á tóli (eða sprettiglugga). Sem lausn, þú vilt kveikja á tóli frá umbúðum <div>eða <span>, helst gert lyklaborðsfókus með því að nota tabindex="0", og hnekkja pointer-eventsá óvirka þættinum.

<span class="d-inline-block" tabindex="0" data-toggle="tooltip" title="Disabled tooltip">
  <button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>

Valmöguleikar

Hægt er að senda valkosti í gegnum gagnaeiginleika eða JavaScript. Fyrir gagnaeiginleika skaltu bæta heiti valkostsins við data-, eins og í data-animation="".

Aðferðir

$().tooltip(options)

Festir verkfæraleiðbeiningar við einingarsafn.

.tooltip('show')

Sýnir verkfæraábendingu frumefnis. Snýr aftur til þess sem hringir áður en verkfæraráðið hefur verið sýnt (þ.e. áður en shown.bs.tooltipatburðurinn á sér stað). Þetta er talið „handvirk“ kveikja á tólabendingunni. Verkfæraleiðbeiningar með núll-lengd titlum birtast aldrei.

$('#element').tooltip('show')

.tooltip('hide')

Felur ábendingu frumefnis. Snýr aftur til þess sem hringir áður en verkfæraráðið hefur verið falið (þ.e. áður en hidden.bs.tooltipatburðurinn á sér stað). Þetta er talið „handvirk“ kveikja á tólabendingunni.

$('#element').tooltip('hide')

.tooltip('toggle')

Breytir ábendingum frumefnis. Snýr aftur til þess sem hringir áður en verkfæraábendingin hefur verið sýnd eða falin (þ.e. áður en atburðurinn shown.bs.tooltipeða hidden.bs.tooltipá sér stað). Þetta er talið „handvirk“ kveikja á tólabendingunni.

$('#element').tooltip('toggle')

.tooltip('dispose')

Felur og eyðileggur verkfæraábendingu frumefnis. Verkfæraábendingar sem nota úthlutun (sem eru búnar til með valmöguleikanum selector) er ekki hægt að eyða fyrir sig á afkvæma kveikjuþáttum.

$('#element').tooltip('dispose')

.tooltip('enable')

Gefur verkfæri frumefnis möguleika á að vera sýndur. Verkfæraleiðbeiningar eru sjálfgefnar virkar.

$('#element').tooltip('enable')

.tooltip('disable')

Fjarlægir möguleikann á að sýna ábendingu frumefnis. Aðeins er hægt að sýna verkfæraráðið ef það er virkjað aftur.

$('#element').tooltip('disable')

.tooltip('toggleEnabled')

Skiptir um möguleikann á því að sýna eða fela verkfæraleiðbeiningar þáttar.

$('#element').tooltip('toggleEnabled')

.tooltip('update')

Uppfærir staðsetningu ábendinga frumefnis.

$('#element').tooltip('update')

Viðburðir

$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})