ٽول ٽِپ

اوسر

ٽول ٽائپ پلگ ان کي استعمال ڪرڻ وقت ڄاڻڻ جون شيون:

• ٽول ٽائپس پوزيشن لاءِ ٽئين پارٽي لائبريري پوپر تي ڀروسو ڪن ٿا . توھان کي شامل ڪرڻ گھرجي popper.min.js کان اڳ bootstrap.js، يا ھڪڙو استعمال ڪريو bootstrap.bundle.min.jsجنھن ۾ Popper شامل آھي.
• اوزار ٽائيپ ڪارڪردگي سببن لاءِ آپٽ اِن آهن، تنهنڪري توهان کي انهن کي پاڻ شروع ڪرڻ گهرجي .
• زيرو ڊگھائي عنوانن سان ٽول ٽائپس ڪڏھن به نه ڏيکاريا ويندا آھن.
• container: 'body'وڌيڪ پيچيده اجزاء (جهڙوڪ اسان جي ان پٽ گروپن، بٽڻ گروپن، وغيره) ۾ رينجرنگ مسئلن کان بچڻ لاء وضاحت ڪريو .
• لڪيل عناصر تي ٽول ٽائپس کي ٽوڙڻ ڪم نه ڪندو.
• ٽول ٽائپس لاءِ .disabledيا disabledعناصر لازمي طور تي چاڙهيو وڃي ٿو چادر جي عنصر تي.
• جڏهن هائيپر لنڪس کان شروع ڪيو ويو آهي جيڪو گھڻن لائينن تي مشتمل آهي، ٽول ٽائپس کي مرڪز ڪيو ويندو. هن رويي کان بچڻ لاء white-space: nowrap;توهان جي ايس تي استعمال ڪريو .<a>
• ٽول ٽائپس کي لڪايو وڃي ان کان اڳ جو انهن جي لاڳاپيل عنصرن کي DOM مان هٽايو وڃي.
• ٽول ٽائپس کي شيڊ ڊوم اندر هڪ عنصر جي مهرباني سان شروع ڪري سگهجي ٿو.

اهو سڀ مليو؟ عظيم، اچو ته ڏسو ته اهي ڪجهه مثالن سان ڪيئن ڪم ڪن ٿا.

مثال

ٽول ٽائپس کي فعال ڪريو

جيئن مٿي ذڪر ڪيو ويو آهي، توهان کي ٽول ٽائپس کي شروع ڪرڻ گهرجي ان کان پهريان اهي استعمال ڪري سگهجن. ھڪڙي صفحي تي سڀني ٽول ٽائپس کي شروع ڪرڻ جو ھڪڙو طريقو اھو آھي انھن کي انھن جي data-bs-toggleخاصيت سان چونڊيو، جھڙوڪ:

const tooltipTriggerList = document.querySelectorAll('[data-bs-toggle="tooltip"]')
const tooltipList = [...tooltipTriggerList].map(tooltipTriggerEl => new bootstrap.Tooltip(tooltipTriggerEl))

لنڪس تي اوزار

ٽول ٽائپس ڏسڻ لاءِ هيٺ ڏنل لنڪ تي هور ڪريو:

<p class="muted">Placeholder text to demonstrate some <a href="#" data-bs-toggle="tooltip" data-bs-title="Default tooltip">inline links</a> with tooltips. This is now just filler, no killer. Content placed here just to mimic the presence of <a href="#" data-bs-toggle="tooltip" data-bs-title="Another tooltip">real text</a>. And all that just to give you an idea of how tooltips would look when used in real-world situations. So hopefully you've now seen how <a href="#" data-bs-toggle="tooltip" data-bs-title="Another one here too">these tooltips on links</a> can work in practice, once you use them on <a href="#" data-bs-toggle="tooltip" data-bs-title="The last tip!">your own</a> site or project.
</p>

حسب ضرورت اوزار

توهان CSS متغير استعمال ڪندي ٽول ٽائپس جي ظاهر کي ترتيب ڏئي سگهو ٿا . اسان هڪ ڪسٽم ڪلاس مقرر ڪريون ٿا data-bs-custom-class="custom-tooltip"اسان جي ڪسٽم ظهور جي دائري لاءِ ۽ ان کي استعمال ڪريو مقامي CSS متغير کي ختم ڪرڻ لاءِ.

.custom-tooltip {
  --bs-tooltip-bg: var(--bs-primary);
}

<button type="button" class="btn btn-secondary"
        data-bs-toggle="tooltip" data-bs-placement="top"
        data-bs-custom-class="custom-tooltip"
        data-bs-title="This top tooltip is themed via CSS variables.">
  Custom tooltip
</button>

ھدايتون

ھيٺ ڏنل بٽڻن تي ھوور ڪريو چار ٽول ٽائپس ھدايتون ڏسڻ لاءِ: مٿي، ساڄي، ھيٺ، ۽ کاٻي. RTL ۾ Bootstrap استعمال ڪرڻ وقت ھدايتون نظر اچن ٿيون.

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

۽ ڪسٽم HTML سان شامل ڪيو ويو:

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

هڪ SVG سان:

سي ايس ايس

متغير

Bootstrap جي ترقي يافته CSS متغير جي نقطي جي حصي جي طور تي، ٽول ٽائپس ھاڻي مقامي سي ايس ايس متغير استعمال ڪن ٿيون .tooltipاصل وقت جي ڪسٽمائيزيشن لاءِ. CSS متغيرن لاءِ قيمتون Sass ذريعي سيٽ ڪيون ويون آهن، تنهنڪري Sass ڪسٽمائيزيشن اڃا به سپورٽ ٿيل آهي.

  --#{$prefix}tooltip-zindex: #{$zindex-tooltip};
  --#{$prefix}tooltip-max-width: #{$tooltip-max-width};
  --#{$prefix}tooltip-padding-x: #{$tooltip-padding-x};
  --#{$prefix}tooltip-padding-y: #{$tooltip-padding-y};
  --#{$prefix}tooltip-margin: #{$tooltip-margin};
  @include rfs($tooltip-font-size, --#{$prefix}tooltip-font-size);
  --#{$prefix}tooltip-color: #{$tooltip-color};
  --#{$prefix}tooltip-bg: #{$tooltip-bg};
  --#{$prefix}tooltip-border-radius: #{$tooltip-border-radius};
  --#{$prefix}tooltip-opacity: #{$tooltip-opacity};
  --#{$prefix}tooltip-arrow-width: #{$tooltip-arrow-width};
  --#{$prefix}tooltip-arrow-height: #{$tooltip-arrow-height};
  

سس متغير

$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:                    null; // TODO: remove this in v6

$tooltip-arrow-width:               .8rem;
$tooltip-arrow-height:              .4rem;
// fusv-disable
$tooltip-arrow-color:               null; // Deprecated in Bootstrap 5.2.0 for CSS variables
// fusv-enable

استعمال

ٽول ٽائپ پلگ ان مطالبن تي مواد ۽ مارڪ اپ ٺاهي ٿو، ۽ ڊفالٽ طور تي ٽول ٽائپس کي انهن جي محرڪ عنصر کان پوءِ رکي ٿو.

جاوا اسڪرپٽ ذريعي ٽول ٽائپ کي ٽوڙيو:

const exampleEl = document.getElementById('example')
const tooltip = new bootstrap.Tooltip(exampleEl, options)

const tooltip = new bootstrap.Tooltip('#example', {
  boundary: document.body // or document.querySelector('#boundary')
})

مارڪ اپ

ٽول ٽائپ لاءِ گهربل مارڪ اپ صرف هڪ dataخاصيت آهي ۽ titleHTML عنصر تي توهان چاهيو ٿا ته هڪ ٽول ٽائپ. ٽول ٽائپ جو ٺاهيل مارڪ اپ بلڪل سادو آهي، جيتوڻيڪ ان کي پوزيشن جي ضرورت آهي (ڊفالٽ طور، topپلگ ان طرفان مقرر ڪيل).

<!-- HTML to write -->
<a href="#" data-bs-toggle="tooltip" data-bs-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>

معذور عناصر

وصف سان گڏ عناصر disabledمتعامل نه هوندا آهن، مطلب ته صارف هڪ ٽول ٽائپ (يا پاپ اوور) کي ٽرگر ڪرڻ لاءِ انهن تي توجهه، هوور، يا ڪلڪ نٿا ڪري سگهن. ڪم ڪار جي طور تي، توھان چاھيو ٿا ٽول ٽِپ کي ٽول ٽِپ کي ريپر مان <div>يا <span>، مثالي طور تي ڪيبورڊ تي ڌيان ڏيڻ جي قابل استعمال ڪندي tabindex="0".

<span class="d-inline-block" tabindex="0" data-bs-toggle="tooltip" data-bs-title="Disabled tooltip">
  <button class="btn btn-primary" type="button" disabled>Disabled button</button>
</span>

اختيارن

جيئن ته اختيارن کي ڊيٽا انتساب يا جاوا اسڪرپٽ ذريعي منتقل ڪري سگھجي ٿو، توھان ھڪڙي اختيار جو نالو شامل ڪري سگھو ٿا data-bs-، جيئن data-bs-animation="{value}". ڊيٽا جي خاصيتن ذريعي اختيارن کي پاس ڪرڻ وقت اختياري جي صورت واري قسم کي تبديل ڪرڻ جي پڪ ڪريو ”ڪيم ڪيس“ مان ” ڪباب ڪيس “. مثال طور، data-bs-custom-class="beautifier"جي بدران استعمال ڪريو data-bs-customClass="beautifier".

Bootstrap 5.2.0 جي طور تي، سڀئي جزا هڪ تجرباتي محفوظ ڪيل ڊيٽا جي خاصيت کي سپورٽ ڪن data-bs-configٿا جيڪي JSON اسٽرنگ جي طور تي سادي جزو جي جوڙجڪ کي گھرائي سگھن ٿا. جڏهن هڪ عنصر آهي data-bs-config='{"delay":0, "title":123}'۽ data-bs-title="456"خاصيتون آهن، حتمي titleقيمت هوندي 456۽ الڳ الڳ ڊيٽا خاصيتون ڏنل قدرن کي ختم ڪري ڇڏيندو data-bs-config. ان کان علاوه، موجوده ڊيٽا جون خاصيتون JSON قدرن کي گھرائڻ جي قابل آھن جھڙوڪ data-bs-delay='{"show":0,"hide":150}'.

فنڪشن سان استعمال ڪنديpopperConfig

const tooltip = new bootstrap.Tooltip(element, {
  popperConfig(defaultBsPopperConfig) {
    // const newPopperConfig = {...}
    // use defaultBsPopperConfig if needed...
    // return newPopperConfig
  }
})

طريقا

const tooltip = bootstrap.Tooltip.getInstance('#example') // Returns a Bootstrap tooltip instance

// setContent example
tooltip.setContent({ '.tooltip-inner': 'another title' })

واقعا

const myTooltipEl = document.getElementById('myTooltip')
const tooltip = bootstrap.Tooltip.getOrCreateInstance(myTooltipEl)

myTooltipEl.addEventListener('hidden.bs.tooltip', () => {
  // do something...
})

tooltip.hide()