企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## 弹出框 popover.js * 弹出提示(popover.js)是工具提示的子类,它比工具提示多了一个 content 参数,是工具提示插件的拓展,并且弹出框依赖于工具提示插件tooltip.js,如果你定制了 Bootstrap,就一定要将依赖的插件编译进去。 * 初始化。由于性能的原因,工具提示和弹出框的 data 编程接口(data api)是必须要手动初始化的。在一个页面上一次性初始化所有弹出框的方式是通过`data-toggle`属性选中他们: ```js $(function () {   $('[data-toggle="popover"]').popover(); }) ``` 你也可以单独初始化某个元素上的弹出提示对象。比如,以下代码就只激活 a标签的链接元素上定义的弹出提示: ```html <a href="#" data-toggle="popover" title="Hello" data-content="Hi, Long time no see, how are you?">Say Hello</a> ``` ```js $(function(){ $('a').popover(); }) ``` 与工具提示不同的是,默认情况下,在鼠标单击链接时,才会显示工具提示。并且,弹出提示的默认位置在目标对象的右侧。运行效果如下: ![](https://img.kancloud.cn/8d/71/8d71bfd93a63cd0f4af592703809fb95_600x116.png) 通过 data-placement 属性,可以设置提示信息的显示位置,可选值有 top | bottom | left | right。如图所示: ![](https://img.kancloud.cn/64/00/6400a00935157beabf60774976e8dde9_731x451.png) * 默认情况下,弹出提示一旦显示,就不会再隐藏。如果希望点击空白区域让弹出框消失,只需设置`data-trigger="focus"`属性即可。为了更好的跨浏览器和跨平台效果,你必须使用`<a>`标签,而不能使用`<button>`标签,并且,还必须包含`role="button"`和`tabindex`属性。 ```html <a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">可消失的弹出框</a> ``` 设置`data-trigger="focus"`属性以后,在链接上点击,会弹出提示信息,点击链接和提示框之外的空白区域,提示框便自动消失。 ***** **弹出提示插件的选项** Bootstrap为工具提示插件提供了 11 个选项,所有的选项都可以通过 data 属性或JavaScript进行设置。 | 名称 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | animation | boolean | true | 为工具提示应用CSS淡入淡出过渡效果 | | container | string false | false | 将提示条附加到特定元素,如 container: 'body' | content|string \| function|''|如果data-content属性不存在,则使用这个默认值 | delay | number object | 0 | 延迟显示和隐藏提示条的时间(毫秒)——手动触发提示条时无效如果只指定一个数值,则隐藏和显示都使用该数值。对象的结构为 delay: { show: 500, hide: 100 }| | html | boolean | false | 提示条支持插入 HTML。如果取值为 false,则使用 jQuery 的 text 方法插入文本。如果担心XSS攻击,那就使用文本 | | placement | string function | 'top' | 设置提示条的位置,取值:top | bottom | left | right | | selector | string | false | 如果提供了选择器,在触发该选择器时才显示提示信息 | | template | string | \[1\] | 使用HTML面板创建工具提示。工具提示的title将被注入到.tooltip-inner中。.tooltip-arrow成为工具提示的箭头。最外层的包装元素应该拥有.tooltip类| | title | string function | '' | 如果title属性不存在,则使用默认值 '' 。要注意单引号与双引号的嵌套关系| |trigger|string|'hover focus'|工具提示的触发方式:click 、hover 、 focus 、manual。可以传入多个触发方式,以空格分隔。manual不能与其他触发方式组合使用|viewportstring | object | function{ selector: 'body', padding: 0 }使工具提示始终在元素的边界之内。 viewport|string \| object \| function|{ selector: 'body', padding: 0 }|使工具提示始终在元素的边界之内。 ```markdown 表中 [1] 表示: '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' ``` 因为弹出框依赖工具提示,它继承了工具提示的选项,并且多了'content'这个选项,如上表所示。 其使用选项的方式与工具提示一样,如下: ```html <a href="##" id="bird">小鸟</a> ``` ```js $('#bird').popover({ html: true, title: '<img src="../img/timg.jpg" width="200px" height="200px"/>', placement: 'bottom', delay: { show: 500, hide: 100 } }); ``` 运行效果如下: ![](https://img.kancloud.cn/6f/e8/6fe882df428aa27fc5eb7868a54f045c_758x337.png) ***** **弹出提示插件的方法** 1、.popover(options) 使用一个可选的对象参数 options调用某个页面元素的弹出提示。如: ```js $('某个元素').popover({ html:true, title:'<p>一只小鸟</p> <img src="../img/timg.jpg" width="170px" height="170px"/>', placement:'bottom', delay:{show:500,hide:100} }) ``` 2、.popover('show') 手动触发某个页面元素的弹出提示,如: ```js $('#element').popover('show') ``` 3、.popover('hide') 手动隐藏某个页面元素的弹出提示,如: ```js $('#element').popover('hide') ``` 4、.popover('toggle') 手动打开或隐藏某个页面元素的弹出提示,如: ```js $('#element').popover('toggle') ``` 5、.popover('destroy') 手动隐藏并销毁某个页面元素的弹出提示。如: ```js $('#element').popover('destroy') ``` ***** **弹出框插件的事件** | 事件 | 含义 | | --- | --- | | show.bs.popover | show方法调用之后,立即触发该事件。 | | shown.bs.popover | 当工具提示已经对用户可见(并且过渡效果执行完毕)之后,触发该事件 | | hide.bs.popover | hide方法调用之后,立即触发该事件 | | hidden.bs.popover | 当工具提示已经被隐藏(并且过渡效果执行完毕)之后,触发该事件 | | inserted.bs.popover | 当向DOM插入工具提示模板时,在模板插入完成并且show.bs.popover触发事件之后,触发该事件。 | ```js $('#myTooltip').on('hidden.bs.popover', function () {     alert("弹框已经隐藏。"); }); ```