devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
607 lines (606 loc) • 22.9 kB
JavaScript
/**
* DevExtreme (ui/drop_down_editor/ui.drop_down_editor.js)
* Version: 18.1.3
* Build date: Tue May 15 2018
*
* Copyright (c) 2012 - 2018 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
"use strict";
var $ = require("../../core/renderer"),
eventsEngine = require("../../events/core/events_engine"),
Guid = require("../../core/guid"),
registerComponent = require("../../core/component_registrator"),
commonUtils = require("../../core/utils/common"),
domUtils = require("../../core/utils/dom"),
focused = require("../widget/selectors").focused,
each = require("../../core/utils/iterator").each,
isDefined = require("../../core/utils/type").isDefined,
extend = require("../../core/utils/extend").extend,
getPublicElement = require("../../core/utils/dom").getPublicElement,
errors = require("../widget/ui.errors"),
positionUtils = require("../../animation/position"),
getDefaultAlignment = require("../../core/utils/position").getDefaultAlignment,
messageLocalization = require("../../localization/message"),
Button = require("../button"),
eventUtils = require("../../events/utils"),
TextBox = require("../text_box"),
clickEvent = require("../../events/click"),
FunctionTemplate = require("../widget/function_template"),
Popup = require("../popup");
var DROP_DOWN_EDITOR_CLASS = "dx-dropdowneditor",
DROP_DOWN_EDITOR_INPUT_WRAPPER_CLASS = "dx-dropdowneditor-input-wrapper",
DROP_DOWN_EDITOR_BUTTON_CLASS = "dx-dropdowneditor-button",
DROP_DOWN_EDITOR_BUTTON_ICON = "dx-dropdowneditor-icon",
DROP_DOWN_EDITOR_OVERLAY = "dx-dropdowneditor-overlay",
DROP_DOWN_EDITOR_OVERLAY_FLIPPED = "dx-dropdowneditor-overlay-flipped",
DROP_DOWN_EDITOR_ACTIVE = "dx-dropdowneditor-active",
DROP_DOWN_EDITOR_BUTTON_VISIBLE = "dx-dropdowneditor-button-visible",
DROP_DOWN_EDITOR_FIELD_CLICKABLE = "dx-dropdowneditor-field-clickable";
var DropDownEditor = TextBox.inherit({
_supportedKeys: function() {
var homeEndHandler = function(e) {
if (this.option("opened")) {
e.preventDefault();
return true
}
return false
};
return extend({}, this.callBase(), {
tab: function(e) {
if (!this.option("opened")) {
return
}
if ("instantly" === this.option("applyValueMode")) {
this.close();
return
}
var $focusableElement = e.shiftKey ? this._getLastPopupElement() : this._getFirstPopupElement();
$focusableElement && eventsEngine.trigger($focusableElement, "focus");
e.preventDefault()
},
escape: function(e) {
if (this.option("opened")) {
e.preventDefault()
}
this.close()
},
upArrow: function(e) {
e.preventDefault();
e.stopPropagation();
if (e.altKey) {
this.close();
return false
}
return true
},
downArrow: function(e) {
e.preventDefault();
e.stopPropagation();
if (e.altKey) {
this._validatedOpening();
return false
}
return true
},
enter: function(e) {
if (this.option("opened")) {
e.preventDefault();
this._valueChangeEventHandler(e)
}
return true
},
home: homeEndHandler,
end: homeEndHandler
})
},
_getDefaultOptions: function() {
return extend(this.callBase(), {
value: null,
onOpened: null,
onClosed: null,
opened: false,
acceptCustomValue: true,
applyValueMode: "instantly",
deferRendering: true,
activeStateEnabled: true,
dropDownButtonTemplate: "dropDownButton",
fieldTemplate: null,
contentTemplate: null,
openOnFieldClick: false,
showDropDownButton: true,
popupPosition: this._getDefaultPopupPosition(),
onPopupInitialized: null,
applyButtonText: messageLocalization.format("OK"),
cancelButtonText: messageLocalization.format("Cancel"),
buttonsLocation: "default",
showPopupTitle: false
})
},
_getDefaultPopupPosition: function() {
var position = getDefaultAlignment(this.option("rtlEnabled"));
return {
offset: {
h: 0,
v: -1
},
my: position + " top",
at: position + " bottom",
collision: "flip flip"
}
},
_defaultOptionsRules: function() {
return this.callBase().concat([{
device: function(_device) {
var isGeneric = "generic" === _device.platform,
isWin10 = "win" === _device.platform && _device.version && 10 === _device.version[0];
return isGeneric || isWin10
},
options: {
popupPosition: {
offset: {
v: 0
}
}
}
}])
},
_inputWrapper: function() {
return this.$element().find("." + DROP_DOWN_EDITOR_INPUT_WRAPPER_CLASS)
},
_init: function() {
this.callBase();
this._initVisibilityActions();
this._initPopupInitializedAction()
},
_initVisibilityActions: function() {
this._openAction = this._createActionByOption("onOpened", {
excludeValidators: ["disabled", "readOnly"]
});
this._closeAction = this._createActionByOption("onClosed", {
excludeValidators: ["disabled", "readOnly"]
})
},
_initPopupInitializedAction: function() {
this._popupInitializedAction = this._createActionByOption("onPopupInitialized", {
excludeValidators: ["disabled", "readOnly", "designMode"]
})
},
_initMarkup: function() {
this.callBase();
this.$element().addClass(DROP_DOWN_EDITOR_CLASS);
this.setAria("role", "combobox")
},
_render: function() {
this.callBase();
this._renderOpenHandler();
this._renderOpenedState()
},
_renderContentImpl: function() {
if (!this.option("deferRendering")) {
this._createPopup()
}
},
_renderInput: function() {
this.callBase();
this.$element().wrapInner($("<div>").addClass(DROP_DOWN_EDITOR_INPUT_WRAPPER_CLASS));
this._$container = this.$element().children().eq(0);
this.setAria({
haspopup: "true",
autocomplete: "list"
})
},
_readOnlyPropValue: function() {
return !this.option("acceptCustomValue") || this.callBase()
},
_cleanFocusState: function() {
this.callBase();
if (this.option("fieldTemplate")) {
eventsEngine.off(this._input(), "focusin focusout beforeactivate")
}
},
_renderField: function() {
var fieldTemplate = this._getTemplateByOption("fieldTemplate");
if (!(fieldTemplate && this.option("fieldTemplate"))) {
return
}
this._renderTemplatedField(fieldTemplate, this._fieldRenderData())
},
_renderTemplatedField: function(fieldTemplate, data) {
var isFocused = focused(this._input());
this._resetFocus(isFocused);
var $container = this._$container;
$container.empty();
this._$dropDownButton = null;
this._$clearButton = null;
fieldTemplate.render({
model: data,
container: domUtils.getPublicElement($container)
});
if (!this._input().length) {
throw errors.Error("E1010")
}
this._refreshEvents();
this._refreshValueChangeEvent();
this._renderFocusState();
isFocused && eventsEngine.trigger(this._input(), "focus")
},
_resetFocus: function(isFocused) {
this._cleanFocusState();
isFocused && eventsEngine.trigger(this._input(), "focusout")
},
_fieldRenderData: function() {
return this.option("value")
},
_renderInputAddons: function() {
this._renderField();
this.callBase();
this._renderDropDownButton()
},
_renderDropDownButton: function() {
if (this._$dropDownButton) {
this._$dropDownButton.remove();
this._$dropDownButton = null
}
var showDropDownButton = this.option("showDropDownButton");
this.$element().toggleClass(DROP_DOWN_EDITOR_BUTTON_VISIBLE, showDropDownButton);
if (!showDropDownButton) {
return
}
this._$dropDownButton = this._createDropDownButton();
this._attachDropDownButtonClickHandler()
},
_attachDropDownButtonClickHandler: function() {
if (this.option("showDropDownButton") && !this.option("openOnFieldClick")) {
this._$dropDownButton.dxButton("option", "onClick", this._openHandler.bind(this))
}
},
_initTemplates: function() {
this.callBase();
this._defaultTemplates.dropDownButton = new FunctionTemplate(function(options) {
var $icon = $("<div>").addClass(DROP_DOWN_EDITOR_BUTTON_ICON);
$(options.container).append($icon)
}, this)
},
_createDropDownButton: function() {
var $button = $("<div>").addClass(DROP_DOWN_EDITOR_BUTTON_CLASS).prependTo(this._buttonsContainer());
this._createComponent($button, Button, {
focusStateEnabled: false,
hoverStateEnabled: false,
activeStateEnabled: false,
disabled: this.option("readOnly"),
useInkRipple: false,
template: this._getTemplateByOption("dropDownButtonTemplate")
});
$button.removeClass("dx-button");
eventsEngine.on($button, "mousedown", function(e) {
e.preventDefault()
});
return $button
},
_renderOpenHandler: function() {
var that = this,
$inputWrapper = that._inputWrapper(),
eventName = eventUtils.addNamespace(clickEvent.name, that.NAME),
openOnFieldClick = that.option("openOnFieldClick");
eventsEngine.off($inputWrapper, eventName);
eventsEngine.on($inputWrapper, eventName, that._getInputClickHandler(openOnFieldClick));
that.$element().toggleClass(DROP_DOWN_EDITOR_FIELD_CLICKABLE, openOnFieldClick);
if (openOnFieldClick) {
that._openOnFieldClickAction = that._createAction(that._openHandler.bind(that))
}
},
_getInputClickHandler: function(openOnFieldClick) {
var that = this;
return openOnFieldClick ? function(e) {
that._executeOpenAction(e)
} : function(e) {
that._focusInput()
}
},
_openHandler: function() {
this._toggleOpenState()
},
_executeOpenAction: function(e) {
this._openOnFieldClickAction({
event: e
})
},
_keyboardEventBindingTarget: function() {
return this._input()
},
_focusInput: function() {
if (this.option("disabled")) {
return false
}
if (!focused(this._input())) {
eventsEngine.trigger(this._input(), "focus")
}
return true
},
_toggleOpenState: function(isVisible) {
if (!this._focusInput()) {
return
}
if (!this.option("readOnly")) {
isVisible = arguments.length ? isVisible : !this.option("opened");
this.option("opened", isVisible)
}
},
_renderOpenedState: function() {
var opened = this.option("opened");
if (opened) {
this._createPopup()
}
this.$element().toggleClass(DROP_DOWN_EDITOR_ACTIVE, opened);
this._setPopupOption("visible", opened);
this.setAria({
expanded: opened,
owns: (opened || void 0) && this._popupContentId
})
},
_createPopup: function() {
if (this._$popup) {
return
}
this._$popup = $("<div>").addClass(DROP_DOWN_EDITOR_OVERLAY).addClass(this.option("customOverlayCssClass")).appendTo(this.$element());
this._renderPopup();
this._renderPopupContent()
},
_renderPopup: function() {
this._popup = this._createComponent(this._$popup, Popup, this._popupConfig());
this._popup.on({
showing: this._popupShowingHandler.bind(this),
shown: this._popupShownHandler.bind(this),
hiding: this._popupHidingHandler.bind(this),
hidden: this._popupHiddenHandler.bind(this)
});
this._popup.option("onContentReady", this._contentReadyHandler.bind(this));
this._contentReadyHandler();
this._popupContentId = "dx-" + new Guid;
this.setAria("id", this._popupContentId, this._popup.$content())
},
_contentReadyHandler: commonUtils.noop,
_popupConfig: function() {
return {
onInitialized: this._popupInitializedHandler(),
position: extend(this.option("popupPosition"), { of: this.$element()
}),
showTitle: this.option("showPopupTitle"),
width: "auto",
height: "auto",
shading: false,
closeOnTargetScroll: true,
closeOnOutsideClick: this._closeOutsideDropDownHandler.bind(this),
animation: {
show: {
type: "fade",
duration: 0,
from: 0,
to: 1
},
hide: {
type: "fade",
duration: 400,
from: 1,
to: 0
}
},
deferRendering: false,
focusStateEnabled: false,
showCloseButton: false,
toolbarItems: this._getPopupToolbarItems(),
onPositioned: this._popupPositionedHandler.bind(this),
fullScreen: false
}
},
_popupInitializedHandler: function() {
if (!this.option("onPopupInitialized")) {
return
}
return function(e) {
this._popupInitializedAction({
popup: e.component
})
}.bind(this)
},
_popupPositionedHandler: function(e) {
e.position && this._popup.overlayContent().toggleClass(DROP_DOWN_EDITOR_OVERLAY_FLIPPED, e.position.v.flip)
},
_popupShowingHandler: commonUtils.noop,
_popupHidingHandler: function() {
this.option("opened", false)
},
_popupShownHandler: function() {
this._openAction();
if (this._$validationMessage) {
this._$validationMessage.dxOverlay("option", "position", this._getValidationMessagePosition())
}
},
_popupHiddenHandler: function() {
this._closeAction();
if (this._$validationMessage) {
this._$validationMessage.dxOverlay("option", "position", this._getValidationMessagePosition())
}
},
_getValidationMessagePosition: function() {
var positionRequest = "below";
if (this._popup && this._popup.option("visible")) {
var myTop = positionUtils.setup(this.$element()).top,
popupTop = positionUtils.setup(this._popup.$content()).top;
positionRequest = myTop + this.option("popupPosition").offset.v > popupTop ? "below" : "above"
}
return this.callBase(positionRequest)
},
_renderPopupContent: function() {
var contentTemplate = this._getTemplateByOption("contentTemplate");
if (!(contentTemplate && this.option("contentTemplate"))) {
return
}
var $popupContent = this._popup.$content(),
templateData = {
value: this._fieldRenderData(),
component: this
};
$popupContent.empty();
contentTemplate.render({
container: domUtils.getPublicElement($popupContent),
model: templateData
})
},
_closeOutsideDropDownHandler: function(e) {
var $target = $(e.target);
var isInputClicked = !!$target.closest(this.$element()).length;
var isDropDownButtonClicked = !!$target.closest(this._$dropDownButton).length;
var isOutsideClick = !isInputClicked && !isDropDownButtonClicked;
return isOutsideClick
},
_clean: function() {
delete this._$dropDownButton;
delete this._openOnFieldClickAction;
if (this._$popup) {
this._$popup.remove();
delete this._$popup;
delete this._popup
}
this.callBase()
},
_setPopupOption: function(optionName, value) {
this._setWidgetOption("_popup", arguments)
},
_validatedOpening: function() {
if (!this.option("readOnly")) {
this._toggleOpenState(true)
}
},
_getPopupToolbarItems: function() {
return "useButtons" === this.option("applyValueMode") ? this._popupToolbarItemsConfig() : []
},
_getFirstPopupElement: function() {
return this._popup._wrapper().find(".dx-popup-done.dx-button")
},
_getLastPopupElement: function() {
return this._popup._wrapper().find(".dx-popup-cancel.dx-button")
},
_popupElementTabHandler: function(e) {
var $element = $(e.currentTarget);
if (e.shiftKey && $element.is(this._getFirstPopupElement()) || !e.shiftKey && $element.is(this._getLastPopupElement())) {
eventsEngine.trigger(this._input(), "focus");
e.preventDefault()
}
},
_popupElementEscHandler: function() {
eventsEngine.trigger(this._input(), "focus");
this.close()
},
_popupButtonInitializedHandler: function(e) {
e.component.registerKeyHandler("tab", this._popupElementTabHandler.bind(this));
e.component.registerKeyHandler("escape", this._popupElementEscHandler.bind(this))
},
_popupToolbarItemsConfig: function() {
var buttonsConfig = [{
shortcut: "done",
options: {
onClick: this._applyButtonHandler.bind(this),
text: this.option("applyButtonText"),
onInitialized: this._popupButtonInitializedHandler.bind(this)
}
}, {
shortcut: "cancel",
options: {
onClick: this._cancelButtonHandler.bind(this),
text: this.option("cancelButtonText"),
onInitialized: this._popupButtonInitializedHandler.bind(this)
}
}];
return this._applyButtonsLocation(buttonsConfig)
},
_applyButtonsLocation: function(buttonsConfig) {
var buttonsLocation = this.option("buttonsLocation"),
resultConfig = buttonsConfig;
if ("default" !== buttonsLocation) {
var position = commonUtils.splitPair(buttonsLocation);
each(resultConfig, function(_, element) {
extend(element, {
toolbar: position[0],
location: position[1]
})
})
}
return resultConfig
},
_applyButtonHandler: function() {
this.close();
this.option("focusStateEnabled") && this.focus()
},
_cancelButtonHandler: function() {
this.close();
this.option("focusStateEnabled") && this.focus()
},
_toggleReadOnlyState: function() {
this.callBase();
this._$dropDownButton && this._$dropDownButton.dxButton("option", "disabled", this.option("readOnly"))
},
_optionChanged: function(args) {
switch (args.name) {
case "opened":
this._renderOpenedState();
break;
case "onOpened":
case "onClosed":
this._initVisibilityActions();
break;
case "onPopupInitialized":
this._initPopupInitializedAction();
break;
case "fieldTemplate":
if (isDefined(args.value)) {
this._renderInputAddons()
} else {
this._invalidate()
}
break;
case "showDropDownButton":
case "contentTemplate":
case "acceptCustomValue":
case "openOnFieldClick":
this._invalidate();
break;
case "dropDownButtonTemplate":
this._renderDropDownButton();
break;
case "popupPosition":
case "deferRendering":
break;
case "applyValueMode":
case "applyButtonText":
case "cancelButtonText":
case "buttonsLocation":
this._setPopupOption("toolbarItems", this._getPopupToolbarItems());
break;
case "showPopupTitle":
this._setPopupOption("showTitle", args.value);
break;
default:
this.callBase(args)
}
},
open: function() {
this.option("opened", true)
},
close: function() {
this.option("opened", false)
},
reset: function() {
this.option("value", null);
this._input().val("")
},
field: function() {
return getPublicElement(this._input())
},
content: function() {
return this._popup ? this._popup.content() : null
}
});
registerComponent("dxDropDownEditor", DropDownEditor);
module.exports = DropDownEditor;