Przejdź do głównej zawartości Przejdź do nawigacji w dokumentach
Check
in English

Zmienne CSS

Użyj niestandardowych właściwości CSS Bootstrap, aby szybko i przyszłościowo projektować i rozwijać.

Bootstrap zawiera wiele niestandardowych właściwości CSS (zmiennych) w skompilowanym CSS w celu dostosowania w czasie rzeczywistym bez konieczności ponownej kompilacji Sassa. Zapewniają one łatwy dostęp do często używanych wartości, takich jak kolory motywu, punkty przerwania i podstawowe stosy czcionek podczas pracy w inspektorze przeglądarki, piaskownicy kodu lub ogólnym prototypowaniu.

Wszystkie nasze niestandardowe właściwości są poprzedzone prefiksem,bs- aby uniknąć konfliktów z CSS stron trzecich.

Zmienne główne

Oto zmienne, które dołączamy (pamiętaj, że :rootjest to wymagane), do których można uzyskać dostęp z każdego miejsca, w którym załadowany jest CSS Bootstrap. Znajdują się one w naszym _root.scsspliku i zawarte w naszych skompilowanych plikach dist.

:root {
  --bs-blue: #0d6efd;
  --bs-indigo: #6610f2;
  --bs-purple: #6f42c1;
  --bs-pink: #d63384;
  --bs-red: #dc3545;
  --bs-orange: #fd7e14;
  --bs-yellow: #ffc107;
  --bs-green: #198754;
  --bs-teal: #20c997;
  --bs-cyan: #0dcaf0;
  --bs-black: #000;
  --bs-white: #fff;
  --bs-gray: #6c757d;
  --bs-gray-dark: #343a40;
  --bs-gray-100: #f8f9fa;
  --bs-gray-200: #e9ecef;
  --bs-gray-300: #dee2e6;
  --bs-gray-400: #ced4da;
  --bs-gray-500: #adb5bd;
  --bs-gray-600: #6c757d;
  --bs-gray-700: #495057;
  --bs-gray-800: #343a40;
  --bs-gray-900: #212529;
  --bs-primary: #0d6efd;
  --bs-secondary: #6c757d;
  --bs-success: #198754;
  --bs-info: #0dcaf0;
  --bs-warning: #ffc107;
  --bs-danger: #dc3545;
  --bs-light: #f8f9fa;
  --bs-dark: #212529;
  --bs-primary-rgb: 13, 110, 253;
  --bs-secondary-rgb: 108, 117, 125;
  --bs-success-rgb: 25, 135, 84;
  --bs-info-rgb: 13, 202, 240;
  --bs-warning-rgb: 255, 193, 7;
  --bs-danger-rgb: 220, 53, 69;
  --bs-light-rgb: 248, 249, 250;
  --bs-dark-rgb: 33, 37, 41;
  --bs-white-rgb: 255, 255, 255;
  --bs-black-rgb: 0, 0, 0;
  --bs-body-color-rgb: 33, 37, 41;
  --bs-body-bg-rgb: 255, 255, 255;
  --bs-font-sans-serif: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
  --bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
  --bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));
  --bs-body-font-family: var(--bs-font-sans-serif);
  --bs-body-font-size: 1rem;
  --bs-body-font-weight: 400;
  --bs-body-line-height: 1.5;
  --bs-body-color: #212529;
  --bs-body-bg: #fff;
  --bs-border-width: 1px;
  --bs-border-style: solid;
  --bs-border-color: #dee2e6;
  --bs-border-color-translucent: rgba(0, 0, 0, 0.175);
  --bs-border-radius: 0.375rem;
  --bs-border-radius-sm: 0.25rem;
  --bs-border-radius-lg: 0.5rem;
  --bs-border-radius-xl: 1rem;
  --bs-border-radius-2xl: 2rem;
  --bs-border-radius-pill: 50rem;
  --bs-link-color: #0d6efd;
  --bs-link-hover-color: #0a58ca;
  --bs-code-color: #d63384;
  --bs-highlight-bg: #fff3cd;
}

Zmienne składowe

Bootstrap 5 coraz częściej wykorzystuje niestandardowe właściwości jako zmienne lokalne dla różnych komponentów. W ten sposób redukujemy nasz skompilowany CSS, upewniamy się, że style nie są dziedziczone w miejscach takich jak zagnieżdżone tabele i umożliwiamy podstawową zmianę stylizacji i rozszerzenie komponentów Bootstrap po kompilacji Sass.

Zajrzyj do naszej dokumentacji tabel, aby dowiedzieć się, jak używamy zmiennych CSS . Nasze paski nawigacyjne również używają zmiennych CSS od wersji 5.2.0. Używamy również zmiennych CSS w naszych siatkach — głównie dla rynsztoków, nowej siatki CSS do wyboru — z większym wykorzystaniem komponentów w przyszłości.

Jeśli to możliwe, przypiszemy zmienne CSS na poziomie podstawowego komponentu (np. .navbardla paska nawigacyjnego i jego podkomponentów). Zmniejsza to zgadywanie, gdzie i jak dostosowywać, a także pozwala na łatwe modyfikacje przez nasz zespół w przyszłych aktualizacjach.

Prefiks

Większość zmiennych CSS używa prefiksu, aby uniknąć kolizji z własną bazą kodu. Ten prefiks jest dodatkiem do --wymaganego dla każdej zmiennej CSS.

Dostosuj prefiks za pomocą $prefixzmiennej Sass. Domyślnie jest ustawiony na bs-(zwróć uwagę na końcowy myślnik).

Przykłady

Zmienne CSS oferują podobną elastyczność do zmiennych Sassa, ale bez potrzeby kompilacji przed udostępnieniem ich przeglądarce. Na przykład tutaj resetujemy czcionki i style linków na naszej stronie za pomocą zmiennych CSS.

body {
  font: 1rem/1.5 var(--bs-font-sans-serif);
}
a {
  color: var(--bs-blue);
}

Punkty przerwania siatki

Chociaż uwzględniamy nasze punkty przerwania siatki jako zmienne CSS (z wyjątkiem xs), pamiętaj, że zmienne CSS nie działają w zapytaniach o media . Jest to zgodne ze specyfikacją CSS dla zmiennych, ale może się zmienić w nadchodzących latach dzięki obsłudze env()zmiennych. Sprawdź odpowiedź na przepełnienie stosu , aby uzyskać przydatne linki. W międzyczasie możesz używać tych zmiennych w innych sytuacjach CSS, a także w swoim JavaScript.