Кампаненты
Даведайцеся, як і чаму мы ствараем амаль усе нашы кампаненты адаптыўна і з базавымі класамі і класамі-мадыфікатарамі.
Базавыя класы
Кампаненты Bootstrap у асноўным створаны з наменклатурай базавых мадыфікатараў. Мы групуем як мага больш агульных уласцівасцей у базавы клас, напрыклад .btn
, а затым групуем асобныя стылі для кожнага варыянту ў класы-мадыфікатары, напрыклад .btn-primary
або .btn-success
.
Для стварэння нашых класаў-мадыфікатараў мы выкарыстоўваем @each
цыклы Sass для перабору карты Sass. Гэта асабліва карысна для генерацыі варыянтаў кампанента $theme-colors
і стварэння адаптыўных варыянтаў для кожнай кропкі супыну. Калі вы наладжваеце гэтыя карты Sass і перакампілюеце, вы аўтаматычна ўбачыце змены, адлюстраваныя ў гэтых цыклах.
Праверце нашы карты Sass і дакументы па цыклах, каб даведацца, як наладзіць гэтыя цыклы і пашырыць падыход базавага мадыфікатара Bootstrap да вашага ўласнага кода.
Мадыфікатары
Многія з кампанентаў Bootstrap створаны з выкарыстаннем базавага класа-мадыфікатара. Гэта азначае, што асноўная частка стыляў змяшчаецца ў базавым класе (напрыклад, .btn
), у той час як варыянты стыляў абмяжоўваюцца класамі-мадыфікатарамі (напрыклад, .btn-danger
). Гэтыя класы-мадыфікатары створаны з $theme-colors
карты, каб наладзіць колькасць і назву нашых класаў-мадыфікатараў.
Вось два прыклады таго, як мы перабіраем $theme-colors
карту, каб стварыць мадыфікатары для кампанентаў .alert
і ..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);
}
Спагадны
Гэтыя цыклы Sass таксама не абмяжоўваюцца каляровымі картамі. Вы таксама можаце ствараць адаптыўныя варыянты вашых кампанентаў. Возьмем, напрыклад, наша адаптыўнае выраўноўванне выпадаючых спісаў, дзе мы змешваем @each
цыкл для $grid-breakpoints
карты Sass з медыя-запытам.
// 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;
}
}
}
}
Калі вы зменіце свой $grid-breakpoints
, вашы змены будуць прымяняцца да ўсіх цыклаў, якія выконваюцца па гэтай карце.
$grid-breakpoints: (
xs: 0,
sm: 576px,
md: 768px,
lg: 992px,
xl: 1200px,
xxl: 1400px
);
Для атрымання дадатковай інфармацыі і прыкладаў таго, як змяніць нашы карты і зменныя Sass, звярніцеся да раздзела Sass дакументацыі Grid .
Стварэнне ўласнага
Мы рэкамендуем вам прыняць гэтыя рэкамендацыі пры стварэнні з дапамогай Bootstrap для стварэння ўласных кампанентаў. Мы самі пашырылі гэты падыход на карыстальніцкія кампаненты ў нашай дакументацыі і прыкладах. Такія кампаненты, як нашы выноскі, створаны гэтак жа, як і кампаненты з базавымі класамі і класамі-мадыфікатарамі.
<div class="callout">...</div>
У вашым CSS у вас будзе нешта накшталт наступнага, дзе асноўная частка стыляў робіцца праз .callout
. Затым унікальныя стылі паміж кожным варыянтам кіруюцца з дапамогай класа-мадыфікатара.
// Base class
.callout {}
// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}
Для выноскі гэты унікальны стыль - гэта проста border-left-color
. Калі вы аб'яднаеце гэты базавы клас з адным з гэтых класаў-мадыфікатараў, вы атрымаеце поўнае сямейства кампанентаў: