com.vaadin.flow.component.confirmdialog.
Class ConfirmDialog
- java.lang.Object
-
- com.vaadin.flow.component.Component
-
- com.vaadin.flow.component.confirmdialog.ConfirmDialog
-
All Implemented Interfaces:
AttachNotifier
,DetachNotifier
,HasComponents
,HasElement
,HasEnabled
,HasOrderedComponents
,HasSize
,HasStyle
,Serializable
@Tag("vaadin-confirm-dialog") @NpmPackage(value="@vaadin/polymer-legacy-adapter",version="23.5.12") @NpmPackage(value="@vaadin/confirm-dialog",version="23.5.12") @NpmPackage(value="@vaadin/vaadin-confirm-dialog",version="23.5.12") @JsModule("@vaadin/polymer-legacy-adapter/style-modules.js") @JsModule("@vaadin/confirm-dialog/src/vaadin-confirm-dialog.js") @JsModule("./confirmDialogConnector.js") public class ConfirmDialog extends Component implements HasSize, HasStyle, HasOrderedComponents
Confirm Dialog is a modal Dialog used to confirm user actions.
Confirm Dialog consists of:
- Title
- Message
- Footer
- ?Cancel? button
- ?Reject? button
- ?Confirm? button
Author:
Vaadin Ltd
See Also:
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
ConfirmDialog.CancelEvent
`cancel` is sent when the user clicks Cancel button or presses Escape key.
static class
ConfirmDialog.ConfirmEvent
`confirm` is sent when the user clicks Confirm button
static class
ConfirmDialog.RejectEvent
`reject` is sent when the user clicks Reject button
-
Constructor Summary
Constructors Constructor Description ConfirmDialog()
Creates an empty dialog with a Confirm button
ConfirmDialog(String header, String text, String confirmText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener)
Creates a dialog with a Confirm button with its click listener and a given texts
ConfirmDialog(String header, String text, String confirmText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener, String cancelText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener)
Creates a two button dialog with Confirm and Cancel buttons
ConfirmDialog(String header, String text, String confirmText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener, String rejectText, ComponentEventListener<ConfirmDialog.RejectEvent> rejectListener, String cancelText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener)
Creates a three button dialog with Confirm, Reject and Cancel buttons
-
Method Summary
All Methods Modifier and Type Method Description Registration
addCancelListener(ComponentEventListener<ConfirmDialog.CancelEvent> listener)
Adds `cancel` event listener
Registration
addConfirmListener(ComponentEventListener<ConfirmDialog.ConfirmEvent> listener)
Adds `confirm` event listener
Registration
addRejectListener(ComponentEventListener<ConfirmDialog.RejectEvent> listener)
Adds `reject` event listener
void
close()
Closes the dialog.
Style
getStyle()
Gets the style instance for managing inline styles for the element of this component.
boolean
isCloseOnEsc()
Gets whether this dialog can be closed by hitting the esc-key or not.
boolean
isOpened()
protected void
onAttach(AttachEvent attachEvent)
Called when the component is attached to a UI.
void
open()
Opens the dialog.
void
setCancelable(boolean cancelable)
Whether to show or hide Cancel button.
void
setCancelButton(Component component)
Sets custom cancel button
void
setCancelButton(Element element)
Sets custom cancel button
void
setCancelButton(String buttonText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener)
Sets Cancel button text and `cancel` event listener.
void
setCancelButton(String buttonText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener, String theme)
Sets Cancel button text, `cancel` event listener and Cancel button theme.
void
setCancelButtonTheme(String cancelTheme)
Sets Cancel button theme
void
setCancelText(String cancelText)
Sets Cancel button text
void
setCloseOnEsc(boolean closeOnEsc)
Sets whether this dialog can be closed by hitting the esc-key or not.
void
setConfirmButton(Component component)
Sets custom confirm button
void
setConfirmButton(Element element)
Sets custom confirm button
void
setConfirmButton(String buttonText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener)
Sets Confirm button text and `confirm` event listener
void
setConfirmButton(String buttonText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener, String theme)
Sets Confirm button text, `confirm` event listener and Confirm button theme
void
setConfirmButtonTheme(String confirmTheme)
Sets Confirm button theme
void
setConfirmText(String confirmText)
Sets Confirm button text
void
setHeader(Component component)
Sets confirmation dialog custom header element
void
setHeader(Element element)
Sets confirmation dialog custom header element
void
setHeader(String header)
Sets confirmation dialog header text
void
setHeight(String height)
Sets the height of the component content area.
void
setOpened(boolean opened)
Opens or closes the dialog.
void
setRejectable(boolean rejectable)
Whether to show or hide Reject button.
void
setRejectButton(Component component)
Sets custom Reject button
void
setRejectButton(Element element)
Sets custom Reject button
void
setRejectButton(String buttonText, ComponentEventListener<ConfirmDialog.RejectEvent> rejectListener)
Sets Reject button text and `reject` event listener.
void
setRejectButton(String buttonText, ComponentEventListener<ConfirmDialog.RejectEvent> rejectListener, String theme)
Sets Reject button text, `reject` event listener, Reject button theme.
void
setRejectButtonTheme(String rejectTheme)
Sets Reject button theme
void
setRejectText(String rejectText)
Sets Reject button text
void
setText(Component component)
Sets custom confirmation message element
void
setText(Element element)
Sets custom confirmation message element
void
setText(String message)
Sets confirmation message text
void
setWidth(String width)
Sets the width of the component content area.
void
updateHeight()
-
Methods inherited from class com.vaadin.flow.component.Component
addListener, findAncestor, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getListeners, getLocale, getParent, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, onDetach, onEnabledStateChanged, scrollIntoView, 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.AttachNotifier
addAttachListener
-
Methods inherited from interface com.vaadin.flow.component.DetachNotifier
addDetachListener
-
Methods inherited from interface com.vaadin.flow.component.HasComponents
add, add, add, addComponentAsFirst, addComponentAtIndex, remove, remove, removeAll
-
Methods inherited from interface com.vaadin.flow.component.HasElement
getElement
-
Methods inherited from interface com.vaadin.flow.component.HasEnabled
isEnabled, setEnabled
-
Methods inherited from interface com.vaadin.flow.component.HasOrderedComponents
getChildren, getComponentAt, getComponentCount, indexOf, replace
-
Methods inherited from interface com.vaadin.flow.component.HasSize
getHeight, getHeightUnit, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getWidth, getWidthUnit, setHeight, setHeightFull, setMaxHeight, setMaxHeight, setMaxWidth, setMaxWidth, setMinHeight, setMinHeight, setMinWidth, setMinWidth, setSizeFull, setSizeUndefined, setWidth, setWidthFull
-
Methods inherited from interface com.vaadin.flow.component.HasStyle
addClassName, addClassNames, getClassName, getClassNames, hasClassName, removeClassName, removeClassNames, setClassName, setClassName
-
-
-
-
Constructor Detail
-
ConfirmDialog
public ConfirmDialog()
Creates an empty dialog with a Confirm button
-
ConfirmDialog
public ConfirmDialog(String header, String text, String confirmText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener)
Creates a dialog with a Confirm button with its click listener and a given texts
Parameters:
header
- the header texttext
- the confirmation message textconfirmText
- the text inside Confirm buttonconfirmListener
- the event listener for `confirm` eventSee Also:
setHeader(String)
,setText(String)
,setConfirmButton(String, ComponentEventListener)
-
ConfirmDialog
public ConfirmDialog(String header, String text, String confirmText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener, String cancelText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener)
Creates a two button dialog with Confirm and Cancel buttons
Parameters:
header
- the header texttext
- the confirmation message textconfirmText
- the text inside Confirm buttonconfirmListener
- the event listener for `confirm` eventcancelText
- the text inside Cancel buttoncancelListener
- the event listener for `cancel` eventSee Also:
setHeader(String)
,setText(String)
,setConfirmButton(String, ComponentEventListener)
,setCancelButton(String, ComponentEventListener)
-
ConfirmDialog
public ConfirmDialog(String header, String text, String confirmText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener, String rejectText, ComponentEventListener<ConfirmDialog.RejectEvent> rejectListener, String cancelText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener)
Creates a three button dialog with Confirm, Reject and Cancel buttons
Parameters:
header
- the header texttext
- the confirmation message textconfirmText
- the text inside Confirm buttonconfirmListener
- the event listener for `confirm` eventrejectText
- the text inside Reject buttonrejectListener
- the event listener for `reject` eventcancelText
- the text inside Cancel buttoncancelListener
- the event listener for `cancel` eventSee Also:
setHeader(String)
,setText(String)
,setConfirmButton(String, ComponentEventListener)
,setCancelButton(String, ComponentEventListener)
,setRejectButton(String, ComponentEventListener)
-
-
Method Detail
-
setWidth
public void setWidth(String width)
Sets the width of the component content area.
The width should be in a format understood by the browser, e.g. "100px" or "2.5em" (Using relative unit, such as percentage, will lead to unexpected results).
If the provided
width
value is null then width is removed.
-
setHeight
public void setHeight(String height)
Sets the height of the component content area.
The height should be in a format understood by the browser, e.g. "100px" or "2.5em" (Using relative unit, such as percentage, will lead to unexpected results).
If the provided
height
value is null then height is removed.
-
updateHeight
public void updateHeight()
-
getStyle
public Style getStyle()
Description copied from interface:
HasStyle
Gets the style instance for managing inline styles for the element of this component.
Specified by:
getStyle
in interfaceHasStyle
Returns:
the style object for the element, not
null
Throws:
UnsupportedOperationException
- ConfirmDialog does not support adding styles to overlay
-
onAttach
protected void onAttach(AttachEvent attachEvent)
Description copied from class:
Component
Called when the component is attached to a UI.
The default implementation does nothing.
This method is invoked before the
AttachEvent
is fired for the component.
-
setCancelable
public void setCancelable(boolean cancelable)
Whether to show or hide Cancel button.
-
setRejectable
public void setRejectable(boolean rejectable)
Whether to show or hide Reject button.
-
setRejectButton
public void setRejectButton(String buttonText, ComponentEventListener<ConfirmDialog.RejectEvent> rejectListener)
Sets Reject button text and `reject` event listener. Makes Reject button visible
Parameters:
buttonText
- the text inside Reject buttonrejectListener
- the event listener for `reject` event
-
setRejectButton
public void setRejectButton(String buttonText, ComponentEventListener<ConfirmDialog.RejectEvent> rejectListener, String theme)
Sets Reject button text, `reject` event listener, Reject button theme. Makes Reject button visible
Parameters:
buttonText
- the text inside Reject buttonrejectListener
- the event listener for `reject` eventtheme
- the theme applied for a Reject button
-
setRejectButton
public void setRejectButton(Component component)
Sets custom Reject button
Parameters:
component
- the component to display instead of default Reject button
-
setRejectButton
public void setRejectButton(Element element)
Sets custom Reject button
Parameters:
element
- the element to display instead of default Reject button
-
setCancelButton
public void setCancelButton(String buttonText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener)
Sets Cancel button text and `cancel` event listener. Makes Cancel button visible
Parameters:
buttonText
- the text inside Cancel buttoncancelListener
- the event listener for `cancel` event
-
setCancelButton
public void setCancelButton(String buttonText, ComponentEventListener<ConfirmDialog.CancelEvent> cancelListener, String theme)
Sets Cancel button text, `cancel` event listener and Cancel button theme. Makes Cancel button visible
Parameters:
buttonText
- the text inside Cancel buttoncancelListener
- the event listener for `cancel` eventtheme
- the theme applied for a Cancel button
-
setCancelButton
public void setCancelButton(Component component)
Sets custom cancel button
Parameters:
component
- the component to display instead of default Cancel button
-
setCancelButton
public void setCancelButton(Element element)
Sets custom cancel button
Parameters:
element
- the element to display instead of default Cancel button
-
setConfirmButton
public void setConfirmButton(String buttonText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener)
Sets Confirm button text and `confirm` event listener
Parameters:
buttonText
- the text inside Confirm buttonconfirmListener
- the event listener for `confirm` event
-
setConfirmButton
public void setConfirmButton(String buttonText, ComponentEventListener<ConfirmDialog.ConfirmEvent> confirmListener, String theme)
Sets Confirm button text, `confirm` event listener and Confirm button theme
Parameters:
buttonText
- the text inside Confirm buttonconfirmListener
- the event listener for `confirm` eventtheme
- the theme applied for a Confirm button
-
setConfirmButton
public void setConfirmButton(Component component)
Sets custom confirm button
Parameters:
component
- the element to display instead of default Confirm button
-
setConfirmButton
public void setConfirmButton(Element element)
Sets custom confirm button
Parameters:
element
- the element to display instead of default Confirm button
-
setText
public void setText(String message)
Sets confirmation message text
-
setText
public void setText(Component component)
Sets custom confirmation message element
Parameters:
component
- the component to display instead of default confirmation text node
-
setText
public void setText(Element element)
Sets custom confirmation message element
Parameters:
element
- the element to display instead of default confirmation text node
-
setConfirmText
public void setConfirmText(String confirmText)
Sets Confirm button text
-
setConfirmButtonTheme
public void setConfirmButtonTheme(String confirmTheme)
Sets Confirm button theme
-
addConfirmListener
public Registration addConfirmListener(ComponentEventListener<ConfirmDialog.ConfirmEvent> listener)
Adds `confirm` event listener
-
setCancelText
public void setCancelText(String cancelText)
Sets Cancel button text
-
setCancelButtonTheme
public void setCancelButtonTheme(String cancelTheme)
Sets Cancel button theme
-
addCancelListener
public Registration addCancelListener(ComponentEventListener<ConfirmDialog.CancelEvent> listener)
Adds `cancel` event listener
-
setRejectText
public void setRejectText(String rejectText)
Sets Reject button text
-
setRejectButtonTheme
public void setRejectButtonTheme(String rejectTheme)
Sets Reject button theme
-
addRejectListener
public Registration addRejectListener(ComponentEventListener<ConfirmDialog.RejectEvent> listener)
Adds `reject` event listener
-
setHeader
public void setHeader(String header)
Sets confirmation dialog header text
-
setHeader
public void setHeader(Component component)
Sets confirmation dialog custom header element
Parameters:
component
- the component to display instead of default header text
-
setHeader
public void setHeader(Element element)
Sets confirmation dialog custom header element
Parameters:
element
- the element to display instead of default header text
-
open
public void open()
Opens the dialog.
Note: You don't need to add the dialog component before opening it, cause 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.
-
isOpened
@Synchronize(property="opened", value="opened-changed") public boolean isOpened()
-
setOpened
public void setOpened(boolean opened)
Opens or closes the dialog.
Note: Confirm-dialog will be attached or detached from the DOM automatically, if it was not added manually.
Parameters:
opened
-true
to open the confirm-dialog,false
to close it
-
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
-
-