Message

Imperative global message notifications with support for types, custom duration, and manual dismissal.

Basic usage

Four types

SuccessErrorWarningInfo

Example

Custom duration

Custom duration

2s5sNo auto-close (0)

Example

Manual close

Manual close

Show messageClose manually

Example

Clear all

Clear all

Fire threeClear all

Example

Grouped messages

Messages with the same group merge into a single one; repeated triggers increment the count (×n). Different groups are independent.

Grouped messages

Save (click repeatedly)Sync (another group)

Example

Updating messages

Tag a message with key, then update its content/type via message.update(key, options) and close it via message.destroy(key).

Updating messages

Start uploadMark as successClose this message

Example

API

Methods

Method	Description
message.info(content, duration?) / message.info(content, options?)	Info message, returns { close }
message.success(content, duration?) / message.success(content, options?)	Success message, returns { close }
message.warning(content, duration?) / message.warning(content, options?)	Warning message, returns { close }
message.error(content, duration?) / message.error(content, options?)	Error message, returns { close }
message.update(key, { content, type?, duration? })	Update content/type of an existing message; creates a new one if the key does not exist
message.destroy(key)	Close the message identified by key
destroyAllMessage()	Clear all messages

Attributes

Attribute	Description	Type	Default
count	Merge count (shows ×n after content when > 1)	string	0
duration	Auto-close duration (ms), 0 to keep open	string	3000
group	Group id: messages in the same group merge into one	—	—
key	Unique id: used by message.update / message.destroy	—	—
type	Message type: info/success/warning/error	string	info

Events

Event	Description
oas-close	Emitted when the message closes (auto-close / close button / destroy), detail: { key? }

• options: { duration?, group?, key?, onClose? }. group merges messages into one and increments the count; key is used by update / destroy; onClose fires when the message closes.
• duration defaults to 3000ms; pass 0 to keep the message open.
• When a message closes (auto-close / close button / destroy), oas-close is emitted with detail: { key? }.
• Stacked and centered at the top; error uses role="alert", others use role="status".