Source

Gorsa Meeshaalee

Galmee fi fakkeenyota gorsa meeshaalee Bootstrap amala CSS fi JavaScript waliin CSS3 fayyadamuun sochiiwwanii fi deetaa-amaloota kuusaa mata duree naannoodhaaf dabaluudhaaf.

Haala Waliigalaa

Wantoota yeroo tooltip plugin fayyadamtan beekuu qabdan:

  • Gorsi meeshaalee iddoo qabachuuf mana kitaabaa qaama 3ffaa Popper.js irratti hirkatu . Gorsi meeshaa akka hojjetuuf bootstrap.js dura popper.min.js dabaluu qabda ykn bootstrap.bundle.min.js/ bootstrap.bundle.jskan Popper.js of keessaa qabu fayyadamuu qabda!
  • Yoo JavaScriptutil.js keenya madda irraa ijaaraa jirta ta'e, .
  • Gorsi meeshaalee sababa raawwii hojiitiin filachuudha, kanaaf ofii keetii jalqabuu qabda .
  • Gorsi meeshaa mata dureewwan dheerina zeeroo qaban gonkumaa hin agarsiifaman.
  • container: 'body'Qaamolee walxaxaa ta'an keessatti (akka gareewwan galtee keenyaa, gareewwan qaree fi kkf) keessatti rakkoolee agarsiisuu akka hin uumamneef ifteessi .
  • Qaamolee dhokatan irratti gorsa meeshaa kakaasuun hin hojjetu.
  • Gorsi meeshaa .disabledykn disabledelementoota elementii marfataa irratti kakaafamuu qabu.
  • Yeroo haayperliinkii sararoota hedduu dabarsan irraa kakaafamu, gorsi meeshaa giddugaleessa ta'a. Amala kana irraa of eeguuf s white-space: nowrap;kee irratti fayyadami .<a>
  • Gorsi meeshaa osoo elementoonni isaanii walgitan DOM irraa hin haqamin dura dhokachuu qabu.
  • Gorsi meeshaa galata elementii DOM golboo keessa jiruun kakaafamuu danda'a.

Bu'aan sochii qaama kanaa prefers-reduced-motiongaaffii miidiyaa irratti hundaa'a. Kutaa sochii hir'ate sanada dhaqqabummaa keenyaa ilaali .

Sana hunda argatte? Guddaa dha, fakkeenya tokko tokkoon akkamitti akka hojjetan haa ilaallu.

Fakkeenya: Gorsa meeshaalee bakka hundatti dandeessisi

data-toggleKaraan tokko gorsa meeshaalee hunda fuula tokko irratti jalqabsiisuu amaloota isaaniitiin filachuu ta'a :

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

Fakkeenyaaf

Gorsa meeshaalee ilaaluuf hidhannoowwan armaan gadii irratti harka kaa'i:

Paantii cimaa sadarkaa itti aanu keffiyeh tarii waa'ee isaanii hin dhageenye. Booth suuraa qeensa raw denim letterpress vegan ergamaa boorsaa stumptown. Qonnaa irraa gara minjaalaatti seitan, mcsweeney's fixie itti fufiinsa qabu quinoa 8-bit uffata ameerikaa terry richardson vinyl chambray qabu . Beard stumptown, kaardii banh mi lomo qilleensaa. Tofu biodiesel williamsburg marfa, afur loko mcsweeney's qulqulleessuu vegan chambray. A really ironic artisan whatever keytar , scenester qonnaa irraa gara minjaala banksy Austin twitter qabachuu freegan cred raw denim buna ka'umsa tokkoo vaayirasii.

Kallattiiwwan gorsa meeshaalee afran: gubbaa, mirgaa, jalaa fi bitaa ilaaluuf qaree armaan gadii irratti harka kaa'i.

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

Akkasumas HTML amala dabalamee wajjin:

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

Fayyadama

Ijaarsi gorsa meeshaa qabiyyee fi mallattoo gaaffii irratti maddisiisa, akkasumas durtii gorsa meeshaa qaama kaka'umsaa isaanii booda kaa'a.

Gorsa meeshaa karaa JaavaScript kakaasi:

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

Iddoon meeshaa yeroo qabduu warraa keenya qabu overflow: autoykn overflow: scrolljaallatu ofumaan jijjiiruuf yaala .table-responsive, garuu ammas iddoo iddoo jalqabaa eega. Furuuf, boundaryfilannoo gara gatii durtii malee waan biraatti saagi, 'scrollParent', kan akka 'window':

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

Markup gochuu

Mallattoon barbaachisu gorsa meeshaa dataamaloota qofaa fi titleqaama HTML irratti gorsa meeshaa qabaachuu barbaadda. Mallattoon gorsa meeshaa uumame baay'ee salphaadha, haa ta'u malee bakka barbaada (durtiidhaan, ifteessaadhaan saagi top).

Gorsi meeshaalee fayyadamtoota kiiboordii fi teeknooloojii gargaaraaf akka hojjetu gochuu

Qaamolee HTML kanneen akka aadaa furtuu irratti xiyyeeffachuu danda'anii fi wal-qunnamsiisoo ta'an qofa irratti gorsa meeshaa dabaluu qabda (kan akka hidhannoo ykn too'annoo unkaa). Qaamolee HTML fedhii isaaniitiin (kan akka <span>s) amallicha dabaluudhaan xiyyeeffannoo akka qabaatan gochuun kan danda'amu ta'us tabindex="0", kun fayyadamtoota kiiboordiidhaaf qaamolee wal-qunnamtii hin taane irratti dhaabbii caancalaa nama aarsu fi burjaajessu danda'u ni dabala, fi teeknooloojiiwwan gargaaraa baay'een yeroo ammaa haala kana keessatti gorsa meeshaa hin beeksisan. Dabalataanis, akka kaka'umsa gorsa meeshaa keetii qofatti hin hirkatin hover, kunis gorsa meeshaa kee fayyadamtoota kiiboordiidhaaf kakaasuun akka hin danda'amne taasisa.

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

Qaamolee hanqifaman

Qaamonni disabledamaloota qaban wal-qunnamsiisoo miti, jechuun fayyadamtoonni xiyyeeffannoo, hover, ykn cuqaasuun gorsa meeshaa (ykn popover) kakaasuu hin danda'an. Akka furmaataatti, gorsa meeshaa marfata irraa kakaasuu barbaadda <div>, <span>akka gaariitti , fayyadamuun kiiboordii-xiyyeeffannoo godhame , fi qaama hanqifame irratti tabindex="0"irra darbuu barbaadda.pointer-events

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

Filannoowwan

Filannoon karaa amaloota deetaa ykn JaavaScript darbuu danda'u. Amaloota deetaatiif, maqaa filannoo gara data-, akkuma keessatti dabali data-animation="".

Hubadhu sababa nageenyaaf filannoowwan sanitize, sanitizeFnfi whiteListamaloota deetaa fayyadamuun dhiyeessuu hin danda'an.

Maqaa Akaakuu Durtii dha Ibsa
sochii qaamaa (animation). boolee dhugaa Ce'umsa fade CSS gara gorsa meeshaatti hojii irra oolchi
qabduu tarree | elementii | soba soba

Gorsa meeshaa gara qaama murtaa'etti dabalata. Fakkeenyaaf: container: 'body'. Filannoon kun keessumaa faayidaa kan qabu yoo ta'u, kunis fiixee meeshaa dhangala'aa galmee keessatti naannoo qaama kakaasutti akka kaa'attu si dandeessisa - kunis yeroo guddina foddaa gorsa meeshaa qaama kakaasu irraa akka hin yaabbanne dhorka.

boodatti hafuu lakkoofsa | meeshaa 0.

Gorsa meeshaa agarsiisuu fi dhoksuu harkifachuu (ms) - gosa kaka'umsa harkaa irratti hin hojjetu

Yoo lakkoofsi kenname, harkifannaa dhoksuu/agarsiisi lamaan irratti hojii irra oola

Caasaan wantaa: 1.1.delay: { "show": 500, "hide": 100 }

html boolee soba

HTML gorsa meeshaa keessatti hayyami.

Yoo dhugaa ta'e, mallattoolee HTML kanneen tooltip's titlekeessa jiran tooltip keessatti ni agarsiifamu. Yoo soba ta'e, textmala jQuery qabiyyee gara DOMtti galchuuf fayyadama.

Yoo waa'ee haleellaa XSS si yaaddesse barreeffama fayyadami.

ramaddii tarree | faayidaa 'gubbaa'

Akkaataa tooltip itti dhaabdan - auto | gubbaa | jalaa | bitaa | sirrii.
Yeroo autoifteessamu, gorsa meeshaa daayinamiikiin irra deebi'ee qajeelcha.

Faankishiniin tokko iddoo murteessuuf yeroo fayyadamu, akka murfii isaa isa jalqabaatti noodiin DOM fiixee meeshaa fi noodiin DOM elementii kakaasu akka isa lammaffaatti waamama. Qabduun thisgara fakkeenya gorsa meeshaatti qindaa'a.

filannoodha tarree | soba soba Yoo filataan kenname, wantoonni gorsa meeshaa galmoota ifteessamaniif ni kennamu. Qabatamaan, kun akkasumas gorsa meeshaalee elementoota DOM daayinamiikiin dabalaman irratti hojii irra oolchuuf fayyadama ( jQuery.ondeeggarsa). Kanaa fi fakkeenya odeeffannoo qabu ilaalaa .
unkaa hidhaa '<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>'

HTML yeroo gorsa meeshaa uumtu fayyadamuuf bu'uura.

Tooltip's titlegara .tooltip-inner.

.arrowxiyya tooltip ta'a.

Qaamni marfataa alaa .tooltipgitaa fi role="tooltip".

mata-duree tarree | elementii | faayidaa '' .

Gatii mata duree durtii yoo titleamalli hin jirre.

Yoo faankishiniin kenname, thistuuta wabii isaa elementii fiixeen meeshaa itti maxxane waliin ni waamama.

dammaqsuu hidhaa 'xiyyeeffannoo hover' jedhu.

Akkaataa tooltip itti kakaafamu - | cuqaasi hover | xiyyeeffannoo | kan harkaanii. Kaka’umsa hedduu darbuu dandeessa; bakka adda baasuun addaan baasuu.

'manual'tooltip sagantaadhaan karaa .tooltip('show'), .tooltip('hide')fi .tooltip('toggle')malawwanii akka kakaafamu agarsiisa; gatii kun kaka'umsa biraa kamiyyuu waliin walitti makamuu hin danda'u.

'hover'ofii isaatiin gorsa meeshaalee karaa kiiboordii kakaafamuu hin dandeenye ni fida, akkasumas kan fayyadamuu qabu yoo malawwan filannoo fayyadamtoota kiiboordii odeeffannoo walfakkaataa dabarsuu jiraatan qofa.

ofseeti jechuun ni danda’ama lakkoofsa | tarree | faayidaa 0.

Ofseeti gorsa meeshaa galma isaa wajjin walqabatee.

Faankishiniin tokko ofseeti murteessuuf yeroo fayyadamu, wanta deetaa ofseeti akka murfii isaa isa jalqabaatti of keessaa qabuun waamama. Faankishinichi wanta caasaa walfakkaataa qabu deebisuu qaba. Qaamni kakaasu DOM noodiin akka falmii lammaffaatti darba.

Odeeffannoo dabalataaf Popper.js's offset docs ilaali .

fallbackIddoo kaa'uu tarree | tarree 'garagalchuu' Popper fallback irratti ejjennoo kam akka fayyadamu ibsuuf hayyami. Odeeffannoo dabalataaf Docs amala Popper.js ilaali
daangaa tarree | qabiyyee 'Warra garagalchuu'. Daangaa danqaa dhangala'aa gorsa meeshaa. Gatii 'viewport', 'window', 'scrollParent', ykn wabii HTMLElement fudhata (JavaScript qofa). Odeeffannoo dabalataaf Popper.js's preventOverflow docs ilaali .
sanitize gochuu boolee dhugaa Sanitization dandeessisi ykn hanqisi. Yoo activated 'template'fi 'title'filannoowwan sanitized ta'u.
Tarree adii meeshaa Gatii durtii Wanti amaloota fi mallattoolee hayyamaman of keessaa qabu
qulqulleessuuFn null | faayidaa duwwaa Asirratti sanitize function mataa keessanii dhiyeessuu dandeessu. Kun faayidaa qabaachuu danda’a yoo mana kitaabaa addaa fayyadamuun qulqulleessuu raawwachuu barbaadde.
popperQindeessaa null | meeshaa duwwaa Qindaa'ina Popper.js durtii Bootstrap jijjiiruuf, qindeessaa Popper.js ilaali

Amaloota deetaa gorsa meeshaalee dhuunfaaf

Filannoon gorsa meeshaalee dhuunfaa filannoodhaan karaa fayyadama amaloota deetaa ifteessuun ni danda'ama, akkuma armaan olitti ibsame.

Malawwan

Malawwanii fi ce’umsawwan wal hin simne

Malleen API hundi wal hin simnee fi ce'umsa jalqabu . Akkuma ce'umsi jalqabame garuu osoo hin xumuramin gara nama bilbileetti deebi'u . Dabalataan, waamichi malaa qaama ce'umsaa irratti ni tuffatama .

Odeeffannoo dabalataaf galmee JaavaScript keenya ilaali .

$().tooltip(options)

Qabduu gorsa meeshaa walitti qabama elementii irratti maxxansi.

.tooltip('show')

Gorsa meeshaa elementii tokkoo mul'isa. Osoo gorsi meeshaa qabatamaan hin agarsiifamiin dura gara waamichaatti deebi'a (jechuunis osoo shown.bs.tooltiptaatee hin uumamin dura). Kunis akka “harkaan” kakaasuu tooltip ta’ee fudhatama. Gorsi meeshaa mata dureewwan dheerina zeeroo qaban gonkumaa hin agarsiifaman.

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

.tooltip('hide')

Gorsa meeshaa elementii dhoksa. Osoo gorsi meeshaa qabatamaan hin dhokatiin (jechuun osoo taatee hin uumamin dura) gara waamichaatti deebi'a . hidden.bs.tooltipKunis akka “harkaan” kakaasuu tooltip ta’ee fudhatama.

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

.tooltip('toggle')

Gorsa meeshaa qaama tokkoo jijjiira. Gara waamichaatti deebi'a osoo gorsi meeshaa qabatamaan hin agarsiifamin ykn hin dhokatiin (jechuunis osoo taatee shown.bs.tooltipykn hin uumamin dura hidden.bs.tooltip). Kunis akka “harkaan” kakaasuu tooltip ta’ee fudhatama.

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

.tooltip('dispose')

Gorsa meeshaa elementii tokkoo dhoksuu fi balleessa. Gorsi meeshaalee bakka bu'iinsa fayyadaman ( kanneen selectorfilannoo fayyadamuun uumaman ) qaamolee kaka'umsaa sanyii irratti dhuunfaan balleessuu hin danda'an.

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

.tooltip('enable')

Dandeettii agarsiisuuf tooltip elementii kenna. Gorsi meeshaalee durtiidhan dandeessifama.

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

.tooltip('disable')

Dandeettii gorsa meeshaa elementii agarsiisuuf haqa. Gorsi meeshaa agarsiisuu kan danda'u yoo irra deebi'amee dandeessifame qofa.

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

.tooltip('toggleEnabled')

Dandeettii gorsa meeshaa elementii akka agarsiifamu ykn dhokfamuuf jijjiira.

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

.tooltip('update')

Bakka gorsa meeshaa qaama tokkoo fooyyessa.

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

Taateewwan

Gosa Taatee Ibsa
gorsa meeshaa agarsiisu.bs Taatee kun yeroo showmala fakkeenyaa waamamu battalumatti dhukaasa.
agarsiifame.bs.tooltip Taatee kun yeroo gorsi meeshaa fayyadamaaf mul'atu taasifamu ni ari'ama (ce'umsa CSS xumuramu ni eega).
gorsa meeshaa dhoksi.bs Taatee kun yeroo hidemala fakkeenyaa waamame battalumatti dhukaafama.
dhokataa.bs.meeshaa Taatee kun yeroo gorsi meeshaa fayyadamaa irraa dhokatee xumuru ni dhukaafama (ce'umsa CSS xumuramuu eega).
gorsa meeshaa.bs.galfame Taatee kun taatee booda show.bs.tooltipyeroo unkaan gorsa meeshaa DOM irratti dabalame ari'ama.
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something...
})