Komponenter
Lær hvordan og hvorfor vi bygger nesten alle komponentene våre responsivt og med basis- og modifikasjonsklasser.
Basisklasser
Bootstraps komponenter er i stor grad bygget med en base-modifikator nomenklatur. Vi grupperer så mange delte egenskaper som mulig i en basisklasse, som .btn
, og grupperer deretter individuelle stiler for hver variant i modifikasjonsklasser, som .btn-primary
eller .btn-success
.
For å bygge modifikatorklassene våre bruker vi Sass sine @each
løkker til å iterere over et Sass-kart. Dette er spesielt nyttig for å generere varianter av en komponent av vår $theme-colors
og lage responsive varianter for hvert bruddpunkt. Når du tilpasser disse Sass-kartene og kompilerer på nytt, vil du automatisk se endringene dine reflektert i disse loopene.
Sjekk ut våre Sass-kart og loops-dokumenter for hvordan du kan tilpasse disse loopene og utvide Bootstraps base-modifier-tilnærming til din egen kode.
Modifikatorer
Mange av Bootstraps komponenter er bygget med en base-modifier klasse tilnærming. Dette betyr at hoveddelen av stilen er inneholdt i en basisklasse (f.eks. .btn
) mens stilvariasjoner er begrenset til modifikatorklasser (f.eks. .btn-danger
). Disse modifikatorklassene er bygget fra $theme-colors
kartet for å tilpasse antallet og navnet på modifikatorklassene våre.
Her er to eksempler på hvordan vi går over $theme-colors
kartet for å generere modifikatorer til .alert
og - .list-group
komponentene.
// 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);
}
Mottakelig
Disse Sass-løkkene er heller ikke begrenset til fargekart. Du kan også generere responsive varianter av komponentene dine. Ta for eksempel vår responsive justering av rullegardinmenyene der vi blander en @each
løkke for $grid-breakpoints
Sass-kartet med en mediespørring.
// 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;
}
}
}
}
Skulle du endre din $grid-breakpoints
, vil endringene gjelde for alle løkkene som itererer over det kartet.
$grid-breakpoints: (
xs: 0,
sm: 576px,
md: 768px,
lg: 992px,
xl: 1200px,
xxl: 1400px
);
For mer informasjon og eksempler på hvordan du endrer våre Sass-kart og variabler, se Sass-delen av Grid-dokumentasjonen .
Skaper din egen
Vi oppfordrer deg til å ta i bruk disse retningslinjene når du bygger med Bootstrap for å lage dine egne komponenter. Vi har utvidet denne tilnærmingen selv til de tilpassede komponentene i vår dokumentasjon og eksempler. Komponenter som våre bildeforklaringer er bygget akkurat som våre leverte komponenter med base- og modifikatorklasser.
<div class="callout">...</div>
I CSS-en din vil du ha noe sånt som følgende der hoveddelen av stylingen gjøres via .callout
. Deretter styres de unike stilene mellom hver variant via modifikasjonsklassen.
// Base class
.callout {}
// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}
For bildetekstene er den unike stylingen bare en border-left-color
. Når du kombinerer den basisklassen med en av disse modifikasjonsklassene, får du hele komponentfamilien din: