آموزش بوت استرپ
راهنمای جامع و آموزش گام به گام طراحی قالب وبسایت با bootstrap

بررسی اجمالی 

چیزهایی که هنگام استفاده از پلاگین tooltip باید بدانید:

1-نکات راهنمای Toolpip به Popper.js کتابخانه حزب 3 برای موقعیت بندی تکیه می کنند. شما باید popper.min.js را قبل از bootstrap.js قرار دهید یا از bootstrap.bundle.min.js / bootstrap.bundle.js استفاده کنید که شامل Popper.js است تا راهنمایی ها کار کند!

2-اگر جاوا اسکریپت خود را از منبع ایجاد می کنید، به util.js نیاز دارد.

3-نکات مربوط به عملکرد به دلایل عملکرد انتخاب می شوند، بنابراین شما باید خودتان آنها را اولویت بندی کنید.

4-راهنمای ابزار با عناوین صفر هیچ وقت نمایش داده نمی شود.

5-مشخص کردن ظرف: body برای جلوگیری از مشکلات تفسیر در اجزای پیچیده تر

6-راه اندازی ابزارهای تبلیغاتی بر روی عناصر پنهان کار نخواهد کرد.

7-نکات راهنمای ابزار برای عناصر .disabled یا غیرفعال باید بر روی عنصر wrapper triggered شود.

8-هنگامی که از hyperlinks که چندین خط را می گیرند، راهنمایی های متنی متمرکز می شوند. استفاده از فضای سفید: nowrap؛ در مورد <a> شما برای جلوگیری از این رفتار

9-نکات راهنمای قبل از حذف عناصر مربوطه از DOM باید پنهان شوند.

همه چی رو گرفتی؟ عالی است، بیایید ببینیم که چگونه آنها با برخی از نمونه ها کار می کنند.

 

مثال: ابزارهای راهنما را در همه جا فعال کنید

یکی از راههای راه اندازی اولیه تمام راهنمایی ها در یک صفحه، می توان آنها را با ویژگی داده های خود انتخاب کرد:

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

 

مثال ها

روی چهار دکمه زیر کلیک کنید تا چهار راهنمای راهنمای ابزار بالا را ببینید: بالا، پایین، راست و چپ.

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

و با HTML سفارشی اضافه شده است:

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

 

استفاده 

افزونه tooltip محتوا و نشانه گذاری را براساس تقاضا ایجاد می کند و مکان های پیش فرض مکان ها را پس از عنصر ماشه ایجاد می کند.

راه اندازی راهنمای ابزار از طریق جاوا اسکریپت:

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

 

نشانه گذاری 

نشانه گذاری مورد نیاز برای یک راهنمایی فقط یک ویژگی داده و عنوان در عنصر HTML است که شما میخواهید یک راهنمای آن داشته باشید. نشانه گذاری شده از یک راهنمای ابزار نسبتا ساده است، هرچند که نیاز به یک موقعیت دارد.

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

 

عناصر غیر فعال 

عناصر با ویژگی غیرفعال تعاملی نیستند، به این معنی که کاربران نمیتوانند فوکوس، شنا، و یا کلیک بر روی آنها برای ایجاد یک راهنمای ابزار (یا popover). به عنوان یک راه حل، شما می خواهید این راهنمای ابزار را از یک بسته بندی <div> یا <span> کاوش کنید، که با استفاده از "tabbedex = "0 ساخته شده است، به طور ایده آل با تمرکز صفحه کلید، و رویدادهای اشاره گر را در عنصر غیر فعال غیرفعال کنید.

 <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-animation = "" استفاده می کنید.

Name Type Default Description
animation boolean true Apply a CSS fade transition to the tooltip
container string | element | false false

Appends the tooltip to a specific element. Example: container: 'body'. This option is particularly useful in that it allows you to position the tooltip in the flow of the document near the triggering element - which will prevent the tooltip from floating away from the triggering element during a window resize.

delay number | object 0

Delay showing and hiding the tooltip (ms) - does not apply to manual trigger type

If a number is supplied, delay is applied to both hide/show

Object structure is: delay: { "show": 500, "hide": 100 }

html boolean false

Allow HTML in the tooltip.

If true, HTML tags in the tooltip's title will be rendered in the tooltip. If false, jQuery's text method will be used to insert content into the DOM.

Use text if you're worried about XSS attacks.

placement string | function 'top'

How to position the tooltip - auto | top | bottom | left | right.
When auto is specified, it will dynamically reorient the tooltip.

When a function is used to determine the placement, it is called with the tooltip DOM node as its first argument and the triggering element DOM node as its second. The this context is set to the tooltip instance.

selector string | false false If a selector is provided, tooltip objects will be delegated to the specified targets. In practice, this is used to enable dynamic HTML content to have popovers added. See this and an informative example.
template string '<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>'

Base HTML to use when creating the tooltip.

The tooltip's title will be injected into the .tooltip-inner.

.arrow will become the tooltip's arrow.

The outermost wrapper element should have the .tooltipclass and role="tooltip".

title string | element | function ''

Default title value if title attribute isn't present.

If a function is given, it will be called with its this reference set to the element that the tooltip is attached to.

trigger string 'hover focus'

How tooltip is triggered - click | hover | focus | manual. You may pass multiple triggers; separate them with a space.

'manual' indicates that the tooltip will be triggered programmatically via the .tooltip('show').tooltip('hide')and .tooltip('toggle') methods; this value cannot be combined with any other trigger.

'hover' on its own will result in tooltips that cannot be triggered via the keyboard, and should only be used if alternative methods for conveying the same information for keyboard users is present.

offset number | string 0 Offset of the tooltip relative to its target. For more information refer to Popper.js's offset docs.
fallbackPlacement string | array 'flip' Allow to specify which position Popper will use on fallback. For more information refer to Popper.js's behavior docs
boundary string | element 'scrollParent' Overflow constraint boundary of the tooltip. Accepts the values of 'viewport''window''scrollParent', or an HTMLElement reference (JavaScript only). For more information refer to Popper.js's preventOverflow docs.

متد ها 

$().tooltip(options)

یک handler tooltip را به یک مجموعه عنصری متصل می کند.

 

.tooltip('show')

یک راهنمای ابزار عنصر را نشان می دهد قبل از اینکه نشانگر tooltip در واقع نشان داده شده (به عنوان مثال قبل از رویداد show.bs.tooltip رخ داده) به تماس گیرنده برگشت می کند. این در نظر گرفته شده "دستی" راه اندازی از راهنمایی است. راهنمای ابزار با عناوین صفر هیچ وقت نمایش داده نمی شود.

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

 

.tooltip('hide')

پلاگین ابزار element را مخفی می کند. قبل از اینکه راهنمای ابزار پنهان (به عنوان مثال قبل از رویداد hidden.bs.tooltip رخ دهد) به تماس گیرنده برگشت می کند. این در نظر گرفته شده "دستی" راه اندازی از راهنمایی است.

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

 

.tooltip('toggle')

ابزارک عنصر را تغییر می دهد قبل از اینکه نشانگر ابزار در واقع نشان داده شده یا پنهان شده باشد (به عنوان مثال قبل از رویداد نشان داده شده .bs.tooltip یا hidden.bs.tooltip)، تماس گرفته می شود. این در نظر گرفته شده "دستی" راه اندازی از راهنمایی است.

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

 

.tooltip('dispose')

پنهان و ناپدید می شود یک راهنمای ابزار عنصر. نکات راهنمای استفاده از deletion را نمی توان به صورت جداگانه در عناصر ناکام نابود کرد.

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

 

.tooltip('enable')

ابزاری برای نشان دادن یک عنصر به شما می دهد. راهنمایی های ابزار به طور پیش فرض فعال هستند

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

 

.tooltip('disable')

توانایی برای نشان دادن عنصر tooltip را نشان می دهد. اگر دوباره فعال شود، راهنمایی قادر خواهد بود نشان داده شود.

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

 

.tooltip('toggleEnabled')

توانایی برای نشان دادن یک عنصر را نشان می دهد یا پنهان می کند.

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

 

.tooltip('update')

موقعیت یابی یک ابزار راهنمای عنصر را به روز می کند.

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

 

مناسبت ها 

Event Type Description
show.bs.tooltip This event fires immediately when the show instance method is called.
shown.bs.tooltip This event is fired when the tooltip has been made visible to the user (will wait for CSS transitions to complete).
hide.bs.tooltip This event is fired immediately when the hide instance method has been called.
hidden.bs.tooltip This event is fired when the tooltip has finished being hidden from the user (will wait for CSS transitions to complete).
inserted.bs.tooltip This event is fired after the show.bs.tooltip event when the tooltip template has been added to the DOM.
 $('#myTooltip').on('hidden.bs.tooltip', function () { // do something… })