Przejdź do głównej zawartości Przejdź do nawigacji w dokumentach
Check
in English

składniki

Dowiedz się, jak i dlaczego budujemy prawie wszystkie nasze komponenty w sposób responsywny oraz z klasami bazowymi i modyfikatorami.

Na tej stronie

Klasy bazowe

Komponenty Bootstrapa są w dużej mierze zbudowane z nomenklaturą modyfikatorów bazowych. Grupujemy jak najwięcej wspólnych właściwości w klasie bazowej, takiej jak .btn, a następnie grupujemy poszczególne style dla każdego wariantu w klasy modyfikujące, takie jak .btn-primarylub .btn-success.

Aby zbudować nasze klasy modyfikatorów, używamy @eachpętli Sassa do iteracji po mapie Sassa. Jest to szczególnie pomocne przy generowaniu przez nas wariantów komponentu $theme-colorsi tworzeniu responsywnych wariantów dla każdego punktu przerwania. Gdy dostosujesz te mapy Sass i ponownie je skompilujesz, automatycznie zobaczysz swoje zmiany odzwierciedlone w tych pętlach.

Zapoznaj się z naszą dokumentacją dotyczącą map i pętli Sass, aby dowiedzieć się, jak dostosować te pętle i rozszerzyć podejście Bootstrap do modyfikatorów bazowych do własnego kodu.

Modyfikatory

Wiele komponentów Bootstrap jest zbudowanych z wykorzystaniem podejścia opartego na klasach modyfikatorów bazowych. Oznacza to, że większość stylizacji jest zawarta w klasie bazowej (np. .btn), podczas gdy odmiany stylów są ograniczone do klas modyfikujących (np .btn-danger. ). Te klasy modyfikatorów są budowane na podstawie $theme-colorsmapy, aby dostosować liczbę i nazwę naszych klas modyfikatorów.

Oto dwa przykłady tego, jak zapętlamy $theme-colorsmapę, aby wygenerować modyfikatory komponentów .alerti ..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);
}

Czuły

Te pętle Sass nie ograniczają się również do map kolorów. Możesz także generować responsywne odmiany swoich komponentów. Weźmy na przykład nasze responsywne wyrównanie list rozwijanych, w których łączymy @eachpętlę $grid-breakpointsmapy Sass z zapytaniem o media.

// 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;
      }
    }
  }
}

Jeśli zmodyfikujesz swój $grid-breakpoints, Twoje zmiany zostaną zastosowane do wszystkich pętli iterujących po tej mapie.

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

Aby uzyskać więcej informacji i przykładów modyfikowania naszych map i zmiennych Sass, zapoznaj się z sekcją Sass w dokumentacji Grid .

Tworzenie własnego

Zachęcamy do przyjęcia tych wytycznych podczas budowania za pomocą Bootstrap w celu tworzenia własnych komponentów. Sami rozszerzyliśmy to podejście na komponenty niestandardowe w naszej dokumentacji i przykładach. Komponenty takie jak nasze objaśnienia są budowane tak jak nasze dostarczone komponenty z klasami bazowymi i modyfikatorami.

To jest objaśnienie. Stworzyliśmy go specjalnie dla naszych dokumentów, aby nasze wiadomości do Ciebie wyróżniały się. Ma trzy warianty poprzez klasy modyfikatorów.
<div class="callout">...</div>

W swoim CSS masz coś takiego jak poniżej, gdzie większość stylizacji odbywa się za pośrednictwem .callout. Następnie niepowtarzalne style pomiędzy poszczególnymi wariantami są kontrolowane przez klasę modyfikatora.

// Base class
.callout {}

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

W przypadku objaśnień ta wyjątkowa stylizacja to tylko border-left-color. Kiedy połączysz tę klasę bazową z jedną z tych klas modyfikujących, otrzymasz kompletną rodzinę komponentów:

To jest objaśnienie informacyjne. Przykładowy tekst, aby pokazać to w akcji.
To jest ostrzeżenie. Przykładowy tekst, aby pokazać to w akcji.
To jest ostrzeżenie o niebezpieczeństwie. Przykładowy tekst, aby pokazać to w akcji.