com.vaadin.flow.component.dialog

Class Dialog

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.dialog.GeneratedVaadinDialog<Dialog>

com.vaadin.flow.component.dialog.Dialog

All Implemented Interfaces:

com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.HasComponents, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasSize, Serializable

@HtmlImport(value="flow-component-renderer.html")
public class Dialog
extends GeneratedVaadinDialog<Dialog>
implements com.vaadin.flow.component.HasComponents, com.vaadin.flow.component.HasSize

Server-side component for the <vaadin-dialog> element.

Author:

Vaadin Ltd

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Dialog.DialogCloseActionEvent `vaadin-dialog-close-action` is sent when the user clicks outside the overlay or presses the escape key.

Nested classes/interfaces inherited from class com.vaadin.flow.component.dialog.GeneratedVaadinDialog

GeneratedVaadinDialog.OpenedChangeEvent<R extends GeneratedVaadinDialog<R>>

Constructor Summary

Constructors

Constructor and Description
Dialog() Creates an empty dialog.
Dialog(com.vaadin.flow.component.Component... components) Creates a dialog with given components inside.

Method Summary

Modifier and Type	Method and Description
void	add(com.vaadin.flow.component.Component... components) Adds the given components into this dialog.
com.vaadin.flow.shared.Registration	addAttachListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.AttachEvent> listener)
void	addComponentAtIndex(int index, com.vaadin.flow.component.Component component) Adds the given component into this dialog at the given index.
com.vaadin.flow.shared.Registration	addDetachListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.DetachEvent> listener)
com.vaadin.flow.shared.Registration	addDialogCloseActionListener(com.vaadin.flow.component.ComponentEventListener<Dialog.DialogCloseActionEvent> listener) Add a listener that controls whether the dialog should be closed or not.
com.vaadin.flow.shared.Registration	addOpenedChangeListener(com.vaadin.flow.component.ComponentEventListener<GeneratedVaadinDialog.OpenedChangeEvent<Dialog>> listener) Add a lister for event fired by the opened-changed events.
void	close() Closes the dialog.
Stream<com.vaadin.flow.component.Component>	getChildren()
String	getHeight()
String	getWidth()
boolean	isCloseOnEsc() Gets whether this dialog can be closed by hitting the esc-key or not.
boolean	isCloseOnOutsideClick() Gets whether this dialog can be closed by clicking outside of it or not.
boolean	isOpened() Gets the open state from the dialog.
void	open() Opens the dialog.
void	remove(com.vaadin.flow.component.Component... components)
void	removeAll()
void	setCloseOnEsc(boolean closeOnEsc) Sets whether this dialog can be closed by hitting the esc-key or not.
void	setCloseOnOutsideClick(boolean closeOnOutsideClick) Sets whether this dialog can be closed by clicking outside of it or not.
void	setHeight(String value)
void	setOpened(boolean opened) Opens or closes the dialog.
void	setWidth(String value)

Methods inherited from class com.vaadin.flow.component.dialog.GeneratedVaadinDialog

getAriaLabelString, isOpenedBoolean, setAriaLabel

Methods inherited from class com.vaadin.flow.component.Component

addListener, fireEvent, from, get, getElement, getEventBus, getId, getLocale, getParent, getTranslation, getTranslation, getUI, hasListener, isTemplateMapped, isVisible, onAttach, onDetach, onEnabledStateChanged, set, setElement, setId, setVisible

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.flow.component.HasComponents

addComponentAsFirst

Methods inherited from interface com.vaadin.flow.component.HasEnabled

isEnabled, setEnabled

Methods inherited from interface com.vaadin.flow.component.HasElement

getElement

Methods inherited from interface com.vaadin.flow.component.HasSize

setSizeFull, setSizeUndefined

Constructor Detail

Dialog

public Dialog()

Creates an empty dialog.

Dialog

public Dialog(com.vaadin.flow.component.Component... components)

Creates a dialog with given components inside.

Parameters:

components - the components inside the dialog

See Also:

add(Component...)

Method Detail

setWidth

public void setWidth(String value)

Specified by:

setWidth in interface com.vaadin.flow.component.HasSize

setHeight

public void setHeight(String value)

Specified by:

setHeight in interface com.vaadin.flow.component.HasSize

getWidth

public String getWidth()

Specified by:

getWidth in interface com.vaadin.flow.component.HasSize

getHeight

public String getHeight()

Specified by:

getHeight in interface com.vaadin.flow.component.HasSize

addDialogCloseActionListener

public com.vaadin.flow.shared.Registration addDialogCloseActionListener(com.vaadin.flow.component.ComponentEventListener<Dialog.DialogCloseActionEvent> listener)

Add a listener that controls whether the dialog should be closed or not.

The listener is informed when the user wants to close the dialog by clicking outside the dialog, or by pressing escape. Then you can decide whether to close or to keep opened the dialog. It means that dialog won't be closed automatically unless you call close() method explicitly in the listener implementation.

NOTE: adding this listener changes behavior of the dialog. Dialog is closed automatically in case there are no any close listeners. And the close() method should be called explicitly to close the dialog in case there are close listeners.

Parameters:

listener -

Returns:

registration for removal of listener

See Also:

close()

add

public void add(com.vaadin.flow.component.Component... components)

Adds the given components into this dialog.

The elements in the DOM will not be children of the <vaadin-dialog> element, but will be inserted into an overlay that is attached into the <body>.

Specified by:

add in interface com.vaadin.flow.component.HasComponents

Parameters:

components - the components to add

remove

public void remove(com.vaadin.flow.component.Component... components)

Specified by:

remove in interface com.vaadin.flow.component.HasComponents

removeAll

public void removeAll()

Specified by:

removeAll in interface com.vaadin.flow.component.HasComponents

addComponentAtIndex

public void addComponentAtIndex(int index,
                                com.vaadin.flow.component.Component component)

Adds the given component into this dialog at the given index.

The element in the DOM will not be child of the <vaadin-dialog> element, but will be inserted into an overlay that is attached into the <body>.

Specified by:

addComponentAtIndex in interface com.vaadin.flow.component.HasComponents

Parameters:

index - the index, where the component will be added.

component - the component to add

isCloseOnEsc

public boolean isCloseOnEsc()

Gets whether this dialog can be closed by hitting the esc-key or not.

By default, the dialog is closable with esc.

Returns:

true if this dialog can be closed with the esc-key, false otherwise

setCloseOnEsc

public void setCloseOnEsc(boolean closeOnEsc)

Sets whether this dialog can be closed by hitting the esc-key or not.

By default, the dialog is closable with esc.

Parameters:

closeOnEsc - true to enable closing this dialog with the esc-key, false to disable it

isCloseOnOutsideClick

public boolean isCloseOnOutsideClick()

Gets whether this dialog can be closed by clicking outside of it or not.

By default, the dialog is closable with an outside click.

Returns:

true if this dialog can be closed by an outside click, false otherwise

setCloseOnOutsideClick

public void setCloseOnOutsideClick(boolean closeOnOutsideClick)

Sets whether this dialog can be closed by clicking outside of it or not.

By default, the dialog is closable with an outside click.

Parameters:

closeOnOutsideClick - true to enable closing this dialog with an outside click, false to disable it

open

public void open()

Opens the dialog.

Note: You don't need to add the dialog component anywhere before opening it. Since <vaadin-dialog>'s location in the DOM doesn't really matter, opening a dialog will automatically add it to the <body> if it's not yet attached anywhere.

close

public void close()

Closes the dialog.

Note: This method also removes the dialog component from the DOM after closing it, unless you have added the component manually.

setOpened

public void setOpened(boolean opened)

Opens or closes the dialog.

Note: You don't need to add the dialog component anywhere before opening it. Since <vaadin-dialog>'s location in the DOM doesn't really matter, opening a dialog will automatically add it to the <body> if it's not yet attached anywhere.

Overrides:

setOpened in class GeneratedVaadinDialog<Dialog>

Parameters:

opened - true to open the dialog, false to close it

isOpened

public boolean isOpened()

Gets the open state from the dialog.

Returns:

the opened property from the dialog

getChildren

public Stream<com.vaadin.flow.component.Component> getChildren()

Overrides:

getChildren in class com.vaadin.flow.component.Component

addOpenedChangeListener

public com.vaadin.flow.shared.Registration addOpenedChangeListener(com.vaadin.flow.component.ComponentEventListener<GeneratedVaadinDialog.OpenedChangeEvent<Dialog>> listener)

Add a lister for event fired by the opened-changed events.

Overrides:

addOpenedChangeListener in class GeneratedVaadinDialog<Dialog>

Parameters:

listener - the listener

Returns:

a Registration for removing the event listener

addAttachListener

public com.vaadin.flow.shared.Registration addAttachListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.AttachEvent> listener)

Note: To listen for opening the dialog, you should use addOpenedChangeListener(ComponentEventListener).

Specified by:

addAttachListener in interface com.vaadin.flow.component.AttachNotifier

addDetachListener

public com.vaadin.flow.shared.Registration addDetachListener(com.vaadin.flow.component.ComponentEventListener<com.vaadin.flow.component.DetachEvent> listener)

Note: To listen for closing the dialog, you should use addOpenedChangeListener(ComponentEventListener), as the component is not necessarily removed from the DOM when closing.

Specified by:

addDetachListener in interface com.vaadin.flow.component.DetachNotifier