बटनहरू
धेरै आकारहरू, राज्यहरू, र थपका लागि समर्थनको साथ फारमहरू, संवादहरू, र थप कार्यहरूका लागि बुटस्ट्र्यापको अनुकूलन बटन शैलीहरू प्रयोग गर्नुहोस्।
उदाहरणहरू
बुटस्ट्र्यापले धेरै पूर्वनिर्धारित बटन शैलीहरू समावेश गर्दछ, प्रत्येकले यसको आफ्नै अर्थपूर्ण उद्देश्यको सेवा गर्दछ, थप नियन्त्रणको लागि केही अतिरिक्तहरू समावेश गर्दछ।
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-secondary">Secondary</button>
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-light">Light</button>
<button type="button" class="btn btn-dark">Dark</button>
<button type="button" class="btn btn-link">Link</button>
सहयोगी टेक्नोलोजीहरूको अर्थ बुझाउँदै
अर्थ थप्न रङको प्रयोगले मात्र दृश्य सङ्केत प्रदान गर्दछ, जुन सहायक प्रविधिहरूका प्रयोगकर्ताहरूलाई जानकारी दिइने छैन - जस्तै स्क्रिन रिडरहरू। सुनिश्चित गर्नुहोस् कि रङद्वारा संकेत गरिएको जानकारी या त सामग्रीबाट नै स्पष्ट छ (जस्तै देखिने पाठ), वा वैकल्पिक माध्यमहरू मार्फत समावेश गरिएको छ, जस्तै .visually-hidden
कक्षासँग लुकेको अतिरिक्त पाठ।
पाठ र्यापिङ असक्षम पार्नुहोस्
यदि तपाइँ बटनको पाठ र्याप गर्न चाहनुहुन्न भने, तपाइँ .text-nowrap
बटनमा कक्षा थप्न सक्नुहुन्छ। Sass मा, तपाइँ $btn-white-space: nowrap
प्रत्येक बटनको लागि पाठ र्यापिङ असक्षम गर्न सेट गर्न सक्नुहुन्छ।
बटन ट्यागहरू
कक्षाहरू तत्वसँग .btn
प्रयोग गर्न डिजाइन गरिएका छन् । <button>
यद्यपि, तपाइँ यी कक्षाहरू <a>
वा <input>
तत्वहरूमा पनि प्रयोग गर्न सक्नुहुन्छ (यद्यपि केही ब्राउजरहरूले अलि फरक रेन्डरिङ लागू गर्न सक्छन्)।
हालको पृष्ठ भित्रका नयाँ पृष्ठहरू वा खण्डहरूमा लिङ्क गर्नुको सट्टा इन-पेज कार्यक्षमता ट्रिगर गर्न प्रयोग हुने तत्वहरूमा बटन वर्गहरू प्रयोग गर्दा, यी लिङ्कहरूलाई सहयोगी प्रविधिहरूमा उनीहरूको उद्देश्यलाई उचित रूपमा व्यक्त गर्न <a>
दिइनु पर्छ। role="button"
स्क्रिन रिडरहरू।
<a class="btn btn-primary" href="#" role="button">Link</a>
<button class="btn btn-primary" type="submit">Button</button>
<input class="btn btn-primary" type="button" value="Input">
<input class="btn btn-primary" type="submit" value="Submit">
<input class="btn btn-primary" type="reset" value="Reset">
रूपरेखा बटनहरू
एउटा बटन चाहिन्छ, तर तिनीहरूले ल्याएका भारी पृष्ठभूमि रंगहरू होइनन्? .btn-outline-*
कुनै पनि बटनमा सबै पृष्ठभूमि छविहरू र रङहरू हटाउनको लागि पूर्वनिर्धारित परिमार्जक वर्गहरूलाई बदल्नुहोस् ।
<button type="button" class="btn btn-outline-primary">Primary</button>
<button type="button" class="btn btn-outline-secondary">Secondary</button>
<button type="button" class="btn btn-outline-success">Success</button>
<button type="button" class="btn btn-outline-danger">Danger</button>
<button type="button" class="btn btn-outline-warning">Warning</button>
<button type="button" class="btn btn-outline-info">Info</button>
<button type="button" class="btn btn-outline-light">Light</button>
<button type="button" class="btn btn-outline-dark">Dark</button>
आकारहरू
फ्यान्सी ठूला वा सानो बटनहरू? थप्नुहोस् .btn-lg
वा .btn-sm
थप आकारहरूको लागि।
<button type="button" class="btn btn-primary btn-lg">Large button</button>
<button type="button" class="btn btn-secondary btn-lg">Large button</button>
<button type="button" class="btn btn-primary btn-sm">Small button</button>
<button type="button" class="btn btn-secondary btn-sm">Small button</button>
तपाइँ CSS चरहरूसँग तपाइँको आफ्नै अनुकूलन आकार रोल गर्न सक्नुहुन्छ:
<button type="button" class="btn btn-primary"
style="--bs-btn-padding-y: .25rem; --bs-btn-padding-x: .5rem; --bs-btn-font-size: .75rem;">
Custom button
</button>
असक्षम राज्य
कुनै पनि तत्वमा disabled
बुलियन विशेषता थपेर बटनहरूलाई निष्क्रिय देखाउनुहोस्। <button>
असक्षम बटनहरू pointer-events: none
लागू भएका छन्, होभर र सक्रिय अवस्थाहरूलाई ट्रिगर हुनबाट रोक्दै।
<button type="button" class="btn btn-primary" disabled>Primary button</button>
<button type="button" class="btn btn-secondary" disabled>Button</button>
<button type="button" class="btn btn-outline-primary" disabled>Primary button</button>
<button type="button" class="btn btn-outline-secondary" disabled>Button</button>
तत्व प्रयोग गरेर असक्षम गरिएका बटनहरू <a>
अलि फरक व्यवहार गर्छन्:
<a>
s ले विशेषतालाई समर्थन गर्दैनdisabled
, त्यसैले तपाईंले.disabled
यसलाई दृश्यात्मक रूपमा असक्षम देखाउनको लागि कक्षा थप्नु पर्छ।pointer-events
एंकर बटनहरूमा सबै असक्षम पार्न केही भविष्य-अनुकूल शैलीहरू समावेश गरिएका छन् ।- प्रयोग गर्ने असक्षम बटनहरूले सहायक प्रविधिहरूमा तत्वको अवस्थालाई संकेत गर्न विशेषता
<a>
समावेश गर्नुपर्छ ।aria-disabled="true"
- प्रयोग गर्ने असक्षम बटनहरूले विशेषता समावेश
<a>
गर्नु हुँदैन ।href
<a class="btn btn-primary disabled" role="button" aria-disabled="true">Primary link</a>
<a class="btn btn-secondary disabled" role="button" aria-disabled="true">Link</a>
लिङ्क कार्यक्षमता चेतावनी
तपाईंले href
असक्षम लिङ्कमा विशेषता राख्नु पर्ने अवस्थाहरूलाई कभर गर्न, .disabled
वर्गले s pointer-events: none
को लिङ्क कार्यक्षमता असक्षम पार्ने प्रयास गर्न प्रयोग गर्दछ। <a>
नोट गर्नुहोस् कि यो CSS गुण अझै HTML को लागी मानकीकृत छैन, तर सबै आधुनिक ब्राउजरहरूले यसलाई समर्थन गर्दछ। थप रूपमा, समर्थन गर्ने ब्राउजरहरूमा पनि pointer-events: none
, किबोर्ड नेभिगेसन अप्रभावित रहन्छ, यसको अर्थ किबोर्ड प्रयोगकर्ताहरू र सहायक प्रविधिहरूका प्रयोगकर्ताहरूले अझै पनि यी लिङ्कहरू सक्रिय गर्न सक्षम हुनेछन्। त्यसैले सुरक्षित हुनको लागि, साथै , किबोर्ड फोकस प्राप्त गर्नबाट रोक्नको लागि यी लिङ्कहरूमा aria-disabled="true"
एउटा विशेषता पनि समावेश गर्नुहोस् , र तिनीहरूको कार्यक्षमता पूर्ण रूपमा असक्षम गर्न अनुकूलन JavaScript प्रयोग गर्नुहोस्।tabindex="-1"
<a href="#" class="btn btn-primary disabled" tabindex="-1" role="button" aria-disabled="true">Primary link</a>
<a href="#" class="btn btn-secondary disabled" tabindex="-1" role="button" aria-disabled="true">Link</a>
ब्लक बटनहरू
हाम्रो डिस्प्ले र ग्याप उपयोगिताहरूको मिश्रणको साथ Bootstrap 4 मा जस्तै पूर्ण-चौडाइको जवाफदेही स्ट्याकहरू, "ब्लक बटनहरू" सिर्जना गर्नुहोस्। बटन विशिष्ट वर्गहरूको सट्टा उपयोगिताहरू प्रयोग गरेर, हामीसँग स्पेसिङ, पङ्क्तिबद्धता, र उत्तरदायी व्यवहारहरूमा धेरै ठूलो नियन्त्रण हुन्छ।
<div class="d-grid gap-2">
<button class="btn btn-primary" type="button">Button</button>
<button class="btn btn-primary" type="button">Button</button>
</div>
यहाँ हामी एक प्रतिक्रियाशील भिन्नता सिर्जना गर्छौं, md
ब्रेकपोइन्ट सम्म ठाडो स्ट्याक गरिएका बटनहरूबाट सुरु गर्दै, जहाँ क्लासलाई .d-md-block
प्रतिस्थापन गर्दछ .d-grid
, यसरी gap-2
उपयोगितालाई रद्द गर्दछ। आफ्नो ब्राउजरको आकार बदल्नुहोस्।
<div class="d-grid gap-2 d-md-block">
<button class="btn btn-primary" type="button">Button</button>
<button class="btn btn-primary" type="button">Button</button>
</div>
तपाईं ग्रिड स्तम्भ चौडाइ वर्गहरूसँग आफ्नो ब्लक बटनहरूको चौडाइ समायोजन गर्न सक्नुहुन्छ। उदाहरणका लागि, आधा-चौडाइको "ब्लक बटन" को लागि, प्रयोग गर्नुहोस् .col-6
। यसलाई तेर्सो रूपमा केन्द्रित गर्नुहोस् .mx-auto
, पनि।
<div class="d-grid gap-2 col-6 mx-auto">
<button class="btn btn-primary" type="button">Button</button>
<button class="btn btn-primary" type="button">Button</button>
</div>
तेर्सो हुँदा बटनहरूको पङ्क्तिबद्धता समायोजन गर्न थप उपयोगिताहरू प्रयोग गर्न सकिन्छ। यहाँ हामीले हाम्रो अघिल्लो उत्तरदायी उदाहरण लिएका छौं र बटनहरूमा केही फ्लेक्स उपयोगिताहरू र मार्जिन उपयोगिता थपेका छौं जब बटनहरू अब स्ट्याक हुँदैनन्।
<div class="d-grid gap-2 d-md-flex justify-content-md-end">
<button class="btn btn-primary me-md-2" type="button">Button</button>
<button class="btn btn-primary" type="button">Button</button>
</div>
बटन प्लगइन
बटन प्लगइनले तपाईंलाई साधारण अन/अफ टगल बटनहरू सिर्जना गर्न अनुमति दिन्छ।
राज्यहरू टगल गर्नुहोस्
data-bs-toggle="button"
बटनको active
स्थिति टगल गर्न थप्नुहोस् । यदि तपाइँ एक बटन पूर्व-टगल गर्दै हुनुहुन्छ भने, तपाइँले म्यानुअल रूपमा .active
क्लास थप्नु पर्छ र aria-pressed="true"
यो सुनिश्चित गर्न को लागी कि यो सहायक प्रविधिहरु लाई उचित रूप मा पठाइएको छ।
<button type="button" class="btn btn-primary" data-bs-toggle="button">Toggle button</button>
<button type="button" class="btn btn-primary active" data-bs-toggle="button" aria-pressed="true">Active toggle button</button>
<button type="button" class="btn btn-primary" disabled data-bs-toggle="button">Disabled toggle button</button>
<a href="#" class="btn btn-primary" role="button" data-bs-toggle="button">Toggle link</a>
<a href="#" class="btn btn-primary active" role="button" data-bs-toggle="button" aria-pressed="true">Active toggle link</a>
<a class="btn btn-primary disabled" aria-disabled="true" role="button" data-bs-toggle="button">Disabled toggle link</a>
विधिहरू
तपाईले बटन कन्स्ट्रक्टरसँग बटन उदाहरण सिर्जना गर्न सक्नुहुन्छ, उदाहरणका लागि:
const bsButton = new bootstrap.Button('#myButton')
विधि | विवरण |
---|---|
dispose |
तत्वको बटनलाई नष्ट गर्छ। (DOM तत्वमा भण्डारण गरिएको डाटा हटाउँछ) |
getInstance |
स्थिर विधि जसले तपाइँलाई DOM तत्वसँग सम्बन्धित बटन उदाहरण प्राप्त गर्न अनुमति दिन्छ, तपाइँ यसलाई यसरी प्रयोग गर्न सक्नुहुन्छ bootstrap.Button.getInstance(element) :। |
getOrCreateInstance |
स्थिर विधि जसले DOM तत्वसँग सम्बन्धित बटन उदाहरण फिर्ता गर्छ वा यसलाई प्रारम्भ नगरिएको अवस्थामा नयाँ सिर्जना गर्दछ। तपाईं यसलाई निम्न रूपमा प्रयोग गर्न सक्नुहुन्छ bootstrap.Button.getOrCreateInstance(element) :। |
toggle |
टगल पुश स्थिति। बटनलाई सक्रिय गरिएको जस्तो देखिन्छ। |
उदाहरणका लागि, सबै बटनहरू टगल गर्न
document.querySelectorAll('.btn').forEach(buttonElement => {
const button = bootstrap.Button.getOrCreateInstance(buttonElement)
button.toggle()
})
CSS
चरहरू
v5.2.0 मा थपियोबुटस्ट्र्यापको विकसित CSS चर दृष्टिकोणको एक भागको रूपमा, बटनहरूले अब स्थानीय CSS चरहरू .btn
परिवर्धित वास्तविक-समय अनुकूलनको लागि प्रयोग गर्दछ। CSS चरका लागि मानहरू Sass मार्फत सेट गरिएका छन्, त्यसैले Sass अनुकूलन अझै पनि समर्थित छ।
--#{$prefix}btn-padding-x: #{$btn-padding-x};
--#{$prefix}btn-padding-y: #{$btn-padding-y};
--#{$prefix}btn-font-family: #{$btn-font-family};
@include rfs($btn-font-size, --#{$prefix}btn-font-size);
--#{$prefix}btn-font-weight: #{$btn-font-weight};
--#{$prefix}btn-line-height: #{$btn-line-height};
--#{$prefix}btn-color: #{$body-color};
--#{$prefix}btn-bg: transparent;
--#{$prefix}btn-border-width: #{$btn-border-width};
--#{$prefix}btn-border-color: transparent;
--#{$prefix}btn-border-radius: #{$btn-border-radius};
--#{$prefix}btn-hover-border-color: transparent;
--#{$prefix}btn-box-shadow: #{$btn-box-shadow};
--#{$prefix}btn-disabled-opacity: #{$btn-disabled-opacity};
--#{$prefix}btn-focus-box-shadow: 0 0 0 #{$btn-focus-width} rgba(var(--#{$prefix}btn-focus-shadow-rgb), .5);
प्रत्येक परिमार्जक वर्गले हाम्रो , , र मिक्सिनहरूसँग .btn-*
थप CSS नियमहरू न्यूनीकरण गर्न उपयुक्त CSS चरहरू अद्यावधिक गर्दछ ।button-variant()
button-outline-variant()
button-size()
.btn-*
यहाँ हाम्रो आफ्नै CSS र Sass चरहरूको मिश्रणको साथ बुटस्ट्र्यापको CSS चरहरू पुन: असाइन गरेर हाम्रा कागजातहरूमा अद्वितीय बटनहरूको लागि हामीले गर्ने जस्तै अनुकूलन परिमार्जनक वर्ग निर्माण गर्ने एउटा उदाहरण छ ।
.btn-bd-primary {
--bs-btn-font-weight: 600;
--bs-btn-color: var(--bs-white);
--bs-btn-bg: var(--bd-violet);
--bs-btn-border-color: var(--bd-violet);
--bs-btn-border-radius: .5rem;
--bs-btn-hover-color: var(--bs-white);
--bs-btn-hover-bg: #{shade-color($bd-violet, 10%)};
--bs-btn-hover-border-color: #{shade-color($bd-violet, 10%)};
--bs-btn-focus-shadow-rgb: var(--bd-violet-rgb);
--bs-btn-active-color: var(--bs-btn-hover-color);
--bs-btn-active-bg: #{shade-color($bd-violet, 20%)};
--bs-btn-active-border-color: #{shade-color($bd-violet, 20%)};
}
Sass चरहरू
$btn-padding-y: $input-btn-padding-y;
$btn-padding-x: $input-btn-padding-x;
$btn-font-family: $input-btn-font-family;
$btn-font-size: $input-btn-font-size;
$btn-line-height: $input-btn-line-height;
$btn-white-space: null; // Set to `nowrap` to prevent text wrapping
$btn-padding-y-sm: $input-btn-padding-y-sm;
$btn-padding-x-sm: $input-btn-padding-x-sm;
$btn-font-size-sm: $input-btn-font-size-sm;
$btn-padding-y-lg: $input-btn-padding-y-lg;
$btn-padding-x-lg: $input-btn-padding-x-lg;
$btn-font-size-lg: $input-btn-font-size-lg;
$btn-border-width: $input-btn-border-width;
$btn-font-weight: $font-weight-normal;
$btn-box-shadow: inset 0 1px 0 rgba($white, .15), 0 1px 1px rgba($black, .075);
$btn-focus-width: $input-btn-focus-width;
$btn-focus-box-shadow: $input-btn-focus-box-shadow;
$btn-disabled-opacity: .65;
$btn-active-box-shadow: inset 0 3px 5px rgba($black, .125);
$btn-link-color: var(--#{$prefix}link-color);
$btn-link-hover-color: var(--#{$prefix}link-hover-color);
$btn-link-disabled-color: $gray-600;
// Allows for customizing button radius independently from global border radius
$btn-border-radius: $border-radius;
$btn-border-radius-sm: $border-radius-sm;
$btn-border-radius-lg: $border-radius-lg;
$btn-transition: color .15s ease-in-out, background-color .15s ease-in-out, border-color .15s ease-in-out, box-shadow .15s ease-in-out;
$btn-hover-bg-shade-amount: 15%;
$btn-hover-bg-tint-amount: 15%;
$btn-hover-border-shade-amount: 20%;
$btn-hover-border-tint-amount: 10%;
$btn-active-bg-shade-amount: 20%;
$btn-active-bg-tint-amount: 20%;
$btn-active-border-shade-amount: 25%;
$btn-active-border-tint-amount: 10%;
सास मिक्सहरू
बटनहरूका लागि त्यहाँ तीनवटा मिक्सिनहरू छन्: बटन र बटन आउटलाइन भेरियन्ट मिक्सिनहरू (दुवैमा आधारित $theme-colors
), साथै बटन साइज मिक्सिन।
@mixin button-variant(
$background,
$border,
$color: color-contrast($background),
$hover-background: if($color == $color-contrast-light, shade-color($background, $btn-hover-bg-shade-amount), tint-color($background, $btn-hover-bg-tint-amount)),
$hover-border: if($color == $color-contrast-light, shade-color($border, $btn-hover-border-shade-amount), tint-color($border, $btn-hover-border-tint-amount)),
$hover-color: color-contrast($hover-background),
$active-background: if($color == $color-contrast-light, shade-color($background, $btn-active-bg-shade-amount), tint-color($background, $btn-active-bg-tint-amount)),
$active-border: if($color == $color-contrast-light, shade-color($border, $btn-active-border-shade-amount), tint-color($border, $btn-active-border-tint-amount)),
$active-color: color-contrast($active-background),
$disabled-background: $background,
$disabled-border: $border,
$disabled-color: color-contrast($disabled-background)
) {
--#{$prefix}btn-color: #{$color};
--#{$prefix}btn-bg: #{$background};
--#{$prefix}btn-border-color: #{$border};
--#{$prefix}btn-hover-color: #{$hover-color};
--#{$prefix}btn-hover-bg: #{$hover-background};
--#{$prefix}btn-hover-border-color: #{$hover-border};
--#{$prefix}btn-focus-shadow-rgb: #{to-rgb(mix($color, $border, 15%))};
--#{$prefix}btn-active-color: #{$active-color};
--#{$prefix}btn-active-bg: #{$active-background};
--#{$prefix}btn-active-border-color: #{$active-border};
--#{$prefix}btn-active-shadow: #{$btn-active-box-shadow};
--#{$prefix}btn-disabled-color: #{$disabled-color};
--#{$prefix}btn-disabled-bg: #{$disabled-background};
--#{$prefix}btn-disabled-border-color: #{$disabled-border};
}
@mixin button-outline-variant(
$color,
$color-hover: color-contrast($color),
$active-background: $color,
$active-border: $color,
$active-color: color-contrast($active-background)
) {
--#{$prefix}btn-color: #{$color};
--#{$prefix}btn-border-color: #{$color};
--#{$prefix}btn-hover-color: #{$color-hover};
--#{$prefix}btn-hover-bg: #{$active-background};
--#{$prefix}btn-hover-border-color: #{$active-border};
--#{$prefix}btn-focus-shadow-rgb: #{to-rgb($color)};
--#{$prefix}btn-active-color: #{$active-color};
--#{$prefix}btn-active-bg: #{$active-background};
--#{$prefix}btn-active-border-color: #{$active-border};
--#{$prefix}btn-active-shadow: #{$btn-active-box-shadow};
--#{$prefix}btn-disabled-color: #{$color};
--#{$prefix}btn-disabled-bg: transparent;
--#{$prefix}btn-disabled-border-color: #{$color};
--#{$prefix}gradient: none;
}
@mixin button-size($padding-y, $padding-x, $font-size, $border-radius) {
--#{$prefix}btn-padding-y: #{$padding-y};
--#{$prefix}btn-padding-x: #{$padding-x};
@include rfs($font-size, --#{$prefix}btn-font-size);
--#{$prefix}btn-border-radius: #{$border-radius};
}
Sass loops
$theme-colors
बटन भेरियन्टहरू (नियमित र रूपरेखा बटनहरूको लागि) मा परिमार्जक वर्गहरू उत्पन्न गर्न हाम्रो नक्सासँग सम्बन्धित मिक्सिनहरू प्रयोग गर्छन् scss/_buttons.scss
।
@each $color, $value in $theme-colors {
.btn-#{$color} {
@if $color == "light" {
@include button-variant(
$value,
$value,
$hover-background: shade-color($value, $btn-hover-bg-shade-amount),
$hover-border: shade-color($value, $btn-hover-border-shade-amount),
$active-background: shade-color($value, $btn-active-bg-shade-amount),
$active-border: shade-color($value, $btn-active-border-shade-amount)
);
} @else if $color == "dark" {
@include button-variant(
$value,
$value,
$hover-background: tint-color($value, $btn-hover-bg-tint-amount),
$hover-border: tint-color($value, $btn-hover-border-tint-amount),
$active-background: tint-color($value, $btn-active-bg-tint-amount),
$active-border: tint-color($value, $btn-active-border-tint-amount)
);
} @else {
@include button-variant($value, $value);
}
}
}
@each $color, $value in $theme-colors {
.btn-outline-#{$color} {
@include button-outline-variant($value);
}
}