DIV CSS 佈局教程網

Bootstrap JavaScript 外掛:彈出框 Popover 學習筆記
編輯:關於JavaScript     

Popover 是在頁面內容上疊加的小小提示層,效果類似 iPad 上的浮出說明,適合用來補充額外資訊。

靜態樣式結構

先看幾個靜態案例的效果:

結構很單純:一個外層容器、一個箭頭、標題與內容。

<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...</p>
    </div>
  </div>
  <div class="popover right"> ... </div>
  <div class="popover bottom"> ... </div>
  <div class="popover left"> ... </div>
  <div class="clearfix"></div>
</div>

還需要一點基本排版讓它們並排展示:

<style type="text/css">
.bs-example-popover .popover {
  position: relative;
  display: block;
  float: left;
  width: 240px;
  margin: 20px;
}
</style>

動態版本

一個按鈕,點擊後在右側彈出提示框。HTML 出乎意料地簡單:

<a id="a2" class="btn btn-lg btn-danger"
   data-placement="right"
   data-content="這裡放彈出框的內容文字"
   title="" href="#" data-original-title="彈出框標題">
  Please Click to toggle popover
</a>

只有一個 <a> 標籤,套上按鈕樣式類,再用三個 data 屬性描述彈出框:

  • data-original-title:標題。
  • data-content:內容。
  • data-placement:位置,可為 top、bottom、left、right。

此時若直接執行,按鈕會出現但點了沒反應——因為還沒初始化。這點與 Tooltip 相同:Bootstrap 的 data API 對 popover 是選擇性加入的,必須自行啟用。

<script type="text/javascript">
$("#a1").popover();
</script>

四個方向

<div class="bs-example tooltip-demo">
  <div class="bs-example-tooltips">
    <button type="button" class="btn btn-default" data-container="body"
            data-toggle="popover" data-placement="left"
            data-content="Vivamus sagittis lacus vel augue...">左側彈框</button>
    <button type="button" class="btn btn-default" data-container="body"
            data-toggle="popover" data-placement="top"
            data-content="Vivamus sagittis lacus vel augue...">上方彈框</button>
    <button type="button" class="btn btn-default" data-container="body"
            data-toggle="popover" data-placement="bottom"
            data-content="Vivamus sagittis lacus vel augue...">下方彈框</button>
    <button type="button" class="btn btn-default" data-container="body"
            data-toggle="popover" data-placement="right"
            data-content="Vivamus sagittis lacus vel augue...">右側彈框</button>
  </div>
</div>

啟用方式可以用 data-toggle 屬性批次處理:

<script type="text/javascript">
$("#a1").popover();
$("[data-toggle=popover]").popover();
</script>

兩個實務上的坑

在按鈕組或輸入框組中使用時:需指定 container: 'body',否則彈出後會讓相鄰元素變寬或失去圓角。

在 disabled 元素上使用時:因 disabled 元素不觸發事件,需先用一個 <div> 包住它,再把 popover 掛在外層 div 上。

用法

$('#example').popover(options);

選項

可透過 data 屬性或 JavaScript 傳入;用 data 屬性時名稱前加 data-,例如 data-animation=""。常用者包含 animation、html(是否允許內容含 HTML)、placement、trigger(hover/click/focus/manual)、title、content、delay 與 container。

方法

$().popover(options)            // 初始化一組元素
$('#element').popover('show')   // 顯示
$('#element').popover('hide')   // 隱藏
$('#element').popover('toggle') // 切換
$('#element').popover('destroy')// 隱藏並銷毀

事件

$('[data-toggle=popover]').on('shown.bs.popover', function () {
  // 彈出框完全顯示後
});

四個事件分別為 show.bs.popover、shown.bs.popover、hide.bs.popover、hidden.bs.popover。

最後提醒

若 data-content 中要放 HTML,必須同時設定 data-html="true";但這也意味著內容若來自使用者輸入就會有 XSS 風險,這種情況請改用標題/內容屬性傳純文字,或以 text() 方式設定。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved