メインコンテンツにスキップ ドキュメント ナビゲーションにスキップ
in English

コンポーネント

ほとんどすべてのコンポーネントをレスポンシブに構築し、基本クラスと修飾子クラスを使用する方法と理由を学びます。

基本クラス

Bootstrap のコンポーネントは、主に基本修飾子命名法で構築されています。できるだけ多くの共有プロパティを などの基本クラスに.btnグループ化し、次に各バリアントの個々のスタイルを や などの修飾子クラスにグループ化し.btn-primaryます.btn-success

修飾子クラスを構築するには、Sass の@eachループを使用して Sass マップを反復処理します。これは、コンポーネントのバリアントを生成$theme-colorsし、ブレークポイントごとにレスポンシブ バリアントを作成する場合に特に役立ちます。これらの Sass マップをカスタマイズして再コンパイルすると、これらのループに反映された変更が自動的に表示されます。

これらのループをカスタマイズし、Bootstrap の base-modifier アプローチを独自のコードに拡張する方法については、Sass マップとループのドキュメントをご覧ください。

修飾子

Bootstrap のコンポーネントの多くは、基本修飾子クラスのアプローチで構築されています。これは、スタイリングの大部分が基本クラス (例: .btn) に含まれているのに対して、スタイルのバリエーションは修飾子クラス (例: .btn-danger) に限定されていることを意味します。これらのモディファイア クラスは$theme-colorsマップから構築され、モディファイア クラスの数と名前をカスタマイズします。

マップをループしておよびコンポーネント$theme-colorsへの修飾子を生成する方法の 2 つの例を次に示します。.alert.list-group

// Generate contextual modifier classes for colorizing the alert.

@each $state, $value in $theme-colors {
  $alert-background: shift-color($value, $alert-bg-scale);
  $alert-border: shift-color($value, $alert-border-scale);
  $alert-color: shift-color($value, $alert-color-scale);
  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {
    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));
  }
  .alert-#{$state} {
    @include alert-variant($alert-background, $alert-border, $alert-color);
  }
}
// List group contextual variants
//
// Add modifier classes to change text and background color on individual items.
// Organizationally, this must come after the `:hover` states.

@each $state, $value in $theme-colors {
  $list-group-variant-bg: shift-color($value, $list-group-item-bg-scale);
  $list-group-variant-color: shift-color($value, $list-group-item-color-scale);
  @if (contrast-ratio($list-group-variant-bg, $list-group-variant-color) < $min-contrast-ratio) {
    $list-group-variant-color: mix($value, color-contrast($list-group-variant-bg), abs($list-group-item-color-scale));
  }

  @include list-group-item-variant($state, $list-group-variant-bg, $list-group-variant-color);
}

レスポンシブ

これらの Sass ループは、カラー マップに限定されません。コンポーネントのレスポンシブ バリエーションを生成することもできます。たとえば、 Sass マップの@eachループとメディア クエリ インクルードを組み合わせたドロップダウンのレスポンシブ アライメントを考えてみましょう。$grid-breakpoints

// We deliberately hardcode the `bs-` prefix because we check
// this custom property in JS to determine Popper's positioning

@each $breakpoint in map-keys($grid-breakpoints) {
  @include media-breakpoint-up($breakpoint) {
    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);

    .dropdown-menu#{$infix}-start {
      --bs-position: start;

      &[data-bs-popper] {
        right: auto;
        left: 0;
      }
    }

    .dropdown-menu#{$infix}-end {
      --bs-position: end;

      &[data-bs-popper] {
        right: 0;
        left: auto;
      }
    }
  }
}

を変更する$grid-breakpointsと、変更はそのマップを反復するすべてのループに適用されます。

$grid-breakpoints: (
  xs: 0,
  sm: 576px,
  md: 768px,
  lg: 992px,
  xl: 1200px,
  xxl: 1400px
);

Sass マップと変数を変更する方法の詳細と例については、Grid ドキュメントの Sass セクションを参照してください。

独自の作成

Bootstrap を使用して独自のコンポーネントを作成する場合は、これらのガイドラインを採用することをお勧めします。私たちはこのアプローチを、ドキュメントとサンプルのカスタム コンポーネントに拡張しました。コールアウトのようなコンポーネントは、基本クラスと修飾子クラスを持つ提供されたコンポーネントと同じように構築されます。

これは吹き出しです。あなたへのメッセージが際立つように、ドキュメント用にカスタムで作成しました。修飾子クラスによる 3 つのバリアントがあります。
<div class="callout">...</div>

CSS では、スタイリングの大部分が を介して行われる次のようなものがあります.callout。次に、各バリアント間の固有のスタイルは修飾子クラスによって制御されます。

// Base class
.callout {}

// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}

コールアウトの場合、そのユニークなスタイルは単なるborder-left-color. その基本クラスをこれらの修飾子クラスの 1 つと組み合わせると、完全なコンポーネント ファミリが得られます。

これは情報コールアウトです。実際の動作を示すテキストの例。
これは警告コールアウトです。実際の動作を示すテキストの例。
これは危険信号です。実際の動作を示すテキストの例。