Messages

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

Methods

clear (id)

Clear a message.

Parameters

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

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

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

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

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

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

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');
});