ジャンボトロン

サイトの主要なマーケティングメッセージを目立たせるために、オプションでビューポート全体に拡張できる、軽量で柔軟なコンポーネントです。

header プロパティと lead プロパティを使用して、見出しとリードテキストを設定できます。または、HTML サポートが必要な場合は、名前付きスロット headerlead を使用できます。

開始タグと終了タグの間にあるその他のものは、ジャンボトロンの下部にレンダリングされます。

プロパティを使った使用方法

<div>
  <b-jumbotron header="BootstrapVue" lead="Bootstrap v4 Components for Vue.js 2">
    <p>For more information visit website</p>
    <b-button variant="primary" href="#">More Info</b-button>
  </b-jumbotron>
</div>

<!-- b-jumbotron.vue -->

スロットを使った使用方法

<div>
  <b-jumbotron>
    <template #header>BootstrapVue</template>

    <template #lead>
      This is a simple hero unit, a simple jumbotron-style component for calling extra attention to
      featured content or information.
    </template>

    <hr class="my-4">

    <p>
      It uses utility classes for typography and spacing to space content out within the larger
      container.
    </p>

    <b-button variant="primary" href="#">Do Something</b-button>
    <b-button variant="success" href="#">Do Something Else</b-button>
  </b-jumbotron>
</div>

<!-- b-jumbotron-using-slots.vue -->

オプション

header-tag を適切な HTML 要素に設定することにより、ヘッダーにレンダリングされるタグを制御します。デフォルトは h1 です。プロパティ header とスロット header の両方がこのタグ内にレンダリングされます。プロパティとスロットの両方が指定されている場合、スロットが表示されます。

header-level プロパティを 1 から 4 までの値に設定することにより、ヘッダーテキストの全体的なサイズを制御します。 1 が最大で、4 が最小です。デフォルト値は 3 です。

リードテキスト

lead-tag を目的の HTML 要素に設定することにより、リードテキストにレンダリングされるタグを制御します。デフォルトは p です。プロパティ lead とスロット lead の両方がこのタグ内にレンダリングされます。プロパティとスロットの両方が指定されている場合、スロットが表示されます。

流動幅

<b-jumbotron> を全幅にし、角を丸めないようにするには、fluid プロパティを設定します。内部コンテンツは自動的に <b-container>(さまざまなブレークポイントで幅が固定)に配置されます。これを流動コンテナーに変更するには、container-fluid プロパティを設定します。fluid プロパティが設定されていない場合、container-fluid プロパティは無効です。

コンポーネントタグ

デフォルトでは、<b-jumbotron> はルート要素を div としてレンダリングします。tag プロパティを目的の要素タグ名に設定することにより、要素タグを他の適切な要素に変更します。

バリアント

bg-variant プロパティ(infodangerwarninglightdark などに設定)を使用して、全体の背景バリアントを制御します。border-variant プロパティを使用して境界線のバリアントを、text-variant プロパティを使用してテキストのバリアントを制御します。3 つのプロパティはすべてデフォルトで null に設定されており、ジャンボトロンにデフォルトのスタイルを使用するように指示します。

<div>
  <b-jumbotron bg-variant="info" text-variant="white" border-variant="dark">
    <template #header>BootstrapVue</template>

    <template #lead>
      This is a simple hero unit, a simple jumbotron-style component for calling extra attention to
      featured content or information.
    </template>

    <hr class="my-4">

    <p>
      It uses utility classes for typography and spacing to space content out within the larger
      container.
    </p>
  </b-jumbotron>
</div>

<!-- b-jumbotron-variants.vue -->

コンポーネントリファレンス

プロパティ

すべてのプロパティのデフォルト値はグローバルに設定可能です。

プロパティ
(クリックして昇順にソート)
タイプ
(クリックして昇順にソート)
デフォルト
説明
bg-variant
文字列Bootstrap テーマカラーバリアントのいずれかを背景に適用します
border-variant
文字列Bootstrap テーマカラーバリアントのいずれかを境界線に適用します
container-fluid
ブール値または文字列falseプロパティ 'fluid' が設定されている場合、このプロパティは内部コンテナーラッパーも流動幅にします。Bootstrap ブレークポイント名のいずれかに設定することもできます
fluid
ブール値falseジャンボトロンを全幅にし、角を丸めません。設定すると、内部コンテンツは自動的に 'b-container'(さまざまなブレークポイントで幅が固定)にラップされます
header
文字列ヘッダーに配置するテキストコンテンツ
header-html
注意して使用してください
文字列ヘッダーに配置する HTML 文字列コンテンツ
header-level
数値または文字列3ヘッダーのスケーリング係数。値の範囲は 1 から 5 です
header-tag
文字列'h1'ヘッダーのデフォルトタグの代わりにレンダリングする HTML タグを指定します
lead
文字列リードパラグラフに配置するテキスト文字列
lead-html
注意して使用してください
文字列リードパラグラフに配置する HTML 文字列
lead-tag
文字列'p'リードパラグラフのデフォルトタグの代わりにレンダリングする HTML タグを指定します
tag
文字列'div'デフォルトタグの代わりにレンダリングする HTML タグを指定します
text-variant
文字列Bootstrap テーマカラーバリアントのいずれかをテキストに適用します

**注意:** HTML 文字列をサポートするプロパティ(`*-html`)は、生のユーザー提供の値が渡されると、クロスサイトスクリプティング(XSS)攻撃に対して脆弱になる可能性があります。最初にユーザー入力を適切にサニタイズする必要があります!

スロット

名前
説明
default ジャンボトロンに配置するコンテンツ
header header
lead lead

個々のコンポーネントのインポート

次の名前付きエクスポートを介して、個々のコンポーネントをプロジェクトにインポートできます

コンポーネント
名前付きエクスポート
インポートパス
<b-jumbotron>BJumbotronbootstrap-vue

import { BJumbotron } from 'bootstrap-vue'
Vue.component('b-jumbotron', BJumbotron)

Vue.js プラグインとしてのインポート

このプラグインには、上記にリストされているすべての個々のコンポーネントが含まれています。プラグインには、コンポーネントのエイリアスも含まれています。

名前付きエクスポート
インポートパス
JumbotronPluginbootstrap-vue

import { JumbotronPlugin } from 'bootstrap-vue'
Vue.use(JumbotronPlugin)