docs(common): Document breaking changes in version 7

dimodi · dimodi · commit 2b5db9b6ff2a · 2024-10-21T18:39:38.000+03:00
diff --git a/components/daterangepicker/overview.md b/components/daterangepicker/overview.md
@@ -89,7 +89,7 @@ The Blazor Date Range Picker provides various parameters that allow you to confi
 | `Placeholder` |`string` | The `placeholder` attribute of the two `<input />` elements. The `Placeholder` will appear if the component is bound to **nullable** DateTime objects - `DateTime?`, but will not be rendered if the component is bound to the default value of a non-nullable DateTime objects. The Placeholder value will be displayed when the input is not focused. Once the user focuses it to start typing, the Format Placeholder (default or [customized one](#format-placeholder)) will override the Placeholder to indicate the format the date should be entered in. |
 | `ShowClearButton` | `bool` | Defines if the user can clear the component value through an **x** button rendered inside the input. |
 | `ShowWeekNumbers` | `bool` | Sets if the popup Calendars will display week numbers according to the [ISO-8601 format](https://learn.microsoft.com/en-us/dotnet/api/system.globalization.isoweek.getweekofyear). Note that the [ISO week number may differ from the conventional .NET week number](https://learn.microsoft.com/en-us/dotnet/api/system.globalization.calendar.getweekofyear). |
-| `ShowOtherMonthDays` | `bool` <br /> (`true`)| Defines whether the leading and trailing days from other months in the Calendar popup are visible in the current month view. |
+| `ShowOtherMonthDays` | `bool` | Defines whether the leading and trailing days from other months in the Calendar popup are visible in the current month view. |
 | `StartValue` and `EndValue` | `T` | The current values of the inputs for start and end of the range. Can be used for two-way binding. |
 | `TabIndex` | `int?` | The `tabindex` attribute of both `input` HTML elements in the component. They both will have the same `tabindex`. Use it to customize the tabbing (focus) order of the inputs on your page. |
 | `Title` | `string` | The title text rendered in the header of the popup(action sheet). Applicable only when [`AdaptiveMode` is set to `Auto`]({%slug adaptive-rendering%}). |
diff --git a/components/textarea/overview.md b/components/textarea/overview.md
@@ -55,8 +55,7 @@ The Blazor TextArea provides various parameters to configure the component:
 | ----------- | ----------- | ----------- |
 | `AutoCapitalize` | `string` | A `string` that maps to the [`autocapitalize`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autocapitalize) attribute of the HTML element. It's applicable only for touch devices and virtual keyboards. |
 | `AutoComplete` | `bool` | Maps to the autocomplete attribute of the HTML `<textarea>`. |
-| `AutoSize` <br /> (deprecated) | `bool` | Specifies if the TextArea will adjust its height based on the user input. You can [use CSS to limit the resizing up to a max height]({%slug textarea-kb-autosize-max-height%}). This parameter is deprecated. Use `ResizeMode` with `Auto` value instead. |
-| `ResizeMode` | `TextAreaResizeMode?` | Specifies the TextArea's resize behavior. Default behavior is the one set by the browser. |
+| `ResizeMode` | `TextAreaResizeMode?` | Specifies the TextArea's resize behavior. Default behavior is the one set by the browser. You can also [use CSS to limit the resizing up to a max height]({%slug textarea-kb-autosize-max-height%}). |
 | `Class` | `string` | The custom CSS class to be rendered on the `<span class="k-textarea">` element. |
 | `Cols` | `int?` | Maps to the `cols` attribute of the HTML `<textarea>` element. Do not use together with `Width`.
 | `DebounceDelay` | `int` | Specifies the time in milliseconds between the last typed symbol and the updating of the value. The default value is 150ms. |
diff --git a/knowledge-base/radiogroup-like-buttongroup.md b/knowledge-base/radiogroup-like-buttongroup.md
@@ -31,7 +31,7 @@ Use custom CSS to make the radio inputs invisible and style their labels to look
 
 The RadioGroup will look similar to a [ButtonGroup with single selection]({%slug buttongroup-selection%}#single-selection). The major difference is that the RadioGroup has a single value of type `<T>`, while each button in the ButtonGroup is bound to a separate `boolean` value for its selected state.
 
->tip The following example is for versions 6.0 and above, which feature an [updated HTML rendering for the RadioGroup]({%slug changes-in-6-0-0%}#radiogroup). If you are using an older version, use the [alternative CSS code from the section below](#solution-up-to-version-511).
+>tip The following example is for versions 6.0 and above, which feature an [updated HTML rendering for the RadioGroup]({%slug rendering-changes-in-6-0-0%}#radiogroup). If you are using an older version, use the [alternative CSS code from the section below](#solution-up-to-version-511).
 
 >caption Style the RadioGroup like a ButtonGroup
 
diff --git a/knowledge-base/textarea-autosize-max-height.md b/knowledge-base/textarea-autosize-max-height.md
@@ -41,7 +41,7 @@ This KB article answers the following questions:
 ````CSHTML
 <TelerikTextArea @bind-Value="@TextValue"
                  Width="500px"
-                 AutoSize="true"
+                 ResizeMode="TextAreaResizeMode.Auto"
                  Class="max-height-200" />
 
 <style>
@@ -56,6 +56,7 @@ This KB article answers the following questions:
 }
 ````
 
+> Use `AutoSize="true"` instead of `ResizeMode="TextAreaResizeMode.Auto"` with Telerik UI for Blazor versions `6.x` and older.
 
 ## See Also
 
diff --git a/upgrade/breaking-changes/2-0-0.md b/upgrade/breaking-changes/2-0-0.md
@@ -3,7 +3,7 @@ title: 2.0.0
 description: Handle the changes in the 2.0.0 major release of the Telerik UI for Blazor components.
 page_title: Breaking Changes in 2.0.0
 slug: changes-in-2-0-0
-position: 1
+position: 1000
 ---
 
 # Breaking Changes in 2.0.0
diff --git a/upgrade/breaking-changes/2-2-0.md b/upgrade/breaking-changes/2-2-0.md
@@ -3,7 +3,7 @@ title: 2.2.0
 description: Handle the changes in the 2.2.0 release of the Telerik UI for Blazor components.
 page_title: Breaking Changes in 2.2.0
 slug: changes-in-2-2-0
-position: 1
+position: 995
 ---
 
 # Breaking Changes in 2.2.0
diff --git a/upgrade/breaking-changes/3-0-0.md b/upgrade/breaking-changes/3-0-0.md
@@ -3,7 +3,7 @@ title: 3.0.0
 description: Handle the changes in the 3.0.0 release of the Telerik UI for Blazor components.
 page_title: Breaking Changes in 3.0.0
 slug: changes-in-3-0-0
-position: 1
+position: 990
 ---
 
 # Breaking Changes in 3.0.0
diff --git a/upgrade/breaking-changes/4-0-0.md b/upgrade/breaking-changes/4-0-0.md
@@ -3,7 +3,7 @@ title: 4.0.0
 description: Handle the changes in the 4.0.0 release of the Telerik UI for Blazor components.
 page_title: Breaking Changes in 4.0.0
 slug: changes-in-4-0-0
-position: 1
+position: 985
 ---
 
 # Breaking Changes in 4.0.0
diff --git a/upgrade/breaking-changes/5-0-0.md b/upgrade/breaking-changes/5-0-0.md
@@ -3,7 +3,7 @@ title: 5.0.0
 description: Handle the changes in the 5.0.0 release of the Telerik UI for Blazor components.
 page_title: Breaking Changes in 5.0.0
 slug: changes-in-5-0-0
-position: 1
+position: 980
 ---
 
 # Breaking Changes in 5.0.0
diff --git a/upgrade/breaking-changes/6-0-0.md b/upgrade/breaking-changes/6-0-0.md
@@ -0,0 +1,24 @@
+---
+title: 6.0.0
+description: Handle the changes in the 6.0.0 release of the Telerik UI for Blazor components.
+page_title: Breaking Changes in 6.0.0
+slug: changes-in-6-0-0
+position: 975
+---
+
+# Breaking Changes in 6.0.0
+
+This article outlines the breaking changes in Telerik UI for Blazor version 6.0.0.
+
+## Themes
+
+The theme color variable names have changed. This is relevant only to Blazor applications that:
+
+* [Use Telerik themes that are built from the source code]({%slug themes-customize%}#building-themes-from-source-code).
+* [Override theme variable values]({%slug themes-customize%}#setting-theme-variables).
+
+See the <a href="https://www.telerik.com/design-system/docs/themes/theme-default/migration/" target="_blank">Design System Migration Article</a>.
+
+## See Also
+
+* [Rendering changes in Telerik UI for Blazor 6.0.0]({%slug rendering-changes-in-6-0-0%})
diff --git a/upgrade/breaking-changes/7-0-0.md b/upgrade/breaking-changes/7-0-0.md
@@ -0,0 +1,54 @@
+---
+title: 7.0.0
+description: Handle the changes in the 7.0.0 release of the Telerik UI for Blazor components.
+page_title: Breaking Changes in 7.0.0
+slug: changes-in-7-0-0
+position: 970
+---
+
+# Breaking Changes in 7.0.0
+
+This article outlines the breaking changes in Telerik UI for Blazor version 7.0.0.
+
+## Common
+
+### AutoComplete, ComboBox, MultiColumnComboBox, MultiSelect
+
+The obsolete `ClearButton` parameter is removed. Use `ShowClearButton` instead.
+
+## DateRangePicker
+
+* The [`ShowOtherMonthDays` parameter's default value]({%slug daterangepicker-overview%}#daterangepicker-parameters) is changed to `false`.
+
+## DropDownButton
+
+* The [`ShowArrowButton` parameter's default value]({%slug dropdownbutton-overview%}#dropdownbutton-parameters) is changed to `false`.
+
+## FileSelect
+
+* The obsolete method `OpenFileSelectAsync()` is removed. [Use `OpenSelectFilesDialog()`]({%slug fileselect-overview%}#fileselect-reference-and-methods) instead.
+
+## Gantt
+
+
+## Grid
+
+* Columns with `Visible="false"` are editable by default in popup edit mode. To avoid this, [set `Editable="false"` together with `Visible="false"`]({%slug components/grid/editing/popup%}).
+* The obsolete `AutoFitColumn()` method is removed. [Use `AutoFitColumnAsync()`]({%slug components/grid/columns/resize%}#autofit-columns) instead.
+* The obsolete `AutoFitColumns()` method is removed. Use `AutoFitColumsAsync()` instead.
+* The obsolete `AutoFitAllColumns()` method is removed. Use `AutoFitAllColumnsAsync()` instead.
+
+## TextArea
+
+* The obsolete parameter `AutoSize` is removed. Use [`ResizeMode="TextAreaResizeMode.Auto"`]({%slug textarea-overview%}#textarea-parameters) instead of `AutoSize="true"`.
+
+## TreeList
+
+* Columns with `Visible="false"` are editable by default in popup edit mode. To avoid this, [set `Editable="false"` together with `Visible="false"`]({%slug treelist-editing-popup%}).
+* The obsolete `AutoFitColumn()` method is removed. [Use `AutoFitColumnAsync()`]({%slug treelist-columns-resize%}#autofit-columns) instead.
+* The obsolete `AutoFitColumns()` method is removed. Use `AutoFitColumsAsync()` instead.
+* The obsolete `AutoFitAllColumns()` method is removed. Use `AutoFitAllColumnsAsync()` instead.
+
+## Upload
+
+* The obsolete method `OpenFileSelectAsync()` is removed. [Use `OpenSelectFilesDialog()`]({%slug upload-overview%}#upload-reference-and-methods) instead.
diff --git a/upgrade/breaking-changes/list.md b/upgrade/breaking-changes/list.md
@@ -11,6 +11,8 @@ position: 0
 This article lists the releases of the Telerik UI for Blazor product that introduce breaking changes. You may want to go through it when [upgrading]({%slug upgrade-tutorial%}) to see whether you are affected.
 
 
+* [7.0.0]({%slug changes-in-7-0-0%})
+* [6.0.0]({%slug changes-in-6-0-0%})
 * [5.0.0]({%slug changes-in-5-0-0%})
 * [4.0.0]({%slug changes-in-4-0-0%})
 * [3.0.0]({%slug changes-in-3-0-0%})
diff --git a/upgrade/rendering-changes/3-4-0.md b/upgrade/rendering-changes/3-4-0.md
@@ -2,7 +2,7 @@
 title: 3.4.0
 description: Handle the rendering changes in the 3.4.0 release of the Telerik UI for Blazor components.
 page_title: Rendering Changes in the 3.4.0 Release 
-slug: changes-in-3-4-0
+slug: rendering-changes-in-3-4-0
 position: 1000
 ---
 
diff --git a/upgrade/rendering-changes/3-6-0.md b/upgrade/rendering-changes/3-6-0.md
@@ -2,7 +2,7 @@
 title: 3.6.0
 description: Handle the rendering changes in the 3.6.0 release of the Telerik UI for Blazor components.
 page_title: Rendering Changes in the 3.6.0 Release 
-slug: changes-in-3-6-0
+slug: rendering-changes-in-3-6-0
 position: 995
 ---
 
diff --git a/upgrade/rendering-changes/4-3-0.md b/upgrade/rendering-changes/4-3-0.md
@@ -2,7 +2,7 @@
 title: 4.3.0
 description: Handle the rendering changes in the 4.3.0 release of the Telerik UI for Blazor components.
 page_title: Rendering Changes in the 4.3.0 Release
-slug: changes-in-4-3-0
+slug: rendering-changes-in-4-3-0
 position: 985
 ---
 
diff --git a/upgrade/rendering-changes/4-6-0.md b/upgrade/rendering-changes/4-6-0.md
@@ -2,7 +2,7 @@
 title: 4.6.0
 description: Handle the rendering changes in the 4.6.0 release of the Telerik UI for Blazor components.
 page_title: Rendering Changes in the 4.6.0 Release
-slug: changes-in-4-6-0
+slug: rendering-changes-in-4-6-0
 position: 980
 ---
 
diff --git a/upgrade/rendering-changes/6-0-0.md b/upgrade/rendering-changes/6-0-0.md
@@ -2,7 +2,7 @@
 title: 6.0.0
 description: Handle the rendering changes in the 6.0.0 release of the Telerik UI for Blazor components.
 page_title: Rendering Changes in the 6.0.0 Release
-slug: changes-in-6-0-0
+slug: rendering-changes-in-6-0-0
 position: 975
 ---
 
diff --git a/upgrade/rendering-changes/7-0-0.md b/upgrade/rendering-changes/7-0-0.md
@@ -2,7 +2,7 @@
 title: 7.0.0
 description: Handle the rendering changes in the 7.0.0 release of the Telerik UI for Blazor components.
 page_title: Rendering Changes in the 7.0.0 Release
-slug: changes-in-7-0-0
+slug: rendering-changes-in-7-0-0
 position: 970
 ---
 
@@ -11,6 +11,7 @@ position: 970
 * [AIPrompt](#aiprompt)
 * [Gantt](#gantt)
 * [Menu](#menu)
+* [PanelBar](#panelbar)
 * [PDFViewer](#pdfviewer)
 * [Signature](#signature)
 * [TabStrip](#tabstrip)
@@ -36,6 +37,10 @@ position: 970
 1. The menu item elements (`<span class="k-link">`) no longer include the `k-in` class.
 2. The `<ul class="k-menu-group">` element no longer includes the `k-reset` and `k-group` classes.
 
+## PanelBar
+
+The `id` attribute of each PanelBar item (`<li class="k-panelbar-item">`) is changed from `tree-item-A_B_C_...` to `tree-item-Z`, where `A`, `B`, and `C` were the parent item's indexes, and `Z` is the current item's index within its own group and hierarchy level.
+
 ## PDFViewer
 
 The `Open`, `Download` and `Print` tools have been moved to a submenu toggled on click of a hamburger menu on the leftmost side of the Toolbar.
diff --git a/upgrade/rendering-changes/list.md b/upgrade/rendering-changes/list.md
@@ -10,13 +10,13 @@ position: 0
 
 As the Telerik UI for Blazor matures we will continuously optimize the HTML rendering and the usage of CSS classes. The rendering changes only affect the styling of the components if the application [overrides the built-in CSS styles]({%slug themes-override%}) or uses an outdated [custom theme]({%slug themes-customize%}). This article tracks the product versions with rendering changes.
 
-* [7.0.0]({%slug changes-in-7-0-0%})
-* [6.0.0]({%slug changes-in-6-0-0%})
-* [4.6.0]({%slug changes-in-4-6-0%})
-* [4.3.0]({%slug changes-in-4-3-0%})
-* [4.0.0]({%slug changes-in-4-0-0%})
-* [3.6.0]({%slug changes-in-3-6-0%})
-* [3.4.0]({%slug changes-in-3-4-0%})
+* [7.0.0]({%slug rendering-changes-in-7-0-0%})
+* [6.0.0]({%slug rendering-changes-in-6-0-0%})
+* [4.6.0]({%slug rendering-changes-in-4-6-0%})
+* [4.3.0]({%slug rendering-changes-in-4-3-0%})
+* [4.0.0]({%slug rendering-changes-in-4-0-0%})
+* [3.6.0]({%slug rendering-changes-in-3-6-0%})
+* [3.4.0]({%slug rendering-changes-in-3-4-0%})
 
 ## Good Styling Practices
 
