Alkatrészek
Tanulja meg, hogyan és miért építjük fel szinte minden összetevőnket érzékenyen, alap- és módosító osztályokkal.
Alap osztályok
A Bootstrap összetevői nagyrészt alapmódosító nómenklatúrával épülnek fel. A lehető legtöbb megosztott tulajdonságot csoportosítjuk egy alaposztályba, például .btn
, majd az egyes változatokhoz tartozó egyedi stílusokat módosító osztályokba csoportosítjuk, például .btn-primary
vagy .btn-success
.
Módosító osztályaink felépítéséhez a Sass ciklusait használjuk @each
a Sass térképen való iterációhoz. Ez különösen akkor hasznos, ha egy összetevő változatait generáljuk, $theme-colors
és minden törésponthoz érzékeny változatokat hozunk létre. A Sass térképek testreszabása és újrafordítása során automatikusan látni fogja a változtatásokat ezekben a hurkokban.
Tekintse meg Sass térképeket és ciklusokat tartalmazó dokumentumainkat , hogy hogyan szabhatja testre ezeket a ciklusokat, és hogyan terjesztheti ki a Bootstrap alapmódosító megközelítését saját kódjára.
Módosítók
A Bootstrap számos összetevője alapmódosító osztályú megközelítéssel készült. Ez azt jelenti, hogy a stílus nagy része egy alaposztályhoz (pl. .btn
), míg a stílusváltozatok módosító osztályokhoz (pl. .btn-danger
) korlátozódik. Ezek a módosító osztályok a térképből épülnek fel $theme-colors
, hogy testreszabhassák módosító osztályaink számát és nevét.
Íme két példa arra, hogyan lépkedünk át a $theme-colors
térképen, hogy módosítókat generáljunk a .alert
és .list-group
összetevőkhöz.
// 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);
}
Fogékony
Ezek a Sass hurkok nem korlátozódnak a színes térképekre sem. Az összetevők adaptív változatait is létrehozhatja. Vegyük például a legördülő menük reszponzív igazítását, ahol a Sass térkép @each
hurkot keverjük össze egy médialekérdezéssel.$grid-breakpoints
// 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;
}
}
}
}
Ha módosítja a $grid-breakpoints
-t, a változtatások az adott térképen iteráló összes hurokra vonatkoznak.
$grid-breakpoints: (
xs: 0,
sm: 576px,
md: 768px,
lg: 992px,
xl: 1200px,
xxl: 1400px
);
A Sass térképek és változóink módosításával kapcsolatos további információkért és példákért tekintse meg a Grid dokumentáció Sass szakaszát .
Saját létrehozása
Javasoljuk, hogy kövesse ezeket az irányelveket, amikor a Bootstrap használatával készít saját összetevőit. Ezt a megközelítést kiterjesztettük a dokumentációnkban és a példákban szereplő egyéni összetevőkre. Az olyan összetevők, mint a kiírásaink, ugyanúgy épülnek fel, mint az általunk biztosított összetevők alap- és módosító osztályokkal.
<div class="callout">...</div>
A CSS-ben a következőhöz hasonlóval rendelkezne, ahol a stílus nagy része a -n keresztül történik .callout
. Ezután az egyes változatok közötti egyedi stílusokat módosító osztályok vezérlik.
// Base class
.callout {}
// Modifier classes
.callout-info {}
.callout-warning {}
.callout-danger {}
A feliratok esetében ez az egyedi stílus csak egy border-left-color
. Ha ezt az alaposztályt kombinálja a módosító osztályok egyikével, megkapja a teljes komponenscsaládot: