devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
765 lines (764 loc) • 28.8 kB
JavaScript
/**
* DevExtreme (esm/ui/drop_down_editor/ui.drop_down_editor.js)
* Version: 21.1.4
* Build date: Mon Jun 21 2021
*
* Copyright (c) 2012 - 2021 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import $ from "../../core/renderer";
import eventsEngine from "../../events/core/events_engine";
import Guid from "../../core/guid";
import registerComponent from "../../core/component_registrator";
import {
noop,
splitPair
} from "../../core/utils/common";
import {
focused
} from "../widget/selectors";
import {
each
} from "../../core/utils/iterator";
import {
isDefined
} from "../../core/utils/type";
import {
extend
} from "../../core/utils/extend";
import {
getPublicElement
} from "../../core/element";
import errors from "../widget/ui.errors";
import animationPosition from "../../animation/position";
import {
getDefaultAlignment
} from "../../core/utils/position";
import DropDownButton from "./ui.drop_down_button";
import Widget from "../widget/ui.widget";
import messageLocalization from "../../localization/message";
import {
addNamespace,
isCommandKeyPressed
} from "../../events/utils/index";
import TextBox from "../text_box";
import {
name as clickEventName
} from "../../events/click";
import devices from "../../core/devices";
import {
FunctionTemplate
} from "../../core/templates/function_template";
import Popup from "../popup";
import {
hasWindow
} from "../../core/utils/window";
import {
getElementWidth,
getSizeValue
} from "./utils";
var DROP_DOWN_EDITOR_CLASS = "dx-dropdowneditor";
var DROP_DOWN_EDITOR_INPUT_WRAPPER = "dx-dropdowneditor-input-wrapper";
var DROP_DOWN_EDITOR_BUTTON_ICON = "dx-dropdowneditor-icon";
var DROP_DOWN_EDITOR_OVERLAY = "dx-dropdowneditor-overlay";
var DROP_DOWN_EDITOR_OVERLAY_FLIPPED = "dx-dropdowneditor-overlay-flipped";
var DROP_DOWN_EDITOR_ACTIVE = "dx-dropdowneditor-active";
var DROP_DOWN_EDITOR_FIELD_CLICKABLE = "dx-dropdowneditor-field-clickable";
var DROP_DOWN_EDITOR_FIELD_TEMPLATE_WRAPPER = "dx-dropdowneditor-field-template-wrapper";
var isIOs = "ios" === devices.current().platform;
var DropDownEditor = TextBox.inherit({
_supportedKeys: function() {
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();
return true
},
upArrow: function(e) {
if (!isCommandKeyPressed(e)) {
e.preventDefault();
e.stopPropagation();
if (e.altKey) {
this.close();
return false
}
}
return true
},
downArrow: function(e) {
if (!isCommandKeyPressed(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
}
})
},
_getDefaultButtons: function() {
return this.callBase().concat([{
name: "dropDown",
Ctor: DropDownButton
}])
},
_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,
openOnFieldClick: false,
showDropDownButton: true,
buttons: void 0,
dropDownOptions: {
showTitle: false
},
popupPosition: this._getDefaultPopupPosition(),
onPopupInitialized: null,
applyButtonText: messageLocalization.format("OK"),
cancelButtonText: messageLocalization.format("Cancel"),
buttonsLocation: "default",
useHiddenSubmitElement: false
})
},
_useTemplates: function() {
return true
},
_getDefaultPopupPosition: function(isRtlEnabled) {
var position = getDefaultAlignment(isRtlEnabled);
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;
return isGeneric
},
options: {
popupPosition: {
offset: {
v: 0
}
}
}
}])
},
_inputWrapper: function() {
return this.$element().find("." + DROP_DOWN_EDITOR_INPUT_WRAPPER).first()
},
_init: function() {
this.callBase();
this._initVisibilityActions();
this._initPopupInitializedAction();
this._updatePopupPosition(this.option("rtlEnabled"));
this._options.cache("dropDownOptions", this.option("dropDownOptions"))
},
_updatePopupPosition: function(isRtlEnabled) {
var {
my: my,
at: at
} = this._getDefaultPopupPosition(isRtlEnabled);
var currentPosition = this.option("popupPosition");
this.option("popupPosition", extend({}, currentPosition, {
my: my,
at: at
}))
},
_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"]
})
},
_initMarkup: function() {
this._renderSubmitElement();
this.callBase();
this.$element().addClass(DROP_DOWN_EDITOR_CLASS);
this.setAria("role", "combobox")
},
_render: function() {
this.callBase();
this._renderOpenHandler();
this._attachFocusOutHandler();
this._renderOpenedState()
},
_renderContentImpl: function() {
if (!this.option("deferRendering")) {
this._createPopup()
}
},
_renderInput: function() {
this.callBase();
this._wrapInput();
this._setDefaultAria()
},
_wrapInput: function() {
this._$container = this.$element().wrapInner($("<div>").addClass(DROP_DOWN_EDITOR_INPUT_WRAPPER)).children().eq(0)
},
_setDefaultAria: function() {
this.setAria({
haspopup: "true",
autocomplete: "list"
})
},
_readOnlyPropValue: function() {
return !this._isEditable() || this.callBase()
},
_cleanFocusState: function() {
this.callBase();
if (this.option("fieldTemplate")) {
this._detachFocusEvents()
}
},
_getFieldTemplate: function() {
return this.option("fieldTemplate") && this._getTemplateByOption("fieldTemplate")
},
_renderMask: function() {
if (this.option("fieldTemplate")) {
return
}
this.callBase()
},
_renderField: function() {
var fieldTemplate = this._getFieldTemplate();
fieldTemplate && this._renderTemplatedField(fieldTemplate, this._fieldRenderData())
},
_renderPlaceholder: function() {
var hasFieldTemplate = !!this._getFieldTemplate();
if (!hasFieldTemplate) {
this.callBase()
}
},
_renderValue: function() {
if (this.option("useHiddenSubmitElement")) {
this._setSubmitValue()
}
var promise = this.callBase();
promise.always(this._renderField.bind(this))
},
_renderTemplatedField: function(fieldTemplate, data) {
var isFocused = focused(this._input());
var $container = this._$container;
this._detachKeyboardEvents();
this._refreshButtonsContainer();
this._detachWrapperContent();
this._detachFocusEvents();
$container.empty();
var $templateWrapper = $("<div>").addClass(DROP_DOWN_EDITOR_FIELD_TEMPLATE_WRAPPER).appendTo($container);
fieldTemplate.render({
model: data,
container: getPublicElement($templateWrapper),
onRendered: () => {
var $input = this._input();
if (!$input.length) {
throw errors.Error("E1010")
}
this._integrateInput();
isFocused && eventsEngine.trigger($input, "focus")
}
});
this._attachWrapperContent($container)
},
_detachWrapperContent() {
var _this$_$submitElement, _this$_$beforeButtons, _this$_$afterButtonsC;
var useHiddenSubmitElement = this.option("useHiddenSubmitElement");
useHiddenSubmitElement && (null === (_this$_$submitElement = this._$submitElement) || void 0 === _this$_$submitElement ? void 0 : _this$_$submitElement.detach());
var beforeButtonsContainerParent = null === (_this$_$beforeButtons = this._$beforeButtonsContainer) || void 0 === _this$_$beforeButtons ? void 0 : _this$_$beforeButtons[0].parentNode;
var afterButtonsContainerParent = null === (_this$_$afterButtonsC = this._$afterButtonsContainer) || void 0 === _this$_$afterButtonsC ? void 0 : _this$_$afterButtonsC[0].parentNode;
null === beforeButtonsContainerParent || void 0 === beforeButtonsContainerParent ? void 0 : beforeButtonsContainerParent.removeChild(this._$beforeButtonsContainer[0]);
null === afterButtonsContainerParent || void 0 === afterButtonsContainerParent ? void 0 : afterButtonsContainerParent.removeChild(this._$afterButtonsContainer[0])
},
_attachWrapperContent($container) {
var _this$_$submitElement2;
var useHiddenSubmitElement = this.option("useHiddenSubmitElement");
$container.prepend(this._$beforeButtonsContainer);
useHiddenSubmitElement && (null === (_this$_$submitElement2 = this._$submitElement) || void 0 === _this$_$submitElement2 ? void 0 : _this$_$submitElement2.appendTo($container));
$container.append(this._$afterButtonsContainer)
},
_refreshButtonsContainer() {
this._$buttonsContainer = this.$element().children().eq(0)
},
_integrateInput: function() {
this._refreshEvents();
this._refreshValueChangeEvent();
this._renderFocusState();
this._refreshEmptinessEvent()
},
_refreshEmptinessEvent: function() {
eventsEngine.off(this._input(), "input blur", this._toggleEmptinessEventHandler);
this._renderEmptinessEvent()
},
_fieldRenderData: function() {
return this.option("value")
},
_initTemplates: function() {
this._templateManager.addDefaultTemplates({
dropDownButton: new FunctionTemplate((function(options) {
var $icon = $("<div>").addClass(DROP_DOWN_EDITOR_BUTTON_ICON);
$(options.container).append($icon)
}))
});
this.callBase()
},
_renderOpenHandler: function() {
var $inputWrapper = this._inputWrapper();
var eventName = addNamespace(clickEventName, this.NAME);
var openOnFieldClick = this.option("openOnFieldClick");
eventsEngine.off($inputWrapper, eventName);
eventsEngine.on($inputWrapper, eventName, this._getInputClickHandler(openOnFieldClick));
this.$element().toggleClass(DROP_DOWN_EDITOR_FIELD_CLICKABLE, openOnFieldClick);
if (openOnFieldClick) {
this._openOnFieldClickAction = this._createAction(this._openHandler.bind(this))
}
},
_attachFocusOutHandler: function() {
if (isIOs) {
this._detachFocusOutEvents();
eventsEngine.on(this._inputWrapper(), addNamespace("focusout", this.NAME), event => {
var newTarget = event.relatedTarget;
var popupWrapper = this.content ? $(this.content()).closest("." + DROP_DOWN_EDITOR_OVERLAY) : this._$popup;
if (newTarget && this.option("opened")) {
var isNewTargetOutside = 0 === $(newTarget).closest("." + DROP_DOWN_EDITOR_OVERLAY, popupWrapper).length;
if (isNewTargetOutside) {
this.close()
}
}
})
}
},
_detachFocusOutEvents: function() {
isIOs && eventsEngine.off(this._inputWrapper(), addNamespace("focusout", this.NAME))
},
_getInputClickHandler: function(openOnFieldClick) {
return openOnFieldClick ? e => {
this._executeOpenAction(e)
} : e => {
this._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 (this.option("focusStateEnabled") && !focused(this._input())) {
this._resetCaretPosition();
eventsEngine.trigger(this._input(), "focus")
}
return true
},
_resetCaretPosition: function() {
var ignoreEditable = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : false;
var inputElement = this._input().get(0);
if (inputElement) {
var {
value: value
} = inputElement;
var caretPosition = isDefined(value) && (ignoreEditable || this._isEditable()) ? value.length : 0;
this._caret({
start: caretPosition,
end: caretPosition
}, true)
}
},
_isEditable: function() {
return this.option("acceptCustomValue")
},
_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
});
this.setAria("owns", opened ? this._popupContentId : void 0, this.$element())
},
_createPopup: function() {
if (this._$popup) {
return
}
this._$popup = $("<div>").addClass(DROP_DOWN_EDITOR_OVERLAY).appendTo(this.$element());
this._renderPopup();
this._renderPopupContent()
},
_renderPopupContent: noop,
_renderPopup: function() {
var popupConfig = extend(this._popupConfig(), this._options.cache("dropDownOptions"));
this._popup = this._createComponent(this._$popup, Popup, popupConfig);
this._popup.on({
showing: this._popupShowingHandler.bind(this),
shown: this._popupShownHandler.bind(this),
hiding: this._popupHidingHandler.bind(this),
hidden: this._popupHiddenHandler.bind(this),
contentReady: this._contentReadyHandler.bind(this)
});
this._contentReadyHandler();
this._setPopupContentId(this._popup.$content());
this._bindInnerWidgetOptions(this._popup, "dropDownOptions")
},
_setPopupContentId($popupContent) {
this._popupContentId = "dx-" + new Guid;
this.setAria("id", this._popupContentId, $popupContent)
},
_contentReadyHandler: noop,
_popupConfig: function() {
return {
onInitialized: this._popupInitializedHandler(),
position: extend(this.option("popupPosition"), {
of: this.$element()
}),
showTitle: this.option("dropDownOptions.showTitle"),
width: () => getElementWidth(this.$element()),
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,
dragEnabled: false,
toolbarItems: this._getPopupToolbarItems(),
onPositioned: this._popupPositionedHandler.bind(this),
fullScreen: false,
contentTemplate: null
}
},
_popupInitializedHandler: function() {
if (!this.option("onPopupInitialized")) {
return null
}
return e => {
this._popupInitializedAction({
popup: e.component
})
}
},
_dimensionChanged: function() {
var popupWidth = getSizeValue(this.option("dropDownOptions.width"));
if (void 0 === popupWidth) {
this._setPopupOption("width", () => getElementWidth(this.$element()))
}
},
_popupPositionedHandler: function(e) {
e.position && this._popup.$overlayContent().toggleClass(DROP_DOWN_EDITOR_OVERLAY_FLIPPED, e.position.v.flip)
},
_popupShowingHandler: noop,
_popupHidingHandler: function() {
this.option("opened", false)
},
_popupShownHandler: function() {
var _this$_validationMess;
this._openAction();
null === (_this$_validationMess = this._validationMessage) || void 0 === _this$_validationMess ? void 0 : _this$_validationMess.option("positionRequest", this._getValidationMessagePositionRequest())
},
_popupHiddenHandler: function() {
var _this$_validationMess2;
this._closeAction();
null === (_this$_validationMess2 = this._validationMessage) || void 0 === _this$_validationMess2 ? void 0 : _this$_validationMess2.option("positionRequest", this._getValidationMessagePositionRequest())
},
_getValidationMessagePositionRequest: function() {
var positionRequest = "below";
if (this._popup && this._popup.option("visible")) {
var {
top: myTop
} = animationPosition.setup(this.$element());
var {
top: popupTop
} = animationPosition.setup(this._popup.$content());
positionRequest = myTop + this.option("popupPosition").offset.v > popupTop ? "below" : "above"
}
return positionRequest
},
_closeOutsideDropDownHandler: function(_ref) {
var {
target: target
} = _ref;
var $target = $(target);
var dropDownButton = this.getButton("dropDown");
var $dropDownButton = dropDownButton && dropDownButton.$element();
var isInputClicked = !!$target.closest(this.$element()).length;
var isDropDownButtonClicked = !!$target.closest($dropDownButton).length;
var isOutsideClick = !isInputClicked && !isDropDownButtonClicked;
return isOutsideClick
},
_clean: function() {
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");
var resultConfig = buttonsConfig;
if ("default" !== buttonsLocation) {
var position = 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()
},
_popupOptionChanged: function(args) {
var options = Widget.getOptionsFromContainer(args);
this._setPopupOption(options);
var optionsKeys = Object.keys(options);
if (-1 !== optionsKeys.indexOf("width") || -1 !== optionsKeys.indexOf("height")) {
this._dimensionChanged()
}
},
_renderSubmitElement: function() {
if (this.option("useHiddenSubmitElement")) {
this._$submitElement = $("<input>").attr("type", "hidden").appendTo(this.$element())
}
},
_setSubmitValue: function() {
this._getSubmitElement().val(this.option("value"))
},
_getSubmitElement: function() {
if (this.option("useHiddenSubmitElement")) {
return this._$submitElement
} else {
return this.callBase()
}
},
_dispose: function() {
this._detachFocusOutEvents();
this.callBase()
},
_setDeprecatedOptions: function() {
this.callBase();
extend(this._deprecatedOptions, {
showPopupTitle: {
since: "20.1",
alias: "dropDownOptions.showTitle"
}
})
},
_optionChanged: function(args) {
var _this$_popup;
switch (args.name) {
case "width":
case "height":
this.callBase(args);
null === (_this$_popup = this._popup) || void 0 === _this$_popup ? void 0 : _this$_popup.repaint();
break;
case "opened":
this._renderOpenedState();
break;
case "onOpened":
case "onClosed":
this._initVisibilityActions();
break;
case "onPopupInitialized":
this._initPopupInitializedAction();
break;
case "fieldTemplate":
if (isDefined(args.value)) {
this._renderField()
} else {
this._invalidate()
}
break;
case "acceptCustomValue":
case "openOnFieldClick":
this._invalidate();
break;
case "dropDownButtonTemplate":
case "showDropDownButton":
this._updateButtons(["dropDown"]);
break;
case "dropDownOptions":
this._popupOptionChanged(args);
this._options.cache("dropDownOptions", this.option("dropDownOptions"));
break;
case "popupPosition":
break;
case "deferRendering":
if (hasWindow()) {
this._createPopup()
}
break;
case "applyValueMode":
case "applyButtonText":
case "cancelButtonText":
case "buttonsLocation":
this._setPopupOption("toolbarItems", this._getPopupToolbarItems());
break;
case "showPopupTitle":
this._setPopupOption("showTitle", args.value);
break;
case "useHiddenSubmitElement":
if (this._$submitElement) {
this._$submitElement.remove();
this._$submitElement = void 0
}
this._renderSubmitElement();
break;
case "rtlEnabled":
this._updatePopupPosition(args.value);
this.callBase(args);
break;
default:
this.callBase(args)
}
},
open: function() {
this.option("opened", true)
},
close: function() {
this.option("opened", false)
},
field: function() {
return getPublicElement(this._input())
},
content: function() {
return this._popup ? this._popup.content() : null
}
});
registerComponent("dxDropDownEditor", DropDownEditor);
export default DropDownEditor;