Skip to content

Commit 1067c88

Browse files
Grids: Update column width API descriptions (DevExpress#7969) (DevExpress#7980)
1 parent 4dc7da4 commit 1067c88

File tree

2 files changed

+12
-6
lines changed

2 files changed

+12
-6
lines changed

api-reference/10 UI Components/GridBase/1 Configuration/columnAutoWidth.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,14 @@ default: false
55
---
66
---
77
##### shortDescription
8-
Specifies whether columns should adjust their widths to the content.
8+
Specifies if the component adjusts column widths to fit content.
99

1010
---
11-
When this property is set to **true**, all columns adjust their width to the content.
11+
When this property is disabled, the component displays data in equal-width columns. {WidgetName} stretches columns to the component container and cuts off values that do not fit. The component displayes an ellipsis at the end of each cut off value.
1212

13-
If the {WidgetName} is wider than its overall content, the columns are stretched to occupy all available width. To avoid this, set the [columnWidth](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/columnWidth.md '{basewidgetpath}/Configuration/#columnWidth') or **columns**.[width](/api-reference/_hidden/GridBaseColumn/width.md '{basewidgetpath}/Configuration/columns/#width') property to *"auto"*.
13+
When **columnAutoWidth** is enabled, the component adjusts the width of each column to avoid cutting off long values. If {WidgetName} content is wider than the component container, {WidgetName} enables horizontal [scrolling](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/scrolling/) to fit content.
1414

15-
If the content is wider, the **columnAutoWidth** property set to **true** causes horizontal scrolling. You can set the [allowHiding](/api-reference/_hidden/GridBaseColumn/allowHiding.md '{basewidgetpath}/Configuration/columns/#allowHiding') property to **false** for columns you want to be displayed continuously.
16-
17-
When the **columnAutoWidth** property is set to **false**, all columns have identical width, which in turn depends on the width of the UI component.
15+
[note] When this property is enabled, virtual keyboards may experience issues with {WidgetName} input.
1816

1917
#include common-demobutton-named with {
2018
url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/ColumnResizing/",
@@ -26,6 +24,7 @@ When the **columnAutoWidth** property is set to **false**, all columns have iden
2624
}
2725

2826
#####See Also#####
27+
- [columnWidth](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/#columnWidth)
2928
- [width](/api-reference/10%20UI%20Components/DOMComponent/1%20Configuration/width.md '{basewidgetpath}/Configuration/#width')
3029
- [columnFixing](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/columnFixing '{basewidgetpath}/Configuration/columnFixing/')
3130
- [wordWrapEnabled](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/wordWrapEnabled.md '{basewidgetpath}/Configuration/#wordWrapEnabled')

api-reference/10 UI Components/GridBase/1 Configuration/columnWidth.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,12 @@ default: undefined
88
Specifies the width for all [data columns](/concepts/05%20UI%20Components/DataGrid/15%20Columns/10%20Column%20Types/1%20Data%20Columns.md '/Documentation/Guide/UI_Components/{WidgetName}/Columns/Column_Types/Data_Columns/'). Has a lower priority than the **column**.[width](/api-reference/_hidden/GridBaseColumn/width.md '{basewidgetpath}/Configuration/columns/#width') property.
99

1010
---
11+
When this property is unspecified and the component container is wider than the content, {WidgetName} stretches columns to fit the container width. If the content is wider than the component container, {WidgetName} cuts off long values that do not fit. {WidgetName} displayes an ellipsis at the end of each cut off value.
12+
13+
When this property is *"auto"*, the component adjusts column widths to fit data. The component decreases its width if the content is narrower than the {WidgetName} container. If the content is wider than the component container, {WidgetName} enables horizontal [scrolling](/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/scrolling/) to fit content.
14+
15+
[note] When **columnWidth** is set to *"auto"*, virtual keyboards may experience issues with {WidgetName} input.
16+
1117
#include common-demobutton-named with {
1218
url: "https://js.devexpress.com/Demos/WidgetsGallery/Demo/DataGrid/ColumnResizing/",
1319
name: "DataGrid"
@@ -18,4 +24,5 @@ Specifies the width for all [data columns](/concepts/05%20UI%20Components/DataGr
1824
}
1925

2026
#####See Also#####
27+
- [columnAutoWidth]({basewidgetpath}/Configuration/#columnAutoWidth)
2128
- [columnMinWidth](/api-reference/10%20UI%20Components/GridBase/1%20Configuration/columnMinWidth.md '{basewidgetpath}/Configuration/#columnMinWidth')

0 commit comments

Comments
 (0)