Flags are the primary method for providing system feedback in the product user interface. Messages include notifications of various kinds: alerts, confirmations, notices, warnings, info and errors.
API status: | experimental |
---|---|
Included in AUI core? | Not in core You must explicitly require the web resource key. |
Web resource key: | com.atlassian.auiplugin:aui-flag |
Experimental since: | 5.7 |
There are several flag types with different colours and icons.
Flags can only be used through the Javascript API.
Note: The aui-nav-actions-list ul should be used when adding actions at the bottom of a Flag.
You can close the flag by calling the close()
method on the DOM element.
If the flag is more than just informational or there are obvious follow-up things a user could do,
add a list of actions to the flag body to allow the user to easily take their next step.
Actions should have the appearance of a link, but should use the appropriate HTML element for
the action — for example, use a <button>
when the action is handled
by JavaScript or does something on the current page; use an <a>
when the action
can take the user to another location in the system.
When a flag is closed, the native event aui-flag-close
is triggered on the flag DOM element. This event bubbles.
These options are set in the options object when creating a flag with JavaScript:
Option | Description | Possible values | Default |
---|---|---|---|
type |
Sets the type of the message | success, info, warning, error | info |
body |
The main content of the message. | HTML | none |
close |
The closing behaviour that this flag has. Valid options are "manual", "auto" and "never".
|
string | "manual" |
title |
Sets the title text of the message. | Plain text | none |