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

Messages (DEPRECATED)

Message is no longer supported. Use Flag instead.

Messages 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.

For visual examples of each kind please see the Design guide.

Example

1
2
3
4
AP.require("messages", function(messages){
  //create a message
  var message = messages.info('plain text title', 'plain text body');
});

Classes

MessageOptions

Properties

Name Type Description
closeable Boolean Adds a control allowing the user to close the message, removing it from the page
fadeout Boolean Toggles the fade away on the message
delay Number Time to wait (in ms) before starting fadeout animation (ignored if fadeout==false)
duration Number Fadeout animation duration in milliseconds (ignored if fadeout==false)

Methods

clear (id)

Clear a message.

Parameters

Name Type Description
id String The ID that was returned when the message was created

Example

1
2
3
4
5
6
7
AP.require("messages", function(messages){
  //create a message
  var message = messages.info('title', 'body');
  setTimeout(function(){
    messages.clear(message);
  }, 2000);
});

error (title, body, options)

Show an error message.

Parameters

Name Type Description
title String Sets the title text of the message
body String The main content of the message
options MessageOptions Message Options

Returns: the ID to be used when clearing the message; String.

Example

1
2
3
4
AP.require("messages", function(messages){
  //create a message
  var message = messages.error('title', 'error message example');
});

generic (title, body, options)

Show a generic message.

Parameters

Name Type Description
title String Sets the title text of the message
body String The main content of the message
options MessageOptions Message Options

Returns: the ID to be used when clearing the message; String.

Example

1
2
3
4
AP.require("messages", function(messages){
  //create a message
  var message = messages.generic('title', 'generic message example');
});

hint (title, body, options) → {String}

Show a hint message.

Parameters

Name Type Description
title String Sets the title text of the message
body String The main content of the message
options MessageOptions Message Options

Returns: the ID to be used when clearing the message; String.

Example

1
2
3
4
AP.require("messages", function(messages){
  //create a message
  var message = messages.hint('title', 'hint message example');
});

info (title, body, options) → {String}

Show an info message.

Parameters

Name Type Description
title String Sets the title text of the message
body String The main content of the message
options MessageOptions Message Options

Returns: the ID to be used when clearing the message; String.

Example

1
2
3
4
AP.require("messages", function(messages){
  //create a message
  var message = messages.info('title', 'info message example');
});

success (title, body, options)

Show a success message.

Parameters

Name Type Description
title String Sets the title text of the message
body String The main content of the message
options MessageOptions Message Options

Returns: the ID to be used when clearing the message; String.

Example

1
2
3
4
AP.require("messages", function(messages){
  //create a message
  var message = messages.success('title', 'success message example');
});

warning (title, body, options) → {String}

Show a warning message.

Parameters

Name Type Description
title String Sets the title text of the message
body String The main content of the message
options MessageOptions

Message Options

Returns: the ID to be used when clearing the message; String.

Example

1
2
3
4
AP.require("messages", function(messages){
  //create a message
  var message = messages.warning('title', 'warning message example');
});
  • System status
  • Privacy
  • Developer Terms
  • Trademark
  • Cookie Preferences
  • © 2019 Atlassian