1
0
mirror of https://github.com/bitwarden/browser synced 2026-02-18 02:19:18 +00:00
Files
browser/libs/components/src/banner/banner.component.ts
2025-07-16 08:39:37 -04:00

59 lines
2.0 KiB
TypeScript

import { CommonModule } from "@angular/common";
import { Component, OnInit, Output, EventEmitter, input, model } from "@angular/core";
import { I18nPipe } from "@bitwarden/ui-common";
import { IconButtonModule } from "../icon-button";
type BannerType = "premium" | "info" | "warning" | "danger";
const defaultIcon: Record<BannerType, string> = {
premium: "bwi-star",
info: "bwi-info-circle",
warning: "bwi-exclamation-triangle",
danger: "bwi-error",
};
/**
* Banners are used for important communication with the user that needs to be seen right away, but has
* little effect on the experience. Banners appear at the top of the user's screen on page load and
* persist across all pages a user navigates to.
* - They should always be dismissible and never use a timeout. If a user dismisses a banner, it should not reappear during that same active session.
* - Use banners sparingly, as they can feel intrusive to the user if they appear unexpectedly. Their effectiveness may decrease if too many are used.
* - Avoid stacking multiple banners.
* - Banners can contain a button or anchor that uses the `bitLink` directive with `linkType="secondary"`.
*/
@Component({
selector: "bit-banner",
templateUrl: "./banner.component.html",
imports: [CommonModule, IconButtonModule, I18nPipe],
})
export class BannerComponent implements OnInit {
readonly bannerType = input<BannerType>("info");
readonly icon = model<string>();
readonly useAlertRole = input(true);
readonly showClose = input(true);
@Output() onClose = new EventEmitter<void>();
ngOnInit(): void {
if (!this.icon()) {
this.icon.set(defaultIcon[this.bannerType()]);
}
}
get bannerClass() {
switch (this.bannerType()) {
case "danger":
return "tw-bg-danger-100 tw-border-b-danger-700";
case "info":
return "tw-bg-info-100 tw-border-b-info-700";
case "premium":
return "tw-bg-success-100 tw-border-b-success-700";
case "warning":
return "tw-bg-warning-100 tw-border-b-warning-700";
}
}
}