bootstrap5 工具提示——迹忆客-ag捕鱼王app官网
使用bootstrap5 创建工具提示
工具提示是一个小的弹出窗口,当用户将鼠标指针放在链接或按钮等元素上时会出现,来提供有关悬停元素的提示或信息。
工具提示对我们网站的新访问者非常有用,因为它们使用户可以通过将鼠标指针放在图标和链接上来了解它们的用途。
步骤 1:添加工具提示标记
要创建工具提示,我们需要向元素添加 data-bs-toggle="tooltip" 属性。 可以使用 title
属性指定悬停时显示的提示文本。
这是向超链接添加工具提示的标准语法。
同样,我们可以向其他元素(例如 button、icon 等)添加工具提示。
步骤 2:启用工具提示
工具提示可以通过 javascript 启用——只需在 javascript 代码中使用目标元素的 id、class 或任何 css 选择器调用bootstrap 的 tooltip() 方法。
我们可以单独或一次性初始化工具提示。 以下 javascript 代码将通过 data-bs-toggle
属性选择它们来初始化页面上的所有工具提示。
document.addeventlistener("domcontentloaded", function(){ var tooltiptriggerlist = [].slice.call(document.queryselectorall('[data-bs-toggle="tooltip"]')); var tooltiplist = tooltiptriggerlist.map(function(element){ return new bootstrap.tooltip(element); }); });
上面的实例显示的效果如下:
注意
:出于性能原因,工具提示 data-apis 是选择加入的,这意味着要使用工具提示,我们必须自己初始化它们。 此外,永远不会显示带有零长度标题的工具提示,并且在也不会在隐藏元素触发工具提示。
提示
:必须在包装元素上触发 .disabled 或 disabled 元素的工具提示。 此外,当工具提示从跨越多行的超链接触发时,它将居中显示。 我们可以使用空格: nowrap; 在这些超链接上来避免这种行为。
设置工具提示的方向
我们可以将工具提示设置为出现在元素的顶部、右侧、底部和左侧。
通过 data 属性定位工具提示
以下示例将向展示如何通过 data 属性设置工具提示的方向。
通过 javascript 定位工具提示
下面示例将展示如何通过 javascript 设置工具提示的方向。
document.addeventlistener("domcontentloaded", function(){ // placement of tooltip on top var tiptop = document.getelementbyid("tiptop"); var tooltiptop = new bootstrap.tooltip(tiptop, { placement : "top" }); // placement of tooltip on right var tipright = document.getelementbyid("tipright"); var tooltipright = new bootstrap.tooltip(tipright, { placement : "right" }); // placement of tooltip on bottom var tipbottom = document.getelementbyid("tipbottom"); var tooltipbottom = new bootstrap.tooltip(tipbottom, { placement : "bottom" }); // placement of tooltip on left var tipleft = document.getelementbyid("tipleft"); var tooltipleft = new bootstrap.tooltip(tipleft, { placement : "left" }); });
options
有一些选项可以传递给bootstrap tooltip() 方法来自定义工具提示插件的功能。
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
animation | boolean | true | 将 css 淡入淡出过渡应用于工具提示。 |
container | 字符串 | element | boolean |
delay | 数字 | object | 0 |
html | boolean | false | 将 html 插入工具提示。 如果为 true,工具提示标题中的 html 标签将在工具提示中呈现。 如果为 false,则将使用 innertext 属性将内容插入到 dom 中。 如果您担心 xss 攻击,请使用简单文本。 |
placement | 函数 | 字符串 | 'top' |
selector | 字符串 | false | false |
template | 字符串 |
|
创建工具提示时要使用的基本 html。 工具提示的标题将被插入到 .tooltip-inner 元素中。 .tooltip-arrow 元素将成为工具提示的箭头。 最外面的包装元素应该有 .tooltip 类。 |
title | 字符串 | element | 函数 |
trigger | 字符串 | 'hover focus' | 指定如何触发工具提示 — click |
fallbackplacements | 数组 | ['top', 'right', 'bottom', 'left'] | 允许指定 popper 将在回退时使用的位置。 |
boundary | 字符串 | element | 'clippingparents' |
customclass | 字符串 | 函数 | '' |
sanitize | boolean | true | 启用或禁用清理。 如果激活“template”和“title”选项将被清理。 |
allowlist | object | 包含允许的属性和标签的对象。 | |
sanitizefn | null | 函数 | null |
offset | 数组 | 字符串 | 函数 |
popperconfig | null | object | 函数 |