使用popover提示框插件时需要注意的事项:
bootstrap.bundle.min.js
/ bootstrap.bundle.js
(这两个脚本中已经包含了Popper.js可以直接运行弹出提示框)。util.js
脚本文件。title
和 content
不会显示为一个弹出提示框。container: 'body'
定义,以避免在更复杂的组件(如输入框组、按钮组等)中产生呈现问题。.disabled
或 disabled
元素的弹出提示框触发点击按钮,必须在在外层父元素上。<a>
上使用 white-space: nowrap;
可以避免这种情况。$(function () { $('[data-toggle="popover"]').popover() })
$(function () { $('.example-popover').popover({ container: 'body' }) })
使用 focus
触发器在用户下次单击当前元素之外的其他元素时关闭弹出窗口。
利用JavaScript启动提示泡:
$('#example').popover(options)
可通过数据属性或JavaScript传递选项参数。对于数据属性,请将选项名称附加到 data-
上,如 data-animation=""
。
名称 | Type类型 | 默认值 | 描述 |
---|---|---|---|
animation | boolean | true | 将CSS淡入淡出转换应用于popover提示框。 |
container | string | element | false | false | 向一个特定元素追加提示框,如 container: 'body' 。这个选项候特别有用,因为它允许你将弹出提示定位在触发元素附近的内容中--这将防止在窗口调整大小的时候,提示框飘到远离(撑出)触发元素的位置。 |
content | string | element | function | '' | 如果 如果提供了一个函数,调用这个函数时,函数的 |
delay | number | object | 0 | 延迟显示和隐藏弹出(ms) - 不适用于手动触发类型。 如果向这个选项提供一个数字值,显示和隐藏都会应用这个延迟。 Object对象结构是: |
html | boolean | false | 向提示框插入HTML。如果值为false,将使用jQuery的text方法向DOM插入内容。如果你担心跨站脚本攻击的话,请使用text 。 |
placement | string | function | 'right' | 如何定位提示框:auto | top | bottom | left | right。 如果用一个函数来决定placement,会调用提示框的DOM节点作为第一个参数,然后触发元素的DOM节点是第二个参数。 |
selector | string | false | false | 如果提供了一个选择器,提示框将被委派给指定的目标。在实践中,它让动态添加的HTML内容也能附加提示框。请参阅 这里文档 以及 一个翔实的示例。 |
template | string | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
在创建提示框时使用基本HTML。 动态提示框的 动态提示框的
最外层的包裹元素必须拥有 |
title | string | element | function | '' | 如果 如果提供了一个函数,调用这个函数时,函数的 |
trigger | string | 'click' | 如何触发提示框 - click | hover | focus | manual。你可以传递多个触发器,用空格隔开它们。但是`manual`不能与别的触发器结合使用。 |
offset | number | string | 0 | 提示框相对于目标的偏移,欲知更多请查询 Tether的偏移文档。 |
fallbackPlacement | string | array | 'flip' | 指定动态提示框在回调时使用哪个位置,有关更多信息请参阅 Popper.js 的 行为属性文档。 |
$().popover(options)
元集集团的弹出提示框初始化。
.popover('show')
显示一个元素的提示框,在弹出实际显示之前返回给调用者(即在shown.bs.popover
事件发生前),这被认为是弹出提示框的手动触发,标题和内容为弹出提示框不显示。
$('#element').popover('show')
.popover('hide')
隐藏元素的提示框,在弹出提示框实际被隐藏之前返回给调用者(即在 hidden.bs.popover
事件发生前),这被认为是弹出提示框的手动触发。
$('#element').popover('hide')
.popover('toggle')
切换元素的提示框,在popver提示框实际显示或隐藏之前返给调用者,即在 shown.bs.popover
或 hidden.bs.popover
事件发生前,这被认为是弹出提示框的手手动触发触发。
$('#element').popover('toggle')
.popover('dispose')
隐藏和销毁一个元素的提示框,使用委托授权 (使用the selector
option创建)的提示框不能在后代触发元素不被单独销毁。
$('#element').popover('dispose')
给一个元素的提示框显示能力,提示框在默认情况下是启用的。
$('#element').popover('enable')
.popover('disable')
删除要显示元素的提示框,只有在重新启用后,才能显示出提示框。
$('#element').popover('disable')
.popover('toggleEnabled')
切换提示窗口的显示或隐藏功能。
$('#element').popover('toggleEnabled')
.popover('update')
更新元素的提示框的位置。
$('#element').popover('update')
事件 | 描述 |
---|---|
show.bs.popover | 当调用 show 实例方法时,此事件立即触发。 |
shown.bs.popover | 当提示框显示时,会触发此事件(待CSS转换过渡完成)。 |
hide.bs.popover | 当调用 hide 实例方法时,此事件立即触发。 |
hidden.bs.popover | 当提示框隐藏后,会触发此事件(待CSS转换过渡完成)。 |
inserted.bs.popover | 当提示框对用户来说最终完成隐藏时(需要等待CSS转换过渡完成),会触发该事件。当事件弹出模板被添加到DOM时,show.bs.popover 事件被触发。 |
$('#myPopover').on('hidden.bs.popover', function () { // do something… })