उपयोगिता एपीआई
उपयोगिता एपीआई उपयोगिता वर्ग उत्पन्न करने के लिए एक सास-आधारित उपकरण है।
बूटस्ट्रैप उपयोगिताओं को हमारे उपयोगिता एपीआई के साथ उत्पन्न किया जाता है और इसका उपयोग सैस के माध्यम से उपयोगिता वर्गों के हमारे डिफ़ॉल्ट सेट को संशोधित या विस्तारित करने के लिए किया जा सकता है। हमारी उपयोगिता एपीआई विभिन्न विकल्पों के साथ वर्गों के परिवारों को उत्पन्न करने के लिए सैस मानचित्रों और कार्यों की एक श्रृंखला पर आधारित है। यदि आप Sass मानचित्रों से अपरिचित हैं, तो आरंभ करने के लिए आधिकारिक Sass दस्तावेज़ पढ़ें।
मानचित्र में हमारी $utilitiesसभी सुविधाएं शामिल हैं और $utilitiesयदि मौजूद हैं तो बाद में इसे आपके कस्टम मानचित्र के साथ मिला दिया जाता है। उपयोगिता मानचित्र में उपयोगिता समूहों की एक प्रमुख सूची है जो निम्नलिखित विकल्पों को स्वीकार करते हैं:
| विकल्प | टाइप | डिफ़ॉल्ट मान | विवरण |
|---|---|---|---|
property |
आवश्यक | - | संपत्ति का नाम, यह एक स्ट्रिंग या स्ट्रिंग्स की एक सरणी हो सकती है (उदाहरण के लिए, क्षैतिज पैडिंग या मार्जिन)। |
values |
आवश्यक | - | मानों की सूची, या मानचित्र यदि आप नहीं चाहते कि वर्ग का नाम मान के समान हो। यदि nullमानचित्र कुंजी के रूप में उपयोग किया जाता है, classतो कक्षा के नाम से नहीं जोड़ा जाता है। |
class |
वैकल्पिक | शून्य | उत्पन्न वर्ग का नाम। यदि प्रदान नहीं किया गया है और propertyस्ट्रिंग की एक सरणी है, तो सरणी classके पहले तत्व के लिए डिफ़ॉल्ट होगा property। यदि प्रदान नहीं किया propertyगया है और एक स्ट्रिंग है, तो नामों valuesके लिए कुंजियों का उपयोग किया जाता है ।class |
css-var |
वैकल्पिक | false |
सीएसएस नियमों के बजाय सीएसएस चर उत्पन्न करने के लिए बूलियन। |
css-variable-name |
वैकल्पिक | शून्य | नियमसेट के अंदर सीएसएस वैरिएबल के लिए कस्टम अन-प्रीफ़िक्स्ड नाम। |
local-vars |
वैकल्पिक | शून्य | सीएसएस नियमों के अलावा जनरेट करने के लिए स्थानीय सीएसएस वैरिएबल का मैप. |
state |
वैकल्पिक | शून्य | उत्पन्न करने के लिए छद्म-वर्ग वेरिएंट (जैसे, :hoverया ) की सूची।:focus |
responsive |
वैकल्पिक | false |
बूलियन इंगित करता है कि उत्तरदायी कक्षाएं उत्पन्न की जानी चाहिए या नहीं। |
rfs |
वैकल्पिक | false |
बूलियन आरएफएस के साथ द्रव पुनर्विक्रय को सक्षम करने के लिए । |
print |
वैकल्पिक | false |
बूलियन इंगित करता है कि प्रिंट कक्षाओं को उत्पन्न करने की आवश्यकता है या नहीं। |
rtl |
वैकल्पिक | true |
बूलियन इंगित करता है कि उपयोगिता को आरटीएल में रखा जाना चाहिए या नहीं। |
एपीआई समझाया
सभी उपयोगिता चर $utilitiesहमारी _utilities.scssस्टाइलशीट में चर में जोड़े जाते हैं। उपयोगिताओं का प्रत्येक समूह कुछ इस तरह दिखता है:
$utilities: (
"opacity": (
property: opacity,
values: (
0: 0,
25: .25,
50: .5,
75: .75,
100: 1,
)
)
);
जो निम्नलिखित आउटपुट करता है:
.opacity-0 { opacity: 0; }
.opacity-25 { opacity: .25; }
.opacity-50 { opacity: .5; }
.opacity-75 { opacity: .75; }
.opacity-100 { opacity: 1; }
संपत्ति
आवश्यक propertyकुंजी को किसी भी उपयोगिता के लिए सेट किया जाना चाहिए, और इसमें एक वैध सीएसएस संपत्ति होनी चाहिए। इस संपत्ति का उपयोग जनरेट की गई उपयोगिता के नियम में किया जाता है। जब classकुंजी को छोड़ दिया जाता है, तो यह डिफ़ॉल्ट वर्ग नाम के रूप में भी कार्य करता है। text-decorationउपयोगिता पर विचार करें :
$utilities: (
"text-decoration": (
property: text-decoration,
values: none underline line-through
)
);
आउटपुट:
.text-decoration-none { text-decoration: none !important; }
.text-decoration-underline { text-decoration: underline !important; }
.text-decoration-line-through { text-decoration: line-through !important; }
मूल्यों
यह निर्दिष्ट करने के लिए कुंजी का उपयोग करें कि valuesनिर्दिष्ट के लिए कौन से मान propertyजेनरेट किए गए वर्ग नामों और नियमों में उपयोग किए जाने चाहिए। एक सूची या नक्शा हो सकता है (उपयोगिताओं में या एक सैस चर में सेट)।
एक सूची के रूप में, जैसे text-decorationउपयोगिताओं के साथ :
values: none underline line-through
मानचित्र के रूप में, जैसे opacityउपयोगिताओं के साथ :
values: (
0: 0,
25: .25,
50: .5,
75: .75,
100: 1,
)
एक Sass चर के रूप में जो सूची या मानचित्र सेट करता है, जैसा कि हमारी positionउपयोगिताओं में है :
values: $position-values
कक्षा
classसंकलित सीएसएस में प्रयुक्त वर्ग उपसर्ग को बदलने के लिए विकल्प का उपयोग करें । उदाहरण के लिए, से बदलने के .opacity-*लिए .o-*:
$utilities: (
"opacity": (
property: opacity,
class: o,
values: (
0: 0,
25: .25,
50: .5,
75: .75,
100: 1,
)
)
);
आउटपुट:
.o-0 { opacity: 0 !important; }
.o-25 { opacity: .25 !important; }
.o-50 { opacity: .5 !important; }
.o-75 { opacity: .75 !important; }
.o-100 { opacity: 1 !important; }
यदि , प्रत्येक कुंजी class: nullके लिए कक्षाएं उत्पन्न करता है:values
$utilities: (
"visibility": (
property: visibility,
class: null,
values: (
visible: visible,
invisible: hidden,
)
)
);
आउटपुट:
.visible { visibility: visible !important; }
.invisible { visibility: hidden !important; }
सीएसएस चर उपयोगिताओं
css-varबूलियन विकल्प को पर सेट करें और एपीआई सामान्य नियमों trueके बजाय दिए गए चयनकर्ता के लिए स्थानीय सीएसएस चर उत्पन्न करेगा । वर्ग नाम से भिन्न CSS चर नाम सेट करने के लिए property: valueएक वैकल्पिक जोड़ें ।css-variable-name
हमारी .text-opacity-*उपयोगिताओं पर विचार करें। यदि हम css-variable-nameविकल्प जोड़ते हैं, तो हमें एक कस्टम आउटपुट मिलेगा।
$utilities: (
"text-opacity": (
css-var: true,
css-variable-name: text-alpha,
class: text-opacity,
values: (
25: .25,
50: .5,
75: .75,
100: 1
)
),
);
आउटपुट:
.text-opacity-25 { --bs-text-alpha: .25; }
.text-opacity-50 { --bs-text-alpha: .5; }
.text-opacity-75 { --bs-text-alpha: .75; }
.text-opacity-100 { --bs-text-alpha: 1; }
स्थानीय सीएसएस चर
सैस मानचित्र निर्दिष्ट करने के लिए विकल्प का उपयोग करें local-varsजो उपयोगिता वर्ग के नियमों के भीतर स्थानीय सीएसएस चर उत्पन्न करेगा। कृपया ध्यान दें कि जेनरेट किए गए सीएसएस नियमों में उन स्थानीय सीएसएस चर का उपभोग करने के लिए अतिरिक्त काम की आवश्यकता हो सकती है। उदाहरण के लिए, हमारी .bg-*उपयोगिताओं पर विचार करें:
$utilities: (
"background-color": (
property: background-color,
class: bg,
local-vars: (
"bg-opacity": 1
),
values: map-merge(
$utilities-bg-colors,
(
"transparent": transparent
)
)
)
);
आउटपुट:
.bg-primary {
--bs-bg-opacity: 1;
background-color: rgba(var(--bs-primary-rgb), var(--bs-bg-opacity)) !important;
}
राज्य अमेरिका
stateछद्म-वर्ग विविधताएं उत्पन्न करने के लिए विकल्प का उपयोग करें । उदाहरण छद्म वर्ग हैं :hoverऔर :focus. जब राज्यों की सूची प्रदान की जाती है, तो उस छद्म वर्ग के लिए वर्गनाम बनाए जाते हैं। उदाहरण के लिए, होवर पर अस्पष्टता बदलने के लिए, जोड़ें state: hoverऔर आप .opacity-hover:hoverअपने संकलित सीएसएस में प्राप्त करेंगे।
एकाधिक छद्म वर्गों की आवश्यकता है? राज्यों की अंतरिक्ष से अलग की गई सूची का उपयोग करें: state: hover focus.
$utilities: (
"opacity": (
property: opacity,
class: opacity,
state: hover,
values: (
0: 0,
25: .25,
50: .5,
75: .75,
100: 1,
)
)
);
आउटपुट:
.opacity-0-hover:hover { opacity: 0 !important; }
.opacity-25-hover:hover { opacity: .25 !important; }
.opacity-50-hover:hover { opacity: .5 !important; }
.opacity-75-hover:hover { opacity: .75 !important; }
.opacity-100-hover:hover { opacity: 1 !important; }
उत्तरदायी
सभी ब्रेकप्वाइंट में उत्तरदायी उपयोगिताओं (जैसे,) responsiveउत्पन्न करने के लिए बूलियन जोड़ें ।.opacity-md-25
$utilities: (
"opacity": (
property: opacity,
responsive: true,
values: (
0: 0,
25: .25,
50: .5,
75: .75,
100: 1,
)
)
);
आउटपुट:
.opacity-0 { opacity: 0 !important; }
.opacity-25 { opacity: .25 !important; }
.opacity-50 { opacity: .5 !important; }
.opacity-75 { opacity: .75 !important; }
.opacity-100 { opacity: 1 !important; }
@media (min-width: 576px) {
.opacity-sm-0 { opacity: 0 !important; }
.opacity-sm-25 { opacity: .25 !important; }
.opacity-sm-50 { opacity: .5 !important; }
.opacity-sm-75 { opacity: .75 !important; }
.opacity-sm-100 { opacity: 1 !important; }
}
@media (min-width: 768px) {
.opacity-md-0 { opacity: 0 !important; }
.opacity-md-25 { opacity: .25 !important; }
.opacity-md-50 { opacity: .5 !important; }
.opacity-md-75 { opacity: .75 !important; }
.opacity-md-100 { opacity: 1 !important; }
}
@media (min-width: 992px) {
.opacity-lg-0 { opacity: 0 !important; }
.opacity-lg-25 { opacity: .25 !important; }
.opacity-lg-50 { opacity: .5 !important; }
.opacity-lg-75 { opacity: .75 !important; }
.opacity-lg-100 { opacity: 1 !important; }
}
@media (min-width: 1200px) {
.opacity-xl-0 { opacity: 0 !important; }
.opacity-xl-25 { opacity: .25 !important; }
.opacity-xl-50 { opacity: .5 !important; }
.opacity-xl-75 { opacity: .75 !important; }
.opacity-xl-100 { opacity: 1 !important; }
}
@media (min-width: 1400px) {
.opacity-xxl-0 { opacity: 0 !important; }
.opacity-xxl-25 { opacity: .25 !important; }
.opacity-xxl-50 { opacity: .5 !important; }
.opacity-xxl-75 { opacity: .75 !important; }
.opacity-xxl-100 { opacity: 1 !important; }
}
छाप
printविकल्प को सक्षम करने से प्रिंट के लिए उपयोगिता वर्ग भी@media print { ... } उत्पन्न होंगे, जो केवल मीडिया क्वेरी के भीतर ही लागू होते हैं ।
$utilities: (
"opacity": (
property: opacity,
print: true,
values: (
0: 0,
25: .25,
50: .5,
75: .75,
100: 1,
)
)
);
आउटपुट:
.opacity-0 { opacity: 0 !important; }
.opacity-25 { opacity: .25 !important; }
.opacity-50 { opacity: .5 !important; }
.opacity-75 { opacity: .75 !important; }
.opacity-100 { opacity: 1 !important; }
@media print {
.opacity-print-0 { opacity: 0 !important; }
.opacity-print-25 { opacity: .25 !important; }
.opacity-print-50 { opacity: .5 !important; }
.opacity-print-75 { opacity: .75 !important; }
.opacity-print-100 { opacity: 1 !important; }
}
महत्त्व
एपीआई द्वारा उत्पन्न सभी उपयोगिताओं में !importantयह सुनिश्चित करना शामिल है कि वे घटकों और संशोधक वर्गों को ओवरराइड करते हैं। आप इस सेटिंग को $enable-important-utilitiesवैरिएबल के साथ विश्व स्तर पर टॉगल कर सकते हैं (डिफॉल्ट टू true)।
एपीआई का उपयोग करना
अब जब आप यूटिलिटीज एपीआई के काम करने के तरीके से परिचित हो गए हैं, तो जानें कि अपनी खुद की कस्टम क्लास कैसे जोड़ें और हमारी डिफॉल्ट यूटिलिटीज को कैसे संशोधित करें।
उपयोगिताओं को ओवरराइड करें
एक ही कुंजी का उपयोग करके मौजूदा उपयोगिताओं को ओवरराइड करें। उदाहरण के लिए, यदि आप अतिरिक्त प्रतिक्रियाशील अतिप्रवाह उपयोगिता वर्ग चाहते हैं, तो आप यह कर सकते हैं:
$utilities: (
"overflow": (
responsive: true,
property: overflow,
values: visible hidden scroll auto,
),
);
उपयोगिताओं को जोड़ें
नई उपयोगिताओं को डिफ़ॉल्ट $utilitiesमानचित्र में एक के साथ जोड़ा जा सकता है map-merge। सुनिश्चित करें कि हमारी आवश्यक एसएएस फाइलें _utilities.scssपहले आयात की जाती हैं, फिर map-mergeअपनी अतिरिक्त उपयोगिताओं को जोड़ने के लिए इसका उपयोग करें। उदाहरण के लिए, यहां cursorतीन मानों के साथ एक प्रतिक्रियाशील उपयोगिता जोड़ने का तरीका बताया गया है।
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
$utilities: map-merge(
$utilities,
(
"cursor": (
property: cursor,
class: cursor,
responsive: true,
values: auto pointer grab,
)
)
);
@import "bootstrap/scss/utilities/api";
उपयोगिताओं को संशोधित करें
$utilitiesडिफ़ॉल्ट मानचित्र में map-getऔर map-mergeकार्यों के साथ मौजूदा उपयोगिताओं को संशोधित करें । widthनीचे दिए गए उदाहरण में, हम उपयोगिताओं में एक अतिरिक्त मूल्य जोड़ रहे हैं । प्रारंभिक से प्रारंभ करें map-mergeऔर फिर निर्दिष्ट करें कि आप किस उपयोगिता को संशोधित करना चाहते हैं। वहां से, उपयोगिता के विकल्पों और मूल्यों को एक्सेस करने और संशोधित करने के लिए नेस्टेड "width"मानचित्र प्राप्त करें।map-get
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
$utilities: map-merge(
$utilities,
(
"width": map-merge(
map-get($utilities, "width"),
(
values: map-merge(
map-get(map-get($utilities, "width"), "values"),
(10: 10%),
),
),
),
)
);
@import "bootstrap/scss/utilities/api";
उत्तरदायी सक्षम करें
आप उपयोगिताओं के मौजूदा सेट के लिए प्रतिक्रियाशील कक्षाओं को सक्षम कर सकते हैं जो वर्तमान में डिफ़ॉल्ट रूप से उत्तरदायी नहीं हैं। उदाहरण के लिए, borderकक्षाओं को उत्तरदायी बनाने के लिए:
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
$utilities: map-merge(
$utilities, (
"border": map-merge(
map-get($utilities, "border"),
( responsive: true ),
),
)
);
@import "bootstrap/scss/utilities/api";
यह अब .borderऔर .border-0प्रत्येक ब्रेकपॉइंट के लिए उत्तरदायी रूपांतर उत्पन्न करेगा। आपका जेनरेट किया गया सीएसएस इस तरह दिखेगा:
.border { ... }
.border-0 { ... }
@media (min-width: 576px) {
.border-sm { ... }
.border-sm-0 { ... }
}
@media (min-width: 768px) {
.border-md { ... }
.border-md-0 { ... }
}
@media (min-width: 992px) {
.border-lg { ... }
.border-lg-0 { ... }
}
@media (min-width: 1200px) {
.border-xl { ... }
.border-xl-0 { ... }
}
@media (min-width: 1400px) {
.border-xxl { ... }
.border-xxl-0 { ... }
}
उपयोगिताओं का नाम बदलें
गुम v4 उपयोगिताओं, या किसी अन्य नामकरण परंपरा के लिए उपयोग किया जाता है? उपयोगिताओं एपीआई का उपयोग किसी दी गई उपयोगिता के परिणाम को ओवरराइड करने के लिए किया जा सकता है class- उदाहरण के लिए, .ms-*उपयोगिताओं का नाम बदलकर oldish करने के लिए .ml-*:
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
$utilities: map-merge(
$utilities, (
"margin-start": map-merge(
map-get($utilities, "margin-start"),
( class: ml ),
),
)
);
@import "bootstrap/scss/utilities/api";
उपयोगिताओं को हटा दें
map-remove()Sass फ़ंक्शन के साथ किसी भी डिफ़ॉल्ट उपयोगिता को हटा दें ।
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
// Remove multiple utilities with a comma-separated list
$utilities: map-remove($utilities, "width", "float");
@import "bootstrap/scss/utilities/api";
map-merge()आप Sass फ़ंक्शन का भी उपयोग कर सकते हैं और nullउपयोगिता को हटाने के लिए समूह कुंजी को सेट कर सकते हैं।
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
$utilities: map-merge(
$utilities,
(
"width": null
)
);
@import "bootstrap/scss/utilities/api";
जोड़ें, हटाएं, संशोधित करें
map-merge()आप Sass फ़ंक्शन के साथ एक साथ कई उपयोगिताओं को जोड़, हटा और संशोधित कर सकते हैं । यहां बताया गया है कि आप पिछले उदाहरणों को एक बड़े मानचित्र में कैसे जोड़ सकते हैं।
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
$utilities: map-merge(
$utilities,
(
// Remove the `width` utility
"width": null,
// Make an existing utility responsive
"border": map-merge(
map-get($utilities, "border"),
( responsive: true ),
),
// Add new utilities
"cursor": (
property: cursor,
class: cursor,
responsive: true,
values: auto pointer grab,
)
)
);
@import "bootstrap/scss/utilities/api";
आरटीएल में उपयोगिता हटाएं
कुछ किनारे के मामले आरटीएल स्टाइलिंग को कठिन बनाते हैं , जैसे अरबी में लाइन ब्रेक। rtlइस प्रकार यूटिलिटीज को विकल्प सेट करके आरटीएल आउटपुट से हटाया जा सकता है false:
$utilities: (
"word-wrap": (
property: word-wrap word-break,
class: text,
values: (break: break-word),
rtl: false
),
);
आउटपुट:
/* rtl:begin:remove */
.text-break {
word-wrap: break-word !important;
word-break: break-word !important;
}
/* rtl:end:remove */
यह आरटीएल में कुछ भी आउटपुट नहीं करता है, आरटीएलसीएसएस removeनियंत्रण निर्देश के लिए धन्यवाद ।