| id | GridBaseColumn.showEditorAlways |
|---|---|
| type | Boolean |
| default | false |
Specifies whether the column displays its values in editors.
Set the showEditorAlways property to true to display a column cell value in an editor when a user does not edit data. For example, you can use this functionality to display Boolean data as check boxes instead of the "true/false" strings.
Behavior of the editor in a cell depends on the component's edit mode:
-
The editing.mode property is set to "cell" or "batch". Users can edit values directly in their cells without switching the component to edit mode.
-
The editing.mode property is set to "row", "form" or "popup". Relevant only for Boolean values. The component displays Boolean values in read-only check boxes. Users should click the Edit button to change cell values.
[note]
This property has the following specifics:
-
The default value of this property depends on the column's dataType. For Boolean columns, the default value is true; for columns of other types - false.
-
The editCellTemplate has higher priority over the cellTemplate if the showEditorAlways property value is true. Relevant for all data types except Boolean.
-
The cellInfo.setValue function does not work when showEditorAlways is true and the component is not in edit mode.
This property has the following specifics:
-
The default value of this property depends on the column's dataType. For Boolean columns, the default value is true; for columns of other types - false.
-
The editCellTemplate has higher priority over the cellTemplate if the showEditorAlways property value is true. Relevant for all data types except Boolean.
-
The cellInfo.setValue function does not work when showEditorAlways is true and the component is not in edit mode.
This property has the following specifics:
-
The default value of this property depends on the column's dataType. For Boolean columns, the default value is true; for columns of other types - false.
-
The editCellTemplate has higher priority over the cellTemplate if the showEditorAlways property value is true. Relevant for all data types except Boolean.
-
The cellInfo.setValue function does not work when showEditorAlways is true and the component is not in edit mode.
This property has the following specifics:
-
The default value of this property depends on the column's dataType. For Boolean columns, the default value is true; for columns of other types - false.
-
The editCellTemplate has higher priority over the cellTemplate if the showEditorAlways property value is true. Relevant for all data types except Boolean.
-
The cellInfo.setValue function does not work when showEditorAlways is true and the component is not in edit mode.
-
To ensure {WidgetName} initializes editors with the correct dimensions when showEditorAlways is enabled for a column, set renderAsync to
true.
[/note]
The following example illustrates how this property works for the Boolean and Date data types:
<!--JavaScript-->$(function() {
$("#{widgetName}Container").dx{WidgetName}({
// ...
columns: [
{
dataField: "BirthDate",
dataType: 'date'
},
{
dataField: "OrderDate",
dataType: 'date',
showEditorAlways: true
},
//...
{
dataField: "CheckedState",
dataType: 'boolean',
showEditorAlways: false
},
{
dataField: "AvailabilityState",
dataType: 'boolean'
},
// ...
]
});
});
<!--HTML-->
<dx-{widget-name} ... >
<dxi-{widget-name}-column dataField="BirthDate" dataType="date"></dxi-{widget-name}-column>
<dxi-{widget-name}-column dataField="OrderDate" dataType="date" showEditorAlways="true"></dxi-{widget-name}-column>
<dxi-{widget-name}-column dataField="CheckedState" dataType="boolean" showEditorAlways="false"></dxi-{widget-name}-column>
<dxi-{widget-name}-column dataField="AvailabilityState" dataType="boolean" ></dxi-{widget-name}-column>
</dx-{widget-name}>
<!--TypeScript-->
import { Dx{WidgetName}Module } from "devextreme-angular";
// ...
export class AppComponent {
// ...
}
@NgModule({
imports: [
// ...
Dx{WidgetName}Module
],
// ...
})
<!-- tab: App.vue -->
<template>
<Dx{WidgetName} ... >
<DxColumn
data-field="BirthDate"
data-type="date"
/>
<DxColumn
data-field="OrderDate"
data-type="date"
:show-editor-always="true"
/>
<DxColumn
data-field="CheckedState"
data-type="boolean"
:show-editor-always="false"
/>
<DxColumn
data-field="AvailabilityState"
data-type="boolean"
/>
</Dx{WidgetName}>
</template>
<script>
import 'devextreme/dist/css/dx.fluent.blue.light.css';
import Dx{WidgetName}, {
DxColumn
} from 'devextreme-vue/{widget-name}';
export default {
components: {
Dx{WidgetName},
DxColumn
},
// ...
}
</script>
<!-- tab: App.js -->
import React from 'react';
import 'devextreme/dist/css/dx.fluent.blue.light.css';
import {WidgetName}, {
Column
} from 'devextreme-react/{widget-name}';
export default function App() {
return (
<{WidgetName} ... >
<Column
dataField="BirthDate"
dataType="date"
/>
<Column
dataField="OrderDate"
dataType="date"
showEditorAlways={true}
/>
<Column
dataField="CheckedState"
dataType="boolean"
showEditorAlways={false}
/>
<Column
dataField="AvailabilityState"
dataType="boolean"
/>
</{WidgetName}>
);
}
#####See Also#####
- columns[].editorOptions
