devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
945 lines (944 loc) • 40.1 kB
JavaScript
/**
* DevExtreme (ui/form/ui.form.layout_manager.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 _typeof = "function" === typeof Symbol && "symbol" === typeof Symbol.iterator ? function(obj) {
return typeof obj
} : function(obj) {
return obj && "function" === typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj
};
var $ = require("../../core/renderer"),
eventsEngine = require("../../events/core/events_engine"),
Guid = require("../../core/guid"),
registerComponent = require("../../core/component_registrator"),
typeUtils = require("../../core/utils/type"),
domUtils = require("../../core/utils/dom"),
isWrapped = require("../../core/utils/variable_wrapper").isWrapped,
isWritableWrapped = require("../../core/utils/variable_wrapper").isWritableWrapped,
unwrap = require("../../core/utils/variable_wrapper").unwrap,
windowUtils = require("../../core/utils/window"),
stringUtils = require("../../core/utils/string"),
each = require("../../core/utils/iterator").each,
extend = require("../../core/utils/extend").extend,
inArray = require("../../core/utils/array").inArray,
dataUtils = require("../../core/utils/data"),
removeEvent = require("../../core/remove_event"),
clickEvent = require("../../events/click"),
normalizeIndexes = require("../../core/utils/array").normalizeIndexes,
errors = require("../widget/ui.errors"),
messageLocalization = require("../../localization/message"),
styleUtils = require("../../core/utils/style"),
inflector = require("../../core/utils/inflector"),
Widget = require("../widget/ui.widget"),
Validator = require("../validator"),
ResponsiveBox = require("../responsive_box"),
themes = require("../themes");
require("../text_box");
require("../number_box");
require("../check_box");
require("../date_box");
require("../button");
var FORM_EDITOR_BY_DEFAULT = "dxTextBox",
FIELD_ITEM_CLASS = "dx-field-item",
FIELD_EMPTY_ITEM_CLASS = "dx-field-empty-item",
FIELD_BUTTON_ITEM_CLASS = "dx-field-button-item",
FIELD_ITEM_REQUIRED_CLASS = "dx-field-item-required",
FIELD_ITEM_OPTIONAL_CLASS = "dx-field-item-optional",
FIELD_ITEM_REQUIRED_MARK_CLASS = "dx-field-item-required-mark",
FIELD_ITEM_OPTIONAL_MARK_CLASS = "dx-field-item-optional-mark",
FIELD_ITEM_LABEL_CLASS = "dx-field-item-label",
FIELD_ITEM_LABEL_ALIGN_CLASS = "dx-field-item-label-align",
FIELD_ITEM_LABEL_CONTENT_CLASS = "dx-field-item-label-content",
FIELD_ITEM_LABEL_TEXT_CLASS = "dx-field-item-label-text",
FIELD_ITEM_LABEL_LOCATION_CLASS = "dx-field-item-label-location-",
FIELD_ITEM_CONTENT_CLASS = "dx-field-item-content",
FIELD_ITEM_CONTENT_LOCATION_CLASS = "dx-field-item-content-location-",
FIELD_ITEM_CONTENT_WRAPPER_CLASS = "dx-field-item-content-wrapper",
FIELD_ITEM_HELP_TEXT_CLASS = "dx-field-item-help-text",
SINGLE_COLUMN_ITEM_CONTENT = "dx-single-column-item-content",
LABEL_HORIZONTAL_ALIGNMENT_CLASS = "dx-label-h-align",
LABEL_VERTICAL_ALIGNMENT_CLASS = "dx-label-v-align",
FORM_LAYOUT_MANAGER_CLASS = "dx-layout-manager",
LAYOUT_MANAGER_FIRST_ROW_CLASS = "dx-first-row",
LAYOUT_MANAGER_FIRST_COL_CLASS = "dx-first-col",
LAYOUT_MANAGER_LAST_COL_CLASS = "dx-last-col",
LAYOUT_MANAGER_ONE_COLUMN = "dx-layout-manager-one-col",
FLEX_LAYOUT_CLASS = "dx-flex-layout",
INVALID_CLASS = "dx-invalid",
LAYOUT_STRATEGY_FLEX = "flex",
LAYOUT_STRATEGY_FALLBACK = "fallback",
SIMPLE_ITEM_TYPE = "simple",
DATA_OPTIONS = ["dataSource", "items"],
EDITORS_WITH_ARRAY_VALUE = ["dxTagBox", "dxRangeSlider"];
var LayoutManager = Widget.inherit({
_getDefaultOptions: function() {
return extend(this.callBase(), {
layoutData: {},
readOnly: false,
colCount: 1,
colCountByScreen: void 0,
labelLocation: "left",
onFieldDataChanged: null,
onEditorEnterKey: null,
customizeItem: null,
alignItemLabels: true,
minColWidth: 200,
showRequiredMark: true,
screenByWidth: null,
showOptionalMark: false,
requiredMark: "*",
optionalMark: messageLocalization.format("dxForm-optionalMark"),
requiredMessage: messageLocalization.getFormatter("dxForm-requiredMessage")
})
},
_setOptionsByReference: function() {
this.callBase();
extend(this._optionsByReference, {
layoutData: true,
validationGroup: true
})
},
_init: function() {
this.callBase();
this._itemWatchers = [];
this._initDataAndItems(this.option("layoutData"))
},
_dispose: function() {
this.callBase();
this._cleanItemWatchers()
},
_initDataAndItems: function(initialData) {
this._syncDataWithItems();
this._updateItems(initialData)
},
_syncDataWithItems: function() {
var that = this,
userItems = that.option("items");
if (typeUtils.isDefined(userItems)) {
each(userItems, function(index, item) {
var value;
if (item.dataField && void 0 === that._getDataByField(item.dataField)) {
if (item.editorOptions) {
value = item.editorOptions.value
}
that._updateFieldValue(item.dataField, value)
}
})
}
},
_getDataByField: function(dataField) {
return dataField ? this.option("layoutData." + dataField) : null
},
_updateFieldValue: function(dataField, value) {
var layoutData = this.option("layoutData"),
newValue = value;
if (!isWrapped(layoutData[dataField]) && typeUtils.isDefined(dataField)) {
this.option("layoutData." + dataField, newValue)
} else {
if (isWritableWrapped(layoutData[dataField])) {
newValue = typeUtils.isFunction(newValue) ? newValue() : newValue;
layoutData[dataField](newValue)
}
}
this._triggerOnFieldDataChanged({
dataField: dataField,
value: newValue
})
},
_triggerOnFieldDataChanged: function(args) {
this._createActionByOption("onFieldDataChanged")(args)
},
_updateItems: function(layoutData) {
var items, processedItems, that = this,
userItems = this.option("items"),
isUserItemsExist = typeUtils.isDefined(userItems),
customizeItem = that.option("customizeItem");
items = isUserItemsExist ? userItems : this._generateItemsByData(layoutData);
if (typeUtils.isDefined(items)) {
processedItems = [];
each(items, function(index, item) {
if (that._isAcceptableItem(item)) {
item = that._processItem(item);
customizeItem && customizeItem(item);
if (typeUtils.isObject(item) && false !== unwrap(item.visible)) {
processedItems.push(item)
}
}
});
if (!that._itemWatchers.length || !isUserItemsExist) {
that._updateItemWatchers(items)
}
this._items = processedItems;
this._sortItems()
}
},
_cleanItemWatchers: function() {
this._itemWatchers.forEach(function(dispose) {
dispose()
});
this._itemWatchers = []
},
_updateItemWatchers: function(items) {
var that = this,
watch = that._getWatch();
items.forEach(function(item) {
if (typeUtils.isObject(item) && typeUtils.isDefined(item.visible) && typeUtils.isFunction(watch)) {
that._itemWatchers.push(watch(function() {
return unwrap(item.visible)
}, function() {
that._updateItems(that.option("layoutData"));
that.repaint()
}, {
skipImmediate: true
}))
}
})
},
_generateItemsByData: function(layoutData) {
var result = [];
if (typeUtils.isDefined(layoutData)) {
each(layoutData, function(dataField) {
result.push({
dataField: dataField
})
})
}
return result
},
_isAcceptableItem: function(item) {
var itemField = item.dataField || item,
itemData = this._getDataByField(itemField);
return !(typeUtils.isFunction(itemData) && !isWrapped(itemData))
},
_processItem: function(item) {
if ("string" === typeof item) {
item = {
dataField: item
}
}
if ("object" === ("undefined" === typeof item ? "undefined" : _typeof(item)) && !item.itemType) {
item.itemType = SIMPLE_ITEM_TYPE
}
if (!typeUtils.isDefined(item.editorType) && typeUtils.isDefined(item.dataField)) {
var value = this._getDataByField(item.dataField);
item.editorType = typeUtils.isDefined(value) ? this._getEditorTypeByDataType(typeUtils.type(value)) : FORM_EDITOR_BY_DEFAULT
}
return item
},
_getEditorTypeByDataType: function(dataType) {
switch (dataType) {
case "number":
return "dxNumberBox";
case "date":
return "dxDateBox";
case "boolean":
return "dxCheckBox";
default:
return "dxTextBox"
}
},
_sortItems: function() {
normalizeIndexes(this._items, "visibleIndex");
this._sortIndexes()
},
_sortIndexes: function() {
this._items.sort(function(itemA, itemB) {
var result, indexA = itemA.visibleIndex,
indexB = itemB.visibleIndex;
if (indexA > indexB) {
result = 1
} else {
if (indexA < indexB) {
result = -1
} else {
result = 0
}
}
return result
})
},
_initMarkup: function() {
this._clearEditorInstances();
this.$element().addClass(FORM_LAYOUT_MANAGER_CLASS);
this.callBase();
this._renderResponsiveBox()
},
_clearEditorInstances: function() {
this._editorInstancesByField = {}
},
_hasBrowserFlex: function() {
return styleUtils.styleProp(LAYOUT_STRATEGY_FLEX) === LAYOUT_STRATEGY_FLEX
},
_renderResponsiveBox: function() {
var that = this;
if (that._items && that._items.length) {
var layoutItems, colCount = that._getColCount(),
$container = $("<div>").appendTo(that.$element());
that._prepareItemsWithMerging(colCount);
layoutItems = that._generateLayoutItems();
that._extendItemsWithDefaultTemplateOptions(layoutItems, that._items);
that._responsiveBox = that._createComponent($container, ResponsiveBox, that._getResponsiveBoxConfig(layoutItems, colCount))
}
},
_extendItemsWithDefaultTemplateOptions: function(targetItems, sourceItems) {
sourceItems.forEach(function(item) {
if (!item.merged) {
if (typeUtils.isDefined(item.disabled)) {
targetItems[item.visibleIndex].disabled = item.disabled
}
if (typeUtils.isDefined(item.visible)) {
targetItems[item.visibleIndex].visible = item.visible
}
}
})
},
_itemStateChangedHandler: function(e) {
this._refresh()
},
_getResponsiveBoxConfig: function(layoutItems, colCount) {
var that = this,
colCountByScreen = that.option("colCountByScreen"),
xsColCount = colCountByScreen && colCountByScreen.xs;
return {
onItemStateChanged: this._itemStateChangedHandler.bind(this),
_layoutStrategy: that._hasBrowserFlex() ? LAYOUT_STRATEGY_FLEX : LAYOUT_STRATEGY_FALLBACK,
onLayoutChanged: function onLayoutChanged() {
var onLayoutChanged = that.option("onLayoutChanged"),
isSingleColumnMode = that.isSingleColumnMode();
if (onLayoutChanged) {
that.$element().toggleClass(LAYOUT_MANAGER_ONE_COLUMN, isSingleColumnMode);
onLayoutChanged(isSingleColumnMode)
}
},
onContentReady: function(e) {
if (that.option("onLayoutChanged")) {
that.$element().toggleClass(LAYOUT_MANAGER_ONE_COLUMN, that.isSingleColumnMode(e.component))
}
that._fireContentReadyAction()
},
itemTemplate: function(e, itemData, itemElement) {
if (!e.location) {
return
}
var $itemElement = $(itemElement),
itemRenderedCountInPreviousRows = e.location.row * colCount,
item = that._items[e.location.col + itemRenderedCountInPreviousRows],
$fieldItem = $("<div>").addClass(item.cssClass).appendTo($itemElement);
$itemElement.toggleClass(SINGLE_COLUMN_ITEM_CONTENT, that.isSingleColumnMode(this));
if (0 === e.location.row) {
$fieldItem.addClass(LAYOUT_MANAGER_FIRST_ROW_CLASS)
}
if (0 === e.location.col) {
$fieldItem.addClass(LAYOUT_MANAGER_FIRST_COL_CLASS)
}
if (e.location.col === colCount - 1 || e.location.col + e.location.colspan === colCount) {
$fieldItem.addClass(LAYOUT_MANAGER_LAST_COL_CLASS)
}
switch (item.itemType) {
case "empty":
that._renderEmptyItem($fieldItem);
break;
case "button":
that._renderButtonItem(item, $fieldItem);
break;
default:
that._renderFieldItem(item, $fieldItem)
}
},
cols: that._generateRatio(colCount),
rows: that._generateRatio(that._getRowsCount(), true),
dataSource: layoutItems,
screenByWidth: that.option("screenByWidth"),
singleColumnScreen: xsColCount ? false : "xs"
}
},
_getColCount: function() {
var colCount = this.option("colCount"),
colCountByScreen = this.option("colCountByScreen");
if (colCountByScreen) {
var screenFactor = windowUtils.hasWindow() ? windowUtils.getCurrentScreenFactor(this.option("screenByWidth")) : "lg",
currentColCount = colCountByScreen[screenFactor];
colCount = currentColCount || colCount
}
if ("auto" === colCount) {
if (!!this._cashedColCount) {
return this._cashedColCount
}
this._cashedColCount = colCount = this._getMaxColCount()
}
return colCount < 1 ? 1 : colCount
},
_getMaxColCount: function() {
if (!windowUtils.hasWindow()) {
return 1
}
var minColWidth = this.option("minColWidth"),
width = this.$element().width(),
itemsCount = this._items.length,
maxColCount = Math.floor(width / minColWidth) || 1;
return itemsCount < maxColCount ? itemsCount : maxColCount
},
isCachedColCountObsolete: function() {
return this._cashedColCount && this._getMaxColCount() !== this._cashedColCount
},
_prepareItemsWithMerging: function(colCount) {
var item, itemsMergedByCol, j, i, items = this._items.slice(0),
result = [];
for (i = 0; i < items.length; i++) {
item = items[i];
result.push(item);
if (this.option("alignItemLabels") || item.alignItemLabels || item.colSpan) {
item.col = this._getColByIndex(result.length - 1, colCount)
}
if (item.colSpan > 1 && item.col + item.colSpan <= colCount) {
itemsMergedByCol = [];
for (j = 0; j < item.colSpan - 1; j++) {
itemsMergedByCol.push({
merged: true
})
}
result = result.concat(itemsMergedByCol)
} else {
delete item.colSpan
}
}
this._items = result
},
_getColByIndex: function(index, colCount) {
return index % colCount
},
_generateLayoutItems: function() {
var item, i, items = this._items,
colCount = this._getColCount(),
result = [];
for (i = 0; i < items.length; i++) {
item = items[i];
if (!item.merged) {
var generatedItem = {
location: {
row: parseInt(i / colCount),
col: this._getColByIndex(i, colCount)
}
};
if (typeUtils.isDefined(item.colSpan)) {
generatedItem.location.colspan = item.colSpan
}
if (typeUtils.isDefined(item.rowSpan)) {
generatedItem.location.rowspan = item.rowSpan
}
result.push(generatedItem)
}
}
return result
},
_renderEmptyItem: function($container) {
return $container.addClass(FIELD_EMPTY_ITEM_CLASS).html(" ")
},
_renderButtonItem: function(item, $container) {
var $button = $("<div>").appendTo($container),
defaultOptions = {
validationGroup: this.option("validationGroup")
};
$container.addClass(FIELD_BUTTON_ITEM_CLASS).css("textAlign", item.alignment ? item.alignment : "right");
this._createComponent($button, "dxButton", extend(defaultOptions, item.buttonOptions));
this._addItemClasses($container, item.col);
return $button
},
_addItemClasses: function($item, column) {
$item.addClass(FIELD_ITEM_CLASS).addClass(this.option("cssItemClass")).addClass(typeUtils.isDefined(column) ? "dx-col-" + column : "")
},
_renderFieldItem: function(item, $container) {
var $label, that = this,
name = that._getName(item),
id = that.getItemID(name),
isRequired = typeUtils.isDefined(item.isRequired) ? item.isRequired : !!that._hasRequiredRuleInSet(item.validationRules),
labelOptions = that._getLabelOptions(item, id, isRequired),
$editor = $("<div>"),
helpID = item.helpText ? "dx-" + new Guid : null;
this._addItemClasses($container, item.col);
$container.addClass(isRequired ? FIELD_ITEM_REQUIRED_CLASS : FIELD_ITEM_OPTIONAL_CLASS);
if (labelOptions.visible && labelOptions.text) {
$label = that._renderLabel(labelOptions).appendTo($container)
}
if (item.itemType === SIMPLE_ITEM_TYPE) {
if (that._isLabelNeedBaselineAlign(item) && "top" !== labelOptions.location) {
$container.addClass(FIELD_ITEM_LABEL_ALIGN_CLASS)
}
that._hasBrowserFlex() && $container.addClass(FLEX_LAYOUT_CLASS)
}
$editor.data("dx-form-item", item);
that._appendEditorToField({
$fieldItem: $container,
$label: $label,
$editor: $editor,
labelOptions: labelOptions
});
that._renderEditor({
$container: $editor,
dataField: item.dataField,
name: name,
editorType: item.editorType,
editorOptions: item.editorOptions,
template: that._getTemplateByFieldItem(item),
isRequired: isRequired,
helpID: helpID,
id: id,
validationBoundary: that.option("validationBoundary")
});
var $validationTarget = $editor.children().first();
if ($validationTarget && $validationTarget.data("dx-validation-target")) {
that._renderValidator($validationTarget, item)
}
that._renderHelpText(item, $editor, helpID);
that._attachClickHandler($label, $editor, item.editorType)
},
_hasRequiredRuleInSet: function(rules) {
var hasRequiredRule;
if (rules && rules.length) {
each(rules, function(index, rule) {
if ("required" === rule.type) {
hasRequiredRule = true;
return false
}
})
}
return hasRequiredRule
},
_getName: function(item) {
return item.dataField || item.name
},
_isLabelNeedBaselineAlign: function(item) {
var largeEditors = ["dxTextArea", "dxRadioGroup", "dxCalendar"];
return !!item.helpText && !this._hasBrowserFlex() || inArray(item.editorType, largeEditors) !== -1
},
_getLabelOptions: function(item, id, isRequired) {
var labelOptions = extend({
showColon: this.option("showColonAfterLabel"),
location: this.option("labelLocation"),
id: id,
visible: true,
isRequired: isRequired
}, item ? item.label : {});
if (!labelOptions.text && item.dataField) {
labelOptions.text = inflector.captionize(item.dataField)
}
if (labelOptions.text) {
labelOptions.text += labelOptions.showColon ? ":" : ""
}
return labelOptions
},
_renderLabel: function(options) {
if (typeUtils.isDefined(options.text) && options.text.length > 0) {
var labelClasses = FIELD_ITEM_LABEL_CLASS + " " + FIELD_ITEM_LABEL_LOCATION_CLASS + options.location,
$label = $("<label>").addClass(labelClasses).attr("for", options.id),
$labelContent = $("<span>").addClass(FIELD_ITEM_LABEL_CONTENT_CLASS).appendTo($label);
$("<span>").addClass(FIELD_ITEM_LABEL_TEXT_CLASS).text(options.text).appendTo($labelContent);
if (options.alignment) {
$label.css("textAlign", options.alignment)
}
$labelContent.append(this._renderLabelMark(options.isRequired));
return $label
}
},
_renderLabelMark: function(isRequired) {
var $mark, requiredMarksConfig = this._getRequiredMarksConfig(),
isRequiredMark = requiredMarksConfig.showRequiredMark && isRequired,
isOptionalMark = requiredMarksConfig.showOptionalMark && !isRequired;
if (isRequiredMark || isOptionalMark) {
var markClass = isRequiredMark ? FIELD_ITEM_REQUIRED_MARK_CLASS : FIELD_ITEM_OPTIONAL_MARK_CLASS,
markText = isRequiredMark ? requiredMarksConfig.requiredMark : requiredMarksConfig.optionalMark;
$mark = $("<span>").addClass(markClass).html(" " + markText)
}
return $mark
},
_getRequiredMarksConfig: function() {
if (!this._cashedRequiredConfig) {
this._cashedRequiredConfig = {
showRequiredMark: this.option("showRequiredMark"),
showOptionalMark: this.option("showOptionalMark"),
requiredMark: this.option("requiredMark"),
optionalMark: this.option("optionalMark")
}
}
return this._cashedRequiredConfig
},
_renderEditor: function(options) {
var editorOptions, dataValue = this._getDataByField(options.dataField),
defaultEditorOptions = {
value: dataValue
},
isDeepExtend = true;
if (EDITORS_WITH_ARRAY_VALUE.indexOf(options.editorType) !== -1) {
defaultEditorOptions.value = defaultEditorOptions.value || []
}
editorOptions = extend(isDeepExtend, defaultEditorOptions, options.editorOptions, {
inputAttr: {
id: options.id
},
validationBoundary: options.validationBoundary
});
this._replaceDataOptions(options.editorOptions, editorOptions);
this._createEditor(options.$container, {
editorType: options.editorType,
dataField: options.dataField,
template: options.template,
name: options.name,
helpID: options.helpID,
isRequired: options.isRequired
}, editorOptions)
},
_replaceDataOptions: function(originalOptions, resultOptions) {
if (originalOptions) {
DATA_OPTIONS.forEach(function(item) {
if (resultOptions[item]) {
resultOptions[item] = originalOptions[item]
}
})
}
},
_renderValidator: function($editor, item) {
var fieldName = this._getFieldLabelName(item),
validationRules = this._prepareValidationRules(item.validationRules, item.isRequired, item.itemType, fieldName);
if (Array.isArray(validationRules)) {
this._createComponent($editor, Validator, {
validationRules: validationRules,
validationGroup: this.option("validationGroup")
})
}
},
_getFieldLabelName: function(item) {
var isItemHaveCustomLabel = item.label && item.label.text,
itemName = isItemHaveCustomLabel ? null : this._getName(item);
return isItemHaveCustomLabel ? item.label.text : itemName && inflector.captionize(itemName)
},
_prepareValidationRules: function(userValidationRules, isItemRequired, itemType, itemName) {
var validationRules, isSimpleItem = itemType === SIMPLE_ITEM_TYPE;
if (isSimpleItem) {
if (userValidationRules) {
validationRules = userValidationRules
} else {
var requiredMessage = stringUtils.format(this.option("requiredMessage"), itemName || "");
validationRules = isItemRequired ? [{
type: "required",
message: requiredMessage
}] : null
}
}
return validationRules
},
_addWrapperInvalidClass: function(editorInstance) {
var wrapperClass = "." + FIELD_ITEM_CONTENT_WRAPPER_CLASS,
toggleInvalidClass = function(e) {
$(e.element).parents(wrapperClass).toggleClass(INVALID_CLASS, "focusin" === e.event.type && false === e.component.option("isValid"))
};
editorInstance.on("focusIn", toggleInvalidClass).on("focusOut", toggleInvalidClass)
},
_createEditor: function($container, renderOptions, editorOptions) {
var editorInstance, that = this,
template = renderOptions.template;
if (renderOptions.dataField && !editorOptions.name) {
editorOptions.name = renderOptions.dataField
}
that._addItemContentClasses($container);
if (template) {
var data = {
dataField: renderOptions.dataField,
editorType: renderOptions.editorType,
editorOptions: editorOptions,
component: that._getComponentOwner()
};
template.render({
model: data,
container: domUtils.getPublicElement($container)
})
} else {
var $editor = $("<div>").appendTo($container);
try {
editorInstance = that._createComponent($editor, renderOptions.editorType, editorOptions);
editorInstance.setAria("describedby", renderOptions.helpID);
editorInstance.setAria("required", renderOptions.isRequired);
that._registerEditorInstance(editorInstance, renderOptions);
if (themes.isMaterial()) {
that._addWrapperInvalidClass(editorInstance)
}
if (renderOptions.dataField) {
that._bindDataField(editorInstance, renderOptions, $container)
}
} catch (e) {
errors.log("E1035", e.message)
}
}
},
_getComponentOwner: function() {
return this.option("form") || this
},
_bindDataField: function(editorInstance, renderOptions, $container) {
var componentOwner = this._getComponentOwner();
editorInstance.on("enterKey", function(args) {
componentOwner._createActionByOption("onEditorEnterKey")(extend(args, {
dataField: renderOptions.dataField
}))
});
this._createWatcher(editorInstance, $container, renderOptions);
this.linkEditorToDataField(editorInstance, renderOptions.dataField, renderOptions.editorType)
},
_createWatcher: function(editorInstance, $container, renderOptions) {
var that = this,
watch = that._getWatch();
if (!typeUtils.isFunction(watch)) {
return
}
var dispose = watch(function() {
return that._getDataByField(renderOptions.dataField)
}, function() {
editorInstance.option("value", that._getDataByField(renderOptions.dataField))
}, {
deep: true,
skipImmediate: true
});
eventsEngine.on($container, removeEvent, dispose)
},
_getWatch: function() {
if (!typeUtils.isDefined(this._watch)) {
var formInstance = this.option("form");
this._watch = formInstance && formInstance.option("integrationOptions.watchMethod")
}
return this._watch
},
_addItemContentClasses: function($itemContent) {
var locationSpecificClass = this._getItemContentLocationSpecificClass();
$itemContent.addClass([FIELD_ITEM_CONTENT_CLASS, locationSpecificClass].join(" "))
},
_getItemContentLocationSpecificClass: function() {
var labelLocation = this.option("labelLocation"),
oppositeClasses = {
right: "left",
left: "right",
top: "bottom"
};
return FIELD_ITEM_CONTENT_LOCATION_CLASS + oppositeClasses[labelLocation]
},
_registerEditorInstance: function(instance, options) {
var name = this._getName(options);
if (name) {
this._editorInstancesByField[name] = instance
}
},
_createComponent: function($editor, type, editorOptions) {
var instance, that = this,
readOnlyState = this.option("readOnly");
instance = that.callBase($editor, type, editorOptions);
readOnlyState && instance.option("readOnly", readOnlyState);
that.on("optionChanged", function(args) {
if ("readOnly" === args.name && !typeUtils.isDefined(editorOptions.readOnly)) {
instance.option(args.name, args.value)
}
});
return instance
},
_getTemplateByFieldItem: function(fieldItem) {
return fieldItem.template ? this._getTemplate(fieldItem.template) : null
},
_appendEditorToField: function(params) {
if (params.$label) {
var location = params.labelOptions.location;
if ("top" === location || "left" === location) {
params.$fieldItem.append(params.$editor)
}
if ("right" === location) {
params.$fieldItem.prepend(params.$editor)
}
this._addInnerItemAlignmentClass(params.$fieldItem, location)
} else {
params.$fieldItem.append(params.$editor)
}
},
_addInnerItemAlignmentClass: function($fieldItem, location) {
if ("top" === location) {
$fieldItem.addClass(LABEL_VERTICAL_ALIGNMENT_CLASS)
} else {
$fieldItem.addClass(LABEL_HORIZONTAL_ALIGNMENT_CLASS)
}
},
_renderHelpText: function(fieldItem, $editor, helpID) {
var helpText = fieldItem.helpText,
isSimpleItem = fieldItem.itemType === SIMPLE_ITEM_TYPE;
if (helpText && isSimpleItem) {
var $editorWrapper = $("<div>").addClass(FIELD_ITEM_CONTENT_WRAPPER_CLASS);
$editor.wrap($editorWrapper);
$("<div>").addClass(FIELD_ITEM_HELP_TEXT_CLASS).attr("id", helpID).text(helpText).appendTo($editor.parent())
}
},
_attachClickHandler: function($label, $editor, editorType) {
var isBooleanEditors = "dxCheckBox" === editorType || "dxSwitch" === editorType;
if ($label && isBooleanEditors) {
eventsEngine.on($label, clickEvent.name, function() {
eventsEngine.trigger($editor.children(), clickEvent.name)
})
}
},
_generateRatio: function(count, isAutoSize) {
var ratio, i, result = [];
for (i = 0; i < count; i++) {
ratio = {
ratio: 1
};
if (isAutoSize) {
ratio.baseSize = "auto"
}
result.push(ratio)
}
return result
},
_getRowsCount: function() {
return Math.ceil(this._items.length / this._getColCount())
},
_optionChanged: function(args) {
if (0 === args.fullName.search("layoutData.")) {
return
}
switch (args.name) {
case "showRequiredMark":
case "showOptionalMark":
case "requiredMark":
case "optionalMark":
this._cashedRequiredConfig = null;
this._invalidate();
break;
case "layoutData":
if (this.option("items")) {
if (!typeUtils.isEmptyObject(args.value)) {
each(this._editorInstancesByField, function(name, editor) {
var valueGetter = dataUtils.compileGetter(name),
dataValue = valueGetter(args.value);
if (typeUtils.isDefined(dataValue)) {
editor.option("value", dataValue)
} else {
editor.reset();
editor.option("isValid", true)
}
})
}
} else {
this._initDataAndItems(args.value);
this._invalidate()
}
break;
case "items":
this._cleanItemWatchers();
this._initDataAndItems(args.value);
this._invalidate();
break;
case "alignItemLabels":
case "labelLocation":
case "requiredMessage":
this._invalidate();
break;
case "customizeItem":
this._updateItems(this.option("layoutData"));
this._invalidate();
break;
case "colCount":
this._resetColCount();
break;
case "minColWidth":
if ("auto" === this.option("colCount")) {
this._resetColCount()
}
break;
case "readOnly":
break;
case "width":
this.callBase(args);
if ("auto" === this.option("colCount")) {
this._resetColCount()
}
break;
case "onFieldDataChanged":
break;
default:
this.callBase(args)
}
},
_resetColCount: function() {
this._cashedColCount = null;
this._invalidate()
},
linkEditorToDataField: function(editorInstance, dataField, editorType) {
var isDataUpdating, fullFieldName = "layoutData." + dataField,
that = this;
that.on("optionChanged", function(args) {
if (args.fullName === fullFieldName) {
isDataUpdating = true;
if ("object" === _typeof(args.value)) {
that._managedUpdateEditorOption(editorInstance, "value", args.value)
} else {
editorInstance.option("value", args.value)
}
isDataUpdating = false
}
});
editorInstance.on("valueChanged", function(args) {
var isObjectValue = "object" === _typeof(args.value),
isSameObjectValue = isObjectValue && args.value === args.previousValue;
if (!isDataUpdating && !isSameObjectValue) {
if (isObjectValue) {
that._managedUpdateFieldValue(dataField, args.value)
} else {
that._updateFieldValue(dataField, args.value)
}
}
})
},
_managedUpdateEditorOption: function(editorInstance, optionName, value) {
if (!this._isValueChangedCalled) {
this._isFieldValueChanged = true;
editorInstance.option(optionName, value);
this._isFieldValueChanged = false
}
},
_managedUpdateFieldValue: function(dataField, value) {
this._isValueChangedCalled = true;
if (!this._isFieldValueChanged) {
this._updateFieldValue(dataField, value)
}
this._isValueChangedCalled = false
},
_dimensionChanged: function() {
if ("auto" === this.option("colCount") && this.isCachedColCountObsolete()) {
this.fireEvent("autoColCountChanged")
}
},
getItemID: function(name) {
var formInstance = this.option("form");
return formInstance && formInstance.getItemID(name)
},
updateData: function(data, value) {
var that = this;
if (typeUtils.isObject(data)) {
each(data, function(dataField, fieldValue) {
that._updateFieldValue(dataField, fieldValue)
})
} else {
if ("string" === typeof data) {
that._updateFieldValue(data, value)
}
}
},
getEditor: function(field) {
return this._editorInstancesByField[field]
},
isSingleColumnMode: function(component) {
var responsiveBox = this._responsiveBox || component;
if (responsiveBox) {
return responsiveBox.option("currentScreenFactor") === responsiveBox.option("singleColumnScreen")
}
}
});
registerComponent("dxLayoutManager", LayoutManager);
module.exports = LayoutManager;