Kelancangan
Manfaatkan file Sass sumber kami untuk memanfaatkan variabel, peta, mixin, dan fungsi untuk membantu Anda membangun lebih cepat dan menyesuaikan proyek Anda.
Manfaatkan file Sass sumber kami untuk memanfaatkan variabel, peta, mixin, dan banyak lagi.
Struktur file
Bila memungkinkan, hindari memodifikasi file inti Bootstrap. Untuk Sass, itu berarti membuat stylesheet Anda sendiri yang mengimpor Bootstrap sehingga Anda dapat memodifikasi dan memperluasnya. Dengan asumsi Anda menggunakan manajer paket seperti npm, Anda akan memiliki struktur file yang terlihat seperti ini:
your-project/
├── scss
│ └── custom.scss
└── node_modules/
└── bootstrap
├── js
└── scss
Jika Anda telah mengunduh file sumber kami dan tidak menggunakan manajer paket, Anda akan ingin mengatur secara manual sesuatu yang mirip dengan struktur itu, menjaga file sumber Bootstrap terpisah dari milik Anda.
your-project/
├── scss
│ └── custom.scss
└── bootstrap/
├── js
└── scss
Pengimporan
Di custom.scss
, Anda akan mengimpor file Sass sumber Bootstrap. Anda memiliki dua opsi: sertakan semua Bootstrap, atau pilih bagian yang Anda butuhkan. Kami mendorong yang terakhir, meskipun perlu diketahui ada beberapa persyaratan dan dependensi di seluruh komponen kami. Anda juga perlu menyertakan beberapa JavaScript untuk plugin kami.
// Custom.scss
// Option A: Include all of Bootstrap
// Include any default variable overrides here (though functions won't be available)
@import "../node_modules/bootstrap/scss/bootstrap";
// Then add additional custom code here
// Custom.scss
// Option B: Include parts of Bootstrap
// 1. Include functions first (so you can manipulate colors, SVGs, calc, etc)
@import "../node_modules/bootstrap/scss/functions";
// 2. Include any default variable overrides here
// 3. Include remainder of required Bootstrap stylesheets
@import "../node_modules/bootstrap/scss/variables";
@import "../node_modules/bootstrap/scss/mixins";
// 4. Include any optional Bootstrap components as you like
@import "../node_modules/bootstrap/scss/root";
@import "../node_modules/bootstrap/scss/reboot";
@import "../node_modules/bootstrap/scss/type";
@import "../node_modules/bootstrap/scss/images";
@import "../node_modules/bootstrap/scss/containers";
@import "../node_modules/bootstrap/scss/grid";
// 5. Add additional custom code here
Dengan pengaturan itu, Anda dapat mulai memodifikasi salah satu variabel dan peta Sass di file custom.scss
. Anda juga dapat mulai menambahkan bagian Bootstrap di bawah // Optional
bagian sesuai kebutuhan. Kami menyarankan untuk menggunakan tumpukan impor penuh dari bootstrap.scss
file kami sebagai titik awal Anda.
Default variabel
Setiap variabel Sass di Bootstrap menyertakan !default
tanda yang memungkinkan Anda mengganti nilai default variabel di Sass Anda sendiri tanpa memodifikasi kode sumber Bootstrap. Salin dan tempel variabel sesuai kebutuhan, ubah nilainya, dan hapus !default
tandanya. Jika suatu variabel telah ditetapkan, maka variabel tersebut tidak akan ditetapkan kembali oleh nilai default di Bootstrap.
Anda akan menemukan daftar lengkap variabel Bootstrap di scss/_variables.scss
. Beberapa variabel disetel ke null
, variabel ini tidak menampilkan properti kecuali jika diganti dalam konfigurasi Anda.
Penggantian variabel harus dilakukan setelah fungsi kita diimpor, tetapi sebelum impor lainnya.
Berikut adalah contoh yang mengubah background-color
dan color
untuk <body>
saat mengimpor dan mengkompilasi Bootstrap melalui npm:
// Required
@import "../node_modules/bootstrap/scss/functions";
// Default variable overrides
$body-bg: #000;
$body-color: #111;
// Required
@import "../node_modules/bootstrap/scss/variables";
@import "../node_modules/bootstrap/scss/mixins";
// Optional Bootstrap components here
@import "../node_modules/bootstrap/scss/root";
@import "../node_modules/bootstrap/scss/reboot";
@import "../node_modules/bootstrap/scss/type";
// etc
Ulangi seperlunya untuk variabel apa pun di Bootstrap, termasuk opsi global di bawah ini.
Peta dan loop
Bootstrap menyertakan beberapa peta Sass, pasangan nilai kunci yang mempermudah pembuatan keluarga CSS terkait. Kami menggunakan peta Sass untuk warna kami, titik putus grid, dan banyak lagi. Sama seperti variabel Sass, semua peta Sass menyertakan !default
flag dan dapat diganti dan diperluas.
Beberapa peta Sass kami digabungkan menjadi peta kosong secara default. Hal ini dilakukan untuk memudahkan perluasan peta Sass yang diberikan, tetapi biayanya membuat penghapusan item dari peta menjadi sedikit lebih sulit.
Ubah peta
Semua variabel dalam $theme-colors
peta didefinisikan sebagai variabel mandiri. Untuk mengubah warna yang ada di $theme-colors
peta kami, tambahkan berikut ini ke file Sass kustom Anda:
$primary: #0074d9;
$danger: #ff4136;
Kemudian, variabel-variabel ini diatur di $theme-colors
peta Bootstrap:
$theme-colors: (
"primary": $primary,
"danger": $danger
);
Tambahkan ke peta
Tambahkan warna baru ke $theme-colors
, atau peta lainnya, dengan membuat peta Sass baru dengan nilai khusus Anda dan menggabungkannya dengan peta asli. Dalam hal ini, kami akan membuat $custom-colors
peta baru dan menggabungkannya dengan $theme-colors
.
// Create your own map
$custom-colors: (
"custom-color": #900
);
// Merge the maps
$theme-colors: map-merge($theme-colors, $custom-colors);
Hapus dari peta
Untuk menghapus warna dari $theme-colors
, atau peta lainnya, gunakan map-remove
. Ketahuilah bahwa Anda harus memasukkannya di antara persyaratan dan opsi kami:
// Required
@import "../node_modules/bootstrap/scss/functions";
@import "../node_modules/bootstrap/scss/variables";
@import "../node_modules/bootstrap/scss/mixins";
$theme-colors: map-remove($theme-colors, "info", "light", "dark");
// Optional
@import "../node_modules/bootstrap/scss/root";
@import "../node_modules/bootstrap/scss/reboot";
@import "../node_modules/bootstrap/scss/type";
// etc
Kunci yang diperlukan
Bootstrap mengasumsikan adanya beberapa kunci khusus dalam peta Sass saat kami menggunakan dan memperluasnya sendiri. Saat Anda menyesuaikan peta yang disertakan, Anda mungkin mengalami kesalahan saat kunci peta Sass tertentu digunakan.
Misalnya, kami menggunakan primary
, success
, dan danger
kunci dari $theme-colors
untuk tautan, tombol, dan status formulir. Mengganti nilai kunci ini seharusnya tidak menimbulkan masalah, tetapi menghapusnya dapat menyebabkan masalah kompilasi Sass. Dalam hal ini, Anda harus memodifikasi kode Sass yang menggunakan nilai tersebut.
Fungsi
warna
Di samping peta Sass yang kita miliki, warna tema juga dapat digunakan sebagai variabel mandiri, seperti $primary
.
.custom-element {
color: $gray-100;
background-color: $dark;
}
Anda dapat mencerahkan atau menggelapkan warna dengan Bootstrap tint-color()
dan shade-color()
fungsinya. Fungsi-fungsi ini akan mencampur warna dengan hitam atau putih, tidak seperti asli Sass lighten()
dan darken()
fungsi yang akan mengubah kecerahan dengan jumlah yang tetap, yang seringkali tidak menghasilkan efek yang diinginkan.
// Tint a color: mix a color with white
@function tint-color($color, $weight) {
@return mix(white, $color, $weight);
}
// Shade a color: mix a color with black
@function shade-color($color, $weight) {
@return mix(black, $color, $weight);
}
// Shade the color if the weight is positive, else tint it
@function shift-color($color, $weight) {
@return if($weight > 0, shade-color($color, $weight), tint-color($color, -$weight));
}
Dalam praktiknya, Anda akan memanggil fungsi dan meneruskan parameter warna dan bobot.
.custom-element {
color: tint-color($primary, 10%);
}
.custom-element-2 {
color: shade-color($danger, 30%);
}
Kontras warna
Untuk memenuhi standar aksesibilitas WCAG 2.0 untuk kontras warna , penulis harus memberikan rasio kontras minimal 4,5:1 , dengan sedikit pengecualian.
Fungsi tambahan yang kami sertakan di Bootstrap adalah fungsi kontras warna, color-contrast
. Ini menggunakan algoritma WCAG 2.0 untuk menghitung ambang kontras berdasarkan pencahayaan relatif dalam ruang sRGB
warna untuk secara otomatis mengembalikan warna kontras terang ( #fff
), gelap ( #212529
) atau hitam ( #000
) berdasarkan warna dasar yang ditentukan. Fungsi ini sangat berguna untuk mixin atau loop di mana Anda menghasilkan banyak kelas.
Misalnya, untuk menghasilkan contoh warna dari $theme-colors
peta kita:
@each $color, $value in $theme-colors {
.swatch-#{$color} {
color: color-contrast($value);
}
}
Ini juga dapat digunakan untuk kebutuhan kontras satu kali:
.custom-element {
color: color-contrast(#000); // returns `color: #fff`
}
Anda juga dapat menentukan warna dasar dengan fungsi peta warna kami:
.custom-element {
color: color-contrast($dark); // returns `color: #fff`
}
Melarikan diri dari SVG
Kami menggunakan escape-svg
fungsi untuk keluar dari <
, >
dan #
karakter untuk gambar latar belakang SVG. Saat menggunakan escape-svg
fungsi, URI data harus dikutip.
Tambah dan Kurangi fungsi
Kami menggunakan fungsi add
dan subtract
untuk membungkus calc
fungsi CSS. Tujuan utama dari fungsi ini adalah untuk menghindari kesalahan ketika nilai "tanpa unit" 0
dilewatkan ke dalam calc
ekspresi. Ekspresi like calc(10px - 0)
akan mengembalikan kesalahan di semua browser, meskipun secara matematis benar.
Contoh di mana kalk itu valid:
$border-radius: .25rem;
$border-width: 1px;
.element {
// Output calc(.25rem - 1px) is valid
border-radius: calc($border-radius - $border-width);
}
.element {
// Output the same calc(.25rem - 1px) as above
border-radius: subtract($border-radius, $border-width);
}
Contoh di mana kalk tidak valid:
$border-radius: .25rem;
$border-width: 0;
.element {
// Output calc(.25rem - 0) is invalid
border-radius: calc($border-radius - $border-width);
}
.element {
// Output .25rem
border-radius: subtract($border-radius, $border-width);
}
campuran
Direktori kami scss/mixins/
memiliki banyak sekali mixin yang mendukung bagian Bootstrap dan juga dapat digunakan di seluruh proyek Anda sendiri.
Skema warna
Mixin singkatan untuk prefers-color-scheme
kueri media tersedia dengan dukungan untuk light
, dark
, dan skema warna kustom.
@mixin color-scheme($name) {
@media (prefers-color-scheme: #{$name}) {
@content;
}
}
.custom-element {
@include color-scheme(dark) {
// Insert dark mode styles here
}
@include color-scheme(custom-named-scheme) {
// Insert custom color scheme styles here
}
}