com.vaadin.ui
Class Notification

java.lang.Object
  com.vaadin.ui.Notification

All Implemented Interfaces:

java.io.Serializable

public class Notification
extends java.lang.Object
implements java.io.Serializable

A notification message, used to display temporary messages to the user - for example "Document saved", or "Save failed".

The notification message can consist of several parts: caption, description and icon. It is usually used with only caption - one should be wary of filling the notification with too much information.

The notification message tries to be as unobtrusive as possible, while still drawing needed attention. There are several basic types of messages that can be used in different situations:

• TYPE_HUMANIZED_MESSAGE fades away quickly as soon as the user uses the mouse or types something. It can be used to show fairly unimportant messages, such as feedback that an operation succeeded ("Document Saved") - the kind of messages the user ignores once the application is familiar.
• TYPE_WARNING_MESSAGE is shown for a short while after the user uses the mouse or types something. It's default style is also more noticeable than the humanized message. It can be used for messages that do not contain a lot of important information, but should be noticed by the user. Despite the name, it does not have to be a warning, but can be used instead of the humanized message whenever you want to make the message a little more noticeable.
• TYPE_ERROR_MESSAGE requires to user to click it before disappearing, and can be used for critical messages.
• TYPE_TRAY_NOTIFICATION is shown for a while in the lower left corner of the window, and can be used for "convenience notifications" that do not have to be noticed immediately, and should not interfere with the current task - for instance to show "You have a new message in your inbox" while the user is working in some other area of the application.

In addition to the basic pre-configured types, a Notification can also be configured to show up in a custom position, for a specified time (or until clicked), and with a custom stylename. An icon can also be added.

See Also:

Serialized Form

Nested Class Summary

static class

Notification.Type

Field Summary

static int	DELAY_FOREVER
static int	DELAY_NONE
static com.vaadin.shared.Position	POSITION_BOTTOM_LEFT Deprecated.
static com.vaadin.shared.Position	POSITION_BOTTOM_RIGHT Deprecated.
static com.vaadin.shared.Position	POSITION_CENTERED Deprecated.
static com.vaadin.shared.Position	POSITION_CENTERED_BOTTOM Deprecated.
static com.vaadin.shared.Position	POSITION_CENTERED_TOP Deprecated.
static com.vaadin.shared.Position	POSITION_TOP_LEFT Deprecated.
static com.vaadin.shared.Position	POSITION_TOP_RIGHT Deprecated.
static Notification.Type	TYPE_ERROR_MESSAGE Deprecated.
static Notification.Type	TYPE_HUMANIZED_MESSAGE Deprecated.
static Notification.Type	TYPE_TRAY_NOTIFICATION Deprecated.
static Notification.Type	TYPE_WARNING_MESSAGE Deprecated.

Constructor Summary

Notification(java.lang.String caption)
Creates a "humanized" notification message.

Notification(java.lang.String caption, Notification.Type type)
Creates a notification message of the specified type.

Notification(java.lang.String caption, java.lang.String description)
Creates a "humanized" notification message with a bigger caption and smaller description.

Notification(java.lang.String caption, java.lang.String description, Notification.Type type)
Creates a notification message of the specified type, with a bigger caption and smaller description.

Notification(java.lang.String caption, java.lang.String description, Notification.Type type, boolean htmlContentAllowed)
Creates a notification message of the specified type, with a bigger caption and smaller description.

Method Summary

java.lang.String	getCaption() Gets the caption part of the notification message.
int	getDelayMsec() Gets the delay before the notification disappears.
java.lang.String	getDescription() Gets the description part of the notification message.
Resource	getIcon() Gets the icon part of the notification message.
com.vaadin.shared.Position	getPosition() Gets the position of the notification message.
java.lang.String	getStyleName() Gets the style name for the notification message.
boolean	isHtmlContentAllowed() Checks whether caption and description are interpreted as html or plain text.
void	setCaption(java.lang.String caption) Sets the caption part of the notification message
void	setDelayMsec(int delayMsec) Sets the delay before the notification disappears.
void	setDescription(java.lang.String description) Sets the description part of the notification message.
void	setHtmlContentAllowed(boolean htmlContentAllowed) Sets whether html is allowed in the caption and description.
void	setIcon(Resource icon) Sets the icon part of the notification message.
void	setPosition(com.vaadin.shared.Position position) Sets the position of the notification message.
void	setStyleName(java.lang.String styleName) Sets the style name for the notification message.
void	show(Page page) Shows this notification on a Page.
static void	show(java.lang.String caption) Shows a notification message on the middle of the current page.
static void	show(java.lang.String caption, Notification.Type type) Shows a notification message the current page.
static void	show(java.lang.String caption, java.lang.String description, Notification.Type type) Shows a notification message the current page.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TYPE_HUMANIZED_MESSAGE

@Deprecated
public static final Notification.Type TYPE_HUMANIZED_MESSAGE

Deprecated.

TYPE_WARNING_MESSAGE

@Deprecated
public static final Notification.Type TYPE_WARNING_MESSAGE

Deprecated.

TYPE_ERROR_MESSAGE

@Deprecated
public static final Notification.Type TYPE_ERROR_MESSAGE

Deprecated.

TYPE_TRAY_NOTIFICATION

@Deprecated
public static final Notification.Type TYPE_TRAY_NOTIFICATION

Deprecated.

POSITION_CENTERED

@Deprecated
public static final com.vaadin.shared.Position POSITION_CENTERED

Deprecated.

POSITION_CENTERED_TOP

@Deprecated
public static final com.vaadin.shared.Position POSITION_CENTERED_TOP

Deprecated.

POSITION_CENTERED_BOTTOM

@Deprecated
public static final com.vaadin.shared.Position POSITION_CENTERED_BOTTOM

Deprecated.

POSITION_TOP_LEFT

@Deprecated
public static final com.vaadin.shared.Position POSITION_TOP_LEFT

Deprecated.

POSITION_TOP_RIGHT

@Deprecated
public static final com.vaadin.shared.Position POSITION_TOP_RIGHT

Deprecated.

POSITION_BOTTOM_LEFT

@Deprecated
public static final com.vaadin.shared.Position POSITION_BOTTOM_LEFT

Deprecated.

POSITION_BOTTOM_RIGHT

@Deprecated
public static final com.vaadin.shared.Position POSITION_BOTTOM_RIGHT

Deprecated.

DELAY_FOREVER

public static final int DELAY_FOREVER

See Also:

Constant Field Values

DELAY_NONE

public static final int DELAY_NONE

See Also:

Constant Field Values

Constructor Detail

Notification

public Notification(java.lang.String caption)

Creates a "humanized" notification message. The caption is rendered as plain text with HTML automatically escaped.

Parameters:

caption - The message to show

Notification

public Notification(java.lang.String caption,
                    Notification.Type type)

Creates a notification message of the specified type. The caption is rendered as plain text with HTML automatically escaped.

Parameters:

caption - The message to show

type - The type of message

Notification

public Notification(java.lang.String caption,
                    java.lang.String description)

Creates a "humanized" notification message with a bigger caption and smaller description. The caption and description are rendered as plain text with HTML automatically escaped.

Parameters:

caption - The message caption

description - The message description

Notification

public Notification(java.lang.String caption,
                    java.lang.String description,
                    Notification.Type type)

Creates a notification message of the specified type, with a bigger caption and smaller description. The caption and description are rendered as plain text with HTML automatically escaped.

Parameters:

caption - The message caption

description - The message description

type - The type of message

Notification

public Notification(java.lang.String caption,
                    java.lang.String description,
                    Notification.Type type,
                    boolean htmlContentAllowed)

Creates a notification message of the specified type, with a bigger caption and smaller description. Care should be taken to to avoid XSS vulnerabilities if html is allowed.

Parameters:

caption - The message caption

description - The message description

type - The type of message

htmlContentAllowed - Whether html in the caption and description should be displayed as html or as plain text

Method Detail

getCaption

public java.lang.String getCaption()

Gets the caption part of the notification message.

Returns:

The message caption

setCaption

public void setCaption(java.lang.String caption)

Sets the caption part of the notification message

Parameters:

caption - The message caption

getDescription

public java.lang.String getDescription()

Gets the description part of the notification message.

Returns:

The message description.

setDescription

public void setDescription(java.lang.String description)

Sets the description part of the notification message.

Parameters:

description -

getPosition

public com.vaadin.shared.Position getPosition()

Gets the position of the notification message.

Returns:

The position

setPosition

public void setPosition(com.vaadin.shared.Position position)

Sets the position of the notification message.

Parameters:

position - The desired notification position

getIcon

public Resource getIcon()

Gets the icon part of the notification message.

Returns:

The message icon

setIcon

public void setIcon(Resource icon)

Sets the icon part of the notification message.

Parameters:

icon - The desired message icon

getDelayMsec

public int getDelayMsec()

Gets the delay before the notification disappears.

Returns:

the delay in msec, -1 indicates the message has to be clicked.

setDelayMsec

public void setDelayMsec(int delayMsec)

Sets the delay before the notification disappears.

Parameters:

delayMsec - the desired delay in msec, -1 to require the user to click the message

setStyleName

public void setStyleName(java.lang.String styleName)

Sets the style name for the notification message.

Parameters:

styleName - The desired style name.

getStyleName

public java.lang.String getStyleName()

Gets the style name for the notification message.

Returns:

setHtmlContentAllowed

public void setHtmlContentAllowed(boolean htmlContentAllowed)

Sets whether html is allowed in the caption and description. If set to true, the texts are passed to the browser as html and the developer is responsible for ensuring no harmful html is used. If set to false, the texts are passed to the browser as plain text.

Parameters:

htmlContentAllowed - true if the texts are used as html, false if used as plain text

isHtmlContentAllowed

public boolean isHtmlContentAllowed()

Checks whether caption and description are interpreted as html or plain text.

Returns:

true if the texts are used as html, false if used as plain text

See Also:

setHtmlContentAllowed(boolean)

show

public void show(Page page)

Shows this notification on a Page.

Parameters:

page - The page on which the notification should be shown

show

public static void show(java.lang.String caption)

Shows a notification message on the middle of the current page. The message automatically disappears ("humanized message"). The caption is rendered as plain text with HTML automatically escaped.

Parameters:

caption - The message

See Also:

Notification(String), show(Page)

show

public static void show(java.lang.String caption,
                        Notification.Type type)

Shows a notification message the current page. The position and behavior of the message depends on the type, which is one of the basic types defined in Notification, for instance Notification.TYPE_WARNING_MESSAGE. The caption is rendered as plain text with HTML automatically escaped.

Parameters:

caption - The message

type - The message type

See Also:

#Notification(String, int), show(Page)

show

public static void show(java.lang.String caption,
                        java.lang.String description,
                        Notification.Type type)

Shows a notification message the current page. The position and behavior of the message depends on the type, which is one of the basic types defined in Notification, for instance Notification.TYPE_WARNING_MESSAGE. The caption is rendered as plain text with HTML automatically escaped.

Parameters:

caption - The message

description - The message description

type - The message type

See Also:

Notification(String, Type), show(Page)