devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
1,169 lines (1,168 loc) • 49 kB
JavaScript
/**
* DevExtreme (esm/ui/form/ui.form.js)
* Version: 23.2.6
* Build date: Wed May 01 2024
*
* Copyright (c) 2012 - 2024 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import _extends from "@babel/runtime/helpers/esm/extends";
import $ from "../../core/renderer";
import eventsEngine from "../../events/core/events_engine";
import registerComponent from "../../core/component_registrator";
import Guid from "../../core/guid";
import {
ensureDefined
} from "../../core/utils/common";
import config from "../../core/config";
import {
isDefined,
isEmptyObject,
isObject,
isString
} from "../../core/utils/type";
import {
each
} from "../../core/utils/iterator";
import {
extend
} from "../../core/utils/extend";
import {
triggerResizeEvent,
triggerShownEvent
} from "../../events/visibility_change";
import {
getPublicElement
} from "../../core/element";
import messageLocalization from "../../localization/message";
import Widget from "../widget/ui.widget";
import Editor from "../editor/editor";
import {
defaultScreenFactorFunc,
getCurrentScreenFactor,
hasWindow
} from "../../core/utils/window";
import ValidationEngine from "../validation_engine";
import {
default as FormItemsRunTimeInfo
} from "./ui.form.items_runtime_info";
import TabPanel from "../tab_panel";
import Scrollable from "../scroll_view/ui.scrollable";
import {
Deferred
} from "../../core/utils/deferred";
import {
isMaterialBased,
isMaterial
} from "../themes";
import tryCreateItemOptionAction from "./ui.form.item_options_actions";
import resizeObserverSingleton from "../../core/resize_observer";
import "./ui.form.layout_manager";
import {
concatPaths,
createItemPathByIndex,
getFullOptionName,
getOptionNameFromFullName,
tryGetTabPath,
getTextWithoutSpaces,
isEqualToDataFieldOrNameOrTitleOrCaption,
isFullPathContainsTabs,
getItemPath,
convertToLayoutManagerOptions
} from "./ui.form.utils";
import {
convertToLabelMarkOptions
} from "./ui.form.layout_manager.utils";
import {
setLabelWidthByMaxLabelWidth
} from "./components/label";
import "../validation_summary";
import "../validation_group";
import {
FORM_CLASS,
FIELD_ITEM_CLASS,
FORM_GROUP_CLASS,
FORM_GROUP_CONTENT_CLASS,
FIELD_ITEM_CONTENT_HAS_GROUP_CLASS,
FIELD_ITEM_CONTENT_HAS_TABS_CLASS,
FORM_GROUP_WITH_CAPTION_CLASS,
FORM_GROUP_CAPTION_CLASS,
FIELD_ITEM_TAB_CLASS,
FORM_FIELD_ITEM_COL_CLASS,
GROUP_COL_COUNT_CLASS,
GROUP_COL_COUNT_ATTR,
FIELD_ITEM_CONTENT_CLASS,
FORM_VALIDATION_SUMMARY,
ROOT_SIMPLE_ITEM_CLASS,
FORM_UNDERLINED_CLASS
} from "./constants";
import {
TOOLBAR_CLASS
} from "../toolbar/constants";
var FOCUSED_STATE_CLASS = "dx-state-focused";
var ITEM_OPTIONS_FOR_VALIDATION_UPDATING = ["items", "isRequired", "validationRules", "visible"];
var Form = Widget.inherit({
_init: function() {
this.callBase();
this._dirtyFields = new Set;
this._cachedColCountOptions = [];
this._itemsRunTimeInfo = new FormItemsRunTimeInfo;
this._groupsColCount = [];
this._attachSyncSubscriptions()
},
_getDefaultOptions: function() {
return extend(this.callBase(), {
formID: "dx-" + new Guid,
formData: {},
colCount: 1,
screenByWidth: defaultScreenFactorFunc,
colCountByScreen: void 0,
labelLocation: "left",
readOnly: false,
onFieldDataChanged: null,
customizeItem: null,
onEditorEnterKey: null,
minColWidth: 200,
alignItemLabels: true,
alignItemLabelsInAllGroups: true,
alignRootItemLabels: true,
showColonAfterLabel: true,
showRequiredMark: true,
showOptionalMark: false,
requiredMark: "*",
optionalMark: messageLocalization.format("dxForm-optionalMark"),
requiredMessage: messageLocalization.getFormatter("dxForm-requiredMessage"),
showValidationSummary: false,
items: void 0,
scrollingEnabled: false,
validationGroup: void 0,
stylingMode: config().editorStylingMode,
labelMode: "outside",
isDirty: false
})
},
_defaultOptionsRules: function() {
return this.callBase().concat([{
device: function() {
return isMaterialBased()
},
options: {
labelLocation: "top"
}
}, {
device: function() {
return isMaterial()
},
options: {
showColonAfterLabel: false
}
}])
},
_setOptionsByReference: function() {
this.callBase();
extend(this._optionsByReference, {
formData: true,
validationGroup: true
})
},
_getGroupColCount: function($element) {
return parseInt($element.attr(GROUP_COL_COUNT_ATTR))
},
_applyLabelsWidthByCol: function($container, index) {
var options = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : {};
var labelMarkOptions = arguments.length > 3 ? arguments[3] : void 0;
var fieldItemClass = options.inOneColumn ? FIELD_ITEM_CLASS : FORM_FIELD_ITEM_COL_CLASS + index;
var cssExcludeTabbedSelector = options.excludeTabbed ? ":not(.".concat(FIELD_ITEM_TAB_CLASS, ")") : "";
setLabelWidthByMaxLabelWidth($container, ".".concat(fieldItemClass).concat(cssExcludeTabbedSelector), labelMarkOptions);
return
},
_applyLabelsWidth: function($container, excludeTabbed, inOneColumn, colCount, labelMarkOptions) {
colCount = inOneColumn ? 1 : colCount || this._getGroupColCount($container);
var applyLabelsOptions = {
excludeTabbed: excludeTabbed,
inOneColumn: inOneColumn
};
var i;
for (i = 0; i < colCount; i++) {
this._applyLabelsWidthByCol($container, i, applyLabelsOptions, labelMarkOptions)
}
},
_getGroupElementsInColumn: function($container, columnIndex, colCount) {
var cssColCountSelector = isDefined(colCount) ? "." + GROUP_COL_COUNT_CLASS + colCount : "";
var groupSelector = "." + FORM_FIELD_ITEM_COL_CLASS + columnIndex + " > ." + FIELD_ITEM_CONTENT_CLASS + " > ." + FORM_GROUP_CLASS + cssColCountSelector;
return $container.find(groupSelector)
},
_applyLabelsWidthWithGroups: function($container, colCount, excludeTabbed, labelMarkOptions) {
if (true === this.option("alignRootItemLabels")) {
var $rootSimpleItems = $container.find(".".concat(ROOT_SIMPLE_ITEM_CLASS));
for (var colIndex = 0; colIndex < colCount; colIndex++) {
this._applyLabelsWidthByCol($rootSimpleItems, colIndex, excludeTabbed, labelMarkOptions)
}
}
var alignItemLabelsInAllGroups = this.option("alignItemLabelsInAllGroups");
if (alignItemLabelsInAllGroups) {
this._applyLabelsWidthWithNestedGroups($container, colCount, excludeTabbed, labelMarkOptions)
} else {
var $groups = this.$element().find("." + FORM_GROUP_CLASS);
var i;
for (i = 0; i < $groups.length; i++) {
this._applyLabelsWidth($groups.eq(i), excludeTabbed, void 0, void 0, labelMarkOptions)
}
}
},
_applyLabelsWidthWithNestedGroups: function($container, colCount, excludeTabbed, labelMarkOptions) {
var applyLabelsOptions = {
excludeTabbed: excludeTabbed
};
var colIndex;
var groupsColIndex;
var groupColIndex;
var $groupsByCol;
for (colIndex = 0; colIndex < colCount; colIndex++) {
$groupsByCol = this._getGroupElementsInColumn($container, colIndex);
this._applyLabelsWidthByCol($groupsByCol, 0, applyLabelsOptions, labelMarkOptions);
for (groupsColIndex = 0; groupsColIndex < this._groupsColCount.length; groupsColIndex++) {
$groupsByCol = this._getGroupElementsInColumn($container, colIndex, this._groupsColCount[groupsColIndex]);
var groupColCount = this._getGroupColCount($groupsByCol);
for (groupColIndex = 1; groupColIndex < groupColCount; groupColIndex++) {
this._applyLabelsWidthByCol($groupsByCol, groupColIndex, applyLabelsOptions, labelMarkOptions)
}
}
}
},
_labelLocation: function() {
return this.option("labelLocation")
},
_alignLabelsInColumn: function(_ref) {
var {
layoutManager: layoutManager,
inOneColumn: inOneColumn,
$container: $container,
excludeTabbed: excludeTabbed,
items: items
} = _ref;
if (!hasWindow() || "top" === this._labelLocation()) {
return
}
var labelMarkOptions = convertToLabelMarkOptions(layoutManager._getMarkOptions());
if (inOneColumn) {
this._applyLabelsWidth($container, excludeTabbed, true, void 0, labelMarkOptions)
} else if (this._checkGrouping(items)) {
this._applyLabelsWidthWithGroups($container, layoutManager._getColCount(), excludeTabbed, labelMarkOptions)
} else {
this._applyLabelsWidth($container, excludeTabbed, false, layoutManager._getColCount(), labelMarkOptions)
}
},
_prepareFormData: function() {
if (!isDefined(this.option("formData"))) {
this.option("formData", {})
}
},
_setStylingModeClass: function() {
if ("underlined" === this.option("stylingMode")) {
this.$element().addClass(FORM_UNDERLINED_CLASS)
}
},
_initMarkup: function() {
ValidationEngine.addGroup(this._getValidationGroup());
this._clearCachedInstances();
this._prepareFormData();
this.$element().addClass(FORM_CLASS);
this._setStylingModeClass();
this.callBase();
this.setAria("role", "form", this.$element());
if (this.option("scrollingEnabled")) {
this._renderScrollable()
}
this._renderLayout();
this._renderValidationSummary();
this._lastMarkupScreenFactor = this._targetScreenFactor || this._getCurrentScreenFactor();
this._attachResizeObserverSubscription()
},
_attachResizeObserverSubscription: function() {
if (hasWindow()) {
var formRootElement = this.$element().get(0);
resizeObserverSingleton.unobserve(formRootElement);
resizeObserverSingleton.observe(formRootElement, () => {
this._resizeHandler()
})
}
},
_resizeHandler: function() {
if (this._cachedLayoutManagers.length) {
each(this._cachedLayoutManagers, (_, layoutManager) => {
var _layoutManager$option;
null === (_layoutManager$option = layoutManager.option("onLayoutChanged")) || void 0 === _layoutManager$option ? void 0 : _layoutManager$option(layoutManager.isSingleColumnMode())
})
}
},
_getCurrentScreenFactor: function() {
return hasWindow() ? getCurrentScreenFactor(this.option("screenByWidth")) : "lg"
},
_clearCachedInstances: function() {
this._itemsRunTimeInfo.clear();
this._cachedLayoutManagers = []
},
_alignLabels: function(layoutManager, inOneColumn) {
this._alignLabelsInColumn({
$container: this.$element(),
layoutManager: layoutManager,
excludeTabbed: true,
items: this.option("items"),
inOneColumn: inOneColumn
});
triggerResizeEvent(this.$element().find(".".concat(TOOLBAR_CLASS)))
},
_clean: function() {
this._clearValidationSummary();
this.callBase();
this._groupsColCount = [];
this._cachedColCountOptions = [];
this._lastMarkupScreenFactor = void 0;
resizeObserverSingleton.unobserve(this.$element().get(0))
},
_renderScrollable: function() {
var useNativeScrolling = this.option("useNativeScrolling");
this._scrollable = new Scrollable(this.$element(), {
useNative: !!useNativeScrolling,
useSimulatedScrollbar: !useNativeScrolling,
useKeyboard: false,
direction: "both",
bounceEnabled: false
})
},
_getContent: function() {
return this.option("scrollingEnabled") ? $(this._scrollable.content()) : this.$element()
},
_clearValidationSummary: function() {
var _this$_$validationSum;
null === (_this$_$validationSum = this._$validationSummary) || void 0 === _this$_$validationSum ? void 0 : _this$_$validationSum.remove();
this._$validationSummary = void 0;
this._validationSummary = void 0
},
_renderValidationSummary: function() {
this._clearValidationSummary();
if (this.option("showValidationSummary")) {
this._$validationSummary = $("<div>").addClass(FORM_VALIDATION_SUMMARY).appendTo(this._getContent());
this._validationSummary = this._$validationSummary.dxValidationSummary({
validationGroup: this._getValidationGroup()
}).dxValidationSummary("instance")
}
},
_prepareItems(items, parentIsTabbedItem, currentPath, isTabs) {
if (items) {
var result = [];
for (var i = 0; i < items.length; i++) {
var item = items[i];
var path = concatPaths(currentPath, createItemPathByIndex(i, isTabs));
var itemRunTimeInfo = {
item: item,
itemIndex: i,
path: path
};
var guid = this._itemsRunTimeInfo.add(itemRunTimeInfo);
if (isString(item)) {
item = {
dataField: item
}
}
if (isObject(item)) {
var preparedItem = _extends({}, item);
itemRunTimeInfo.preparedItem = preparedItem;
preparedItem.guid = guid;
this._tryPrepareGroupItem(preparedItem);
this._tryPrepareTabbedItem(preparedItem, path);
this._tryPrepareItemTemplate(preparedItem);
if (parentIsTabbedItem) {
preparedItem.cssItemClass = FIELD_ITEM_TAB_CLASS
}
if (preparedItem.items) {
preparedItem.items = this._prepareItems(preparedItem.items, parentIsTabbedItem, path)
}
result.push(preparedItem)
} else {
result.push(item)
}
}
return result
}
},
_tryPrepareGroupItem: function(item) {
if ("group" === item.itemType) {
item.alignItemLabels = ensureDefined(item.alignItemLabels, true);
item._prepareGroupItemTemplate = itemTemplate => {
if (item.template) {
item.groupContentTemplate = this._getTemplate(itemTemplate)
}
item.template = this._itemGroupTemplate.bind(this, item)
};
item._prepareGroupItemTemplate(item.template)
}
},
_tryPrepareTabbedItem: function(item, path) {
if ("tabbed" === item.itemType) {
item.template = this._itemTabbedTemplate.bind(this, item);
item.tabs = this._prepareItems(item.tabs, true, path, true)
}
},
_tryPrepareItemTemplate: function(item) {
if (item.template) {
item.template = this._getTemplate(item.template)
}
},
_checkGrouping: function(items) {
if (items) {
for (var i = 0; i < items.length; i++) {
var item = items[i];
if ("group" === item.itemType) {
return true
}
}
}
},
_renderLayout: function() {
var that = this;
var items = that.option("items");
var $content = that._getContent();
items = that._prepareItems(items);
that._rootLayoutManager = that._renderLayoutManager($content, this._createLayoutManagerOptions(items, {
isRoot: true,
colCount: that.option("colCount"),
alignItemLabels: that.option("alignItemLabels"),
screenByWidth: this.option("screenByWidth"),
colCountByScreen: this.option("colCountByScreen"),
onLayoutChanged: function(inOneColumn) {
that._alignLabels.bind(that)(that._rootLayoutManager, inOneColumn)
},
onContentReady: function(e) {
that._alignLabels(e.component, e.component.isSingleColumnMode())
}
}))
},
_tryGetItemsForTemplate: function(item) {
return item.items || []
},
_itemTabbedTemplate: function(item, e, $container) {
var _item$tabs;
var $tabPanel = $("<div>").appendTo($container);
var tabPanelOptions = extend({}, item.tabPanelOptions, {
dataSource: item.tabs,
onItemRendered: args => {
var _item$tabPanelOptions, _item$tabPanelOptions2;
null === (_item$tabPanelOptions = item.tabPanelOptions) || void 0 === _item$tabPanelOptions ? void 0 : null === (_item$tabPanelOptions2 = _item$tabPanelOptions.onItemRendered) || void 0 === _item$tabPanelOptions2 ? void 0 : _item$tabPanelOptions2.call(_item$tabPanelOptions, args);
triggerShownEvent(args.itemElement)
},
itemTemplate: (itemData, e, container) => {
var $container = $(container);
var alignItemLabels = ensureDefined(itemData.alignItemLabels, true);
var layoutManager = this._renderLayoutManager($container, this._createLayoutManagerOptions(this._tryGetItemsForTemplate(itemData), {
colCount: itemData.colCount,
alignItemLabels: alignItemLabels,
screenByWidth: this.option("screenByWidth"),
colCountByScreen: itemData.colCountByScreen,
cssItemClass: itemData.cssItemClass,
onLayoutChanged: inOneColumn => {
this._alignLabelsInColumn({
$container: $container,
layoutManager: layoutManager,
items: itemData.items,
inOneColumn: inOneColumn
})
}
}));
if (this._itemsRunTimeInfo) {
this._itemsRunTimeInfo.extendRunTimeItemInfoByKey(itemData.guid, {
layoutManager: layoutManager
})
}
if (alignItemLabels) {
this._alignLabelsInColumn({
$container: $container,
layoutManager: layoutManager,
items: itemData.items,
inOneColumn: layoutManager.isSingleColumnMode()
})
}
}
});
var tryUpdateTabPanelInstance = (items, instance) => {
if (Array.isArray(items)) {
items.forEach(item => this._itemsRunTimeInfo.extendRunTimeItemInfoByKey(item.guid, {
widgetInstance: instance
}))
}
};
var tabPanel = this._createComponent($tabPanel, TabPanel, tabPanelOptions);
$($container).parent().addClass(FIELD_ITEM_CONTENT_HAS_TABS_CLASS);
tabPanel.on("optionChanged", e => {
if ("dataSource" === e.fullName) {
tryUpdateTabPanelInstance(e.value, e.component)
}
});
tryUpdateTabPanelInstance([{
guid: item.guid
}, ...null !== (_item$tabs = item.tabs) && void 0 !== _item$tabs ? _item$tabs : []], tabPanel)
},
_itemGroupTemplate: function(item, options, $container) {
var id = options.editorOptions.inputAttr.id;
var $group = $("<div>").toggleClass(FORM_GROUP_WITH_CAPTION_CLASS, isDefined(item.caption) && item.caption.length).addClass(FORM_GROUP_CLASS).appendTo($container);
var groupAria = {
role: "group",
labelledby: id
};
this.setAria(groupAria, $group);
$($container).parent().addClass(FIELD_ITEM_CONTENT_HAS_GROUP_CLASS);
if (item.caption) {
$("<span>").addClass(FORM_GROUP_CAPTION_CLASS).text(item.caption).attr("id", id).appendTo($group)
}
var $groupContent = $("<div>").addClass(FORM_GROUP_CONTENT_CLASS).appendTo($group);
if (item.groupContentTemplate) {
item._renderGroupContentTemplate = () => {
$groupContent.empty();
var data = {
formData: this.option("formData"),
component: this
};
item.groupContentTemplate.render({
model: data,
container: getPublicElement($groupContent)
})
};
item._renderGroupContentTemplate()
} else {
var layoutManager = this._renderLayoutManager($groupContent, this._createLayoutManagerOptions(this._tryGetItemsForTemplate(item), {
colCount: item.colCount,
colCountByScreen: item.colCountByScreen,
alignItemLabels: item.alignItemLabels,
cssItemClass: item.cssItemClass
}));
this._itemsRunTimeInfo && this._itemsRunTimeInfo.extendRunTimeItemInfoByKey(item.guid, {
layoutManager: layoutManager
});
var colCount = layoutManager._getColCount();
if (!this._groupsColCount.includes(colCount)) {
this._groupsColCount.push(colCount)
}
$group.addClass(GROUP_COL_COUNT_CLASS + colCount);
$group.attr(GROUP_COL_COUNT_ATTR, colCount)
}
},
_createLayoutManagerOptions: function(items, extendedLayoutManagerOptions) {
return convertToLayoutManagerOptions({
form: this,
formOptions: this.option(),
$formElement: this.$element(),
items: items,
validationGroup: this._getValidationGroup(),
extendedLayoutManagerOptions: extendedLayoutManagerOptions,
onFieldDataChanged: args => {
if (!this._isDataUpdating) {
this._triggerOnFieldDataChanged(args)
}
},
onContentReady: args => {
this._itemsRunTimeInfo.addItemsOrExtendFrom(args.component._itemsRunTimeInfo);
extendedLayoutManagerOptions.onContentReady && extendedLayoutManagerOptions.onContentReady(args)
},
onDisposing: _ref2 => {
var {
component: component
} = _ref2;
var nestedItemsRunTimeInfo = component.getItemsRunTimeInfo();
this._itemsRunTimeInfo.removeItemsByItems(nestedItemsRunTimeInfo)
},
onFieldItemRendered: () => {
var _this$_validationSumm;
null === (_this$_validationSumm = this._validationSummary) || void 0 === _this$_validationSumm ? void 0 : _this$_validationSumm.refreshValidationGroup()
}
})
},
_renderLayoutManager: function($parent, layoutManagerOptions) {
var baseColCountByScreen = {
lg: layoutManagerOptions.colCount,
md: layoutManagerOptions.colCount,
sm: layoutManagerOptions.colCount,
xs: 1
};
this._cachedColCountOptions.push({
colCountByScreen: extend(baseColCountByScreen, layoutManagerOptions.colCountByScreen)
});
var $element = $("<div>");
$element.appendTo($parent);
var instance = this._createComponent($element, "dxLayoutManager", layoutManagerOptions);
instance.on("autoColCountChanged", () => {
this._clearAutoColCountChangedTimeout();
this.autoColCountChangedTimeoutId = setTimeout(() => !this._disposed && this._refresh(), 0)
});
this._cachedLayoutManagers.push(instance);
return instance
},
_getValidationGroup: function() {
return this.option("validationGroup") || this
},
_createComponent: function($element, type, config) {
config = config || {};
this._extendConfig(config, {
readOnly: this.option("readOnly")
});
return this.callBase($element, type, config)
},
_attachSyncSubscriptions: function() {
var that = this;
that.on("optionChanged", (function(args) {
var optionFullName = args.fullName;
if ("formData" === optionFullName) {
if (!isDefined(args.value)) {
that._options.silent("formData", args.value = {})
}
that._triggerOnFieldDataChangedByDataSet(args.value)
}
if (that._cachedLayoutManagers.length) {
each(that._cachedLayoutManagers, (function(index, layoutManager) {
if ("formData" === optionFullName) {
that._isDataUpdating = true;
layoutManager.option("layoutData", args.value);
that._isDataUpdating = false
}
if ("readOnly" === args.name || "disabled" === args.name) {
layoutManager.option(optionFullName, args.value)
}
}))
}
}))
},
_optionChanged: function(args) {
var splitFullName = args.fullName.split(".");
if (splitFullName.length > 1 && -1 !== splitFullName[0].search("items") && this._itemsOptionChangedHandler(args)) {
return
}
if (splitFullName.length > 1 && -1 !== splitFullName[0].search("formData") && this._formDataOptionChangedHandler(args)) {
return
}
this._defaultOptionChangedHandler(args)
},
_defaultOptionChangedHandler: function(args) {
switch (args.name) {
case "formData":
if (!this.option("items")) {
this._invalidate()
} else if (isEmptyObject(args.value)) {
this._clear()
}
break;
case "onFieldDataChanged":
break;
case "items":
case "colCount":
case "onEditorEnterKey":
case "labelLocation":
case "labelMode":
case "alignItemLabels":
case "showColonAfterLabel":
case "customizeItem":
case "alignItemLabelsInAllGroups":
case "showRequiredMark":
case "showOptionalMark":
case "requiredMark":
case "optionalMark":
case "requiredMessage":
case "scrollingEnabled":
case "formID":
case "colCountByScreen":
case "screenByWidth":
case "stylingMode":
this._invalidate();
break;
case "showValidationSummary":
this._renderValidationSummary();
break;
case "minColWidth":
if ("auto" === this.option("colCount")) {
this._invalidate()
}
break;
case "alignRootItemLabels":
case "readOnly":
case "isDirty":
break;
case "width":
this.callBase(args);
this._rootLayoutManager.option(args.name, args.value);
this._alignLabels(this._rootLayoutManager, this._rootLayoutManager.isSingleColumnMode());
break;
case "validationGroup":
ValidationEngine.removeGroup(args.previousValue || this);
this._invalidate();
break;
default:
this.callBase(args)
}
},
_itemsOptionChangedHandler: function(args) {
var nameParts = args.fullName.split(".");
var value = args.value;
var itemPath = this._getItemPath(nameParts);
var item = this.option(itemPath);
var optionNameWithoutPath = args.fullName.replace(itemPath + ".", "");
var simpleOptionName = optionNameWithoutPath.split(".")[0].replace(/\[\d+]/, "");
var itemAction = this._tryCreateItemOptionAction(simpleOptionName, item, item[simpleOptionName], args.previousValue, itemPath);
var result = this._tryExecuteItemOptionAction(itemAction) || this._tryChangeLayoutManagerItemOption(args.fullName, value);
if (!result && item) {
this._changeItemOption(item, optionNameWithoutPath, value);
var items = this._generateItemsFromData(this.option("items"));
this.option("items", items);
result = true
}
return result
},
_formDataOptionChangedHandler: function(args) {
var nameParts = args.fullName.split(".");
var value = args.value;
var dataField = nameParts.slice(1).join(".");
var editor = this.getEditor(dataField);
if (editor) {
editor.option("value", value)
} else {
this._triggerOnFieldDataChanged({
dataField: dataField,
value: value
})
}
return true
},
_tryCreateItemOptionAction: function(optionName, item, value, previousValue, itemPath) {
if ("tabs" === optionName) {
this._itemsRunTimeInfo.removeItemsByPathStartWith("".concat(itemPath, ".tabs"));
value = this._prepareItems(value, true, itemPath, true)
}
return tryCreateItemOptionAction(optionName, {
item: item,
value: value,
previousValue: previousValue,
itemsRunTimeInfo: this._itemsRunTimeInfo
})
},
_tryExecuteItemOptionAction: function(action) {
return action && action.tryExecute()
},
_updateValidationGroupAndSummaryIfNeeded: function(fullName) {
var optionName = getOptionNameFromFullName(fullName);
if (ITEM_OPTIONS_FOR_VALIDATION_UPDATING.indexOf(optionName) > -1) {
ValidationEngine.addGroup(this._getValidationGroup());
if (this.option("showValidationSummary")) {
var _this$_validationSumm2;
null === (_this$_validationSumm2 = this._validationSummary) || void 0 === _this$_validationSumm2 ? void 0 : _this$_validationSumm2.refreshValidationGroup()
}
}
},
_setLayoutManagerItemOption(layoutManager, optionName, value, path) {
if (this._updateLockCount > 0) {
!layoutManager._updateLockCount && layoutManager.beginUpdate();
var key = this._itemsRunTimeInfo.findKeyByPath(path);
this.postponedOperations.add(key, () => {
!layoutManager._disposed && layoutManager.endUpdate();
return (new Deferred).resolve()
})
}
var contentReadyHandler = e => {
e.component.off("contentReady", contentReadyHandler);
if (isFullPathContainsTabs(path)) {
var tabPath = tryGetTabPath(path);
var tabLayoutManager = this._itemsRunTimeInfo.findGroupOrTabLayoutManagerByPath(tabPath);
if (tabLayoutManager) {
this._alignLabelsInColumn({
items: tabLayoutManager.option("items"),
layoutManager: tabLayoutManager,
$container: tabLayoutManager.$element(),
inOneColumn: tabLayoutManager.isSingleColumnMode()
})
}
} else {
this._alignLabels(this._rootLayoutManager, this._rootLayoutManager.isSingleColumnMode())
}
};
layoutManager.on("contentReady", contentReadyHandler);
layoutManager.option(optionName, value);
this._updateValidationGroupAndSummaryIfNeeded(optionName)
},
_tryChangeLayoutManagerItemOption(fullName, value) {
var nameParts = fullName.split(".");
var optionName = getOptionNameFromFullName(fullName);
if ("items" === optionName && nameParts.length > 1) {
var itemPath = this._getItemPath(nameParts);
var layoutManager = this._itemsRunTimeInfo.findGroupOrTabLayoutManagerByPath(itemPath);
if (layoutManager) {
this._itemsRunTimeInfo.removeItemsByItems(layoutManager.getItemsRunTimeInfo());
var items = this._prepareItems(value, false, itemPath);
this._setLayoutManagerItemOption(layoutManager, optionName, items, itemPath);
return true
}
} else if (nameParts.length > 2) {
var endPartIndex = nameParts.length - 2;
var _itemPath = this._getItemPath(nameParts.slice(0, endPartIndex));
var _layoutManager = this._itemsRunTimeInfo.findGroupOrTabLayoutManagerByPath(_itemPath);
if (_layoutManager) {
var fullOptionName = getFullOptionName(nameParts[endPartIndex], optionName);
if ("editorType" === optionName) {
if (_layoutManager.option(fullOptionName) !== value) {
return false
}
}
if ("visible" === optionName) {
var formItems = this.option(getFullOptionName(_itemPath, "items"));
if (formItems && formItems.length) {
var layoutManagerItems = _layoutManager.option("items");
formItems.forEach((item, index) => {
var layoutItem = layoutManagerItems[index];
layoutItem.visibleIndex = item.visibleIndex
})
}
}
this._setLayoutManagerItemOption(_layoutManager, fullOptionName, value, _itemPath);
return true
}
}
return false
},
_tryChangeLayoutManagerItemOptions(itemPath, options) {
var result;
this.beginUpdate();
each(options, (optionName, optionValue) => {
result = this._tryChangeLayoutManagerItemOption(getFullOptionName(itemPath, optionName), optionValue);
if (!result) {
return false
}
});
this.endUpdate();
return result
},
_getItemPath: function(nameParts) {
var itemPath = nameParts[0];
var i;
for (i = 1; i < nameParts.length; i++) {
if (-1 !== nameParts[i].search(/items\[\d+]|tabs\[\d+]/)) {
itemPath += "." + nameParts[i]
} else {
break
}
}
return itemPath
},
_triggerOnFieldDataChanged: function(args) {
this._updateIsDirty(args.dataField);
this._createActionByOption("onFieldDataChanged")(args)
},
_triggerOnFieldDataChangedByDataSet(data) {
if (data && isObject(data)) {
Object.keys(data).forEach(key => {
this._triggerOnFieldDataChanged({
dataField: key,
value: data[key]
})
})
}
},
_updateFieldValue: function(dataField, value) {
if (isDefined(this.option("formData"))) {
var editor = this.getEditor(dataField);
this.option("formData." + dataField, value);
if (editor) {
var editorValue = editor.option("value");
if (editorValue !== value) {
editor.option("value", value)
}
}
}
},
_generateItemsFromData: function(items) {
var formData = this.option("formData");
var result = [];
if (!items && isDefined(formData)) {
each(formData, (function(dataField) {
result.push({
dataField: dataField
})
}))
}
if (items) {
each(items, (function(index, item) {
if (isObject(item)) {
result.push(item)
} else {
result.push({
dataField: item
})
}
}))
}
return result
},
_getItemByField: function(field, items) {
var that = this;
var fieldParts = isObject(field) ? field : that._getFieldParts(field);
var fieldName = fieldParts.fieldName;
var fieldPath = fieldParts.fieldPath;
var resultItem;
if (items.length) {
each(items, (function(index, item) {
var itemType = item.itemType;
if (fieldPath.length) {
var path = fieldPath.slice();
item = that._getItemByFieldPath(path, fieldName, item)
} else if ("group" === itemType && !(item.caption || item.name) || "tabbed" === itemType && !item.name) {
var subItemsField = that._getSubItemField(itemType);
item.items = that._generateItemsFromData(item.items);
item = that._getItemByField({
fieldName: fieldName,
fieldPath: fieldPath
}, item[subItemsField])
}
if (isEqualToDataFieldOrNameOrTitleOrCaption(item, fieldName)) {
resultItem = item;
return false
}
}))
}
return resultItem
},
_getFieldParts: function(field) {
var fieldName = field;
var separatorIndex = fieldName.indexOf(".");
var resultPath = [];
while (-1 !== separatorIndex) {
resultPath.push(fieldName.substr(0, separatorIndex));
fieldName = fieldName.substr(separatorIndex + 1);
separatorIndex = fieldName.indexOf(".")
}
return {
fieldName: fieldName,
fieldPath: resultPath.reverse()
}
},
_getItemByFieldPath: function(path, fieldName, item) {
var itemType = item.itemType;
var subItemsField = this._getSubItemField(itemType);
var isItemWithSubItems = "group" === itemType || "tabbed" === itemType || item.title;
var result;
do {
if (isItemWithSubItems) {
var name = item.name || item.caption || item.title;
var isGroupWithName = isDefined(name);
var nameWithoutSpaces = getTextWithoutSpaces(name);
var pathNode = void 0;
item[subItemsField] = this._generateItemsFromData(item[subItemsField]);
if (isGroupWithName) {
pathNode = path.pop()
}
if (!path.length) {
result = this._getItemByField(fieldName, item[subItemsField]);
if (result) {
break
}
}
if (!isGroupWithName || isGroupWithName && nameWithoutSpaces === pathNode) {
if (path.length) {
result = this._searchItemInEverySubItem(path, fieldName, item[subItemsField])
}
}
} else {
break
}
} while (path.length && !isDefined(result));
return result
},
_getSubItemField: function(itemType) {
return "tabbed" === itemType ? "tabs" : "items"
},
_searchItemInEverySubItem: function(path, fieldName, items) {
var that = this;
var result;
each(items, (function(index, groupItem) {
result = that._getItemByFieldPath(path.slice(), fieldName, groupItem);
if (result) {
return false
}
}));
if (!result) {
result = false
}
return result
},
_changeItemOption: function(item, option, value) {
if (isObject(item)) {
item[option] = value
}
},
_dimensionChanged: function() {
var currentScreenFactor = this._getCurrentScreenFactor();
if (this._lastMarkupScreenFactor !== currentScreenFactor) {
if (this._isColCountChanged(this._lastMarkupScreenFactor, currentScreenFactor)) {
this._targetScreenFactor = currentScreenFactor;
this._refresh();
this._targetScreenFactor = void 0
}
this._lastMarkupScreenFactor = currentScreenFactor
}
},
_isColCountChanged: function(oldScreenSize, newScreenSize) {
var isChanged = false;
each(this._cachedColCountOptions, (function(index, item) {
if (item.colCountByScreen[oldScreenSize] !== item.colCountByScreen[newScreenSize]) {
isChanged = true;
return false
}
}));
return isChanged
},
_refresh: function() {
var editorSelector = ".".concat(FOCUSED_STATE_CLASS, " > :not(.dx-dropdowneditor-input-wrapper) input,") + " .".concat(FOCUSED_STATE_CLASS, " textarea");
eventsEngine.trigger(this.$element().find(editorSelector), "change");
this.callBase()
},
_updateIsDirty: function(dataField) {
var editor = this.getEditor(dataField);
if (!editor) {
return
}
if (editor.option("isDirty")) {
this._dirtyFields.add(dataField)
} else {
this._dirtyFields.delete(dataField)
}
this.option("isDirty", !!this._dirtyFields.size)
},
updateRunTimeInfoForEachEditor: function(editorAction) {
this._itemsRunTimeInfo.each((function(_, itemRunTimeInfo) {
var widgetInstance = itemRunTimeInfo.widgetInstance;
if (isDefined(widgetInstance) && Editor.isEditor(widgetInstance)) {
editorAction(widgetInstance)
}
}))
},
_clear: function() {
this.updateRunTimeInfoForEachEditor(editor => {
editor.clear();
editor.option("isValid", true)
});
ValidationEngine.resetGroup(this._getValidationGroup())
},
_updateData: function(data, value, isComplexData) {
var that = this;
var _data = isComplexData ? value : data;
if (isObject(_data)) {
each(_data, (function(dataField, fieldValue) {
that._updateData(isComplexData ? data + "." + dataField : dataField, fieldValue, isObject(fieldValue))
}))
} else if (isString(data)) {
that._updateFieldValue(data, value)
}
},
registerKeyHandler: function(key, handler) {
this.callBase(key, handler);
this._itemsRunTimeInfo.each((function(_, itemRunTimeInfo) {
if (isDefined(itemRunTimeInfo.widgetInstance)) {
itemRunTimeInfo.widgetInstance.registerKeyHandler(key, handler)
}
}))
},
_focusTarget: function() {
return this.$element().find("." + FIELD_ITEM_CONTENT_CLASS + " [tabindex]").first()
},
_visibilityChanged: function() {
this._alignLabels(this._rootLayoutManager, this._rootLayoutManager.isSingleColumnMode())
},
_clearAutoColCountChangedTimeout: function() {
if (this.autoColCountChangedTimeoutId) {
clearTimeout(this.autoColCountChangedTimeoutId);
this.autoColCountChangedTimeoutId = void 0
}
},
_dispose: function() {
this._clearAutoColCountChangedTimeout();
ValidationEngine.removeGroup(this._getValidationGroup());
this.callBase()
},
clear: function() {
this._clear()
},
resetValues: function() {
this._clear()
},
reset: function(editorsData) {
this.updateRunTimeInfoForEachEditor(editor => {
var editorName = editor.option("name");
if (editorsData && editorName in editorsData) {
editor.reset(editorsData[editorName])
} else {
editor.reset()
}
});
this._renderValidationSummary()
},
updateData: function(data, value) {
this._updateData(data, value)
},
getEditor: function(dataField) {
return this._itemsRunTimeInfo.findWidgetInstanceByDataField(dataField) || this._itemsRunTimeInfo.findWidgetInstanceByName(dataField)
},
getButton: function(name) {
return this._itemsRunTimeInfo.findWidgetInstanceByName(name)
},
updateDimensions: function() {
var that = this;
var deferred = new Deferred;
if (that._scrollable) {
that._scrollable.update().done((function() {
deferred.resolveWith(that)
}))
} else {
deferred.resolveWith(that)
}
return deferred.promise()
},
itemOption: function(id, option, value) {
var items = this._generateItemsFromData(this.option("items"));
var item = this._getItemByField(id, items);
var path = getItemPath(items, item);
if (!item) {
return
}
switch (arguments.length) {
case 1:
return item;
case 3:
var itemAction = this._tryCreateItemOptionAction(option, item, value, item[option], path);
this._changeItemOption(item, option, value);
var fullName = getFullOptionName(path, option);
if (!this._tryExecuteItemOptionAction(itemAction) && !this._tryChangeLayoutManagerItemOption(fullName, value)) {
this.option("items", items)
}
break;
default:
if (isObject(option)) {
if (!this._tryChangeLayoutManagerItemOptions(path, option)) {
var allowUpdateItems;
each(option, (optionName, optionValue) => {
var itemAction = this._tryCreateItemOptionAction(optionName, item, optionValue, item[optionName], path);
this._changeItemOption(item, optionName, optionValue);
if (!allowUpdateItems && !this._tryExecuteItemOptionAction(itemAction)) {
allowUpdateItems = true
}
});
allowUpdateItems && this.option("items", items)
}
}
}
},
validate: function() {
return ValidationEngine.validateGroup(this._getValidationGroup())
},
getItemID: function(name) {
return "dx_" + this.option("formID") + "_" + (name || new Guid)
},
getTargetScreenFactor: function() {
return this._targetScreenFactor
}
});
registerComponent("dxForm", Form);
export default Form;