• About the JavaScript API
  • AP
  • Cookie
  • Dialog
  • Events
  • History
  • Inline dialog
  • Flag
  • Messages (DEPRECATED)
  • Proxy request
  • Request

Flag

Flags are the primary method for providing system feedback in the product’s user interface. Messages include notifications of various kinds: alerts, confirmations, notices, warnings, info, and errors.

For visual examples of each flag, see the Design guide.

Example

1
2
3
4
5
6
7
8
var flag = AP.flag.create({
  title: 'Successfully created a flag.',
  body: 'This is a flag.',
  type: 'success',
  actions: {
    'actionkey': 'Click me'
  }
});

Methods

create (options)

Creates a new flag.

Parameters

Name Type Description
options Object

Options of the flag.

Properties
Name Type Default Description
title String

The title text of the flag.

body String

The body text of the flag.

type String info

Sets the type of the message. Valid options are "info", "success", "warning" and "error".

close String

The closing behavior for this flag. Valid options are "manual", and "auto".

actions Object

Map of {actionIdentifier: 'Action link text'} to add to the flag. The actionIdentifier will be passed to a 'flag.action' event if the link is clicked.

Returns: Flag~Flag

Methods

close ()

Closes the flag.

Example

1
2
3
4
5
6
7
8
var flag = AP.flag.create({
  title: 'Successfully created a flag.',
  body: 'This is a flag.',
  type: 'info'
});

// Close the flag.
flag.close()
  • System status
  • Privacy
  • Developer Terms
  • Trademark
  • Cookie Preferences
  • © 2019 Atlassian