屬性
所有屬性的預設值都可以在全域設定。
屬性 | 類型 | 預設 | 說明 |
---|---|---|---|
aspect | 字串 | '16by9' | 嵌入的長寬比。支援的值有 '16by9'、'21by9'、'4by3' 和 '1by1',且會轉譯成 CSS 類別。有關更多詳細資料,請參閱文件 |
tag | 字串 | 'div' | 指定要渲染為 HTML 標籤而不是預設標籤 |
type | 字串 | 'iframe' | 嵌入類型。可能的值有 'iframe'、'video'、'embed' 和 'object' |
根據父層的寬度建立回應式影片或投影片,在任一裝置上都能隨之縮放。
直接套用於 <iframe>
、<embed>
、<video>
和 <object>
元素
<div>
<b-embed
type="iframe"
aspect="16by9"
src="https://www.youtube.com/embed/zpOULjyy-n8?rel=0"
allowfullscreen
></b-embed>
</div>
<!-- b-embed.vue -->
支援的嵌入類型為 iframe
(預設)、video
、embed
和 object
,相當於標準 HTML 元素 <iframe>
、<video>
、<embed>
和 <object>
。
透過 type
prop 設定要使用的嵌入類型。
長寬比可透過 aspect
prop 設定。支援的長寬比為:21by9
(21:9)、16by9
(16:9)、4by3
(4:3) 和 1by1
(1:1)。預設長寬比為 16by9
。長寬比定義在 Bootstrap 的 SCSS 中,轉換為類別名稱 embed-responsive-{aspect}
(例如 embed-responsive-16by9
、embed-responsive-4by3
等)。
回應式嵌入封裝於外層元素(預設為 div
)內,以強制套用法向的長寬比。可透過 tag
prop 變更此標籤。
type
、aspect
與 tag
props) 的任何其他額外屬性都套用在內嵌的元素內 (即 iframe
、video
、embed
或 object
)。 在 <b-embed>
開頭和結尾標籤之間的任何子元素都將置入內嵌元素內。請注意類型 iframe
不支援任何子元素。
範例:回應式嵌入 HTML5 <video>
<div>
<b-embed type="video" aspect="4by3" controls poster="poster.png">
<source src="dev-stories.webm" type="video/webm">
<source src="dev-stories.mp4" type="video/mp4">
</b-embed>
</div>
<b-embed>
所有屬性的預設值都可以在全域設定。
屬性 | 類型 | 預設 | 說明 |
---|---|---|---|
aspect | 字串 | '16by9' | 嵌入的長寬比。支援的值有 '16by9'、'21by9'、'4by3' 和 '1by1',且會轉譯成 CSS 類別。有關更多詳細資料,請參閱文件 |
tag | 字串 | 'div' | 指定要渲染為 HTML 標籤而不是預設標籤 |
type | 字串 | 'iframe' | 嵌入類型。可能的值有 'iframe'、'video'、'embed' 和 'object' |
名稱 | 說明 |
---|---|
預設 | 要插入嵌入中的內容 |
你可以透過下列命名外來匯入個別組件到你的專案中
組件 | 命名外來 | 匯入路徑 |
---|---|---|
<b-embed> | BEmbed | bootstrap-vue |
範例
import { BEmbed } from 'bootstrap-vue' Vue.component('b-embed', BEmbed)
此外掛包含了上述所有列出的個別組件. 外掛也包含了任何組件別名。
命名外來 | 匯入路徑 |
---|---|
EmbedPlugin | bootstrap-vue |
範例
import { EmbedPlugin } from 'bootstrap-vue' Vue.use(EmbedPlugin)