טאָסט
פּוש נאָוטאַפאַקיישאַנז צו דיין וויזאַטערז מיט אַ טאָסט, אַ לייטווייט און לייכט קוסטאָמיזאַבלע פלינק אָנזאָג.
טאָוסטס זענען לייטווייט נאָוטאַפאַקיישאַנז דיזיינד צו נאָכקרימען די שטופּן נאָוטאַפאַקיישאַנז וואָס זענען פּאָפּולאַרייזד דורך רירעוודיק און דעסקטאַפּ אָפּערייטינג סיסטעמען. זיי זענען געבויט מיט פלעקסבאָקס, אַזוי זיי זענען גרינג צו ייַנרייען און שטעלע.
איבערבליק
טינגז צו וויסן ווען איר נוצן די טאָסט פּלוגין:
- אויב איר בויען אונדזער דזשאַוואַסקריפּט פֿון מקור, עס ריקווייערז
util.js
. - טאָוסטס זענען אַפּט-אין פֿאַר פאָרשטעלונג סיבות, אַזוי איר מוזן ינישאַלייז זיי זיך .
- ביטע טאָן אַז איר זענט פאַראַנטוואָרטלעך פֿאַר פּאַזישאַנינג טאָסט.
- טאָוסט וועט אויטאָמאַטיש באַהאַלטן אויב איר טאָן ניט ספּעציפיצירן
autohide: false
.
די אַנאַמיישאַן ווירקונג פון דעם קאָמפּאָנענט איז אָפענגיק אויף די prefers-reduced-motion
מידיאַ אָנפֿרעג. זען די רידוסט באַוועגונג אָפּטיילונג פון אונדזער אַקסעסאַביליטי דאַקיומענטיישאַן .
ביישפילן
באַסיק
צו מוטיקן עקסטענסיבלע און פּרידיקטאַבאַל טאָסט, מיר רעקאָמענדירן אַ כעדער און גוף. טאָסט כעדערז נוצן display: flex
, אַלאַוינג גרינג אַליינמאַנט פון אינהאַלט דאַנק צו אונדזער גרענעץ און פלעקסבאָקס יוטילאַטיז.
טאָוסט זענען ווי פלעקסאַבאַל ווי איר דאַרפֿן און האָבן זייער קליין פארלאנגט מאַרקאַפּ. אין אַ מינימום, מיר דאַרפן אַ איין עלעמענט צו אַנטהאַלטן דיין "טאָוסטיד" אינהאַלט און שטארק מוטיקן אַ אָפּזאָגן קנעפּל.
טראַנסלוסאַנט
טאָוסט זענען אויך אַ ביסל טראַנסלוסאַנט, אַזוי זיי צונויפגיסן איבער וואָס זיי זאלן דערשייַנען איבער. פֿאַר בראַוזערז וואָס שטיצן די backdrop-filter
CSS פאַרמאָג, מיר וועלן אויך פּרווון צו בלער די עלעמענטן אונטער אַ טאָסט.
סטאַקינג
ווען איר האָבן קייפל טאָסט, מיר פעליקייַט צו ווערטיקלי סטאַקינג זיי אין אַ ליינעוודיק שטייגער.
פּלייסמאַנט
שטעלן טאָסט מיט מנהג CSS ווי איר דאַרפֿן ז��י. די שפּיץ רעכט איז אָפט געניצט פֿאַר נאָוטאַפאַקיישאַנז, ווי די שפּיץ מיטל. אויב איר וועט נאָר ווייַזן איין טאָסט אין אַ צייַט, שטעלן די פּאַזישאַנינג סטיילז רעכט אויף די .toast
.
פֿאַר סיסטעמען וואָס דזשענערייט מער נאָוטאַפאַקיישאַנז, באַטראַכטן ניצן אַ ראַפּינג עלעמענט אַזוי זיי קענען לייכט אָנלייגן.
איר קענען אויך באַקומען פאַנטאַזיע מיט פלעקסבאָקס יוטילאַטיז צו ייַנרייען טאָסט כאָריזאַנטאַלי און / אָדער ווערטיקלי.
אַקסעסאַביליטי
טאָוסטס זענען בדעה צו זיין קליין ינטעראַפּשאַנז פֿאַר דיין וויזאַטערז אָדער יוזערז, אַזוי צו העלפֿן יענע מיט פאַרשטעלן לייענער און ענלעך אַסיסטאַנץ טעקנאַלאַדזשיז, איר זאָל ייַנוויקלען דיין טאָסט אין אַ aria-live
געגנט . ענדערונגען צו לעבן מקומות (אַזאַ ווי ינדזשעקטינג / אַפּדייטינג אַ טאָסט קאָמפּאָנענט) זענען אויטאָמאַטיש אַנאַונסט דורך פאַרשטעלן לייענער אָן נויט צו מאַך די באַניצער 'ס פאָקוס אָדער אַנדערש יבעררייַסן די באַניצער. אין דערצו, אַרייַננעמען aria-atomic="true"
צו ענשור אַז די גאנצע טאָסט איז שטענדיק אַנאַונסט ווי אַ איין (אַטאָמישע) אַפּאַראַט, אלא ווי אַנאַונסינג וואָס איז פארענדערט (וואָס קען פירן צו פּראָבלעמס אויב איר נאָר דערהייַנטיקן טייל פון די טאָסט אינהאַלט, אָדער אויב איר ווייַזן די זעלבע טאָסט אינהאַלט אין אַ שפּעטער צייט). אויב די נויטיק אינפֿאָרמאַציע איז וויכטיק פֿאַר דעם פּראָצעס, למשל פֿאַר אַ רשימה פון ערראָרס אין אַ פאָרעם, נוצן די פלינק קאָמפּאָנענטאַנשטאָט טאָסט.
באַמערקונג אַז די לעבן געגנט דאַרף זיין פאָרשטעלן אין די מאַרקאַפּ איידער די טאָסט איז דזשענערייטאַד אָדער דערהייַנטיקט. אויב איר דינאַמיקאַללי דזשענערייט ביידע אין דער זעלביקער צייט און אַרייַנשפּריצן זיי אין די בלאַט, זיי וועלן בכלל נישט זיין מודיע דורך אַסיסטאַטיוו טעקנאַלאַדזשיז.
איר אויך דאַרפֿן צו אַדאַפּט די role
און aria-live
מדרגה דיפּענדינג אויף די אינהאַלט. אויב עס איז אַ וויכטיק אָנזאָג ווי אַ טעות, נוצן role="alert" aria-live="assertive"
, אַנדערש נוצן role="status" aria-live="polite"
אַטריביוץ.
ווי דער אינהאַלט איר ווייַזן ענדערונגען, זיין זיכער צו דערהייַנטיקן די delay
טיימאַוט צו ענשור אַז מענטשן האָבן גענוג צייט צו לייענען די טאָסט.
ווען איר נוצן autohide: false
, איר מוזן לייגן אַ נאָענט קנעפּל צו לאָזן ניצערס צו אָפּזאָגן די טאָסט.
דזשאַוואַסקריפּט נאַטור
באַניץ
ינישאַליזע טאָסט דורך דזשאַוואַסקריפּט:
אָפּציעס
אָפּציעס קענען זיין דורכגעגאנגען דורך דאַטן אַטריביוץ אָדער דזשאַוואַסקריפּט. פֿאַר דאַטן אַטריביוץ, צולייגן די אָפּציע נאָמען צו data-
, ווי אין data-animation=""
.
נאָמען | טיפּ | פעליקייַט | באַשרייַבונג |
---|---|---|---|
אַנאַמיישאַן | בוליאַן | אמת | צולייגן אַ CSS וועלקן יבערגאַנג צו די טאָסט |
אַוטאָהידע | בוליאַן | אמת | אַוטאָ באַהאַלטן די טאָסט |
פאַרהאַלטן | נומער | 500 |
פאַרהאַלטן כיידינג די טאָסט (מס) |
מעטהאָדס
אַסינטשראָנאָוס מעטהאָדס און טראַנזישאַנז
אַלע אַפּי מעטהאָדס זענען ייסינגקראַנאַס און אָנהייבן אַ יבערגאַנג . זיי צוריקקומען צו די קאַללער ווי באַלד ווי די יבערגאַנג איז סטאַרטעד אָבער איידער עס ענדס . אין אַדישאַן, אַ מעטאָד רופן אויף אַ יבערגאַנג קאָמפּאָנענט וועט זיין איגנאָרירט .
זען אונדזער דזשאַוואַסקריפּט דאַקיומענטיישאַן פֿאַר מער אינפֿאָרמאַציע .
$().toast(options)
אַטאַטשיז אַ טאָסט האַנדלער צו אַן עלעמענט זאַמלונג.
.toast('show')
אַנטפּלעקט אַן עלעמענט ס טאָסט. קערט צו די קאַללער איידער די טאָסט איז אַקשלי געוויזן (ד"ה איידער די shown.bs.toast
געשעעניש אַקערז). איר מוזן מאַניואַלי רופן דעם אופֿן, אַנשטאָט דיין טאָסט וועט נישט ווייַזן.
.toast('hide')
באַהאַלט אַן עלעמענט ס טאָסט. קערט צו די קאַללער איידער די טאָסט איז פאקטיש געווען פאַרבאָרגן (ד"ה איידער די hidden.bs.toast
געשעעניש אַקערז). איר האָבן צו מאַניואַלי רופן דעם אופֿן אויב איר געמאכט autohide
צו false
.
.toast('dispose')
באַהאַלט אַן עלעמענט ס טאָסט. דיין טאָסט וועט בלייבן אויף די DOM אָבער וועט נישט ווייַזן ענימאָר.
געשעענישן
געשעעניש טיפּ | באַשרייַבונג |
---|---|
ווייַזן.בס.טאָסט | דער געשעעניש פירט גלייך ווען דער show בייַשפּיל אופֿן איז גערופן. |
געוויזן.בס.טאָסט | דעם געשעעניש איז פייערד ווען די טאָסט איז געווען קענטיק צו דער באַניצער. |
באַהאַלטן.בס.טאָסט | דעם געשעעניש איז פייערד מיד ווען די hide בייַשפּיל אופֿן איז גערופן. |
פאַרבאָרגן.בס.טאָסט | דעם געשעעניש איז פייערד ווען די טאָסט איז פאַרטיק צו זיין פאַרבאָרגן פון די באַניצער. |