4.6Bootstrap学习js插件篇之弹出框

喜欢ヅ旅行 2022-08-27 04:42 186阅读 0赞

## 案例 ##

为页面内容添加一个小的覆盖层，就像iPad上的效果一样，为页面元素增加额外的信息。

#### 插件依赖 ####

弹出框依赖[工具提示插件][Link 1]，因此需要先加载工具提示插件。

#### 选择性加入的功能 ####

出于性能方面的考虑，工具提示和弹框组件的data属性api是选择性加入的，也就是说你必须自己初始化他们。

#### 弹出框在按钮组和输入框组中使用时，需要额外的设置 ####

当提示框与`.btn-group` 或 `.input-group`联合使用时，你需要指定`container: 'body'`选项（见下面的文档）以避免不需要的副作用（例如，当弹出框显示之后，与其合作的页面元素可能变得更宽或是去圆角）。

#### 在禁止使用的页面元素上使用弹出框时需要额外增加一个元素将其包裹起来 ####

为了给`disabled` 或`.disabled`元素添加弹出框时，将需要增加弹出框的页面元素包裹在一个`<div>`中，然后对这个`<div>`元素应用弹出框。

### 静态案例 ###

4个可选选项：top、right、bottom,和left排列。

代码段

.bs-example
    		{
    			border-color:#ddd;
    			border-radius:4px 4px 0 0;
    			border-width:1px;
    			box-shadow:none;
    			margin-left:0;
    			margin-right:0;
    			border-style:solid;
    		}
    	.bs-example-popover .popover {
          position: relative;
          display: block;
          float: left;
          width: 240px;
          margin: 20px;
    }

<h1 class="page-header">3、弹出框</h1>
    	<div class="bs-example bs-example-popover">
    	<div class="popover top">
    		<div class="arrow"></div>
    		<h3 class="popover-title">Popover top</h3>
    		<div class="popover-content">
    			<p>Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.</p>
    		</div>
    	</div>
    	<div class="popover right">
            <div class="arrow"></div>
            <h3 class="popover-title">Popover right</h3>
            <div class="popover-content">
              <p>Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.</p>
            </div>
          </div>
    
          <div class="popover bottom">
            <div class="arrow"></div>
            <h3 class="popover-title">Popover bottom</h3>
    
            <div class="popover-content">
              <p>Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.</p>
            </div>
          </div>
    
          <div class="popover left">
            <div class="arrow"></div>
            <h3 class="popover-title">Popover left</h3>
            <div class="popover-content">
              <p>Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.</p>
            </div>
          </div>
    	</div>

预览效果

![Center][]

动态演示：

代码段：

js初始化：

预览效果：

![Center 1][]

注意，当指定了placement时候，特别注意方向问题。因为弹出框是以触发事件元素中心开始弹出，很可能被覆盖而无法全部显示出来。

代码中a标签href属性必须指定为javascript:void(0)去除链接效果。

四个方位：

代码

<a href="javascript:void(0)" id="a_pop1" class="btn btn-danger" data-placement="left" data-content=
    	"
    	风吹雨成花 时间追不上白马
    	你年少掌心的梦话 依然紧握着吗
    	云翻涌成夏 眼泪被岁月蒸发
    	这条路上的你我她 有谁迷路了吗
    	"
    	data-original-title="时间煮雨"
    	>左侧</a>
    	<a href="javascript:void(0)" id="a_pop2" class="btn btn-danger" data-placement="top" data-content=
    	"
    我们说好不分离 要一直一直在一起
    就算与时间为敌 就算与全世界背离
    风吹亮雪花 吹白我们的头发 
    当初说一起闯天下 你们还记得吗
    	" data-original-title="时间煮雨">
    	上部
    	</a>
    	<a href="javascript:void(0)" id="a_pop3" class="btn btn-danger" data-placement="bottom" data-content=
    	"
    那一年盛夏 心愿许的无限大
    我们手拉手也成舟 划过悲伤河流
    你曾说过不分离 要一直一直在一起
    现在我想问问你 是否只是童言无忌
    	" data-original-title="时间煮雨">
    	下部
    	</a>
    	<a href="javascript:void(0)" id="a_pop4" class="btn btn-danger" data-placement="right" data-content=
    	"
    	天真岁月不忍欺 青春荒唐我不负你
    大雪求你别抹去 我们在一起的痕迹
    大雪也无法抹去 我们给彼此的印记
    今夕何夕 青草离离
    明月夜送君千里 等来年 秋风起
    	" data-original-title="时间煮雨">
    	右侧
    	</a>
    	</div>
    	<script type="text/javascript">
    		$("#a_pop1").popover();
    		$("#a_pop2").popover();
    		$("#a_pop3").popover();
    		$("#a_pop4").popover();
    	</script>

预览效果；

![Center 2][]

### 选项 ###

可以将选项通过data属性或JavaScript传递。对于data属性，需要将选项名称放到`data-`之后，例如`data-animation=""`。

<table style="border-collapse:collapse; border-spacing:0px; max-width:100%; background-color:transparent; width:847px; margin-bottom:20px; border:1px solid rgb(221,221,221)"> 
 <thead style=""> 
  <tr style=""> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221); width:100px"> 名称</th> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221); width:100px"> 类型</th> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221); width:50px"> 默认值</th> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221)"> 描述</th> 
  </tr> 
 </thead> 
 <tbody style=""> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> animation</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> boolean</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> true</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> apply a CSS fade transition to the tooltip</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> html</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> boolean</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> false</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> Insert HTML into the popover. If false, jQuery's&nbsp;<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">text</code>&nbsp;method will be used to insert content into the DOM. Use text if you're worried about XSS attacks.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> placement</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> string | function</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> 'right'</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> how to position the popover - top | bottom | left | right | auto.<br style=""> When "auto" is specified, it will dynamically reorient the popover. For example, if placement is "auto left", the tooltip will display to the left when possible, otherwise it will display right.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> selector</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> string</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> false</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> 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&nbsp;<a href="https://github.com/twbs/bootstrap/issues/4215" style="background-color:transparent; color:rgb(66,139,202); text-decoration:none" rel="nofollow">this</a>&nbsp;and&nbsp;<a href="http://jsfiddle.net/fScua/" style="background-color:transparent; color:rgb(66,139,202); text-decoration:none" rel="nofollow">an informative example</a>.</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> trigger</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> string</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> 'click'</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> how popover is triggered - click | hover | focus | manual</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> title</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> string | function</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> ''</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> default title value if&nbsp;<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">title</code>&nbsp;attribute isn't present</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> content</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> string | function</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> ''</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> default content value if&nbsp;<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">data-content</code>&nbsp;attribute isn't present</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> delay</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> number | object</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> 0</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> <p style="margin-top:0px; margin-bottom:10px; line-height:2">delay showing and hiding the popover (ms) - does not apply to manual trigger type</p> <p style="margin-top:0px; margin-bottom:10px; line-height:2">If a number is supplied, delay is applied to both hide/show</p> <p style="margin-top:0px; margin-bottom:10px; line-height:2">Object structure is:&nbsp;<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">delay: { show: 500, hide: 100 }</code></p> </td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> container</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> string | false</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> false</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> <p style="margin-top:0px; margin-bottom:10px; line-height:2">Appends the popover to a specific element. Example:&nbsp;<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">container: 'body'</code>. This option is particularly useful in that it allows you to position the popover in the flow of the document near the triggering element -&nbsp;which will prevent the popover from floating away from the triggering element during a window resize.</p> </td> 
  </tr> 
 </tbody> 
</table>

#### 为单个弹出框应用data属性 ####

对单个弹出框可以通过data属性单独指定选项，如上所示。

### 方法 ###

#### $().popover(options) ####

为一组元素初始化弹出框。

#### .popover('show') ####

显示弹出框。

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

#### .popover('hide') ####

隐藏弹出框。

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

#### .popover('toggle') ####

展示或隐藏弹出框。

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

#### .popover('destroy') ####

隐藏并销毁弹出框。

$('#element').popover('destroy')

### 事件 ###

$( '\#myPopover' ).on( 'hidden.bs.popover' ,  **function**() \{   *// do something…* \})

[Link 1]: http://v3.bootcss.com/javascript/#tooltips
[Center]: /images/20220824/46b20a6f409043dd8364eca71e5935b7.png
[Center 1]: /images/20220824/061fe09ef7674b6d9f0a435369056e7e.png
[Center 2]: /images/20220824/7a268840f54c4c52964c694b03d7d82f.png