Komponente

Bazne klase

Komponente Bootstrapa uglavnom su izgrađene s nomenklaturom baznog modifikatora. Grupiramo što više zajedničkih svojstava u osnovnu klasu, kao što je .btn, a zatim grupiramo pojedinačne stilove za svaku varijantu u klase modifikatora, kao što je .btn-primaryili .btn-success.

Kako bismo izgradili naše klase modifikatora, koristimo Sassove @eachpetlje za ponavljanje preko Sass mape. Ovo je posebno korisno za naše generiranje varijanti komponente $theme-colorsi stvaranje odgovarajućih varijanti za svaku prijelomnu točku. Dok prilagođavate ove Sass mape i ponovno kompajlirate, automatski ćete vidjeti svoje promjene reflektirane u ovim petljama.

Provjerite naše Sass mape i dokumente o petljama da biste saznali kako prilagoditi ove petlje i proširiti Bootstrapov pristup baznog modifikatora na vaš vlastiti kod.

Modifikatori

Mnoge Bootstrapove komponente izgrađene su s pristupom klase osnovnog modifikatora. To znači da je većina stila sadržana u osnovnoj klasi (npr. .btn), dok su varijacije stila ograničene na klase modifikatora (npr. .btn-danger). Ove klase modifikatora izgrađene su iz $theme-colorsmape kako bi se prilagodio broj i naziv naših klasa modifikatora.

Ovdje su dva primjera kako prelazimo preko $theme-colorsmape da generiramo modifikatore komponenti .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);
}

Uzvratni

Ni ove Sassove petlje nisu ograničene na mape boja. Također možete generirati odgovarajuće varijacije svojih komponenti. Uzmimo za primjer naše responzivno poravnanje padajućih izbornika gdje miješamo @eachpetlju za $grid-breakpointsSass mapu s medijskim upitom za uključivanje.

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

Ako izmijenite svoj $grid-breakpoints, vaše će se promjene primijeniti na sve petlje koje se ponavljaju preko te karte.

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

Za više informacija i primjere o tome kako modificirati naše Sass mape i varijable, pogledajte odjeljak Sass u Grid dokumentaciji .

Stvaranje vlastitog

Potičemo vas da usvojite ove smjernice kada gradite s Bootstrapom kako biste izradili vlastite komponente. Sami smo proširili ovaj pristup na prilagođene komponente u našoj dokumentaciji i primjerima. Komponente poput naših oblačića izgrađene su baš kao i naše komponente s osnovnim i modifikatorskim klasama.

<div class="callout">...</div>

U svom CSS-u imali biste nešto poput sljedećeg gdje se većina stiliziranja vrši putem .callout. Zatim se jedinstveni stilovi između svake varijante kontroliraju putem klase modifikatora.

// Base class
.callout {}

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

Za oblačiće, taj jedinstveni stil je samo border-left-color. Kada kombinirate tu osnovnu klasu s jednom od tih modifikatorskih klasa, dobit ćete kompletnu obitelj komponenti: