Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP HOW TO W3.CSS C C++ C# BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS R TYPESCRIPT ANGULAR GIT POSTGRESQL MONGODB ASP AI GO KOTLIN SASS VUE DSA GEN AI SCIPY AWS CYBERSECURITY DATA SCIENCE
     ❯   

Bootstrap JS 工具提示


JS 工具提示 (tooltip.js)

工具提示插件是一个小的弹出框,当用户将鼠标指针悬停在元素上时出现。

有关工具提示的教程,请阅读我们的 Bootstrap 工具提示教程


通过 data-* 属性

data-toggle="tooltip" 激活工具提示。

title 属性指定应在工具提示中显示的文本。

示例

<a href="#" data-toggle="tooltip" title="万岁!">将鼠标悬停在我身上</a>
自己试试 »

通过 JavaScript

工具提示不是纯 CSS 插件,因此必须使用 jQuery 初始化:选择指定的元素并调用 tooltip() 方法。

示例

// 选择文档中所有具有 data-toggle="tooltips" 的元素
$('[data-toggle="tooltip"]').tooltip();

// 选择指定元素
$('#myTooltip').tooltip();
自己试试 »

工具提示选项

选项可以通过 data 属性或 JavaScript 传递。对于 data 属性,将选项名称附加到 data-,如 data-placement=""。

名称 类型 默认值 描述 试试
animation 布尔值 true

指定是否在显示和隐藏工具提示时添加 CSS 淡入淡出过渡效果

  • true - 添加淡入淡出效果
  • false - 不要添加淡入淡出效果
试试
container 字符串或布尔值 false false 将工具提示附加到特定元素。
示例:container: 'body'
试试
delay 数字或对象 0 指定显示和隐藏工具提示所需的时间(毫秒)。

要为显示和隐藏指定不同的延迟,请使用对象结构

delay: {show: 500, hide: 100} - 这将花费 500 毫秒来显示工具提示,但只花费 100 毫秒来隐藏它
试试
html 布尔值  false 指定是否接受工具提示中的 HTML 标签
 
  • true - 接受 HTML 标签
  • false - 不要接受 HTML 标签
注意: HTML 必须插入 title 属性中(或使用 title 选项)。

当设置为 false(默认值)时,将使用 jQuery 的 text() 方法。如果您担心 XSS 攻击,请使用此方法
试试
placement 字符串 "top" 指定工具提示位置。可能的值

  • "top" - 工具提示在顶部
  • "bottom" - 工具提示在底部
  • "left" - 工具提示在左侧
  • "right" - 工具提示在右侧
  • "auto" - 让浏览器决定工具提示的位置。例如,如果值为“auto left”,则工具提示将尽可能显示在左侧,否则显示在右侧。如果值为“auto bottom”,则工具提示将尽可能显示在底部,否则显示在顶部
试试
selector 字符串或布尔值 false false 将工具提示添加到指定的选择器 试试
template 字符串   创建工具提示时要使用的基本 HTML。

工具提示的标题将插入到具有类 .tooltip-inner 的元素中,而具有类 .tooltip-arrow 的元素将成为工具提示的箭头。

最外层的包装元素应具有 .tooltip 类。
title 字符串 "" 指定应在工具提示中显示的文本 试试
trigger 字符串 "hover focus" 指定如何触发工具提示。可能的值

  • "click" - 通过点击触发工具提示
  • "hover" - 将鼠标悬停在工具提示上触发
  • "focus" - 当工具提示获得焦点(通过 Tab 键或点击,例如)时触发
  • "manual" - 手动触发工具提示
提示:要传递多个值,请用空格隔开它们
试试
viewport 字符串或对象 {selector: "body", padding: 0} 使工具提示保持在该元素的边界内。

示例:viewport: '#viewport' 或 {selector: '#viewport', padding: 0}


工具提示方法

下表列出了所有可用的工具提示方法。

方法 描述 试试
.tooltip(options) 使用选项激活工具提示。有关有效值,请参见上面的选项 试试
.tooltip("show") 显示工具提示 试试
.tooltip("hide") 隐藏工具提示 试试
.tooltip("toggle") 切换工具提示 试试
.tooltip("destroy") 隐藏并销毁工具提示 试试

工具提示事件

下表列出了所有可用的工具提示事件。

事件 描述 试试
show.bs.tooltip 当工具提示即将显示时发生 试试
shown.bs.tooltip 当工具提示完全显示(CSS 过渡完成后)时发生 试试
hide.bs.tooltip 当工具提示即将隐藏时发生 试试
hidden.bs.tooltip 当工具提示完全隐藏(CSS 过渡完成后)时发生 试试

更多示例

自定义工具提示设计

使用 CSS 自定义工具提示的外观

示例

/* 工具提示 */
.test + .tooltip > .tooltip-inner {
  background-color: #73AD21;
  color: #FFFFFF;
  border: 1px solid green;
  padding: 15px;
  font-size: 20px;
}

/* 顶部工具提示 */
.test + .tooltip.top > .tooltip-arrow {
  border-top: 5px solid green;
}

/* 底部工具提示 */
.test + .tooltip.bottom > .tooltip-arrow {
  border-bottom: 5px solid blue;
}

/* 左侧工具提示 */
.test + .tooltip.left > .tooltip-arrow {
  border-left: 5px solid red;
}

/* 右侧工具提示 */
.test + .tooltip.right > .tooltip-arrow {
  border-right: 5px solid black;
}
自己试试 »

×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
[email protected]

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
[email protected]

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookie and privacy policy.

Copyright 1999-2024 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.