Svetuka kune chikuru content Svetuka kuenda kudocs navigation
Check
in English

Alerts

Ipa mamiriro emhinduro mameseji ezviitwa zvemushandisi ane mashoma anowanikwa uye anochinjika echenjedzo meseji.

Pa peji ino

Mienzaniso

Zviziviso zviripo kune chero hurefu hwemavara, pamwe nesarudzo yekuvhara bhatani. Kuti uite manyorerwo akakodzera, shandisa imwe yemakirasi masere anodiwa.alert-success emamiriro ezvinhu (semuenzaniso, ). Pakudzinga mukati, shandisa chenjedzo JavaScript plugin .

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>
Kuendesa zvinoreva kunobatsira matekinoroji

Kushandisa ruvara kuwedzera zvinoreva kunongopa chiratidzo chekuona, icho chisingazopirwe kune vashandisi vetekinoroji yekubatsira - senge zvidzitiro zvekuverenga. Ita shuwa kuti ruzivo rwunoratidzwa neruvara rwuri pachena kubva pane zvirimo (semuzvinyorwa zvinooneka), kana kuti zvinosanganisirwa neimwe nzira, senge mamwe mavara akavigwa .visually-hiddennekirasi.

Rarama muenzaniso

Dzvanya bhatani riri pazasi kuratidza yambiro (yakavanzika ine inline masitaera ekutanga), wobva warasa (uye paradza) nebhatani rekuvhara rakavakwa.

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

Isu tinoshandisa inotevera JavaScript kukonzeresa yedu yehupenyu yambiro demo:

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')
  })
}

Shandisa .alert-linkutility kirasi kukurumidza kupa anoenderana mavara ekubatanidza mukati meyambiro ipi neipi.

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>

Zvimwe zvemukati

Yambiro inogona zvakare kuve nekuwedzera HTML zvinhu senge misoro, ndima uye divider.

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>

Icons

Saizvozvo, unogona kushandisa flexbox utilities uye Bootstrap Icons kugadzira yambiro ine zvidhori. Zvichienderana nemifananidzo yako uye zvirimo, ungangoda kuwedzera zvimwe zvinoshandiswa kana masitaera etsika.

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>

Unoda inopfuura chiratidzo chimwe chezviziviso zvako? Funga kushandisa mamwe maBootstrap Icons uye kugadzira yemuno SVG sprite sekudaro kuti utarise zvidhori zvakafanana kakawanda.

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>

Kudzinga

Uchishandisa yambiro yeJavaScript plugin, zvinokwanisika kudzinga chero yambiro inline. Heino maitiro:

  • Ita shuwa kuti waisa yambiro plugin, kana yakaunganidzwa Bootstrap JavaScript.
  • Wedzera bhatani rekuvhara uye .alert-dismissiblekirasi, iyo inowedzera imwe padding kurudyi rweyambiro uye inoisa bhatani rekuvhara.
  • Pabhatani rekuvhara, wedzera data-bs-dismiss="alert"hunhu, izvo zvinokonzeresa kushanda kweJavaScript. Iva nechokwadi chekushandisa <button>chinhu nacho kuita zvakanaka pamidziyo yese.
  • Kuti upe chenjedzo paunenge uchivadzinga, ita chokwadi chekuwedzera .fadeuye .showmakirasi.

Iwe unogona kuona izvi muchiito neiyo live demo:

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>
Kana yambiro ikaraswa, chinhu chinobviswa zvachose kubva pachimiro chepeji. Kana mushandisi wekhibhodi akarasa yambiro achishandisa bhatani rekuvhara, kutarisa kwavo kunobva kwarasika uye, zvichienderana nebrowser, gadzirisa zvakare pakutanga kwepeji / gwaro. Nechikonzero ichi, isu tinokurudzira kusanganisa yekuwedzera JavaScript inoteerera closed.bs.alertchiitiko uye nehurongwa inoseta focus()kunzvimbo yakakodzera kwazvo pane peji. Kana uri kuronga kufambisa kutarisa kune isiri-interactive element iyo isingagamuchire tarisiro, ita shuwa yekuwedzera tabindex="-1"kune iyo element.

CSS

Variables

Yakawedzerwa mu v5.2.0

Sechikamu cheBootstrap's evolving CSS variables approach, chenjedzo ikozvino dzinoshandisa emunharaunda CSS madhizaini .alertpakusimudzira chaiyo-nguva yekugadziriswa. Hwaro hwemhando dzeCSS dzakaiswa kuburikidza neSass, saka Sass customization ichiri kutsigirwa, zvakare.

  --#{$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 zvakasiyana

$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

Sass kusanganisa

Inoshandiswa pamwe chete $theme-colorsnekugadzira mamiriro ekugadzirisa makirasi ezviziviso zvedu.

@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%);
  }
}

Sass loop

Loop iyo inogadzira iyo modifier makirasi ane alert-variant()mixin.

// 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 maitiro

Tanga

Tanga zvinhu sezviyeuchidzo

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

Nechinangwa chega chekudzinga yambiro, hazvidi kuti utange chikamu nemaoko kuburikidza neJS API. Nekushandisa data-bs-dismiss="alert", chikamu chinozotangwa otomatiki uye nekudzingwa zvakanaka.

Ona chikamu chezvinokonzeresa kuti uwane rumwe ruzivo.

Zvikonzero

Kudzingwa kunogona kuwanikwa datanehunhu huri pabhatani mukati meyambiro sezvakaratidzwa pazasi:

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

kana pabhatani riri kunze kwechenjedzo uchishandisa data-bs-targetsezvaratidzwa pazasi:

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

Ziva kuti kuvhara yambiro kuchaibvisa kubva kuDOM.

Nzira

Iwe unogona kugadzira yambiro chiitiko nemugadziri wekuzivisa, semuenzaniso:

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

Izvi zvinoita kuti chenjedzo iteerere kune zviitiko zvekudzvanya pane zvinodzika zvinhu zvine data-bs-dismiss="alert"hunhu. (Hazvina basa kana uchishandisa iyo data-api's auto-initialization.)

Nzira Tsanangudzo
close Inovhara yambiro nekuibvisa muDOM. Kana iyo .fadeuye .showmakirasi aripo pane chinhu, yambiro inopera isati yabviswa.
dispose Inoparadza chenjedzo yechinhu. (Inobvisa data rakachengetwa pachinhu cheDOM)
getInstance Static method which allows you to get the alert instance associated to a DOM element. For example: bootstrap.Alert.getInstance(alert).
getOrCreateInstance Static method which returns an alert instance associated to a DOM element or create a new one in case it wasn’t initialized. You can use it like this: bootstrap.Alert.getOrCreateInstance(element).

Basic usage:

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

Events

Bootstrap’s alert plugin exposes a few events for hooking into alert functionality.

Event Description
close.bs.alert Fires immediately when the close instance method is called.
closed.bs.alert Fired when the alert has been closed and CSS transitions have completed. 
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()
})