Source

Theming Bootstrap

اسان جي نئين بلٽ ان Sass متغيرن سان بوٽ اسٽريپ 4 کي ڪسٽمائيز ڪريو عالمي طرز جي ترجيحن لاءِ آسان موضوعن ۽ جزن جي تبديلين لاءِ.

تعارف

Bootstrap 3 ۾، موضوع گهڻو ڪري LESS، ڪسٽم CSS، ۽ هڪ الڳ موضوع واري اسٽائل شيٽ ۾ متغير اوور رائڊز ذريعي هلائي وئي جيڪا اسان اسان جي distفائلن ۾ شامل ڪئي. ڪجھ ڪوششن سان، ھڪڙي بنيادي فائلن کي ڇھڻ کان سواء بوٽ اسٽراپ 3 جي نظر کي مڪمل طور تي تبديل ڪري سگھي ٿو. Bootstrap 4 هڪ واقف، پر ٿورڙو مختلف طريقو مهيا ڪري ٿو.

هاڻي، موضوع ساس متغيرن، ساس نقشن، ۽ ڪسٽم CSS پاران مڪمل ڪيو ويو آهي. ڪابه وڌيڪ وقف ٿيل موضوع اسٽائل شيٽ ناهي؛ بجاءِ، توھان چالو ڪري سگھوٿا بلٽ ان ٿيم کي شامل ڪرڻ لاءِ گريڊيئينٽ، شيڊز ۽ وڌيڪ.

ساس

اسان جو ذريعو استعمال ڪريو Sass فائلون متغيرن، نقشن، ميڪسينز، ۽ وڌيڪ مان فائدو وٺڻ لاء.

فائل جي جوڙجڪ

جڏهن به ممڪن هجي، بوٽ اسٽراپ جي بنيادي فائلن کي تبديل ڪرڻ کان پاسو ڪريو. ساس لاءِ، ان جو مطلب آهي توهان جي پنهنجي اسٽائل شيٽ ٺاهڻ جيڪا بوٽ اسٽريپ درآمد ڪري ٿي ته جيئن توهان ان کي تبديل ۽ وڌائي سگهو. فرض ڪيو ته توهان استعمال ڪري رهيا آهيو هڪ پيڪيج مئنيجر جهڙوڪ npm، توهان وٽ هوندو هڪ فائيل ڍانچي جيڪو هن جهڙو نظر اچي ٿو:

your-project/
├── scss
│   └── custom.scss
└── node_modules/
    └── bootstrap
        ├── js
        └── scss

جيڪڏهن توهان اسان جون ماخذ فائلون ڊائون لوڊ ڪيون آهن ۽ پيڪيج مئنيجر استعمال نه ڪري رهيا آهيو، توهان چاهيو ٿا ته دستي طور تي ان ڍانچي سان ڪجهه ملندڙ جلندڙ سيٽ اپ ڪريو، بوٽ اسٽريپ جي ماخذ فائلن کي پنهنجي پاڻ کان الڳ رکندي.

your-project/
├── scss
│   └── custom.scss
└── bootstrap/
    ├── js
    └── scss

درآمد ڪرڻ

توھان ۾ custom.scss، توھان درآمد ڪندا Bootstrap جو ذريعو Sass فائلون. توھان وٽ ٻه اختيار آھن: شامل ڪريو سڀ بوٽ اسٽريپ، يا انھن حصن کي چونڊيو جيڪي توھان جي ضرورت آھي. اسان بعد ۾ حوصلا افزائي ڪريون ٿا، جيتوڻيڪ ڄاڻو ته اسان جي اجزاء ۾ ڪجهه گهربل ۽ انحصار آهن. توھان کي اسان جي پلگ ان لاءِ ڪجھ جاوا اسڪرپٽ پڻ شامل ڪرڻ جي ضرورت پوندي.

// Custom.scss
// Option A: Include all of Bootstrap

@import "node_modules/bootstrap/scss/bootstrap";
// Custom.scss
// Option B: Include parts of Bootstrap

// Required
@import "node_modules/bootstrap/scss/functions";
@import "node_modules/bootstrap/scss/variables";
@import "node_modules/bootstrap/scss/mixins";

// Optional
@import "node_modules/bootstrap/scss/reboot";
@import "node_modules/bootstrap/scss/type";
@import "node_modules/bootstrap/scss/images";
@import "node_modules/bootstrap/scss/code";
@import "node_modules/bootstrap/scss/grid";

انهي سيٽ اپ سان گڏ، توهان شروع ڪري سگهو ٿا ڪنهن به Sass متغير ۽ نقشن کي توهان جي custom.scss. توھان پڻ شروع ڪري سگھوٿا بوٽ اسٽراپ جا حصا شامل ڪرڻ لاءِ // Optionalسيڪشن جي تحت ضرورت مطابق. اسان توهان جي شروعاتي نقطي طور اسان جي bootstrap.scssفائل مان مڪمل درآمد اسٽيڪ استعمال ڪرڻ جي صلاح ڏيو ٿا.

متغير ڊفالٽ

Bootstrap 4 ۾ ھر Sass variable ۾ جھنڊو شامل آھي !defaultتوھان کي اجازت ڏئي ٿو ته توھان جي پنھنجي Sass ۾ متغير جي ڊفالٽ قيمت کي تبديل ڪرڻ جي بغير بوٽ اسٽريپ جي سورس ڪوڊ کي تبديل ڪرڻ جي. ڪاپي ۽ پيسٽ ڪريو متغيرات جي ضرورت مطابق، انهن جي قيمتن کي تبديل ڪريو، ۽ !defaultپرچم کي هٽايو. جيڪڏهن هڪ متغير اڳ ۾ ئي تفويض ڪيو ويو آهي، پوء اهو بوٽ اسٽراپ ۾ ڊفالٽ ويلز طرفان ٻيهر تفويض نه ڪيو ويندو.

ساڳئي Sass فائل ۾ متغير اوور رائڊز ڊفالٽ متغيرن کان اڳ يا بعد ۾ اچي سگھن ٿا. تنهن هوندي، جڏهن Sass فائلن تي اوور رائيڊ ڪيو وڃي، توهان جي اووررائڊز ضرور اچڻ گهرجن ان کان اڳ جو توهان Bootstrap جي Sass فائلن کي درآمد ڪريو.

هتي هڪ مثال آهي جيڪو تبديل ڪري ٿو background-color۽ colorان لاءِ <body>جڏهن بوٽ اسٽريپ کي npm ذريعي درآمد ۽ مرتب ڪرڻ:

// Your variable overrides
$body-bg: #000;
$body-color: #111;

// Bootstrap and its default variables
@import "node_modules/bootstrap/scss/bootstrap";

Bootstrap ۾ ڪنهن به متغير لاءِ ضروري طور تي ورجايو، بشمول هيٺ ڏنل عالمي اختيارن.

نقشا ۽ لوپ

Bootstrap 4 ۾ شامل آھن ھٿن Sass نقشا، اھم قدر جوڙو جيڪي لاڳاپيل CSS جي خاندانن کي پيدا ڪرڻ آسان بڻائين ٿا. اسان استعمال ڪريون ٿا ساس نقشا اسان جي رنگن لاءِ، گرڊ بريڪ پوائنٽس، ۽ وڌيڪ. بس ساس متغير وانگر، سڀني ساس نقشن ۾ !defaultپرچم شامل آهي ۽ ختم ڪري سگھجي ٿو ۽ وڌايو وڃي ٿو.

اسان جا ڪجھ ساس نقشا ڊفالٽ طور خالي ٿيلن ۾ ضم ٿيل آھن. اهو ڪيو ويو آهي هڪ ڏنل ساس نقشي جي آسان توسيع جي اجازت ڏيڻ لاءِ، پر قيمت تي اچي ٿو هڪ نقشي مان شيون هٽائڻ کي ٿورو وڌيڪ ڏکيو.

نقشو تبديل ڪريو

اسان جي $theme-colorsنقشي ۾ موجود رنگ کي تبديل ڪرڻ لاءِ، ھيٺين کي پنھنجي ڪسٽم Sass فائل ۾ شامل ڪريو:

$theme-colors: (
  "primary": #0074d9,
  "danger": #ff4136
);

نقشي ۾ شامل ڪريو

۾ نئون رنگ $theme-colorsشامل ڪرڻ لاءِ، نئين ڪي ۽ قدر شامل ڪريو:

$theme-colors: (
  "custom-color": #900
);

نقشي تان هٽايو

يا ڪنهن ٻئي نقشي مان رنگ هٽائڻ لاءِ $theme-colors، استعمال ڪريو map-remove:

$theme-colors: map-remove($theme-colors, "success", "info", "danger");

گهربل ڪنجيون

بوٽ اسٽريپ ساس نقشن ۾ ڪجهه مخصوص ڪنجين جي موجودگي کي فرض ڪري ٿو جيئن اسان استعمال ڪيو ۽ پاڻ کي وڌايو. جيئن ته توهان شامل ڪيل نقشن کي ترتيب ڏيو ٿا، توهان شايد غلطين کي منهن ڏئي سگهون ٿا جتي هڪ مخصوص Sass نقشي جي ڪنجي استعمال ڪئي پئي وڃي.

مثال طور، اسان استعمال ڪندا آهيون primary, success, and dangerkey from from $theme-colorslinks, buttons, and form states. انهن ڪنجين جي قدرن کي تبديل ڪرڻ سان ڪوبه مسئلو نه هجڻ گهرجي، پر انهن کي هٽائڻ سان ساس تاليف جا مسئلا ٿي سگهن ٿا. انهن مثالن ۾، توهان کي Sass ڪوڊ کي تبديل ڪرڻ جي ضرورت پوندي جيڪا انهن قدرن کي استعمال ڪري ٿي.

افعال

بوٽ اسٽريپ ڪيترن ئي Sass افعال کي استعمال ڪري ٿو، پر صرف هڪ ذيلي سيٽ عام موضوع تي لاڳو ٿئي ٿو. اسان رنگن جي نقشن مان قدر حاصل ڪرڻ لاءِ ٽي ڪم شامل ڪيا آھن:

@function color($key: "blue") {
  @return map-get($colors, $key);
}

@function theme-color($key: "primary") {
  @return map-get($theme-colors, $key);
}

@function gray($key: "100") {
  @return map-get($grays, $key);
}

اهي توهان کي اجازت ڏين ٿا هڪ رنگ چونڊيو ساس نقشي مان گهڻو ڪري توهان ڪيئن استعمال ڪندا آهيو رنگ متغير مان v3.

.custom-element {
  color: gray("100");
  background-color: theme-color("dark");
}

اسان وٽ هڪ ٻيو فنڪشن پڻ آهي نقشي مان رنگ جي هڪ خاص سطح حاصل ڪرڻ لاءِ. $theme-colorsناڪاري سطح جا قدر رنگ کي روشن ڪندا، جڏهن ته اعليٰ سطحون اونداهو ٿي وينديون.

@function theme-color-level($color-name: "primary", $level: 0) {
  $color: theme-color($color-name);
  $color-base: if($level > 0, #000, #fff);
  $level: abs($level);

  @return mix($color-base, $color, $level * $theme-color-interval);
}

عملي طور تي، توهان فنڪشن کي ڪال ڪندا ۽ ٻن پيٽرولن ۾ پاس ڪندا: رنگ جو نالو $theme-colors(مثال طور، پرائمري يا خطرو) ۽ هڪ عددي سطح.

.custom-element {
  color: theme-color-level(primary, -10);
}

اضافي افعال شامل ٿي سگھن ٿا مستقبل ۾ يا توھان جي پنھنجي مرضي مطابق Sass اضافي Sass نقشن لاءِ ليول افعال ٺاھڻ لاءِ، يا ھڪڙو عام ھڪڙو جيڪڏھن توھان چاھيو ٿا ته وڌيڪ لفظي.

رنگ برعڪس

ھڪڙو اضافي فنڪشن جيڪو اسان بوٽ اسٽراپ ۾ شامل آھي اھو آھي رنگ برعڪس فنڪشن، color-yiq. اهو YIQ رنگ جي جڳهه کي استعمال ڪري ٿو خودڪار طور تي مخصوص بنيادي رنگ جي بنياد تي روشني ( #fff) يا ڳاڙهو ( ) برعڪس رنگ واپس ڪرڻ لاء. #111هي فنڪشن خاص طور تي ڪارائتو آهي mixins يا loops لاءِ جتي توهان ڪيترائي ڪلاس ٺاهي رهيا آهيو.

$theme-colorsمثال طور، اسان جي نقشي مان رنگن جا نمونا ٺاهڻ لاءِ :

@each $color, $value in $theme-colors {
  .swatch-#{$color} {
    color: color-yiq($value);
  }
}

اهو پڻ استعمال ڪري سگهجي ٿو هڪ بند جي ابتڙ ضرورتن لاءِ:

.custom-element {
  color: color-yiq(#000); // returns `color: #fff`
}

توھان پڻ بيان ڪري سگھو ٿا بنيادي رنگ اسان جي رنگ نقشي جي ڪمن سان:

.custom-element {
  color: color-yiq(theme-color("dark")); // returns `color: #fff`
}

ساس اختيارن

Bootstrap 4 کي اسان جي بلٽ ان ڪسٽم متغير فائل سان ترتيب ڏيو ۽ آساني سان عالمي CSS ترجيحن کي نئين $enable-*Sass متغيرن سان ٽوگل ڪريو. هڪ متغير جي قيمت کي ختم ڪريو ۽ npm run testضرورت مطابق ٻيهر گڏ ڪريو.

توھان ڳولي سگھوٿا ۽ انھن متغيرن کي اسان جي _variables.scssفائل ۾ اهم عالمي اختيارن لاءِ ترتيب ڏيو.

متغير قدر وصف
$spacer 1rem(ڊفالٽ)، يا ڪو قدر > 0 پروگرام جي ترتيب سان اسان جي اسپيسر يوٽيلٽيز کي پيدا ڪرڻ لاءِ ڊفالٽ اسپيسر جي قيمت بيان ڪري ٿي .
$enable-rounded true(ڊفالٽ) ياfalse border-radiusمختلف حصن تي اڳواٽ بيان ڪيل انداز کي فعال ڪري ٿو.
$enable-shadows trueيا false(ڊفالٽ) box-shadowمختلف حصن تي اڳواٽ بيان ڪيل انداز کي فعال ڪري ٿو.
$enable-gradients trueيا false(ڊفالٽ) background-imageمختلف حصن تي اسٽائل ذريعي اڳواٽ بيان ڪيل گرڊينٽ کي فعال ڪري ٿو .
$enable-transitions true(ڊفالٽ) ياfalse transitionمختلف حصن تي اڳواٽ بيان ڪيل s کي فعال ڪري ٿو.
$enable-hover-media-query trueيا false(ڊفالٽ) بيڪار
$enable-grid-classes true(ڊفالٽ) ياfalse گرڊ سسٽم لاءِ سي ايس ايس ڪلاس جي نسل کي فعال ڪري ٿو (مثال طور، .container, , .row, .col-md-1, etc.).
$enable-caret true(ڊفالٽ) ياfalse pseudo عنصر ڪيريٽ کي فعال ڪري ٿو .dropdown-toggle.
$enable-print-styles true(ڊفالٽ) ياfalse پرنٽنگ کي بهتر ڪرڻ لاءِ اسلوب کي فعال ڪري ٿو.

رنگ

بوٽ اسٽريپ جا ڪيترائي مختلف جزا ۽ يوٽيلٽيز ٺاهيا ويا آهن رنگن جي هڪ سيريز ذريعي ساس نقشي ۾ بيان ڪيل. ھن نقشي کي لوپ ڪري سگھجي ٿو ساس ۾ تڪڙو ھڪڙو سلسلو پيدا ڪرڻ لاءِ.

سڀ رنگ

Bootstrap 4 ۾ موجود سڀئي رنگ، اسان جي scss/_variables.scssفائل ۾ Sass variables ۽ Sass نقشي طور موجود آهن. ان کي وڌايو ويندو ايندڙ نابالغ رليزز ۾ اضافي رنگن کي شامل ڪرڻ لاءِ، گهڻو ڪري گريس اسڪيل پيلٽ وانگر جيڪو اسان اڳ ۾ ئي شامل ڪيو آهي.

نيرو
انڊگو
واڱڻائي
گلابي
ڳاڙهو
نارنگي
پيلو
سائو
ٽيل
سائي

ھتي آھي توھان پنھنجي ساس ۾ انھن کي ڪيئن استعمال ڪري سگھو ٿا:

// With variable
.alpha { color: $purple; }

// From the Sass map with our `color()` function
.beta { color: color("purple"); }

رنگ يوٽيلٽي ڪلاس پڻ سيٽنگ color۽ background-color.

مستقبل ۾، اسان مقصد ڏينداسين Sass نقشا ۽ ھر رنگ جي ڇانو لاءِ متغيرات جيئن اسان ھيٺ ڏنل گريسڪيل رنگن سان ڪيو آھي.

موضوع جا رنگ

اسان سڀني رنگن جو ذيلي سيٽ استعمال ڪندا آهيون رنگن جي اسڪيمن کي ٺاهڻ لاءِ هڪ ننڍڙو رنگ پيلٽ ٺاهڻ لاءِ، اسان جي scss/_variables.scssفائل ۾ Sass متغير ۽ Sass نقشي جي طور تي پڻ موجود آهي.

پرائمري
ثانوي
ڪاميابي
خطرو
ڊيڄاريندڙ
ڄاڻ
روشني
ڳاڙهو

گرين

گرين متغيرن جو هڪ وسيع سيٽ ۽ هڪ ساس نقشو scss/_variables.scssتوهان جي پروجيڪٽ ۾ گرين جي مسلسل رنگن لاءِ.

100
200
300
400
500
600
700
800
900

اندر _variables.scss، توهان اسان جا رنگ متغير ۽ ساس نقشو ڳوليندا. $colorsهتي ساس نقشي جو هڪ مثال آهي :

$colors: (
  "blue": $blue,
  "indigo": $indigo,
  "purple": $purple,
  "pink": $pink,
  "red": $red,
  "orange": $orange,
  "yellow": $yellow,
  "green": $green,
  "teal": $teal,
  "cyan": $cyan,
  "white": $white,
  "gray": $gray-600,
  "gray-dark": $gray-800
) !default;

نقشي ۾ شامل ڪريو، ھٽايو، يا تبديل ڪريو قدرن کي اپڊيٽ ڪرڻ لاءِ ته اھي ڪيئن استعمال ٿين ٿا ٻين ڪيترن ئي حصن ۾. بدقسمتي سان هن وقت، هر جزو هن ساس نقشي کي استعمال نٿو ڪري. مستقبل ۾ تازه ڪاريون هن کي بهتر ڪرڻ جي ڪوشش ڪندا. ان وقت تائين، متغيرن جي استعمال تي منصوبو ٺاهيو ${color}۽ هن ساس نقشي.

اجزاء

بوٽ اسٽريپ جا ڪيترائي حصا ۽ افاديتون @eachلوپ سان ٺهيل آهن جيڪي هڪ ساس نقشي تي ٻيهر ورجائيندا آهن. اهو خاص طور تي مددگار آهي اسان جي طرفان هڪ جزو جي مختلف $theme-colorsقسمن کي پيدا ڪرڻ ۽ هر بريڪ پوائنٽ لاءِ جوابي مختلف قسمون ٺاهڻ. جيئن توهان انهن ساس نقشن کي ترتيب ڏيو ۽ ٻيهر گڏ ڪريو، توهان خودڪار طريقي سان ڏسندا ته توهان جون تبديليون انهن لوپس ۾ ظاهر ٿينديون.

تبديل ڪندڙ

بوٽ اسٽريپ جا ڪيترائي حصا بنيادي-موڊيفائر ڪلاس جي انداز سان ٺهيل آهن. هن جو مطلب آهي ته اسٽائل جو وڏو حصو هڪ بنيادي طبقي تي مشتمل آهي (مثال طور، .btn) جڏهن ته انداز جي مختلف تبديلين کي تبديل ڪندڙ طبقن تائين محدود آهي (مثال طور، .btn-danger). اهي موڊيفائر ڪلاس $theme-colorsنقشي مان ٺاهيا ويا آهن ته جيئن اسان جي موڊيفائر ڪلاسن جي تعداد ۽ نالو کي ترتيب ڏيو.

Here are two examples of how we loop over the $theme-colors map to generate modifiers to the .alert component and all our .bg-* background utilities.

// Generate alert modifier classes
@each $color, $value in $theme-colors {
  .alert-#{$color} {
    @include alert-variant(theme-color-level($color, -10), theme-color-level($color, -9), theme-color-level($color, 6));
  }
}

// Generate `.bg-*` color utilities
@each $color, $value in $theme-colors {
  @include bg-variant('.bg-#{$color}', $value);
}

Responsive

These Sass loops aren’t limited to color maps, either. You can also generate responsive variations of your components or utilities. Take for example our responsive text alignment utilities where we mix an @each loop for the $grid-breakpoints Sass map with a media query include.

@each $breakpoint in map-keys($grid-breakpoints) {
  @include media-breakpoint-up($breakpoint) {
    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);

    .text#{$infix}-left   { text-align: left !important; }
    .text#{$infix}-right  { text-align: right !important; }
    .text#{$infix}-center { text-align: center !important; }
  }
}

Should you need to modify your $grid-breakpoints, your changes will apply to all the loops iterating over that map.

CSS variables

Bootstrap 4 ان جي مرتب ڪيل CSS ۾ لڳ ڀڳ ٻه درجن CSS ڪسٽم پراپرٽيز (متغير) شامل آهن. اهي عام طور تي استعمال ٿيل قدرن تائين آسان رسائي فراهم ڪن ٿيون جهڙوڪ اسان جي موضوع جا رنگ، بريڪ پوائنٽس، ۽ بنيادي فونٽ اسٽيڪ جڏهن توهان جي برائوزر جي انسپيڪٽر، ڪوڊ سينڊ باڪس، يا عام پروٽو ٽائپنگ ۾ ڪم ڪري رهيا آهن.

موجود متغير

هتي اهي متغير آهن جن ۾ اسان شامل آهيون (ياد رکو ته :rootگهربل آهي). اهي اسان جي _root.scssفائل ۾ موجود آهن.

:root {
  --blue: #007bff;
  --indigo: #6610f2;
  --purple: #6f42c1;
  --pink: #e83e8c;
  --red: #dc3545;
  --orange: #fd7e14;
  --yellow: #ffc107;
  --green: #28a745;
  --teal: #20c997;
  --cyan: #17a2b8;
  --white: #fff;
  --gray: #6c757d;
  --gray-dark: #343a40;
  --primary: #007bff;
  --secondary: #6c757d;
  --success: #28a745;
  --info: #17a2b8;
  --warning: #ffc107;
  --danger: #dc3545;
  --light: #f8f9fa;
  --dark: #343a40;
  --breakpoint-xs: 0;
  --breakpoint-sm: 576px;
  --breakpoint-md: 768px;
  --breakpoint-lg: 992px;
  --breakpoint-xl: 1200px;
  --font-family-sans-serif: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
  --font-family-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
}

مثال

CSS متغير Sass جي متغيرن لاءِ ساڳي لچڪ پيش ڪن ٿا، پر برائوزر تي پيش ڪرڻ کان اڳ تاليف جي ضرورت کان سواءِ. مثال طور، هتي اسان پنهنجي صفحي جي فونٽ ۽ لنڪ اسلوب کي CSS متغيرن سان ري سيٽ ڪري رهيا آهيون.

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

توھان پڻ استعمال ڪري سگھو ٿا اسان جا بريڪ پوائنٽ متغير پنھنجي ميڊيا سوالن ۾:

.content-secondary {
  display: none;
}

@media (min-width(var(--breakpoint-sm))) {
  .content-secondary {
    display: block;
  }
}