Angular トースト通知サービス | ng-hub-ui-toast
Signals、ライフサイクル Observable、プログレスバー、6 つの配置位置、完全な CSS 変数によるテーマ設定を備えた standalone な Angular トースト通知サービス。
API リファレンス
toast の完全な仕様をここにまとめました。バインド、リッスン、プロジェクション、テーマ設定ができるすべてが一か所に集約されています。必要なものを接続し、好きなようにスタイリングしてください — standalone で signal フレンドリーです。
インプット
10 個のインプットで toast を調整。通常の Angular @Input と同じようにバインドできます。
| 名前 | 型 | デフォルト | 説明 |
|---|---|---|---|
data (hub-toast)必須 | HubToastData | — | レンダリングするトースト:id、type、message、省略可能な title、解決済みの設定、およびライフサイクルの Subject を含みます。ToastContainerComponent によって内部的に提供されるため、通常は自分でバインドすることはありません。 |
timeOut / extendedTimeOut (config) | number | 5000 / 2500 | timeOut は自動で閉じるまでの時間(ミリ秒、0 = 常時表示)です。extendedTimeOut は、ユーザーがトーストのホバーをやめた後に追加で与えられる時間です。 |
closeButton / progressBar (config) | boolean | true / false | closeButton はトーストに閉じるボタンを表示し、progressBar は自動で閉じるまでのカウントダウンバーを表示します。 |
tapToDismiss (config) | boolean | true | ユーザーがトースト上のどこかをクリックするとトーストを閉じます。 |
disableTimeOut (config) | boolean | 'timeOut' | 'extendedTimeOut' | false | 自動で閉じる動作を無効にします:true または 'timeOut' は最初のタイマーを無効にし、'extendedTimeOut' はホバーによる延長のみを無効にします。 |
newestOnTop (config) | boolean | true | true の場合、最新のトーストがスタックの下ではなく上に挿入されます。 |
positionClass (config) | HubToastPosition | string | 'toast-top-right' | トーストコンテナの画面上の位置:組み込みの 6 つの toast-top/bottom-left/center/right クラスのいずれか、またはカスタムクラス文字列。 |
maxOpened (config) | number | 0 | 同時に表示できるトーストの最大数。0 は無制限を意味します。 |
autoDismiss (config) | boolean | false | maxOpened に達したとき、新しいトーストのために最も古いトーストを自動的に削除します。 |
preventDuplicates (config) | boolean | false | メッセージとタイプがすでに表示中のトーストと一致する新しいトーストを無視し、代わりに既存のトーストのハンドルを返します。 |
アウトプット
toast の動作に反応 — ロジックを接続できる 1 個のイベント。
| 名前 | 型 | 説明 |
|---|---|---|
closed (hub-toast) | EventEmitter<number> | トーストを閉じるべきときにトースト id を発行します — 自動で閉じるタイマーの満了後、tapToDismiss によるタップ、または閉じるボタンが契機になります。 |
メソッド
toast をコードから操作 — プログラム操作のための 7 個のメソッドを備えています。
| 名前 | シグネチャ | 戻り値 | 説明 |
|---|---|---|---|
ToastService.success | success(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | 指定されたメッセージ、省略可能なタイトル、および呼び出し単位の設定上書きで成功トーストを表示します。 |
ToastService.error | error(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | 指定されたメッセージ、省略可能なタイトル、および呼び出し単位の設定上書きでエラートーストを表示します。 |
ToastService.warning | warning(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | 指定されたメッセージ、省略可能なタイトル、および呼び出し単位の設定上書きで警告トーストを表示します。 |
ToastService.info | info(message: string, title?: string, config?: Partial<HubToastConfig>): HubToastRef | HubToastRef handle for the created toast | 指定されたメッセージ、省略可能なタイトル、および呼び出し単位の設定上書きで情報トーストを表示します。 |
ToastService.show | show(message: string, title?: string, config?: Partial<HubToastConfig>, type?: HubToastType | string): HubToastRef | HubToastRef handle for the created toast | 組み込みまたはカスタムのタイプ文字列でトーストを表示します。タイプはトーストのホストに data-type として適用され、アクセントのスタイリングを決定します。 |
ToastService.remove | remove(toastId: number): void | void | 表示系メソッドから返された id を使って、特定のトーストを削除します。 |
ToastService.clear | clear(): void | void | アクティブなすべてのトーストを直ちに削除し、各トーストの onHidden の Observable を完了させます。 |
テンプレート
テンプレートはまだドキュメント化されていません。