DIV CSS 佈局教程網

Bootstrap 彈出框(Popover)插件:屬性、方法與事件
編輯:關於JavaScript     

彈出框(Popover)可以看成工具提示的進化版:它除了文字,還能承載標題與較長的內容,適合放說明段落、快捷操作按鈕或小型表單。Bootstrap 的 Popover 插件會依需求動態產生內容與標記,預設插入在觸發元素的後面。

使用上只需把滑鼠懸停在元素上(或改成點擊觸發)即可,內容完全可以用 Bootstrap Data API 填充。要注意的是:Popover 內部實作依賴於 Tooltip 插件,因此若單獨引入,必須先載入 tooltip.js 再載入 popover.js,否則完全不會作用。不想處理依賴就直接載入 bootstrap.js 或壓縮版 bootstrap.min.js。

一、兩種啟用方式

1. 透過 data 屬性

為連結或按鈕加上 data-toggle="popover",title 提供標題、data-content 提供內容,預設顯示在上方:

<a href="#" data-toggle="popover" title="Example popover">請懸停在我的上面</a>

2. 透過 JavaScript

$('#identifier').popover(options)

和 Tooltip 一樣,Popover 不是純 CSS 插件,必須用 jQuery 啟用。一次啟用頁面上所有的彈出框:

$(function () {
  $("[data-toggle='popover']").popover();
});

二、基本範例

點擊一個元素,彈出一個含標題與內容的容器:

<button class="btn btn-lg btn-danger" type="button" data-toggle="popover"
        title="彈出框" data-content="這是一個彈出框插件">
  點擊彈出/隱藏彈出框
</button>

// JavaScript 初始化
$('button').popover();

注意預設的觸發方式是「滑鼠懸停」,若照抄上面的範例卻發現要點擊才出,記得加上 data-trigger="click" 或改用 focus(點擊其他地方自動關閉,很適合搭配表單說明)。

三、可用屬性

Popover 的配置屬性與 Tooltip 幾乎相同,多出的重點是 viewport:

$('button').popover({
  container: 'body',
  viewport: {
    selector: '#view',
    padding: 10
  }
});

container: 'body' 用來避開父元素 overflow: hidden 造成的裁切;viewport 則是 Bootstrap 3.3.5 之後加入的重要選項,它讓彈出框以指定容器為界自動翻轉位置,避免超出視窗。若把 selector 設為 'body',就能防止彈出框被畫面邊緣切掉——這是實務上最常需要調整的一項。

四、四個方法

$('button').popover('show');    // 顯示
$('button').popover('hide');    // 隱藏
$('button').popover('toggle');  // 反轉顯示/隱藏
$('button').popover('destroy'); // 隱藏並銷毀

五、四個事件

$('button').on('show.bs.popover', function () {
  alert('呼叫 show 方法時觸發!');
});

由於 Popover 的內容常用來放互動元素(例如「加入收藏」按鈕),而這些元素是動態產生的,因此若要在內容中綁定事件,務必使用事件委派($(document).on('click', '.selector', fn))或在 shown.bs.popover 中處理,直接對初始 DOM 綁定是不會生效的。

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