Komponenty
Zistite, ako a prečo vytvárame takmer všetky naše komponenty responzívne a so základnými triedami a triedami modifikátorov.
Základné triedy
Komponenty Bootstrapu sú z veľkej časti postavené s nomenklatúrou modifikátora základne. Zoskupujeme čo najviac zdieľaných vlastností do základnej triedy, napríklad .btn
, a potom zoskupujeme jednotlivé štýly pre každý variant do tried modifikátorov, napríklad .btn-primary
alebo .btn-success
.
Na zostavenie tried modifikátorov používame Sassove @each
slučky na iteráciu cez Sass mapu. Toto je obzvlášť užitočné pri generovaní variantov komponentu našimi $theme-colors
a vytváraní responzívnych variantov pre každý bod prerušenia. Keď si tieto mapy Sass prispôsobíte a prekompilujete, vaše zmeny sa automaticky prejavia v týchto slučkách.
Pozrite si naše dokumenty o mapách a slučkách Sass , kde nájdete informácie o tom, ako prispôsobiť tieto slučky a rozšíriť prístup modifikátora základne Bootstrapu na váš vlastný kód.
Modifikátory
Mnohé z komponentov Bootstrapu sú zostavené s prístupom triedy modifikátorov základne. To znamená, že väčšina štýlu je obsiahnutá v základnej triede (napr. .btn
), zatiaľ čo variácie štýlu sú obmedzené na triedy modifikátorov (napr. .btn-danger
). Tieto triedy modifikátorov sú vytvorené z $theme-colors
mapy, aby bolo možné prispôsobiť počet a názov našich tried modifikátorov.
Tu sú dva príklady toho, ako prechádzame cez $theme-colors
mapu, aby sme generovali modifikátory komponentov .alert
a ..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);
}
Responzívne
Tieto slučky Sass nie sú obmedzené ani na farebné mapy. Môžete tiež generovať responzívne variácie vašich komponentov. Vezmime si napríklad naše responzívne zarovnanie rozbaľovacích ponúk, kde kombinujeme @each
slučku pre $grid-breakpoints
mapu Sass s mediálnym dopytom.
// 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;
}
}
}
}
Ak upravíte svoje $grid-breakpoints
, vaše zmeny sa použijú na všetky cykly, ktoré sa opakujú na tejto mape.
$grid-breakpoints: (
xs: 0,
sm: 576px,
md: 768px,
lg: 992px,
xl: 1200px,
xxl: 1400px
);
Ďalšie informácie a príklady, ako upraviť naše mapy a premenné Sass, nájdete v sekcii Sass v dokumentácii Grid .
Vytvorenie vlastného
Odporúčame vám osvojiť si tieto pokyny pri vytváraní vlastných komponentov pomocou Bootstrapu. Tento prístup sme sami rozšírili na vlastné komponenty v našej dokumentácii a príkladoch. Komponenty, ako sú naše popisy, sú zostavené rovnako ako naše poskytnuté komponenty so základnými triedami a triedami modifikátorov.
<div class="callout">...</div>
Vo svojom CSS by ste mali niečo ako nasledujúce, kde sa väčšina štýlov vykonáva prostredníctvom .callout
. Potom sa jedinečné štýly medzi jednotlivými variantmi riadia prostredníctvom triedy modifikátorov.
// Base class
.callout {}
// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}
Pre popisky, tento jedinečný štýl je len border-left-color
. Keď skombinujete túto základnú triedu s jednou z týchto tried modifikátorov, získate kompletnú rodinu komponentov: