Komponenty
Zjistěte, jak a proč stavíme téměř všechny naše komponenty responzivně a se základními a modifikačními třídami.
Základní třídy
Komponenty Bootstrapu jsou z velké části sestaveny s nomenklaturou modifikátorů báze. Seskupujeme co nejvíce sdílených vlastností do základní třídy, jako .btn
je , a poté seskupujeme jednotlivé styly pro každou variantu do tříd modifikátorů, jako je .btn-primary
nebo .btn-success
.
K vytvoření našich tříd modifikátorů používáme Sassovy @each
smyčky k iteraci přes Sass mapu. To je zvláště užitečné pro generování variant komponenty podle našeho $theme-colors
názoru a vytváření responzivních variant pro každý bod přerušení. Když si tyto mapy Sass přizpůsobíte a překompilujete, automaticky uvidíte, že se vaše změny projeví v těchto smyčkách.
Podívejte se na naše dokumenty k mapám a smyčkám Sass , kde najdete, jak tyto smyčky přizpůsobit a rozšířit přístup modifikátoru báze Bootstrap na váš vlastní kód.
Modifikátory
Mnoho komponent Bootstrapu je vytvořeno s přístupem třídy modifikátorů báze. To znamená, že většina stylů je obsažena v základní třídě (např. .btn
), zatímco varianty stylu jsou omezeny na třídy modifikátorů (např. .btn-danger
). Tyto třídy modifikátorů jsou vytvořeny z $theme-colors
mapy, aby bylo možné přizpůsobit počet a název našich tříd modifikátorů.
Zde jsou dva příklady toho, jak procházíme $theme-colors
mapu, abychom generovali modifikátory komponent .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);
}
Responzivní
Tyto smyčky Sass nejsou omezeny ani na barevné mapy. Můžete také generovat responzivní varianty vašich komponent. Vezměme si například naše responzivní zarovnání rozbalovacích nabídek, kde mícháme @each
smyčku pro $grid-breakpoints
mapu Sass s dotazem na média.
// 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;
}
}
}
}
Pokud upravíte svůj $grid-breakpoints
, budou se vaše změny vztahovat na všechny cykly iterující přes tuto mapu.
$grid-breakpoints: (
xs: 0,
sm: 576px,
md: 768px,
lg: 992px,
xl: 1200px,
xxl: 1400px
);
Další informace a příklady, jak upravit naše mapy a proměnné Sass, naleznete v sekci Sass v dokumentaci Grid .
Vytváření vlastních
Doporučujeme vám, abyste si tyto pokyny osvojili při sestavování pomocí Bootstrapu a vytváření vlastních komponent. Tento přístup jsme sami rozšířili na vlastní komponenty v naší dokumentaci a příkladech. Komponenty, jako jsou naše popisky, jsou sestaveny stejně jako námi poskytované komponenty se základními a modifikačními třídami.
<div class="callout">...</div>
Ve vašem CSS byste měli něco jako následující, kde se většina stylů provádí pomocí .callout
. Poté jsou jedinečné styly mezi každou variantou řízeny pomocí třídy modifikátoru.
// Base class
.callout {}
// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}
Pro popisky je tento jedinečný styl jen border-left-color
. Když tuto základní třídu zkombinujete s jednou z těchto tříd modifikátorů, získáte kompletní rodinu komponent: