devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
249 lines (248 loc) • 9.02 kB
JavaScript
/**
* DevExtreme (esm/__internal/ui/radio_group/m_radio_group.js)
* Version: 24.2.6
* Build date: Mon Mar 17 2025
*
* Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import registerComponent from "../../../core/component_registrator";
import devices from "../../../core/devices";
import $ from "../../../core/renderer";
import {
Deferred
} from "../../../core/utils/deferred";
import {
extend
} from "../../../core/utils/extend";
import {
isDefined
} from "../../../core/utils/type";
import DataExpressionMixin from "../../../ui/editor/ui.data_expression";
import Editor from "../../ui/editor/editor";
import RadioCollection from "./m_radio_collection";
const RADIO_BUTTON_CLASS = "dx-radiobutton";
const RADIO_GROUP_HORIZONTAL_CLASS = "dx-radiogroup-horizontal";
const RADIO_GROUP_VERTICAL_CLASS = "dx-radiogroup-vertical";
const RADIO_GROUP_CLASS = "dx-radiogroup";
const RADIO_FEEDBACK_HIDE_TIMEOUT = 100;
class RadioGroup extends Editor {
_dataSourceOptions() {
return {
paginate: false
}
}
_defaultOptionsRules() {
const defaultOptionsRules = super._defaultOptionsRules();
return defaultOptionsRules.concat([{
device: {
tablet: true
},
options: {
layout: "horizontal"
}
}, {
device: () => "desktop" === devices.real().deviceType && !devices.isSimulator(),
options: {
focusStateEnabled: true
}
}])
}
_fireContentReadyAction(force) {
force && super._fireContentReadyAction()
}
_focusTarget() {
return this.$element()
}
_getAriaTarget() {
return this.$element()
}
_getDefaultOptions() {
const defaultOptions = super._getDefaultOptions();
return extend(defaultOptions, extend(DataExpressionMixin._dataExpressionDefaultOptions(), {
hoverStateEnabled: true,
activeStateEnabled: true,
layout: "vertical"
}))
}
_getItemValue(item) {
return this._valueGetter ? this._valueGetter(item) : item.text
}
_getSubmitElement() {
return this._$submitElement
}
_init() {
super._init();
this._activeStateUnit = ".dx-radiobutton";
this._feedbackHideTimeout = 100;
this._initDataExpressions()
}
_initMarkup() {
$(this.element()).addClass("dx-radiogroup");
this._renderSubmitElement();
this.setAria("role", "radiogroup");
this._renderRadios();
this._renderLayout();
super._initMarkup()
}
_itemClickHandler(_ref) {
let {
itemElement: itemElement,
event: event,
itemData: itemData
} = _ref;
if (this.itemElements().is(itemElement)) {
const newValue = this._getItemValue(itemData);
if (newValue !== this.option("value")) {
this._saveValueChangeEvent(event);
this.option("value", newValue)
}
}
}
_getSelectedItemKeys() {
let value = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : this.option("value");
const isNullSelectable = "this" !== this.option("valueExpr");
const shouldSelectValue = isNullSelectable && null === value || isDefined(value);
return shouldSelectValue ? [value] : []
}
_setSelection(currentValue) {
const value = this._unwrappedValue(currentValue);
this._setCollectionWidgetOption("selectedItemKeys", this._getSelectedItemKeys(value))
}
_renderValidationState() {
var _this$_validationMess;
super._renderValidationState();
null === (_this$_validationMess = this._validationMessage) || void 0 === _this$_validationMess || _this$_validationMess.$content().attr("role", "alert")
}
_optionChanged(args) {
const {
name: name,
value: value
} = args;
this._dataExpressionOptionChanged(args);
switch (name) {
case "dataSource":
this._invalidate();
break;
case "focusStateEnabled":
case "accessKey":
case "tabIndex":
this._setCollectionWidgetOption(name, value);
break;
case "disabled":
super._optionChanged(args);
this._setCollectionWidgetOption(name, value);
break;
case "valueExpr":
this._setCollectionWidgetOption("keyExpr", this._getCollectionKeyExpr());
break;
case "value":
this._setSelection(value);
this._setSubmitValue(value);
super._optionChanged(args);
break;
case "items":
this._setSelection(this.option("value"));
break;
case "itemTemplate":
case "displayExpr":
break;
case "layout":
this._renderLayout();
this._updateItemsSize();
break;
default:
super._optionChanged(args)
}
}
_render() {
super._render();
this._updateItemsSize()
}
_renderLayout() {
const {
layout: layout
} = this.option();
const $element = $(this.element());
$element.toggleClass("dx-radiogroup-vertical", "vertical" === layout);
$element.toggleClass("dx-radiogroup-horizontal", "horizontal" === layout)
}
_renderRadios() {
this._areRadiosCreated = Deferred();
const $radios = $("<div>").appendTo(this.$element());
const {
displayExpr: displayExpr,
accessKey: accessKey,
focusStateEnabled: focusStateEnabled,
itemTemplate: itemTemplate,
tabIndex: tabIndex
} = this.option();
this._createComponent($radios, RadioCollection, {
onInitialized: _ref2 => {
let {
component: component
} = _ref2;
this._radios = component
},
onContentReady: e => {
this._fireContentReadyAction(true)
},
onItemClick: this._itemClickHandler.bind(this),
displayExpr: displayExpr,
accessKey: accessKey,
dataSource: this._dataSource,
focusStateEnabled: focusStateEnabled,
itemTemplate: itemTemplate,
keyExpr: this._getCollectionKeyExpr(),
noDataText: "",
scrollingEnabled: false,
selectByClick: false,
selectionMode: "single",
selectedItemKeys: this._getSelectedItemKeys(),
tabIndex: tabIndex
});
this._areRadiosCreated.resolve()
}
_renderSubmitElement() {
this._$submitElement = $("<input>").attr("type", "hidden").appendTo(this.$element());
this._setSubmitValue()
}
_setOptionsByReference() {
super._setOptionsByReference();
extend(this._optionsByReference, {
value: true
})
}
_setSubmitValue(value) {
value = value ?? this.option("value");
const submitValue = "this" === this.option("valueExpr") ? this._displayGetter(value) : value;
this._$submitElement.val(submitValue)
}
_setCollectionWidgetOption(name, value) {
this._areRadiosCreated.done(this._setWidgetOption.bind(this, "_radios", arguments))
}
_updateItemsSize() {
const {
layout: layout
} = this.option();
if ("horizontal" === layout) {
var _this$itemElements;
null === (_this$itemElements = this.itemElements()) || void 0 === _this$itemElements || _this$itemElements.css("height", "auto")
} else {
var _this$itemElements2;
const itemsCount = this.option("items").length;
null === (_this$itemElements2 = this.itemElements()) || void 0 === _this$itemElements2 || _this$itemElements2.css("height", 100 / itemsCount + "%")
}
}
focus() {
var _this$_radios;
null === (_this$_radios = this._radios) || void 0 === _this$_radios || _this$_radios.focus()
}
itemElements() {
var _this$_radios2;
return null === (_this$_radios2 = this._radios) || void 0 === _this$_radios2 ? void 0 : _this$_radios2._itemElements()
}
}
RadioGroup.include(DataExpressionMixin);
registerComponent("dxRadioGroup", RadioGroup);
export default RadioGroup;