Hälytykset
Tarjoa asiayhteyteen liittyviä palauteviestejä tyypillisistä käyttäjän toimista kourallisen saatavilla olevien ja joustavien hälytysviestien avulla.
Esimerkkejä
Hälytykset ovat saatavilla minkä tahansa pituisesta tekstistä sekä valinnainen hylkäyspainike. Oikean tyylin saamiseksi käytä yhtä kahdeksasta vaaditusta kontekstuaalisesta luokasta (esim. .alert-success
). Käytä inline-hylkäämiseen Alerts jQuery -laajennusta .
<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>
Tarkoituksen välittäminen avustaville tekniikoille
Värien käyttö merkityksen lisäämiseen antaa vain visuaalisen osoituksen, jota ei välitetä avustavien tekniikoiden, kuten näytönlukijoiden, käyttäjille. Varmista, että värillä merkitty tieto näkyy joko itsestään sisällöstä (esim. näkyvä teksti) tai sisällytetään vaihtoehtoisin keinoin, kuten .sr-only
luokan mukana piilotettu lisäteksti.
Linkin väri
Käytä .alert-link
hyödyllisyysluokkaa tarjotaksesi nopeasti vastaavia värillisiä linkkejä mihin tahansa hälytykseen.
<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>
Lisäsisältö
Hälytykset voivat sisältää myös muita HTML-elementtejä, kuten otsikoita, kappaleita ja jakajia.
Hyvin tehty!
Aww joo, luit onnistuneesti tämän tärkeän hälytysviestin. Tämä esimerkkiteksti kestää hieman pidempään, jotta näet, kuinka hälytyksen välilyönti toimii tämäntyyppisen sisällön kanssa.
Aina kun tarvitset, muista käyttää marginaaliapuohjelmia pitääksesi asiat kauniina ja siistinä.
<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>
Hylkääminen
Alert JavaScript -laajennuksella on mahdollista hylätä kaikki ilmoitukset. Näin:
- Varmista, että olet ladannut hälytyslaajennuksen tai käännetyn Bootstrap JavaScriptin.
- Jos rakennat JavaScript-koodiamme lähteestä, se vaatii
util.js
. Käytetty versio sisältää tämän. - Lisää hylkäyspainike ja
.alert-dismissible
luokka, joka lisää ylimääräistä täyttöä hälytyksen oikealle puolelle ja sijoittaa.close
painikkeen. - Lisää hylkäämispainikkeeseen
data-dismiss="alert"
attribuutti, joka käynnistää JavaScript-toiminnon. Muista käyttää<button>
elementtiä sen kanssa, jotta se toimii oikein kaikissa laitteissa. - Jos haluat animoida hälytyksiä, kun hylkäät ne, muista lisätä
.fade
ja.show
luokat.
Voit nähdä tämän toiminnassa live-demon avulla:
<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="close" data-dismiss="alert" aria-label="Close">
<span aria-hidden="true">×</span>
</button>
</div>
JavaScript-käyttäytyminen
Liipaisimet
Ota hälytyksen hylkääminen käyttöön JavaScriptin kautta:
$('.alert').alert()
Tai attribuutit ilmoituksendata
painikkeessa , kuten yllä on osoitettu:
<button type="button" class="close" data-dismiss="alert" aria-label="Close">
<span aria-hidden="true">×</span>
</button>
Huomaa, että hälytyksen sulkeminen poistaa sen DOM:sta.
menetelmät
Menetelmä | Kuvaus |
---|---|
$().alert() |
Saa hälytyksen kuuntelemaan napsautustapahtumia jälkeläisissä elementeissä, joilla on data-dismiss="alert" attribuutti. (Ei välttämätöntä data-api:n automaattista alustusta käytettäessä.) |
$().alert('close') |
Sulkee hälytyksen poistamalla sen DOM:sta. Jos elementissä on luokat .fade ja .show , hälytys häviää ennen kuin se poistetaan. |
$().alert('dispose') |
Tuhoaa elementin hälytyksen. |
$('.alert').alert('close')
Tapahtumat
Bootstrapin hälytyslaajennus paljastaa muutamia tapahtumia, jotka liittyvät hälytystoimintoihin.
Tapahtuma | Kuvaus |
---|---|
close.bs.alert |
Tämä tapahtuma käynnistyy välittömästi, kun close instanssimenetelmää kutsutaan. |
closed.bs.alert |
Tämä tapahtuma käynnistyy, kun hälytys on suljettu (odottaa CSS-siirtymien valmistumista). |
$('#myAlert').on('closed.bs.alert', function () {
// do something...
})