મુખ્ય સામગ્રી પર જાઓ ડૉક્સ નેવિગેશન પર જાઓ
Check
in English

ચેતવણીઓ

મુઠ્ઠીભર ઉપલબ્ધ અને લવચીક ચેતવણી સંદેશાઓ સાથે લાક્ષણિક વપરાશકર્તા ક્રિયાઓ માટે સંદર્ભિત પ્રતિસાદ સંદેશાઓ પ્રદાન કરો.

ઉદાહરણો

કોઈપણ લંબાઈના ટેક્સ્ટ તેમજ વૈકલ્પિક બંધ બટન માટે ચેતવણીઓ ઉપલબ્ધ છે. યોગ્ય સ્ટાઇલ માટે, આઠ જરૂરી સંદર્ભ વર્ગોમાંથી એકનો ઉપયોગ કરો (દા.ત., .alert-success). ઇનલાઇન બરતરફી માટે, ચેતવણીઓ JavaScript પ્લગઇનનો ઉપયોગ કરો .

html
<div class="alert alert-primary" role="alert">
  A simple primary alert—check it out!
</div>
<div class="alert alert-secondary" role="alert">
  A simple secondary alert—check it out!
</div>
<div class="alert alert-success" role="alert">
  A simple success alert—check it out!
</div>
<div class="alert alert-danger" role="alert">
  A simple danger alert—check it out!
</div>
<div class="alert alert-warning" role="alert">
  A simple warning alert—check it out!
</div>
<div class="alert alert-info" role="alert">
  A simple info alert—check it out!
</div>
<div class="alert alert-light" role="alert">
  A simple light alert—check it out!
</div>
<div class="alert alert-dark" role="alert">
  A simple dark alert—check it out!
</div>
સહાયક તકનીકોનો અર્થ પહોંચાડવો

અર્થ ઉમેરવા માટે રંગનો ઉપયોગ કરવાથી માત્ર એક વિઝ્યુઅલ સંકેત મળે છે, જે સહાયક ટેક્નોલોજીના વપરાશકર્તાઓ સુધી પહોંચાડવામાં આવશે નહીં - જેમ કે સ્ક્રીન રીડર્સ. ખાતરી કરો કે રંગ દ્વારા સૂચવવામાં આવેલી માહિતી કાં તો સામગ્રીમાંથી જ સ્પષ્ટ છે (દા.ત. દૃશ્યમાન ટેક્સ્ટ), અથવા વૈકલ્પિક માધ્યમો દ્વારા શામેલ છે, જેમ કે .visually-hiddenવર્ગ સાથે છુપાયેલ વધારાની ટેક્સ્ટ.

જીવંત ઉદાહરણ

ચેતવણી બતાવવા માટે નીચેના બટન પર ક્લિક કરો (પ્રારંભ કરવા માટે ઇનલાઇન શૈલીઓ સાથે છુપાયેલ), પછી બિલ્ટ-ઇન બંધ બટન વડે તેને કાઢી નાખો (અને નાશ કરો).

html
<div id="liveAlertPlaceholder"></div>
<button type="button" class="btn btn-primary" id="liveAlertBtn">Show live alert</button>

અમે અમારા લાઇવ એલર્ટ ડેમોને ટ્રિગર કરવા માટે નીચેની JavaScript નો ઉપયોગ કરીએ છીએ:

const alertPlaceholder = document.getElementById('liveAlertPlaceholder')

const alert = (message, type) => {
  const wrapper = document.createElement('div')
  wrapper.innerHTML = [
    `<div class="alert alert-${type} alert-dismissible" role="alert">`,
    `   <div>${message}</div>`,
    '   <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>',
    '</div>'
  ].join('')

  alertPlaceholder.append(wrapper)
}

const alertTrigger = document.getElementById('liveAlertBtn')
if (alertTrigger) {
  alertTrigger.addEventListener('click', () => {
    alert('Nice, you triggered this alert message!', 'success')
  })
}

.alert-linkકોઈપણ ચેતવણીમાં ઝડપથી મેળ ખાતી રંગીન લિંક્સ પ્રદાન કરવા માટે ઉપયોગિતા વર્ગનો ઉપયોગ કરો .

html
<div class="alert alert-primary" role="alert">
  A simple primary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-secondary" role="alert">
  A simple secondary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-success" role="alert">
  A simple success alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-danger" role="alert">
  A simple danger alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-warning" role="alert">
  A simple warning alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-info" role="alert">
  A simple info alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-light" role="alert">
  A simple light alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-dark" role="alert">
  A simple dark alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>

વધારાની સામગ્રી

ચેતવણીઓમાં હેડિંગ, ફકરા અને વિભાજકો જેવા વધારાના HTML ઘટકો પણ હોઈ શકે છે.

html
<div class="alert alert-success" role="alert">
  <h4 class="alert-heading">Well done!</h4>
  <p>Aww yeah, you successfully read this important alert message. This example text is going to run a bit longer so that you can see how spacing within an alert works with this kind of content.</p>
  <hr>
  <p class="mb-0">Whenever you need to, be sure to use margin utilities to keep things nice and tidy.</p>
</div>

ચિહ્નો

એ જ રીતે, તમે ચિહ્નો સાથે ચેતવણીઓ બનાવવા માટે ફ્લેક્સબોક્સ ઉપયોગિતાઓ અને બુટસ્ટ્રેપ ચિહ્નોનો ઉપયોગ કરી શકો છો. તમારા ચિહ્નો અને સામગ્રીના આધારે, તમે વધુ ઉપયોગિતાઓ અથવા કસ્ટમ શૈલીઓ ઉમેરવા માગી શકો છો.

html
<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg xmlns="http://www.w3.org/2000/svg" class="bi bi-exclamation-triangle-fill flex-shrink-0 me-2" viewBox="0 0 16 16" role="img" aria-label="Warning:">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </svg>
  <div>
    An example alert with an icon
  </div>
</div>

તમારી ચેતવણીઓ માટે એક કરતાં વધુ આયકનની જરૂર છે? વધુ બુટસ્ટ્રેપ ચિહ્નોનો ઉપયોગ કરવાનું અને સ્થાનિક SVG સ્પ્રાઈટ બનાવવાનો વિચાર કરો જેથી કરીને સમાન ચિહ્નોને વારંવાર સંદર્ભિત કરી શકાય.

html
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
  <symbol id="check-circle-fill" viewBox="0 0 16 16">
    <path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0zm-3.97-3.03a.75.75 0 0 0-1.08.022L7.477 9.417 5.384 7.323a.75.75 0 0 0-1.06 1.06L6.97 11.03a.75.75 0 0 0 1.079-.02l3.992-4.99a.75.75 0 0 0-.01-1.05z"/>
  </symbol>
  <symbol id="info-fill" viewBox="0 0 16 16">
    <path d="M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16zm.93-9.412-1 4.705c-.07.34.029.533.304.533.194 0 .487-.07.686-.246l-.088.416c-.287.346-.92.598-1.465.598-.703 0-1.002-.422-.808-1.319l.738-3.468c.064-.293.006-.399-.287-.47l-.451-.081.082-.381 2.29-.287zM8 5.5a1 1 0 1 1 0-2 1 1 0 0 1 0 2z"/>
  </symbol>
  <symbol id="exclamation-triangle-fill" viewBox="0 0 16 16">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </symbol>
</svg>

<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Info:"><use xlink:href="#info-fill"/></svg>
  <div>
    An example alert with an icon
  </div>
</div>
<div class="alert alert-success d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Success:"><use xlink:href="#check-circle-fill"/></svg>
  <div>
    An example success alert with an icon
  </div>
</div>
<div class="alert alert-warning d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Warning:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    An example warning alert with an icon
  </div>
</div>
<div class="alert alert-danger d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Danger:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    An example danger alert with an icon
  </div>
</div>

બરતરફ

ચેતવણી JavaScript પ્લગઇનનો ઉપયોગ કરીને, કોઈપણ ચેતવણી ઇનલાઇનને કાઢી નાખવાનું શક્ય છે. અહીં કેવી રીતે છે:

  • ખાતરી કરો કે તમે ચેતવણી પ્લગઇન અથવા સંકલિત બુટસ્ટ્રેપ JavaScript લોડ કર્યું છે.
  • ક્લોઝ બટન અને ક્લાસ ઉમેરો .alert-dismissible, જે ચેતવણીની જમણી બાજુએ વધારાનું પેડિંગ ઉમેરે છે અને ક્લોઝ બટનને સ્થાન આપે છે.
  • બંધ બટન પર, data-bs-dismiss="alert"વિશેષતા ઉમેરો, જે JavaScript કાર્યક્ષમતાને ટ્રિગર કરે છે. <button>બધા ઉપકરણો પર યોગ્ય વર્તન માટે તેની સાથે તત્વનો ઉપયોગ કરવાની ખાતરી કરો .
  • .fadeચેતવણીઓને બરતરફ કરતી વખતે એનિમેટ કરવા માટે, અને .showવર્ગો ઉમેરવાની ખાતરી કરો .

તમે આને લાઇવ ડેમો સાથે ક્રિયામાં જોઈ શકો છો:

html
<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <strong>Holy guacamole!</strong> You should check in on some of those fields below.
  <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
</div>
જ્યારે ચેતવણી કાઢી નાખવામાં આવે છે, ત્યારે તત્વ પૃષ્ઠના બંધારણમાંથી સંપૂર્ણપણે દૂર થઈ જાય છે. જો કીબોર્ડ વપરાશકર્તા ક્લોઝ બટનનો ઉપયોગ કરીને ચેતવણીને કાઢી નાખે છે, તો તેમનું ધ્યાન અચાનક જ ખોવાઈ જશે અને, બ્રાઉઝરના આધારે, પૃષ્ઠ/દસ્તાવેજની શરૂઆતમાં રીસેટ થઈ જશે. આ કારણોસર, અમે વધારાની JavaScript શામેલ કરવાની ભલામણ કરીએ છીએ જે closed.bs.alertઇવેન્ટ માટે સાંભળે છે અને પ્રોગ્રામેટિકલી focus()પૃષ્ઠમાં સૌથી યોગ્ય સ્થાન પર સેટ કરે છે. જો તમે ફોકસને બિન-ઇન્ટરેક્ટિવ તત્વ પર ખસેડવાનું આયોજન કરી રહ્યાં છો જે સામાન્ય રીતે ફોકસ પ્રાપ્ત કરતું નથી, તો ઘટકમાં ઉમેરવાની ખાતરી કરો tabindex="-1".

CSS

ચલો

v5.2.0 માં ઉમેરાયેલ

બુટસ્ટ્રેપના વિકસતા CSS ચલો અભિગમના ભાગરૂપે, ચેતવણીઓ હવે .alertઉન્નત રીઅલ-ટાઇમ કસ્ટમાઇઝેશન માટે સ્થાનિક CSS ચલોનો ઉપયોગ કરે છે. CSS ચલો માટેના મૂલ્યો Sass દ્વારા સેટ કરવામાં આવ્યા છે, તેથી Sass કસ્ટમાઇઝેશન હજુ પણ સપોર્ટેડ છે.

  --#{$prefix}alert-bg: transparent;
  --#{$prefix}alert-padding-x: #{$alert-padding-x};
  --#{$prefix}alert-padding-y: #{$alert-padding-y};
  --#{$prefix}alert-margin-bottom: #{$alert-margin-bottom};
  --#{$prefix}alert-color: inherit;
  --#{$prefix}alert-border-color: transparent;
  --#{$prefix}alert-border: #{$alert-border-width} solid var(--#{$prefix}alert-border-color);
  --#{$prefix}alert-border-radius: #{$alert-border-radius};
  

Sass ચલો

$alert-padding-y:               $spacer;
$alert-padding-x:               $spacer;
$alert-margin-bottom:           1rem;
$alert-border-radius:           $border-radius;
$alert-link-font-weight:        $font-weight-bold;
$alert-border-width:            $border-width;
$alert-bg-scale:                -80%;
$alert-border-scale:            -70%;
$alert-color-scale:             40%;
$alert-dismissible-padding-r:   $alert-padding-x * 3; // 3x covers width of x plus default padding on either side

સાસ મિક્સિન

$theme-colorsઅમારી ચેતવણીઓ માટે સંદર્ભ સંશોધક વર્ગો બનાવવા માટે સાથે સંયોજનમાં વપરાય છે .

@mixin alert-variant($background, $border, $color) {
  --#{$prefix}alert-color: #{$color};
  --#{$prefix}alert-bg: #{$background};
  --#{$prefix}alert-border-color: #{$border};

  @if $enable-gradients {
    background-image: var(--#{$prefix}gradient);
  }

  .alert-link {
    color: shade-color($color, 20%);
  }
}

સાસ લૂપ

લૂપ જે alert-variant()મિક્સિન વડે મોડિફાયર ક્લાસ જનરેટ કરે છે.

// Generate contextual modifier classes for colorizing the alert.

@each $state, $value in $theme-colors {
  $alert-background: shift-color($value, $alert-bg-scale);
  $alert-border: shift-color($value, $alert-border-scale);
  $alert-color: shift-color($value, $alert-color-scale);

  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {
    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));
  }
  .alert-#{$state} {
    @include alert-variant($alert-background, $alert-border, $alert-color);
  }
}

JavaScript વર્તન

પ્રારંભ કરો

ચેતવણીઓ તરીકે તત્વોને પ્રારંભ કરો

const alertList = document.querySelectorAll('.alert')
const alerts = [...alertList].map(element => new bootstrap.Alert(element))

ચેતવણીને બરતરફ કરવાના એકમાત્ર હેતુ માટે, JS API દ્વારા મેન્યુઅલી ઘટકને પ્રારંભ કરવું જરૂરી નથી. નો ઉપયોગ કરીને data-bs-dismiss="alert", ઘટક આપમેળે શરૂ થશે અને યોગ્ય રીતે બરતરફ થશે.

વધુ વિગતો માટે ટ્રિગર્સ વિભાગ જુઓ .

ટ્રિગર્સ

બરતરફી નીચે દર્શાવ્યા મુજબ ચેતવણીની અંદરનાdata બટન પરની વિશેષતા સાથે પ્રાપ્ત કરી શકાય છે:

<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>

અથવા ચેતવણીની બહારનાdata-bs-target બટન પર નીચે દર્શાવ્યા મુજબનો ઉપયોગ કરીને :

<button type="button" class="btn-close" data-bs-dismiss="alert" data-bs-target="#my-alert" aria-label="Close"></button>

નોંધ કરો કે ચેતવણી બંધ કરવાથી તે DOM માંથી દૂર થઈ જશે.

પદ્ધતિઓ

તમે ચેતવણી કન્સ્ટ્રક્ટર સાથે ચેતવણી ઉદાહરણ બનાવી શકો છો, ઉદાહરણ તરીકે:

const bsAlert = new bootstrap.Alert('#myAlert')

આ વંશજ તત્વો પર ક્લિક ઇવેન્ટ્સ માટે ચેતવણી સાંભળે છે જેમાં data-bs-dismiss="alert"વિશેષતા હોય છે. (ડેટા-એપીઆઈના સ્વતઃ-પ્રારંભનો ઉપયોગ કરતી વખતે જરૂરી નથી.)

પદ્ધતિ વર્ણન
close ચેતવણીને DOM માંથી દૂર કરીને બંધ કરે છે. જો .fadeઅને .showવર્ગો તત્વ પર હાજર હોય, તો તેને દૂર કરવામાં આવે તે પહેલાં ચેતવણી ઝાંખા થઈ જશે.
dispose તત્વની ચેતવણીનો નાશ કરે છે. (DOM તત્વ પર સંગ્રહિત ડેટાને દૂર કરે છે)
getInstance સ્ટેટિક મેથડ જે તમને DOM એલિમેન્ટ સાથે સંકળાયેલ એલર્ટ ઇન્સ્ટન્સ મેળવવા માટે પરવાનગી આપે છે. ઉદાહરણ તરીકે: bootstrap.Alert.getInstance(alert).
getOrCreateInstance સ્થિર પદ્ધતિ કે જે DOM ઘટક સાથે સંકળાયેલ ચેતવણીનો દાખલો આપે છે અથવા જો તે પ્રારંભ ન થયો હોય તો એક નવો બનાવો. તમે તેનો આ રીતે ઉપયોગ કરી શકો છો: bootstrap.Alert.getOrCreateInstance(element).

મૂળભૂત ઉપયોગ:

const alert = bootstrap.Alert.getOrCreateInstance('#myAlert')
alert.close()

ઘટનાઓ

બુટસ્ટ્રેપનું ચેતવણી પ્લગઇન ચેતવણી કાર્યક્ષમતામાં હૂક કરવા માટે કેટલીક ઘટનાઓને ઉજાગર કરે છે.

ઘટના વર્ણન
close.bs.alert closeજ્યારે ઇન્સ્ટન્સ પદ્ધતિને બોલાવવામાં આવે ત્યારે તરત જ આગ થાય છે.
closed.bs.alert જ્યારે ચેતવણી બંધ થઈ ગઈ હોય અને CSS સંક્રમણો પૂર્ણ થઈ જાય ત્યારે ફાયર કરવામાં આવે છે.
const myAlert = document.getElementById('myAlert')
myAlert.addEventListener('closed.bs.alert', event => {
  // do something, for instance, explicitly move focus to the most appropriate element,
  // so it doesn't get lost/reset to the start of the page
  // document.getElementById('...').focus()
})