com.github.gwtbootstrap.client.ui.Modal Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of gwt-bootstrap Show documentation
Show all versions of gwt-bootstrap Show documentation
A GWT Library that provides the widgets of Twitter Bootstrap.
The newest version!
/*
* Copyright 2013 GWT-Bootstrap
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.github.gwtbootstrap.client.ui;
import com.github.gwtbootstrap.client.ui.base.DivWidget;
import com.github.gwtbootstrap.client.ui.base.HasVisibility;
import com.github.gwtbootstrap.client.ui.event.HasVisibleHandlers;
import com.github.gwtbootstrap.client.ui.base.IsAnimated;
import com.github.gwtbootstrap.client.ui.constants.BackdropType;
import com.github.gwtbootstrap.client.ui.constants.Constants;
import com.github.gwtbootstrap.client.ui.constants.DismissType;
import com.github.gwtbootstrap.client.ui.event.*;
import com.google.gwt.core.client.JavaScriptObject;
import com.google.gwt.dom.client.Element;
import com.google.gwt.dom.client.Style;
import com.google.gwt.event.shared.HandlerRegistration;
import com.google.gwt.user.client.DOM;
import com.google.gwt.user.client.Event;
import com.google.gwt.user.client.ui.PopupPanel;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.Widget;
import java.util.HashSet;
import java.util.Set;
//@formatter:off
/**
* Popup dialog with optional header and {@link ModalFooter footer.}
*
* By default, all other Modals are closed once a new one is opened. This
* setting can be {@link #setHideOthers(boolean) overridden.}
*
*
*
UiBinder Usage:
*
*
* {@code
*
* Modal Content!
*
* Save
*
*
* }
*
*
* All arguments are optional.
*
*
* @author Carlos Alexandro Becker
* @author Dominik Mayer
* @author Danilo Reinert
*
* @see Bootstrap
* documentation
* @see PopupPanel
*
* @since 2.0.4.0
*/
// @formatter:on
public class Modal extends DivWidget implements HasVisibility, HasVisibleHandlers, IsAnimated {
private static Set currentlyShown = new HashSet();
private final DivWidget header = new DivWidget();
private final DivWidget body = new DivWidget("modal-body");
private boolean keyboard = true;
private BackdropType backdropType = BackdropType.NORMAL;
private boolean show = false;
private boolean hideOthers = true;
private boolean configured = false;
private Close close = new Close(DismissType.MODAL);
private String title;
/**
* Creates an empty, hidden widget.
*/
public Modal() {
super("modal");
getElement().setAttribute("tabindex", "-1");
super.add(header);
super.add(body);
setVisible(false);
}
/**
* Creates an empty, hidden widget with specified show behavior.
*
* @param animated true if the widget should be animated.
*/
public Modal(boolean animated) {
this(animated, false);
}
/**
* Creates an empty, hidden widget with specified show behavior.
*
* @param animated true if the widget should be animated.
* @param dynamicSafe true removes from RootPanel when hidden
*/
public Modal(boolean animated,
boolean dynamicSafe) {
this();
setAnimation(animated);
setDynamicSafe(dynamicSafe);
}
/**
* Setup the modal to prevent memory leaks. When modal is hidden, will
* remove all event handlers, and them remove the modal DOM from document
* DOM.
*
* Default is false.
*
* @param dynamicSafe
*/
public void setDynamicSafe(boolean dynamicSafe) {
if (dynamicSafe) {
addHiddenHandler(new HiddenHandler() {
@Override
public void onHidden(HiddenEvent hiddenEvent) {
unsetHandlerFunctions(getElement());
Modal.this.removeFromParent();
}
});
}
}
/**
* Sets the title of the Modal.
*
* @param title the title of the Modal
*/
@Override
public void setTitle(String title) {
this.title = title;
header.clear();
if (title == null || title.isEmpty()) {
showHeader(false);
} else {
header.add(close);
header.add(new Heading(3, title));
showHeader(true);
}
}
/**
* Gets the title of the Modal.
*
* @return title
*/
public String getTitle() {
return title;
}
private void showHeader(boolean show) {
if (show)
header.setStyleName(Constants.MODAL_HEADER);
else
header.removeStyleName(Constants.MODAL_HEADER);
}
/**
* {@inheritDoc}
*/
public void setAnimation(boolean animated) {
if (animated)
addStyleName(Constants.FADE);
else
removeStyleName(Constants.FADE);
}
/**
* {@inheritDoc}
*/
public boolean getAnimation() {
return getStyleName().contains(Constants.FADE);
}
/**
* Sets whether this Modal appears on top of others or is the only one
* visible on screen.
*
* @param hideOthers true to make sure that this modal is the only one
* shown. All others will be hidden. Default: true
*/
public void setHideOthers(boolean hideOthers) {
this.hideOthers = hideOthers;
}
/**
* Sets whether the Modal is closed when the ESC is pressed.
*
* @param keyboard true if the Modal is closed by ESC
* key. Default: true
*/
public void setKeyboard(boolean keyboard) {
this.keyboard = keyboard;
reconfigure();
}
/**
* Get Keyboard enable state
*
* @return true:enable false:disable
*/
public boolean isKeyboardEnable() {
return this.keyboard;
}
/**
* Sets the type of the backdrop.
*
* @param type the backdrop type
*/
public void setBackdrop(BackdropType type) {
backdropType = type;
reconfigure();
}
/**
* Get backdrop type.
*
* @return backdrop type.
*/
public BackdropType getBackdropType() {
return this.backdropType;
}
/**
* Reconfigures the modal with changed settings.
*/
protected void reconfigure() {
if (configured) {
reconfigure(keyboard, backdropType, show);
}
}
/**
* {@inheritDoc}
*/
@Override
public void add(Widget w) {
if (w instanceof ModalFooter) {
super.add(w);
} else
body.add(w);
}
/**
* {@inheritDoc}
*/
@Override
public void insert(Widget w, int beforeIndex) {
body.insert(w, beforeIndex);
}
/**
* {@inheritDoc}
*/
public void show() {
checkAttachedOnShow();
changeVisibility("show");
// centerVertically(getElement()); Note: Doesn't work with Bootstrap 2.3.2
}
/**
* {@inheritDoc}
*/
public void show(boolean autoShow) {
checkAttachedOnShow();
changeVisibility("show", autoShow);
// centerVertically(getElement()); Note: Doesn't work with Bootstrap 2.3.2
}
private void checkAttachedOnShow() {
if (!this.isAttached()) {
RootPanel.get().add(this);
}
}
@Override
protected void onAttach() {
super.onAttach();
configure(keyboard, backdropType, show);
setHandlerFunctions(getElement());
configured = true;
}
/**
* {@inheritDoc}
*/
public void hide() {
changeVisibility("hide");
}
/**
* {@inheritDoc}
*/
public void hide(boolean autoHidden) {
changeVisibility("hide", autoHidden);
}
/**
* {@inheritDoc}
*/
public void toggle() {
changeVisibility("toggle");
}
/**
* {@inheritDoc}
*/
public void toggle(boolean autoToggle) {
changeVisibility("toggle", autoToggle);
}
private void changeVisibility(String visibility) {
changeVisibility(getElement(), visibility);
}
private void changeVisibility(String visibility, boolean autoTriggered) {
changeVisibility(getElement(), visibility, autoTriggered);
}
/**
* This method is called immediately when the widget's {@link #hide()}
* method is executed.
*/
protected void onHide(Event e) {
fireEvent(new HideEvent(e, getAutoTriggered(e)));
}
/**
* This method is called once the widget is completely hidden.
*/
protected void onHidden(Event e) {
fireEvent(new HiddenEvent(e, getAutoTriggered(e)));
currentlyShown.remove(this);
}
/**
* This method is called immediately when the widget's {@link #show()}
* method is executed.
*/
protected void onShow(Event e) {
if (hideOthers)
hideShownModals();
fireEvent(new ShowEvent(e, getAutoTriggered(e)));
}
private void hideShownModals() {
for (Modal m : currentlyShown) {
if (!m.equals(this)) {
m.hide(true);
}
}
}
/**
* This method is called once the widget is completely shown.
*/
protected void onShown(Event e) {
fireEvent(new ShownEvent(e, getAutoTriggered(e)));
currentlyShown.add(this);
}
private void reconfigure(boolean keyboard, BackdropType backdropType, boolean show) {
if (backdropType == BackdropType.NORMAL) {
reconfigure(getElement(), keyboard, true, show);
} else if (backdropType == BackdropType.NONE) {
reconfigure(getElement(), keyboard, false, show);
} else if (backdropType == BackdropType.STATIC) {
reconfigure(getElement(), keyboard, BackdropType.STATIC.get(), show);
}
}
private void configure(boolean keyboard, BackdropType backdropType, boolean show) {
if (backdropType == BackdropType.NORMAL) {
configure(getElement(), keyboard, true, show);
} else if (backdropType == BackdropType.NONE) {
configure(getElement(), keyboard, false, show);
} else if (backdropType == BackdropType.STATIC) {
configure(getElement(), keyboard, BackdropType.STATIC.get(), show);
}
}
//@formatter:off
private native void reconfigure(Element e, boolean k, boolean b, boolean s) /*-{
// Init vars
var $e = $wnd.jQuery(e);
var modal = $e.data('modal');
var wasShown = null;
// If element is modal, then unset it
if (modal) {
$e.removeData('modal');
wasShown = modal.isShown;
}
// Apply modal again to the element
$e.modal({
keyboard: k,
backdrop: b,
show: s
});
// If previous modal was shown, then reset it to current modal
if (wasShown) {
$e.data('modal').isShown = wasShown;
}
}-*/;
private native void reconfigure(Element e, boolean k, String b, boolean s) /*-{
// Init vars
var $e = $wnd.jQuery(e);
var modal = $e.data('modal');
var wasShown = null;
// If element is modal, then unset it
if (modal) {
$e.removeData('modal');
wasShown = modal.isShown;
}
// Apply modal again to the element
$e.modal({
keyboard: k,
backdrop: b,
show: s
});
// If previous modal was shown, then reset it to current modal
if (wasShown) {
$e.data('modal').isShown = wasShown;
}
}-*/;
private native void configure(Element e, boolean k, boolean b, boolean s) /*-{
$wnd.jQuery(e).modal({
keyboard: k,
backdrop: b,
show: s
});
}-*/;
private native void configure(Element e, boolean k, String b, boolean s) /*-{
$wnd.jQuery(e).modal({
keyboard: k,
backdrop: b,
show: s
});
}-*/;
private native void changeVisibility(Element e, String visibility) /*-{
$wnd.jQuery(e).modal(visibility);
}-*/;
private native void changeVisibility(Element e, String visibility, boolean autoTriggered) /*-{
var $e = $wnd.jQuery(e);
var modal = $e.data('modal');
if (modal)
modal.autoTriggered = autoTriggered;
$e.modal(visibility);
}-*/;
private native boolean getAutoTriggered(JavaScriptObject jso) /*-{
// Prevent null result
if (jso.autoTriggered) return true;
return false;
}-*/;
/**
* Links the Java functions that fire the events.
*/
private native void setHandlerFunctions(Element element) /*-{
var that = this;
var $el = $wnd.jQuery(element);
var autoTriggeredCheck = function (event, removeProperty) {
var modal = $wnd.jQuery(event.target).data('modal');
if (modal && modal.autoTriggered) {
event.autoTriggered = true;
if (removeProperty)
modal.autoTriggered = false;
}
};
$el.on('hide', function (e) {
if (e.target === this) {
autoTriggeredCheck(e);
[email protected]::onHide(Lcom/google/gwt/user/client/Event;)(e);
e.stopPropagation();
}
});
$el.on('hidden', function (e) {
if (e.target === this) {
autoTriggeredCheck(e, true);
[email protected]::onHidden(Lcom/google/gwt/user/client/Event;)(e);
e.stopPropagation();
}
});
$el.on('show', function (e) {
if (e.target === this) {
autoTriggeredCheck(e);
[email protected]::onShow(Lcom/google/gwt/user/client/Event;)(e);
e.stopPropagation();
}
});
$el.on('shown', function (e) {
if (e.target === this) {
autoTriggeredCheck(e, true);
[email protected]::onShown(Lcom/google/gwt/user/client/Event;)(e);
e.stopPropagation();
}
});
}-*/;
/**
* Unlinks all the Java functions that fire the events.
*/
private native void unsetHandlerFunctions(Element e) /*-{
var $e = $wnd.jQuery(e);
$e.off('hide');
$e.off('hidden');
$e.off('show');
$e.off('shown');
}-*/;
//@formatter:on
/**
* {@inheritDoc}
*/
public HandlerRegistration addHideHandler(HideHandler handler) {
return addHandler(handler, HideEvent.getType());
}
/**
* {@inheritDoc}
*/
public HandlerRegistration addHiddenHandler(HiddenHandler handler) {
return addHandler(handler, HiddenEvent.getType());
}
/**
* {@inheritDoc}
*/
public HandlerRegistration addShowHandler(ShowHandler handler) {
return addHandler(handler, ShowEvent.getType());
}
/**
* {@inheritDoc}
*/
public HandlerRegistration addShownHandler(ShownHandler handler) {
return addHandler(handler, ShownEvent.getType());
}
/**
* Show/Hide close button. The Modal must have a title.
*
* @param visible true for show and false to hide. Defaults is
* true.
*/
public void setCloseVisible(boolean visible) {
close.getElement().getStyle().setVisibility(visible
? Style.Visibility.VISIBLE
: Style.Visibility.HIDDEN);
}
/**
* @deprecated modal do not support setSize method
*/
@Override
public void setSize(String width, String height) {
throw new UnsupportedOperationException("modal do not support setSize method");
}
/**
* Sets the Modal's width.
*
* @param width Modal's new width, in px
*/
public void setWidth(int width) {
DOM.setStyleAttribute(this.getElement(), "width", width + "px");
DOM.setStyleAttribute(this.getElement(), "marginLeft", (-width / 2) + "px");
}
/**
* Sets the Modal's body maxHeight.
*
* @param maxHeight the Modal's body new maxHeight, in CSS units (e.g. "10px", "1em")
*/
public void setMaxHeigth(String maxHeight) {
DOM.setStyleAttribute(body.getElement(), "maxHeight", maxHeight);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy