Source

ምኽሪ መሳርሒታት

ሰነዳትን ኣብነታትን ንምውሳኽ ብሕታዊ ቡትስትራፕ መሳርሒታት ምስ CSSን ጃቫስክሪፕትን ብምጥቃም CSS3 ንኣኒሜሽንን ዳታ-ባህርያት ንከባብያዊ ኣርእስቲ መኽዘንን።

ሓፈሻዊ ትሕዝቶ

ነቲ tooltip plugin ክትጥቀመሉ ከለኻ ክትፈልጦም ዘለካ ነገራት፤

  • ምኽሪ መሳርሒታት ንኣቀማምጣ ኣብ 3ይ ወገን ቤተ-መጻሕፍቲ Popper.js ይምርኮሱ ። ቅድሚ bootstrap.js popper.min.js ከተካትት ኣለካ ወይ ድማ bootstrap.bundle.min.js/ ክትጥቀም ኣለካ bootstrap.bundle.jsእዚ ድማ Popper.js ዝሓዘ ምኽሪ መሳርሒታት ንኽሰርሕ!
  • ጃቫስክሪፕትናutil.js ካብ ምንጪ ትሃንጽ እንተኾንካ ፡ .
  • ምኽርታት መሳርሒታት ብናይ ኣፈጻጽማ ምኽንያታት ምምራጽ ስለዝኾኑ ባዕልኻ ክትጅምሮም ኣለካ .
  • ዜሮ ንውሓት ዘለዎም ኣርእስታት ዘለዎም ምኽርታት መሳርሒታት ፈጺሞም ኣይርኣዩን እዮም።
  • container: 'body'ኣብ ዝያዳ ዝተሓላለኹ ኣካላት (ከም ናይ ምእታው ጉጅለታትና፣ ናይ መጠወቒ ጉጅለታት ወዘተ) ጸገማት ምቕራብ ንኸይፍጠር ምግላጽ ።
  • ኣብ ሕቡእ ባእታታት ምኽሪ መሳርሒታት ምብጋስ ኣይሰርሕን እዩ።
  • ምኽሪ መሳርሒታት ን .disabledወይ disabledባእታታት ኣብ መጠቕለሊ ባእታ ክብገሱ ኣለዎም።
  • ካብ ብዙሓት መስመራት ዝሽፍኑ ሃይፐርሊንክታት ምስ ዝጅምር፡ ምኽርታት መሳርሒታት ኣብ ማእከል ክኾኑ እዮም። ካብዚ ባህሪ ንምውጋድ white-space: nowrap;ኣብ sካ ተጠቐም ።<a>
  • ምኽሪ መሳርሒታት ቅድሚ ተዛመድቲ ባእታታቶም ካብ DOM ምእላይ ክሕብኡ ኣለዎም።

እዚ ኩሉ ረኺብካዮ? ብሉጽ፡ ብገለ ኣብነታት ከመይ ከም ዝሰርሑ ንርአ።

ኣብነት፡ ኣብ ኩሉ ቦታ መሳርሒታት ምኽርታት ኣንቅሕ

ሓደ ካብቲ ኣብ ሓደ ገጽ ንዘሎ ኩሉ ምኽርታት መሳርሒታት ንምጅማር ዝሕግዝ መንገዲ ብባህርያቶም ምምራጽ ምኾነ data-toggle፤

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

ኣብነታት

ምኽሪ መሳርሒታት ንምርኣይ ኣብዞም ኣብ ታሕቲ ዘለዉ ሊንክታት ምልክት ግበር፤

ስጡም ካምቻ next level keffiyeh ምናልባት ኣይሰማዕኩምን ትኾኑ። ፎቶ ዳስ ጭሕሚ ጥረ ዲኒም ሌተርፕረስ ቪጋን መልእኽተኛ ቦርሳ stumptown. ካብ ሕርሻ ናብ ጠረጴዛ seitan, mcsweeney's fixie ዘላቒ quinoa 8-bit ኣሜሪካዊ ኣልባሳት ቴሪ ሪቻርድሰን ቪኒል chambray ኣለዎም ። ጭሕሚ ስቱምፕታውን፣ ካርዲጋን ባንህ ሚ ሎሞ ነጎዳታት። ቶፉ ባዮዲዘል ዊልያምስበርግ ማርፋ፣ ኣርባዕተ ሎኮ ማክስዊኒ ናይ ምጽራይ ቪጋን ቻምብሬይ። A really ironic artisan whatever keytar , scenester ሕርሻ-ናብ-መኣዲ banksy ኦስቲን ትዊተር መትሓዚ freegan cred ጥረ ዲኒም ንጽል-መበቆል ቡን ቫይራል.

ኣብ ልዕሊ እቶም ኣብ ታሕቲ ዘለዉ መጠወቒታት ምልክት ብምግባር ነተን ኣርባዕተ ኣንፈታት መሳርሒታት ርአ፡ ማለት ላዕለዋይ፡ የማን፡ ታሕተዋይን ጸጋምን።

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

ከምኡ’ውን ምስ ብሕታዊ ኤችቲኤምኤል ዝተወሰኸ፤

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

ኣጠቓቕማ

እቲ ናይ መሳርሒ ምኽሪ ፕላግ-ኢን ትሕዝቶን ምልክትን ብመሰረት ጠለብ የፍሪ፣ ብነባሪ ድማ ድሕሪ እቲ መበገሲ ባእታኦም መተሓሳሰቢ መሳርሒታት የቐምጥ።

ነቲ ናይ መሳርሒ ምኽሪ ብመንገዲ ጃቫስክሪፕት ኣበግሶ፤

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

ምልክት ምግባር

ንሓደ መሳርሒ ምኽሪ ዘድሊ ምልክት dataባህሪ ጥራይ ኮይኑ titleኣብቲ HTML ባእታ ምኽሪ መሳርሒ ክህልወካ ትደሊ። እቲ ዝፍጠር ምልክት ናይ ሓደ መሳርሒ ምኽሪ ምናልባት ቀሊል እዩ፣ ዋላ እኳ ቦታ ዝሓትት እንተኾነ (ብነባሪ፣ topብፕላግ-ኢን ናብ ዝተቐመጠ)።

ንተጠቀምቲ ቁልፊ ሰሌዳን ሓጋዚ ቴክኖሎጅን መሳርሒታት ዝሰርሑ ምግባር

ኣብ HTML ባእታታት ብባህሊ ኣብ ሰሌዳ ቁልፊ ዘተኮሩን መስተጋብራዊ ዝኾኑን (ከም መላግቦታት ወይ ቁጽጽር ቅጥዒ) ጥራይ እዩ ምኽርታት መሳርሒታት ክትውስኽ ዘለካ። ዋላ እኳ ፍቓደኛታት ኤችቲኤምኤል ባእታታት (ከም <span>s) ነቲ ባህሪ ብምውሳኽ ትኹረት ዝገብሩ ክኾኑ እንተኽኣሉ tabindex="0"፡ እዚ ንተጠቀምቲ ሰሌዳ ቁልፊ ኣብ ዘይመተሓላለፍቲ ባእታታት ከሕርቑን ከደናግሩን ዝኽእሉ ናይ ትብ ስቶፕ ክውስኽ እዩ። ብተወሳኺ ኣብዚ እዋን መብዛሕትኦም ሓገዝቲ ቴክኖሎጂታት ኣብዚ ኩነታት እዚ ነቲ መሳርሒ ምኽሪ ኣየፍልጡን እዮም።

hoverብተወሳኺ ፡ ንመሳርሒታትካ ከም መበገሲ ንመሳርሒኻ ጥራይ ኣይትጽጋዕ ፡ እዚ ንመሳርሒታትካ ንተጠቀምቲ ሰሌዳ ቁልፊ ንኽጅምር ዘይከኣል ይገብሮ።

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

ስንኩላን ባእታታት

እቲ ባህሪ ዘለዎም ባእታታት disabledመስተጋብራዊ ኣይኮኑን፣ ማለት ተጠቀምቲ ንሓደ መሳርሒ ምኽሪ (ወይ ፖፖቨር) ንምብጋስ ከተኩሩ፣ ክሕንብሱ፣ ወይ ጠዊቖም ክገብሩ ኣይክእሉን እዮም። ከም መፍትሒ፡ ነቲ ምኽሪ መሳርሒ ካብ መጠቕለሊ <div>ወይ <span>፡ ብዝበለጸ ፡ ተጠቒምካ ቁልፊ ሰሌዳ-ትኹረት ዝግበረሉ ጌርካ ክትጅምሮ ክትደሊ ኢኻ tabindex="0"፡ ከምኡ’ውን ነቲ 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>

ኣማራጺታት

ኣማራጺታት ብመንገዲ ዳታ ​​ባህርያት ወይ ጃቫስክሪፕት ክሓልፉ ይኽእሉ። ንባህርያት ዳታ፡ ስም ኣማራጺ ናብ ምውሳኽ data-፡ ከምቲ ኣብ data-animation="".

ሽም ዓይነት ትሑዝ መግለፂ
ኣኒሜሽን ምግባር ቡልያን ዝብል እዩ። ሓቂ ኣብቲ መሳርሒ ምኽሪ ናይ CSS ምድምሳስ ምስግጋር ተግባራዊ ግበር
መትሓዚ ሕብረ ቃላት | ባእታ | ሓሶት ሓሶት

ነቲ ናይ መሳርሒ ምኽሪ ናብ ሓደ ፍሉይ ባእታ ይውስኾ። ኣብነት container: 'body'፡ . እዚ ኣማራጺ ብፍላይ ጠቓሚ እዩ ምኽንያቱ ነቲ ጫፍ መሳርሒ ኣብ ዋሕዚ ናይቲ ሰነድ ኣብ ጥቓ እቲ መበገሲ ባእታ ከተቐምጦ ስለዘኽእለካ - እዚ ድማ እቲ ጫፍ መሳርሒ ኣብ እዋን ምቕያር ዓቐን መስኮት ካብቲ መበገሲ ባእታ ርሒቑ ከይንሳፈፍ ይከላኸል።
ምዝንጋዕ ቁጽሪ | ግኡዝ ነገር 0.

ምድንጓይ ምርኣይን ምሕባእን ናይ መሳርሒ ምኽሪ (ms) - ንዓይነት ማንዋል ትሪግር ኣይምልከትን እዩ።

ቁጽሪ እንተተቐሪቡ፡ ምድንጓይ ኣብ ክልቲኡ ምሕባእ/ምርኣይ ይትግበር

ኣቃውማ ኣቕሓ፤delay: { "show": 500, "hide": 100 }
html ዝብል ጽሑፍ ኣሎ። ቡልያን ዝብል እዩ። ሓሶት

ኣብቲ መሳርሒ ምኽሪ HTML ፍቐድ።

ሓቂ እንተኾይኑ ኣብቲ tooltip's ዝርከቡ HTML tags ኣብቲ tooltip titleክቐርቡ እዮም። ሓሶት እንተኾይኑ፡ ናይ jQuery textሜላ ትሕዝቶ ናብ DOM ንምእታው ክጥቀም እዩ።

ብዛዕባ መጥቃዕቲ XSS እንተተጨኒቕካ ጽሑፍ ተጠቐም።
ምምዳብ ሕብረ ቃላት | ተግባር 'ላዕለዋይ'

ከመይ ጌርና ን tooltip - auto | ላዕለዋይ ክፋል | ታሕተዋይ ክፋል | ጸጋም | ትኽክል.
ምስ autoተገልጸ፡ ነቲ መሳርሒ ምኽሪ ብዳይናሚክ ዳግማይ ከቕንዖ እዩ።

ሓደ ፋንክሽን ንኣቀማምጣ ንምውሳን ኣብ ዝጥቀመሉ እዋን፡ ቱልቲፕ DOM ኖድ ከም ቀዳማይ ሞጎተኡ፡ እቲ ትሪግሪንግ ኤለመንት DOM ኖድ ድማ ከም ካልኣይ ጌሩ ይጽዋዕ። እቲ thisዓውዲ ናብቲ ናይ መሳርሒ ምኽሪ ምሳሌ ይቕመጥ።
መምረጺ ሕብረ ቃላት | ሓሶት ሓሶት ሓደ መምረጺ እንተተዋሂቡ፡ ናይ መሳርሒ ምኽሪ ነገራት ናብቶም ዝተገልጹ ዕላማታት ክውከሉ እዮም። ብተግባር እዚ ዳይናሚክ ኤችቲኤምኤል ትሕዝቶ ፖፖቨርስ ክውሰኽ ንምኽኣል ይጥቀመሉ። ነዚን መሃሪ ኣብነትን ርአ ።
ቅጥዒ ገመድ '<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>'

ንመሳርሒ ምኽሪ ክትፈጥር ከለኻ ክትጥቀመሉ እትደሊ HTML መሰረት ግበር።

እቲ tooltip's titleኣብቲ .tooltip-inner.

.arrowናይቲ መሳርሒ ፍላጻ ክኸውን እዩ።

እቲ ደጋዊ ዝኾነ መጠቕለሊ ባእታ .tooltipክፍሊን role="tooltip".
ርእሲ ሕብረ ቃላት | ባእታ | ተግባር '' ።

titleባህሪ እንተዘይሃልዩ ነባሪ ዋጋ ኣርእስቲ ።

ሓደ ፋንክሽን እንተተዋሂቡ this፡ መወከሲኡ ምስቲ መሳርሒ ቲፕ ዝተተሓሓዘሉ ባእታ ሒዙ ክጽዋዕ እዩ።
ምልዕዓል ገመድ 'ሆቨር ፎኮስ' ዝብል ጽሑፍ ኣሎ።

ከመይ ጌሩ tooltip ይጅምር - | ጠውቕ hover | ትኹረት | ናይ ኢድ. ብዙሓት መበገሲታት ክትሓልፍ ትኽእል ኢኻ፤ ብነጥቢ ፍለዮም።

'manual'.tooltip('show')እቲ መሳርሒ ምኽሪ ብመንገዲ , .tooltip('hide')and .tooltip('toggle')methods ብፕሮግራም ከም ዝጅምር የመልክት ፤ እዚ ዋጋ ምስ ዝኾነ ካልእ መበገሲ ክውሃሃድ ኣይክእልን።

'hover'ንባዕሉ ብመንገዲ ቁልፊ ሰሌዳ ክብገስ ዘይክእል ምኽርታት መሳርሒታት ከስዕብ እዩ፣ ንተጠቀምቲ ሰሌዳ ቁልፊ ተመሳሳሊ ሓበሬታ ንምትሕልላፍ ኣማራጺ ሜላታት ምስ ዝህሉ ጥራይ ድማ ክጥቀመሉ ይግባእ።
ኦፍሴት ዝበሃል ምዃኑ’ዩ። ቁጽሪ | ገመድ 0. ምትዕርራይ ናይቲ መሳርሒ ምኽሪ ብተዛማዲ ምስቲ ዕላማኡ። ንዝያዳ ሓበሬታ ኣብ Popper.js's offset docs ተወከሱ ።
fallbackምቕማጥ ሕብረ ቃላት | ስርርዕ 'መንገብገብ' ፖፐር ኣብ ፎልባክ ኣየናይ ቦታ ከም ዝጥቀም ንምግላጽ ፍቐደሉ። ንዝያዳ ሓበሬታ ኣብ Popper.js ናይ ባህሪ ሰነዳት ተወከሱ
ዶብ ምዃኑ’ዩ። ሕብረ ቃላት | ባእታ 'ስክሮልወላዲ'። ናይ ምፍሳስ ደረት ዶብ ናይቲ መሳርሒ ምኽሪ። 'viewport'ናይ , 'window', 'scrollParent', ወይ ናይ HTMLElement መወከሲ ክብርታት ይቕበል (ጃቫስክሪፕት ጥራይ)። ንዝያዳ ሓበሬታ ኣብ Popper.js's preventOverflow docs ተወከሱ ።

ንውልቃዊ ምኽርታት መሳርሒታት ዝኸውን ባህርያት ዳታ

ኣማራጺታት ንውልቃዊ ምኽርታት መሳርሒታት ብኣማራጺ ብመንገዲ ኣጠቓቕማ ባህርያት ዳታ ክግለጹ ይኽእሉ፣ ከምቲ ኣብ ላዕሊ ዝተገልጸ።

ኣገባባት

ዘይተመዓራረዩ ኣገባባትን ምስግጋራትን።

ኩሎም ናይ ኤፒኣይ ሜላታት ዘይተመዓራረዩ ኮይኖም ምስግጋር ይጅምሩ ። እቲ ምስግጋር ምስ ተጀመረ ግን ከኣ ቅድሚ ምውድኡ ናብቲ ደዋሊ ይምለሱ ። ብተወሳኺ፡ ኣብ ሓደ መሰጋገሪ ኣካል ዝግበር ናይ ሜላ ጻውዒት ዕሽሽ ክበሃል እዩ .

ንዝያዳ ሓበሬታ ኣብ ሰነድ ጃቫስክሪፕትና ርአ።

$().tooltip(options)

ንሓደ ናይ መሳርሒ ምኽሪ መትሓዚ ምስ ሓደ ናይ ባእታ እኽብካብ የተሓሕዞ።

.tooltip('show')

ናይ ሓደ ባእታ መሳርሒ ምኽሪ ይገልጽ። ቅድሚ እቲ መሳርሒ ምኽሪ ብጭቡጥ ምርኣይ (ማለት ቅድሚ እቲ shown.bs.tooltipፍጻመ ምፍጣሩ) ናብቲ ደዋሊ ይምለስ። እዚ ከም “ብኢድ” ምብጋስ ናይቲ መሳርሒ ምኽሪ ይቑጸር። ዜሮ ንውሓት ዘለዎም ኣርእስታት ዘለዎም ምኽርታት መሳርሒታት ፈጺሞም ኣይርኣዩን እዮም።

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

.tooltip('hide')

ናይ ሓደ ባእታ መሳርሒ ምኽሪ ይሓብእ። ቅድሚ እቲ መሳርሒ ምኽሪ ብጭቡጥ ምሕባኡ (ማለት ቅድሚ እቲ hidden.bs.tooltipፍጻመ ምፍጣሩ) ናብቲ ደዋሊ ይምለስ። እዚ ከም “ብኢድ” ምብጋስ ናይቲ መሳርሒ ምኽሪ ይቑጸር።

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

.tooltip('toggle')

ናይ ሓደ ባእታ መሳርሒ ምኽሪ ይቕይሮ። ቅድሚ እቲ መሳርሒ ምኽሪ ብጭቡጥ ምርኣይ ወይ ምሕባኡ (ማለት ቅድሚ እቲ shown.bs.tooltipወይ hidden.bs.tooltipፍጻመ ምፍጣሩ) ናብቲ ደዋሊ ይምለስ። እዚ ከም “ብኢድ” ምብጋስ ናይቲ መሳርሒ ምኽሪ ይቑጸር።

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

.tooltip('dispose')

ናይ ሓደ ባእታ መሳርሒ ምኽሪ ይሓብኦን የጥፍኦን። ውክልና ዝጥቀሙ ምኽርታት መሳርሒታት ( እቲ selectorኣማራጺ ተጠቒሞም ዝፍጠሩ ) ኣብ ዘርኢ መበገሲ ባእታታት ብውልቂ ክጠፍኡ ኣይክእሉን።

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

.tooltip('enable')

ናይ ሓደ ባእታ tooltip ናይ ምርኣይ ዓቕሚ ይህቦ። ምኽሪ መሳርሒታት ብነባሪ ይንቀሳቐሱ።

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

.tooltip('disable')

ናይ ሓደ ባእታ መሳርሒ ምኽሪ ንኽርአ ዘለዎ ዓቕሚ የወግድ። እቲ መሳርሒ ምኽሪ ዳግማይ ምስ ዝኽፈት ጥራይ እዩ ክረአ ዝኽእል።

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

.tooltip('toggleEnabled')

ናይ ሓደ ባእታ መሳርሒ ምኽሪ ንኽርአ ወይ ንኽሕባእ ዘለዎ ዓቕሚ ይቕይሮ።

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

.tooltip('update')

ናይ ሓደ ባእታ መሳርሒ ምኽሪ ኣቀማምጣ የዘምን።

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

ፍጻሜታት

ዓይነት ፍጻመ መግለፂ
show.bs.tooltip ዝብል ጽሑፍ ኣሎ። showእዚ ፍጻመ እዚ እቲ ናይ ምሳሌ ሜላ ምስ ዝጽዋዕ ብቕጽበት ይትኩስ ።
shown.bs.tooltip ዝብል ጽሑፍ ኣሎ። እዚ ፍጻመ ዝትኮስ እቲ ምኽሪ መሳርሒ ንተጠቃሚ ርኡይ ምስ ዝኸውን እዩ (CSS ምስግጋራት ክሳብ ዝዛዘም ክጽበ እዩ)።
hide.bs.tooltip ዝብል ጽሑፍ ኣሎ። እዚ ፍጻመ እዚ እቲ ናይ hideምሳሌ ሜላ ምስ ተጸውዐ ብቕጽበት ይትኮስ።
hidden.bs.tooltip ዝብል ጽሑፍ ኣሎ። እዚ ፍጻመ እዚ እቲ መሳርሒ ምኽሪ ካብ ተጠቃሚ ምሕባእ ምስ ወድአ እዩ ዝትኮስ (ምስግጋር CSS ክሳብ ዝዛዘም ክጽበ እዩ)።
inserted.bs.tooltip ዝብል ጽሑፍ ኣሎ። እዚ ፍጻመ ድሕሪ እቲ show.bs.tooltipፍጻመ ዝትኮስ እቲ ናይ መሳርሒ ምኽሪ ቅጥዒ ናብ DOM ምስ ተወሰኸ እዩ። 
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})