Displays real time updates without interrupting the user's workflow to communicate an important message or status. MDN Popover API
<nve-notification id="notification" position="top" close-timeout="2000">
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-button popovertarget="notification">button</nve-button>
Notification
some text content in a notification
button
Installation
Learn more about native Popover APIs.
import '@nvidia-elements/core/notification/define.js';
<nve-notification id="notification" position="top" close-timeout="2000">
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-button popovertarget="notification">button</nve-button>
Visual
Standard notification layout with title and body content in centered positioning for consistent notification structure.
<nve-notification position="center">
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
Events
Event Description open Dispatched when the notification opens.
Dispatched on a popover element just after showing or hiding. MDN
Dispatched on a popover just before showing or hiding. MDN
Dispatched when the notification closes.
Event handling for notification lifecycle events. Useful for adding custom behavior when notification state changes.
<nve-notification id="notification" position="top" close-timeout="2000" closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-button popovertarget="notification">button</nve-button>
<script type="module">
const notification = document.querySelector("nve-notification");
notification.addEventListener("beforetoggle", () => console.log("beforetoggle"));
notification.addEventListener("toggle", () => console.log("toggle"));
notification.addEventListener("close", () => console.log("close"));
notification.addEventListener("open", () => console.log("open"));
</script>
Status
Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
Status Description accent Highlights important actions or draws attention to primary interactive elements. warning Indicates cautionary actions that require careful consideration before proceeding. success Represents positive outcomes, confirmations, or constructive actions. danger Signals destructive or irreversible actions that need extra attention and confirmation.
Notification status variants for different message types and severity levels. Use status to convey message importance: success for confirmations, warning for cautions, danger for errors, and accent for general information requiring attention.
<nve-notification-group position="center">
<nve-notification>
<h3 nve-text="label">Default</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification status="accent">
<h3 nve-text="label">Accent</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification status="success">
<h3 nve-text="label">Success</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification status="warning">
<h3 nve-text="label">Warning</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification status="danger">
<h3 nve-text="label">Danger</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
</nve-notification-group>
Actions
Notification with actions for immediate user response. Use notifications with actions when the notification requires user decision-making (like "Retry", "View Details", or "Undo"), making the next step clear and reducing friction in error recovery or task completion flows.
<nve-notification position="center">
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
<div nve-layout="row gap:sm align:right">
<nve-button container="inline">Dismiss</nve-button>
<nve-button container="inline">Accept</nve-button>
</div>
</nve-notification>
Interactive Group
Dynamic notification group with programmatic creation and stacking. Perfect for toast-style notifications generated by user actions or system events, with progressive timeout and automatic removal patterns for managing many notifications.
<nve-notification-group position="bottom" alignment="end" id="group"></nve-notification-group>
<nve-button>generate</nve-button>
<script type="module">
const button = document.querySelector("nve-button");
button.addEventListener("click", () => {
const notification = document.createElement("nve-notification");
notification.closable = true;
notification.status = ["warning", "danger", "success", "accent", undefined][Math.floor(Math.random() * 5)];
notification.innerHTML =
'<h3 nve-text="label">' +
(notification.status ?? "default") +
'</h3><p nve-text="body">some text content in a notification</p>';
notification.closeTimeout = 1000 * (document.querySelectorAll("nve-notification").length + 1);
notification.addEventListener("close", () => notification.remove(), { once: true });
notification.position = "bottom";
notification.alignment = "end";
document.querySelector("nve-notification-group").prepend(notification);
});
</script>
Alignment
Determines the alignment of the popover relative to the provided anchor element.
Alignment Description start Aligns the popover to the beginning edge of the anchor for left or top alignment. end Aligns the popover to the ending edge of the anchor for right or bottom alignment. center Centers the popover along the anchor's edge for balanced positioning.
Notification positioning and alignment options for flexible screen placement. Use consistent positioning for notification types: bottom-right for success confirmations, top-center for warnings, accommodating different screen sizes and user attention patterns.
<nve-notification position="top">
<h3 nve-text="label">Top</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="top" alignment="start">
<h3 nve-text="label">Top Start</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="top" alignment="end">
<h3 nve-text="label">Top End</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="right">
<h3 nve-text="label">Right</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="right" alignment="start">
<h3 nve-text="label">Right Start</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="right" alignment="end">
<h3 nve-text="label">Right End</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="bottom">
<h3 nve-text="label">Bottom</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="bottom" alignment="start">
<h3 nve-text="label">Bottom Start</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="bottom" alignment="end">
<h3 nve-text="label">Bottom End</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="left">
<h3 nve-text="label">Left</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="left" alignment="start">
<h3 nve-text="label">Left Start</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="left" alignment="end">
<h3 nve-text="label">Left End</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
Position
Determines the position of an element along both inline and block axis. MDN
Position Description center Centers the popover directly over the anchor element. top Positions the popover above the anchor element. bottom Positions the popover below the anchor element. left Positions the popover to the left side of the anchor element. right Positions the popover to the right side of the anchor element.
Basic notification positioning at screen edges without alignment specification. Use edge positions for standard notification placement, choosing position based on content importance and user workflow patterns.
<nve-notification position="top">
<h3 nve-text="label">Position Top</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="right">
<h3 nve-text="label">Position Right</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="bottom">
<h3 nve-text="label">Position Bottom</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification position="left">
<h3 nve-text="label">Position Left</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
Position Group
Determines the position of an element along both inline and block axis. MDN
Position Description center Centers the popover directly over the anchor element. top Positions the popover above the anchor element. bottom Positions the popover below the anchor element. left Positions the popover to the left side of the anchor element. right Positions the popover to the right side of the anchor element.
Grouped notifications with consistent positioning for stacking many messages. Use notification groups to manage many alerts in an organized queue, maintaining visual consistency and providing users with a clear notification center.
<nve-notification-group position="top">
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
</nve-notification-group>
<nve-notification-group position="right">
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
</nve-notification-group>
<nve-notification-group position="bottom">
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
</nve-notification-group>
<nve-notification-group position="left">
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
<nve-notification closable>
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
</nve-notification>
</nve-notification-group>
Content Wrap
Notification with text wrapping for longer content. Use when notification messages exceed single-line length, but keep content concise for better readability and user comprehension.
<nve-notification position="center">
<h3 nve-text="label">Notification</h3>
<p nve-text="body" style="width: 230px">
some text content in a notification with some really long text in it that just keeps going...
</p>
</nve-notification>
Custom Status
Custom status color for notification. Use custom status color and icon slot to convey a different meaning than the default status color. Use sparingly as it can add unnecessary cognitive load to the user.
<nve-notification style="--status-color: var(--nve-ref-color-purple-plum-800)" position="center">
<h3 nve-text="label">Notification</h3>
<p nve-text="body">some text content in a notification</p>
<nve-icon slot="icon" name="sparkles" aria-label="Info"></nve-icon>
<div nve-layout="row align:right">
<nve-button container="inline">Action</nve-button>
</div>
</nve-notification>
Release Status
All elements and features go through 3 phases of stability, pre-release, beta and stable.
pre-release
Docs Preview
API Documentation
Fully Themeable
beta
Robust unit test coverages
Passed API Review
Passed Designer VQA Review
Included in library package
stable
No known outstanding AA WCAG issues
No known outstanding performance issues
Adapts to different screen/container sizes
No breaking API changes for at least 90 days