in English

Nasihun kayan aiki

Takaddun bayanai da misalai don ƙara kayan aikin Bootstrap na al'ada tare da CSS da JavaScript ta amfani da CSS3 don rayarwa da sifofin bayanai don ajiyar take na gida.

Dubawa

Abubuwan da ya kamata ku sani lokacin amfani da plugin ɗin kayan aiki:

  • Bayanan kayan aiki sun dogara da ɗakin karatu na ɓangare na uku Popper don matsayi. Dole ne ku haɗa popper.min.js kafin bootstrap.js ko amfani bootstrap.bundle.min.js/ bootstrap.bundle.jswanda ya ƙunshi Popper don kayan aikin kayan aiki suyi aiki!
  • Idan kuna gina JavaScript ɗin mu daga tushe, yana buƙatarutil.js .
  • Nasihun kayan aiki suna shiga don dalilan aiki, don haka dole ne ka fara su da kanka .
  • Ba a taɓa nuna nassoshin kayan aiki masu tsayin sifili ba.
  • Ƙayyade container: 'body'don guje wa yin matsaloli a cikin ƙarin hadaddun abubuwa (kamar ƙungiyoyin shigar da mu, ƙungiyoyin maɓalli, da sauransu).
  • Ƙirar kayan aiki akan abubuwan ɓoye ba zai yi aiki ba.
  • Dole ne a kunna nassosin kayan aiki don .disabledko disabledabubuwa akan abin nadi.
  • Lokacin da aka jawo daga hyperlinks waɗanda ke kan layi da yawa, kayan aikin kayan aiki za su kasance a tsakiya. Yi amfani white-space: nowrap;da <a>s ɗin ku don guje wa wannan halin.
  • Dole ne a ɓoye bayanan kayan aiki kafin a cire abubuwan da suka dace daga DOM.
  • Ana iya kunna nassosin kayan aiki godiya ga wani abu a cikin inuwa DOM.
Ta hanyar tsoho, wannan bangaren yana amfani da ginanniyar sanitizer na abun ciki, wanda ke fitar da duk wani abu na HTML da ba a yarda da shi ba. Duba sashin sanitizer a cikin takaddun JavaScript ɗin mu don ƙarin cikakkun bayanai.
Tasirin raye-rayen wannan bangaren ya dogara ne da prefers-reduced-motiontambayar kafofin watsa labarai. Dubi raguwar sashin motsi na takaddun damar mu .

Samu duk wannan? Mai girma, bari mu ga yadda suke aiki tare da wasu misalai.

Misali: Kunna shawarwarin kayan aiki a ko'ina

Hanya ɗaya don fara duk shawarwarin kayan aiki akan shafi shine zaɓi su ta yanayin su data-toggle:

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

Misalai

Tsallake kan hanyoyin da ke ƙasa don ganin kayan aiki:

Rubutun ɗigon wuri don nuna wasu hanyoyin haɗin layi tare da tukwici na kayan aiki. Wannan yanzu kawai filler ne, babu kisa. Abun ciki da aka sanya anan kawai don kwaikwayi kasancewar ainihin rubutu . Kuma duk wannan kawai don ba ku ra'ayin yadda kayan aikin kayan aiki zasu kasance yayin amfani da su a cikin yanayi na ainihi. Don haka da fatan kun ga yanzu yadda waɗannan nasihun kayan aiki akan hanyoyin haɗin gwiwa zasu iya aiki a aikace, da zarar kun yi amfani da su akan rukunin yanar gizonku ko aikinku .

Tsaya akan maɓallan da ke ƙasa don ganin kwatancen kayan aiki guda huɗu: sama, dama, ƙasa, da hagu.

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

Kuma tare da ƙarin HTML na al'ada:

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

Amfani

Filogin kayan aiki yana haifar da abun ciki da alama akan buƙata, kuma ta tsohuwa wuraren abubuwan kayan aiki bayan abubuwan da suka haifar da su.

Ƙaddamar da kayan aiki ta hanyar JavaScript:

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

Matsayin kayan aiki yana ƙoƙarin canzawa ta atomatik lokacin da kwandon iyaye yana da overflow: autoko overflow: scrollson namu .table-responsive, amma har yanzu yana kiyaye matsayin wuri na asali. Don warwarewa, saita boundaryzaɓin zuwa wani abu ban da ƙima ta asali, 'scrollParent', kamar 'window':

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

Alamar alama

Alamar da ake buƙata don tip ɗin kayan aiki datasifa ce kawai kuma titleakan ɓangarorin HTML ɗin da kuke son samun tip ɗin kayan aiki. Samfuran alamar kayan aiki yana da sauƙi, kodayake yana buƙatar matsayi (ta tsohuwa, an saita shi topta plugin).

Yin shawarwarin kayan aiki suyi aiki ga madannai da masu amfani da fasaha masu taimako

Ya kamata ku ƙara kayan aiki kawai zuwa abubuwan HTML waɗanda ke al'adar madannai-maida hankali da mu'amala (kamar hanyoyin haɗin gwiwa ko sarrafa tsari). Kodayake abubuwan HTML na sabani (kamar <span>s) ana iya mai da hankali ta hanyar ƙara tabindex="0"sifa, wannan zai ƙara yuwuwar tsayawar shafin mai ban haushi da ruɗani akan abubuwan da ba sa mu'amala da masu amfani da madannai, kuma galibin fasahar taimako a halin yanzu ba sa sanar da kayan aiki a cikin wannan yanayin. Bugu da ƙari, kar a dogara kawai a hovermatsayin abin faɗakar da kayan aikin ku, saboda wannan zai sa na'urorin ku ba su yiwu su jawo masu amfani da madannai ba.

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

Abubuwan da aka kashe

Abubuwan da ke da disabledsifa ba sa mu'amala da juna, ma'ana masu amfani ba za su iya mai da hankali ba, shawagi, ko danna su don faɗakar da kayan aiki (ko popover). A matsayin madaidaicin aiki, za ku so ku jawo tip ɗin kayan aiki daga nannade <div>ko <span>, wanda aka yi daidai da maɓalli mai mahimmanci ta amfani tabindex="0"da , kuma ku soke abin da ke pointer-eventskan nakasa.

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

Zabuka

Za a iya wucewa ta hanyar sifofin bayanai ko JavaScript. Don halayen bayanai, saka sunan zaɓin zuwa data-, kamar a cikin data-animation="".

Lura cewa saboda dalilai na tsaro sanitize, sanitizeFnda whiteListzaɓuɓɓukan ba za a iya samar da su ta amfani da halayen bayanai ba.
Suna Nau'in Default Bayani
tashin hankali boolean gaskiya Aiwatar da canjin CSS fade zuwa tip ɗin kayan aiki
ganga zaren | kashi | karya karya

Yana haɗa tip ɗin kayan aiki zuwa takamaiman yanki. Misali container: 'body':. Wannan zaɓin yana da amfani musamman don yana ba ku damar sanya kayan aiki a cikin kwararar daftarin aiki kusa da abin da ke haifarwa - wanda zai hana kayan aikin daga shawagi daga abin da ke kunnawa yayin girman taga.
jinkiri lamba | abu 0

Jinkirin nunawa da ɓoye bayanan kayan aiki (ms) - baya aiki ga nau'in fararwa na hannu

Idan an ba da lamba, ana amfani da jinkiri ga duka ɓoye/nunawa

Tsarin abu shine:delay: { "show": 500, "hide": 100 }
html boolean karya

Bada HTML a cikin tukwici na kayan aiki.

Idan gaskiya ne, HTML tags a cikin Tooltip's titleza a sanya a cikin Tooltip. Idan ƙarya, textza a yi amfani da hanyar jQuery don saka abun ciki a cikin DOM.

Yi amfani da rubutu idan kun damu da harin XSS.
jeri zaren | aiki ' saman'

Yadda ake saka kayan aiki - auto | saman | kasa | hagu | dama.
Lokacin autoda aka ƙayyade, zai sake jujjuya matakin kayan aiki.

Lokacin da aka yi amfani da aiki don ƙayyade wuri, ana kiran shi tare da kayan aiki na DOM node a matsayin hujja ta farko da maɓallin DOM mai jawowa a matsayin na biyu. An thissaita mahallin zuwa misalin kayan aiki.
mai zaɓe zaren | karya karya Idan an samar da mai zaɓe, za a ba da abubuwan da suka shafi kayan aiki zuwa takamaiman maƙasudai. A aikace, ana amfani da wannan don amfani da nassoshi na kayan aiki zuwa abubuwan DOM masu ƙarfi ( jQuery.ongoyan baya). Dubi wannan da misali mai ba da labari .
samfuri kirtani '<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>'

Tushen HTML don amfani yayin ƙirƙirar tukwici.

Za a yi allurar kayan aiki titlea cikin .tooltip-inner.

.arrowzai zama kibiyar tip ɗin kayan aiki.

Abun nadi na waje yakamata ya kasance yana da .tooltipaji da role="tooltip".
take zaren | kashi | aiki ''

Tsohuwar ƙimar take idan babu titlesifa.

Idan an ba da aiki, za a kira shi tare da thissaita saitin abin da aka makala kayan aikin.
jawo kirtani 'Hover focus'

Yadda ake kunna tip ɗin kayan aiki - danna | shawa | mayar da hankali | manual. Kuna iya wuce abubuwan jan hankali da yawa; raba su da sarari.

'manual'yana nuna cewa za a kunna titin kayan aiki ta hanyar tsari ta hanyar .tooltip('show'), .tooltip('hide')da .tooltip('toggle')hanyoyin; Ba za a iya haɗa wannan ƙimar tare da kowane abin tayar da hankali ba.

'hover'da kansa zai haifar da kayan aikin da ba za a iya kunna su ta hanyar madannai ba, kuma yakamata a yi amfani da su idan akwai wasu hanyoyin isar da bayanai iri ɗaya ga masu amfani da madannai.
biya diyya lamba | zaren | aiki 0

Matsakaicin matakin kayan aiki dangane da manufar sa.

Lokacin da aka yi amfani da aiki don tantance abin da aka kashe, ana kiran shi da wani abu mai ɗauke da bayanan kashewa azaman hujja ta farko. Dole ne aikin ya dawo da abu mai tsari iri ɗaya. An wuce kullin DOM mai jawowa azaman hujja ta biyu.

Don ƙarin bayani koma zuwa Popper's offset docs .
fallbackPlacement zaren | tsararru 'juya' Bada izinin saka ko wane matsayi Popper zai yi amfani da shi akan koma baya. Don ƙarin bayani koma zuwa Docs halayyar Popper
Class Class zaren | aiki ''

Ƙara azuzuwan zuwa matakin kayan aiki lokacin da aka nuna shi. Lura cewa waɗannan azuzuwan za a ƙara su ban da kowane nau'i da aka kayyade a cikin samfuri. Don ƙara azuzuwan da yawa, raba su da sarari: 'a b'.

Hakanan zaka iya wuce aikin da yakamata ya dawo da kirtani ɗaya mai ɗauke da ƙarin sunayen aji.
iyaka zaren | kashi ' gungurawaParent' Matsakaicin ƙaƙƙarfan ƙayyadaddun ƙayyadaddun kayan aiki. Yana karɓar ƙimar 'viewport', 'window', 'scrollParent', ko ma'anar HTMLElement (JavaScript kawai). Don ƙarin bayani koma zuwa Popper's preventOverflow docs .
sanitize boolean gaskiya Kunna ko kashe tsaftar. Idan an kunna 'template'kuma 'title'za a tsabtace zaɓuɓɓuka. Duba sashin sanitizer a cikin takaddun JavaScript ɗin mu .
whiteList abu Ƙimar ta asali Abu wanda ya ƙunshi halayen da aka yarda da alamun
sanitizeFn null | aiki banza Anan zaku iya samar da aikin tsabtace ku. Wannan na iya zama da amfani idan kun fi son yin amfani da ɗakin karatu da aka keɓe don yin tsafta.
popperConfig null | abu banza Don canza tsohuwar saitin Popper na Bootstrap, duba tsarin Popper

Halayen bayanai don ƙa'idodin kayan aiki guda ɗaya

Zaɓuɓɓuka don ƙayyadaddun bayanan kayan aiki ɗaya na iya zama a madadin ta hanyar amfani da sifofin bayanai, kamar yadda aka bayyana a sama.

Hanyoyin

Hanyoyi masu daidaitawa da canji

Duk hanyoyin API ba daidai ba ne kuma suna fara canji . Suna komawa ga mai kiran da zarar an fara canji amma kafin ya ƙare . Bugu da ƙari, za a yi watsi da kiran hanya akan ɓangaren canji .

Duba takaddun JavaScript ɗin mu don ƙarin bayani .

$().tooltip(options)

Haɗa mai sarrafa kayan aiki zuwa tarin abubuwa.

.tooltip('show')

Yana bayyana matakin kayan aiki. Komawa ga mai kira kafin a nuna matakin kayan aiki (watau kafin shown.bs.tooltipabin ya faru). Ana ɗaukar wannan a matsayin "manual" yana haifar da tip ɗin kayan aiki. Ba a taɓa nuna nassoshin kayan aiki masu tsayin sifili ba.

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

.tooltip('hide')

Yana ɓoye bayanan kayan aiki. Komawa ga mai kira kafin a ɓoye bayanan kayan aiki (watau kafin hidden.bs.tooltipabin ya faru). Ana ɗaukar wannan a matsayin "manual" yana haifar da tip ɗin kayan aiki.

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

.tooltip('toggle')

Yana jujjuya matakin kayan aiki. Komawa ga mai kira kafin a nuna tip ɗin kayan aiki a zahiri ko a ɓoye (watau kafin abin shown.bs.tooltipko hidden.bs.tooltipya faru). Ana ɗaukar wannan a matsayin "manual" yana haifar da tip ɗin kayan aiki.

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

.tooltip('dispose')

Yana ɓoyewa kuma yana lalata tushen kayan aiki. Nasihun kayan aiki waɗanda ke amfani da wakilai (wanda aka ƙirƙira ta amfani da selectorzaɓi ) ba za a iya lalata su daban-daban akan abubuwan da ke haifar da zuriya ba.

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

.tooltip('enable')

Yana ba da tip ɗin kayan aiki ikon nunawa. Ana kunna bayanan kayan aiki ta tsohuwa.

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

.tooltip('disable')

Yana kawar da damar da za a nuna tip ɗin kayan aiki. Za a iya nuna tip ɗin kayan aiki ne kawai idan an sake kunna shi.

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

.tooltip('toggleEnabled')

Yana jujjuya ikon kayan aikin abun nunawa ko ɓoye.

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

.tooltip('update')

Yana sabunta matsayi na tukwici na kayan aiki.

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

Abubuwan da suka faru

Nau'in Taron Bayani
nuna.bs.tooltip Wannan taron yana gobara nan da nan lokacin da showaka kira hanyar misali.
nuna.bs.tooltip Ana korar wannan taron lokacin da aka bayyana kayan aikin ga mai amfani (zai jira canjin CSS ya kammala).
boye.bs.tooltip Ana korar wannan taron nan da nan lokacin da hideaka kira hanyar misali.
boye.bs.tooltip Ana korar wannan taron lokacin da kayan aikin ya gama ɓoye daga mai amfani (zai jira canjin CSS ya kammala).
shigar.bs.tooltip An kori wannan taron bayan show.bs.tooltiptaron lokacin da aka ƙara samfurin kayan aiki zuwa DOM. 
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something...
})