Tósta
Brúigh fógraí chuig do chuairteoirí le tósta, teachtaireacht rabhaidh éadrom agus inoiriúnaithe go héasca.
Is fógraí éadroma iad tósta atá deartha chun aithris a dhéanamh ar bhrúfhógraí a bhfuil tóir ag córais oibriúcháin soghluaiste agus deisce orthu. Tá siad tógtha le flexbox, mar sin tá siad éasca a ailíniú agus a shuíomh.
Forbhreathnú
Rudaí le fios agus an breiseán tósta in úsáid:
- Má tá ár JavaScript á thógáil agat ón bhfoinse, teastaíonn
util.js
. - Tá rogha an diúltaithe ag tósta ar chúiseanna feidhmíochta, mar sin ní mór duit iad a thosú tú féin .
- Beidh tósta i bhfolach go huathoibríoch mura sonraíonn tú
autohide: false
.
Samplaí
Bunúsach
Chun tóstaí sínte agus intuartha a spreagadh, molaimid ceanntásc agus corp. Úsáideann ceanntásca tósta display: flex
, a cheadaíonn ailíniú éasca an ábhair a bhuíochas lenár bhfóntais corrlaigh agus flexbox.
Bíonn tósta chomh solúbtha agus is gá duit agus is beag an marcáil riachtanach a bhíonn acu. Ar a laghad, teastaíonn gné amháin uainn chun d’ábhar “tósta” a chuimsiú agus molaimid go láidir cnaipe a dhíbhe.
Tréshoilseach
Bíonn tósta beagáinín tréshoilseach freisin, agus mar sin meascann siad cibé rud a d’fhéadfadh a bheith os a chionn. Maidir le brabhsálaithe a thacaíonn le backdrop-filter
hairíonna CSS, déanfaimid iarracht freisin na heilimintí a dhoiléiriú faoi thósta.
Cruachta
Nuair a bhíonn go leor toasts agat, ní mór dúinn iad a chruachadh go hingearach ar bhealach inléite.
Socrúchán
Cuir tósta le CSS saincheaptha de réir mar is gá duit. Is minic a úsáidtear an barr ar dheis le haghaidh fógraí, mar atá sa lár uachtarach. Mura bhfuil tú chun ach tósta amháin a thaispeáint ag an am, cuir na stíleanna suite ar dheis ar an .toast
.
Maidir le córais a ghineann níos mó fógraí, smaoinigh ar eilimint timfhilleadh a úsáid ionas gur féidir iad a chruachadh go héasca.
Is féidir leat a bheith mhaisiúil freisin le fóntais flexbox chun tósta a ailíniú go cothrománach agus/nó go hingearach.
Inrochtaineacht
Is éard atá i gceist le tósta ná cur isteach beag ar do chuairteoirí nó d’úsáideoirí, mar sin chun cabhrú leo siúd a bhfuil léitheoirí scáileáin agus teicneolaíochtaí cúnta comhchosúla acu, ba chóir duit do thóstaí a chuimilt i aria-live
réigiún . Fógraíonn léitheoirí scáileáin go huathoibríoch athruithe ar réigiúin bheo (amhail comhpháirt tósta a instealladh/nuashonrú) gan gá le fócas an úsáideora a bhogadh nó gan cur isteach ar an úsáideoir ar bhealach eile. Ina theannta sin, aria-atomic="true"
cinntigh go bhfógrófar an tósta ar fad i gcónaí mar aonad amháin (adamhach), seachas an méid a athraíodh a fhógairt (a d’fhéadfadh fadhbanna a bheith ann mura nuashonraíonn tú ach cuid d’ábhar an tósta, nó má tá an t-ábhar tósta céanna á thaispeáint ag pointe ama níos déanaí). Má tá an fhaisnéis atá ag teastáil tábhachtach don phróiseas, m.sh. le haghaidh liosta earráidí i bhfoirm, bain úsáid as an gcomhpháirt foláirimhin ionad tósta.
Tabhair faoi deara go gcaithfidh an réigiún beo a bheith i láthair sa mharcáil sula ndéantar an tósta a ghiniúint nó a nuashonrú. Má ghineann tú an dá cheann go dinimiciúil ag an am céanna agus má instealladh isteach sa leathanach iad, de ghnáth ní dhéanfaidh teicneolaíochtaí cúnta iad a fhógairt.
Ní mór duit freisin a oiriúnú role
agus aria-live
leibhéal ag brath ar an ábhar. Más teachtaireacht thábhachtach é mar earráid, úsáid role="alert" aria-live="assertive"
, nó bain úsáid as role="status" aria-live="polite"
tréithe.
De réir mar a athraíonn an t-ábhar atá á thaispeáint agat, déan cinnte an t-am istigh a nuashonrú chun a chinntiú go mbíonn go leor delay
ama ag daoine an tósta a léamh.
Agus tú ag úsáid autohide: false
, ní mór duit cnaipe gar a chur leis chun ligean d'úsáideoirí an tósta a dhíbhe.
Iompar javascript
Úsáid
Cuir tús le tósta trí JavaScript:
Roghanna
Is féidir roghanna a chur ar aghaidh trí tréithe sonraí nó JavaScript. Maidir le tréithe sonraí, cuir ainm na rogha i gceangal le data-
, mar atá i data-animation=""
.
Ainm | Cineál | Réamhshocrú | Cur síos |
---|---|---|---|
beochan | Boole | fíor | Cuir trasdul céimnithe CSS i bhfeidhm ar an tósta |
uathfholú | Boole | fíor | Auto cheilt ar an tósta |
moill | uimhir | 500 |
Moill ar an tósta a chur i bhfolach (ms) |
Modhanna
Modhanna agus aistrithe asincrónacha
Tá gach modh API asincrónach agus cuireann siad tús le haistriú . Filleann siad ar an nglaoiteoir a luaithe a chuirtear tús leis an aistriú ach sula gcríochnaíonn sé . Ina theannta sin, ní thabharfar aird ar ghlao modha ar chomhpháirt trasdula .
Féach ar ár gcáipéisíocht JavaScript le haghaidh tuilleadh eolais .
$().toast(options)
Ceanglaítear láimhseálaí tósta le bailiúchán eilimintí.
.toast('show')
Nochtann tósta eilimint. Filleann sé ar an té atá ag glaoch sula dtaispeántar an tósta (ie sula shown.bs.toast
dtarlaíonn an teagmhas). Caithfidh tú an modh seo a ghlaoch de láimh, ina ionad sin ní thaispeánfar do thósta.
.toast('hide')
Folaigh tósta eiliminte. Filleann sé ar an té atá ag glaoch sula gcuirtear an tósta i bhfolach (ie sula hidden.bs.toast
dtarlaíonn an t-imeacht). Caithfidh tú an modh seo a ghlaoch de láimh má rinne tú autohide
é false
.
.toast('dispose')
Folaigh tósta eiliminte. Fanfaidh do thósta ar an DOM ach ní thaispeánfar a thuilleadh é.
Imeachtaí
Cineál Imeachta | Cur síos |
---|---|
taispeáin.bs.tósta | Téann an teagmhas seo chun solais láithreach nuair show a ghlaoitear an modh ásc. |
léirithe.bs.tósta | Cuirtear an teagmhas seo ar ceal nuair a bhíonn an tósta infheicthe don úsáideoir. |
folaigh.bs.tósta | Cuirtear an teagmhas seo ar ceal láithreach nuair hide a ghlaoitear an modh ásc. |
i bhfolach.bs.tósta | Cuirtear an teagmhas seo ar ceal nuair a bhíonn an tósta i bhfolach ón úsáideoir. |