約夏克布丁
將 Bootstrap 彈出框(如 iOS 中的彈出框)添加到您網站上的任何元素的文檔和示例。
使用 popover 插件時要知道的事情:
- Popover 依賴第三方庫Popper.js進行定位。您必須在 bootstrap.js 之前包含popper.min.js或使用
bootstrap.bundle.min.js
/bootstrap.bundle.js
其中包含 Popper.js 才能使彈出框工作! - 彈出框需要工具提示插件作為依賴項。
- 如果您從源代碼構建我們的 JavaScript,它需要
util.js
. - 出於性能原因,彈出框是可選的,因此您必須自己初始化它們。
- 零長度
title
和content
值永遠不會顯示彈出框。 - 指定
container: 'body'
以避免在更複雜的組件(如我們的輸入組、按鈕組等)中出現渲染問題。 - 在隱藏元素上觸發彈出框將不起作用。
.disabled
or元素的彈出框disabled
必須在包裝元素上觸發。- 當從跨越多行的錨點觸發時,彈出框將在錨點的整體寬度之間居中。
white-space: nowrap;
在你的 s 上使用<a>
以避免這種行為。 - 在從 DOM 中刪除其相應元素之前,必須隱藏彈出框。
繼續閱讀以了解彈出框如何與一些示例一起使用。
初始化頁面上所有彈出框的一種方法是通過它們的data-toggle
屬性來選擇它們:
當父元素上的某些樣式會干擾彈出框時,您需要指定自定義樣式,container
以便彈出框的 HTML 出現在該元素中。
<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>
有四個選項可用:上對齊、右對齊、下對齊和左對齊。
使用focus
觸發器在用戶下次單擊與切換元素不同的元素時關閉彈出框。
下次單擊時關閉所需的特定標記
對於正確的跨瀏覽器和跨平台行為,您必須使用<a>
標籤,而不是<button>
標籤,並且您還必須包含一個tabindex
屬性。
<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?">Dismissible popover</a>
具有該disabled
屬性的元素不是交互式的,這意味著用戶無法懸停或單擊它們來觸發彈出框(或工具提示)。作為一種解決方法,您需要從包裝器中觸發彈出框,<div>
或者<span>
覆蓋pointer-events
禁用元素上的 。
對於禁用的彈出框觸發器,您可能還希望data-trigger="hover"
彈出框顯示為用戶的即時視覺反饋,因為他們可能不希望單擊禁用的元素。
<span class="d-inline-block" data-toggle="popover" data-content="Disabled popover">
<button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>
通過 JavaScript 啟用彈出框:
選項可以通過數據屬性或 JavaScript 傳遞。對於數據屬性,將選項名稱附加到 中data-
,如data-animation=""
.
姓名 | 類型 | 默認 | 描述 |
---|---|---|---|
動畫 | 布爾值 | 真的 | 對彈出框應用 CSS 淡入淡出過渡 |
容器 | 字符串 | 元素 | 錯誤的 | 錯誤的 | 將彈出框附加到特定元素。示例: |
內容 | 字符串 | 元素 | 功能 | '' |
如果給定了一個函數,它將被調用,並將其 |
延遲 | 號碼 | 目的 | 0 | 延遲顯示和隱藏彈出框(毫秒) - 不適用於手動觸發類型 如果提供了一個數字,延遲將應用於隱藏/顯示 對象結構為: |
html | 布爾值 | 錯誤的 | 將 HTML 插入彈出框。如果為 false,jQuery 的text 方法將用於將內容插入 DOM。如果您擔心 XSS 攻擊,請使用文本。 |
放置 | 字符串 | 功能 | '正確的' | 如何定位彈出框 - 自動 | 頂部 | 底部 | 離開 | 正確的。 當一個函數用於確定位置時,它會以彈出框 DOM 節點作為其第一個參數,觸發元素 DOM 節點作為其第二個參數來調用。 |
選擇器 | 字符串 | 錯誤的 | 錯誤的 | 如果提供了選擇器,彈出框對象將被委託給指定的目標。實際上,這用於啟用動態 HTML 內容以添加彈出框。請參閱this和一個內容豐富的示例。 |
模板 | 細繩 | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>' |
創建彈出框時要使用的基本 HTML。 彈出框 彈出框
最外層的包裝元素應該有 |
標題 | 字符串 | 元素 | 功能 | '' |
如果給定了一個函數,它將被調用,並將其 |
扳機 | 細繩 | '點擊' | 彈出框是如何觸發的 - 點擊 | 懸停 | 焦點 | 手動的。您可以傳遞多個觸發器;用空格分隔它們。`manual` 不能與任何其他觸發器結合使用。 |
抵消 | 號碼 | 細繩 | 0 | 彈出框相對於其目標的偏移量。有關更多信息,請參閱 Popper.js 的偏移量文檔。 |
後備放置 | 字符串 | 大批 | '翻動' | 允許指定 Popper 將在回退時使用的位置。有關更多信息,請參閱 Popper.js 的行為文檔 |
邊界 | 字符串 | 元素 | '滾動父' | 彈出框的溢出約束邊界。接受 、 、 或 HTMLElement 引用的值'viewport' ('window' 僅限'scrollParent' JavaScript)。有關更多信息,請參閱 Popper.js 的preventOverflow 文檔。 |
單個彈出框的數據屬性
如上所述,可以通過使用數據屬性來指定單個彈出框的選項。
異步方法和轉換
所有 API 方法都是異步的並開始一個轉換。他們會在轉換開始但在結束之前立即返回給調用者。此外,過渡組件上的方法調用將被忽略。
初始化元素集合的彈出框。
顯示元素的彈出框。在彈出框實際顯示之前(即在事件發生之前)返回給調用者。shown.bs.popover
這被認為是彈出框的“手動”觸發。標題和內容都為零長度的彈出框永遠不會顯示。
隱藏元素的彈出框。在彈出框實際上被隱藏之前(即在事件發生之前)返回給調用者。hidden.bs.popover
這被認為是彈出框的“手動”觸發。
切換元素的彈出框。在彈出框實際顯示或隱藏之前(即在or事件發生之前)返回給調用者。這被認為是彈出框的“手動”觸發。shown.bs.popover
hidden.bs.popover
隱藏和銷毀元素的彈出框。使用委託(使用選項創建)的selector
彈出框不能在後代觸發器元素上單獨銷毀。
使元素的彈出框能夠顯示。彈出框默認啟用。
移除顯示元素彈出框的能力。只有重新啟用彈出框才能顯示。
切換元素的彈出框是否顯示或隱藏。
更新元素彈出框的位置。
事件類型 | 描述 |
---|---|
show.bs.popover | show 調用實例方法時立即觸發此事件。 |
顯示的.bs.popover | 當彈出框對用戶可見時觸發此事件(將等待 CSS 轉換完成)。 |
hide.bs.popover | hide 調用實例方法時立即觸發此事件。 |
hidden.bs.popover | 當彈出窗口完成對用戶隱藏時觸發此事件(將等待 CSS 轉換完成)。 |
插入的.bs.popover | 該事件show.bs.popover 在彈出框模板添加到 DOM 後觸發。 |