Skip to content

Commit 4893efb

Browse files
author
Kendo Bot
committed
Sync with Kendo UI Professional
1 parent b54fdfe commit 4893efb

File tree

105 files changed

+3104
-826
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

105 files changed

+3104
-826
lines changed

‎docs-aspnet-core/_config.yml‎

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,21 @@ navigation:
126126
"html-helpers/data-management/grid/accessibility":
127127
title: "Accessibility"
128128
position: 60
129+
"html-helpers/data-management/treelist/editing":
130+
title: "Editing"
131+
position: 3
132+
"html-helpers/data-management/treelist/export":
133+
title: "Export"
134+
position: 6
135+
"html-helpers/data-management/treelist/columns":
136+
title: "Columns"
137+
position: 7
138+
"html-helpers/data-management/treelist/globalization":
139+
title: "Globalization"
140+
position: 40
141+
"html-helpers/data-management/treelist/accessibility":
142+
title: "Accessibility"
143+
position: 50
129144
"html-helpers/data-management/pivotgrid":
130145
title: "PivotGrid"
131146
"html-helpers/data-management/spreadsheet/import-and-export-data":
@@ -134,18 +149,57 @@ navigation:
134149
title: "End-User Documentation"
135150
"html-helpers/editors":
136151
title: "Editors"
152+
"html-helpers/editors/autocomplete/accessibility":
153+
title: "Accessibility"
154+
position: 50
155+
"html-helpers/editors/combobox/accessibility":
156+
title: "Accessibility"
157+
position: 50
158+
"html-helpers/editors/daterangepicker/globalization":
159+
title: "Globalization"
160+
position: 40
161+
"html-helpers/editors/daterangepicker/accessibility":
162+
title: "Accessibility"
163+
position: 50
137164
"html-helpers/editors/datetimepicker/globalization":
138165
title: "Globalization"
139166
position: 40
140167
"html-helpers/editors/datetimepicker/accessibility":
141168
title: "Accessibility"
142169
position: 50
170+
"html-helpers/editors/dropdownlist/accessibility":
171+
title: "Accessibility"
172+
position: 50
173+
"html-helpers/editors/dropdowntree/accessibility":
174+
title: "Accessibility"
175+
position: 50
176+
"html-helpers/editors/editor/accessibility":
177+
title: "Accessibility"
178+
position: 50
143179
"html-helpers/editors/listbox/globalization":
144180
title: "Globalization"
145181
position: 40
146182
"html-helpers/editors/listbox/accessibility":
147183
title: "Accessibility"
148184
position: 50
185+
"html-helpers/editors/multicolumncombobox/accessibility":
186+
title: "Accessibility"
187+
position: 50
188+
"html-helpers/editors/multiselect/accessibility":
189+
title: "Accessibility"
190+
position: 50
191+
"html-helpers/editors/numerictextbox/accessibility":
192+
title: "Accessibility"
193+
position: 50
194+
"html-helpers/editors/rating/accessibility":
195+
title: "Accessibility"
196+
position: 50
197+
"html-helpers/editors/switch/accessibility":
198+
title: "Accessibility"
199+
position: 50
200+
"html-helpers/editors/upload/accessibility":
201+
title: "Accessibility"
202+
position: 50
149203
"html-helpers/editors/listbox/binding":
150204
title: "Data Binding"
151205
position: 2

‎docs-aspnet-core/accessibility/accessibility-compliance.md‎

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,12 @@ The following table lists the Telerik UI for ASP.NET Core components which suppo
1313
|Component |Section 508 |WCAG 2.1 |Keyboard Navigation
1414
|:--- |:--- |:--- |:---
1515
|AutoComplete |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/autocomplete/keyboard-navigation)
16-
|BarCode |Yes |AAA |N/A
16+
|BarCode |Yes |AAA |n/a
1717
|Button |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/button/keyboard-navigation)
1818
|ButtonGroup |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/buttongroup/keyboard-navigation)
1919
|Calendar |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/calendar/keyboard-navigation)
20-
|Charts |Yes |AAA |N/A
21-
|Chat |Yes |AAA |N/A
20+
|Charts |Yes |AAA |n/a
21+
|Chat |Yes |AAA |n/a
2222
|ComboBox |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/combobox/keyboard-navigation)
2323
|ColorPicker |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/colorpicker/keyboard-navigation)
2424
|DateInput |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/dateinput/keyboard-navigation)
@@ -30,35 +30,35 @@ The following table lists the Telerik UI for ASP.NET Core components which suppo
3030
|Editor |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/editor/keyboard-navigation)
3131
|Gantt |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/gantt/keyboard-navigation)
3232
|Grid |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/grid/keyboard-navigation)
33-
|LinearGauge |Yes |AAA |N/A
33+
|LinearGauge |Yes |AAA |n/a
3434
|ListBox |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/listbox/keyboard-navigation)
3535
|ListView |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/listview/keyboard-navigation)
3636
|Map |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/map/index)
3737
|MaskedTextbox |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/maskedtextbox/index)
3838
|Menu |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/menu/keyboard-navigation)
3939
|MediaPlayer |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/mediaplayer/keyboard-navigation)
4040
|MultiSelect |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/multiselect/keyboard-navigation)
41-
|Notification |Yes |AA |N/A
41+
|Notification |Yes |AA |n/a
4242
|NumericTextbox|Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/numerictextbox/keyboard-navigation)
4343
|PanelBar |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/panelbar/keyboard-navigation)
44-
|PivotGrid |Yes |AAA |N/A
45-
|QRCode |Yes |AAA |N/A
46-
|RadialGauge |Yes |AAA |N/A
47-
|Responsive Panel |Yes |AA |N/A
48-
|ScrollView |Yes |AAA |N/A
44+
|PivotGrid |Yes |AAA |n/a
45+
|QRCode |Yes |AAA |n/a
46+
|RadialGauge |Yes |AAA |n/a
47+
|Responsive Panel |Yes |AA |n/a
48+
|ScrollView |Yes |AAA |n/a
4949
|Scheduler |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/scheduler/selection)
5050
|Slider |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/slider/keyboard-navigation)
51-
|Sortable |Yes |AAA |N/A
51+
|Sortable |Yes |AAA |n/a
5252
|Splitter |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/splitter/keyboard-navigation)
53-
|Spreadsheet |No |N/A |N/A
53+
|Spreadsheet |No |n/a |n/a
5454
|Switch |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/switch/keyboard-navigation)
5555
|TabStrip |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/tabstrip/keyboard-navigation)
5656
|TimePicker |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/timepicker/keyboard-navigation)
5757
|ToolBar |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/toolbar/index)
58-
|Tooltip |Yes |AA |N/A
58+
|Tooltip |Yes |AA |n/a
5959
|TreeList |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/treelist/keyboard-navigation)
6060
|TreeView |Yes |AA |[Yes](http://demos.telerik.com/aspnet-core/treeview/keyboard-navigation)
61-
|Upload |Yes |AA |N/A
61+
|Upload |Yes |AA |n/a
6262
|Window |Yes |AAA |[Yes](http://demos.telerik.com/aspnet-core/window/keyboard-navigation)
6363

6464
## Suggested Links

‎docs-aspnet-core/html-helpers/charts/chart-types/overview.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The Charts support a wide range of series types.
1212

1313
## Categorical Charts
1414

15-
[Categorical charts]({% slug htmlhelpers_categoricalcharts_aspnetcorev %}) provide built-in support for displaying dates. The categories represent unique values which are not mathematically related to each other.</p>
15+
[Categorical charts]({% slug htmlhelpers_categoricalcharts_aspnetcore %}) provide built-in support for displaying dates. The categories represent unique values which are not mathematically related to each other.</p>
1616

1717
Examples of categorical charts are [Area]({% slug areacharts_aspnetcore_htmlhelper %}), [Bar]({% slug barcharts_aspnetcore_htmlhelper %}), [Box Plot]({% slug boxplotcharts_aspnetcore_htmlhelper %}), [Bullet]({% slug bulletcharts_aspnetcore_htmlhelper %}), and [Line Charts]({% slug linecharts_aspnetcore_htmlhelper %}).
1818

‎docs-aspnet-core/html-helpers/data-management/treelist/accessibility/keyboard-navigation.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
title: Keyboard Navigation
3+
page_title: Keyboard Navigation | Telerik UI TreeList HtmlHelper for ASP.NET Core
4+
description: "Get started with the Telerik UI TreeList HtmlHelper for ASP.NET Core and learn about the accessibility support it provides through its keyboard navigation functionality."
5+
slug: htmlhelpers_treelist_aspnetcore_keynav
6+
position: 2
7+
---
8+
9+
# Keyboard Navigation
10+
11+
By default, the keyboard navigation of the TreeList is disabled.
12+
13+
For a complete example, refer to the [demo on using the keyboard navigation of the TreeList](https://demos.telerik.com/aspnet-core/treelist/keyboard-navigation).
14+
15+
The TreeList supports its keyboard navigation functionality through the `Navigatable()` method. When enabled, you can initially select a row or cell and then move within the TreeList by using the `Arrow` keys. The navigation occurs at a cell level regardless of what the `Selectable()` mode is. To select the current row or cell, press `Space`.
16+
17+
The following example demonstrates how to enable the key navigation in the TreeList.
18+
19+
@(Html.Kendo().TreeList<Kendo.Mvc.Examples.Models.TreeList.EmployeeDirectoryModel>()
20+
.Name("treelist")
21+
/* Other configuration. */
22+
.Navigatable()
23+
)
24+
25+
The keyboard navigation of the TreeList works by listening to the `keydown` events on the wrapper element of the helper. Its behavior is based on the assumption that whatever the user does is in accordance with the currently focused TreeList cell and not with the focused element of the browser. If the data cells of the TreeList contain hyperlinks that have to be activated through the keyboard:
26+
27+
1. Navigate to the respective TreeList cell by using the `Arrow` keys.
28+
1. Press `Enter` to focus the hyperlink inside the cell.
29+
1. Press `Enter` again.
30+
31+
To return the focus on the table cell, press `Esc`. In order for the hyperlinks to be inaccessible through tabbing, set the `tabindex="-1"` attribute to the custom hyperlinks.
32+
33+
You can also avoid the procedure and bypass the keyboard navigation of the TreeList, access the custom hyperlinks with tabbing, and activate them with `Enter`. To achieve this, prevent the `keydown` event bubbling of the custom hyperlinks. As a result, the `Enter` key-presses will be unnoticed by the TreeList.
34+
35+
## See Also
36+
37+
* [Keyboard Navigation by the TreeList HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/treelist/keyboard-navigation)
38+
* [Accessibility in Telerik UI for ASP.NET Core]({% slug overview_accessibility %})

‎docs-aspnet-core/html-helpers/data-management/treelist/accessibility/overview.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
title: Overview
3+
page_title: TreeList Accessibility | Telerik UI TreeList HtmlHelper for ASP.NET Core
4+
description: "Get started with the Telerik UI TreeList HtmlHelper for ASP.NET Core and learn about its accessibility support for WAI-ARIA, Section 508, and WCAG 2.1."
5+
slug: htmlhelpers_treelist_aspnetcore_accessibility
6+
position: 1
7+
---
8+
9+
# TreeList Accessibility
10+
11+
The TreeList is accessible by screen readers and provides WAI-ARIA, Section 508, WCAG 2.1, and keyboard support.
12+
13+
For more information, refer to:
14+
* [Keyboard navigation by the UI for ASP.NET Core TreeList]({% slug htmlhelpers_treelist_aspnetcore_keynav %})
15+
* [Accessibility in Telerik UI for ASP.NET Core]({% slug overview_accessibility %})
16+
17+
## WAI-ARIA
18+
19+
The component follows the WAI-ARIA Authoring Practices for implementing the keyboard navigation for its component role and is tested against the popular screen readers. For more information, refer to the article on [WAI-ARIA support in UI for ASP.NET Core]({% slug overview_accessibility %}#wai-aria).
20+
21+
## Section 508
22+
23+
The TreeList is compliant with the Section 508 requirements. For more information, refer to the article on [Section 508 support in Kendo UI for jQuery]({% slug overview_accessibility %}#section-508).
24+
25+
## WCAG 2.1
26+
27+
The TreeList supports the standards for providing accessible web content which are set by the [Web Content Accessibility Guidelines 2.1](https://www.w3.org/TR/WCAG/).
28+
29+
For more information, refer to:
30+
* [WCAG 2.1 support by the TreeList (demo)](https://demos.telerik.com/aspnet-core/treelist/index)
31+
* [WCAG 2.1 compliance in UI for ASP.NET Core ]({% slug overview_accessibility %}#wcag-21)
32+
33+
## See Also
34+
35+
* [WCAG 2.1 Support by the TreeList HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/treelist/index)
36+
* [Keyboard Navigation by the TreeList HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/treelist/keyboard-navigation)
37+
* [Keyboard Navigation by the TreeList HtmlHelper for ASP.NET Core]({% slug htmlhelpers_treelist_aspnetcore_keynav %})
38+
* [Accessibility Compliance in Telerik UI for ASP.NET Core]({% slug compliance_accessibility %})

‎docs-aspnet-core/html-helpers/data-management/treelist/aggregates.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: Aggregates
3+
page_title: Aggregates | Telerik UI TreeList HtmlHelper for ASP.NET Core
4+
description: "Get started with the Telerik UI TreeList HtmlHelper for ASP.NET Core and group its data by using aggregate functions."
5+
slug: htmlhelpers_treelist_aspnetcore_aggregates
6+
position: 3
7+
---
8+
9+
# Aggregates
10+
11+
The TreeList enables you to display aggregated number results when the user groups its data.
12+
13+
To enable grouping with aggregate functions, use the `DataSource.Aggregates()`, `ClientGroupFooterTemplate()`, `ClientGroupHeaderColumnTemplate()`, or `ClientFooterTemplate()` methods of the TreeList, and the `aggregate` fields of its data source. For a runnable example, refer to the [demo on using aggregate functions in the TreeList](https://demos.telerik.com/aspnet-core/treelist/aggregates).
14+
15+
## See Also
16+
17+
* [Aggregates by the TreeList HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/treelist/aggregates)
18+
* [Server-Side API](/api/treelist)

‎docs-aspnet-core/html-helpers/data-management/treelist/ajax-binding.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ The Ajax-bound mode has the following features:
1616
- The TreeList retrieves only the data (in JSON format) representing the current level items.
1717
- All column templates are executed client-side. They follow the [Kendo UI for jQuery template](http://docs.telerik.com/kendo-ui/framework/templates/overview) definition rules and may contain embedded JavaScript code.
1818

19-
To configure the Grid for ASP.NET Core to do Ajax binding:
19+
To configure the TreeList for ASP.NET Core to do Ajax binding:
2020

2121
1. Create a new ASP.NET Core web application. Follow the steps from the [introductory article]({% slug gettingstarted_aspnetmvc6_aspnetmvc %}) to add Telerik UI for ASP.NET Core to the application.
2222
1. Open the `HomeController.cs` and add a new action method which will return the items as JSON. The TreeList makes Ajax requests to this action.

‎docs-aspnet-core/html-helpers/data-management/treelist/client-side-paging.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,10 @@ position: 4
1010

1111
The TreeList supports client-side paging for large sets of data.
1212

13-
To enable the paging functionality, configure the `Pageable` settings.
13+
To enable the paging functionality of the TreeList, configure the `Pageable` settings.
1414

1515
> * Remember to set a `PageSize`. You can define a `PageSize` in the `Pageable` or in the `DataSource` settings. If an already existing dataSource instance is passed to the TreeList, then the `PageSize` option has to be set in the dataSource settings and not in the `Pageable` settings.
16-
> * By default, `ServerOperations` are enabled in the Grid ASP.Net Core wrapper. For client-side paging you have to disable the server operations by setting the `ServerOperations` to `false`.
16+
> * By default, `ServerOperations` are enabled in the TreeList HtmlHelper. For client-side paging you have to disable the server operations by setting the `ServerOperations` to `false`.
1717
1818
@(Html.Kendo().TreeList<Kendo.Mvc.Examples.Models.TreeList.EmployeeDirectoryModel>()
1919
.Name("treelist")
@@ -43,7 +43,7 @@ To enable the paging functionality, configure the `Pageable` settings.
4343

4444
The root TreeList items have their `parentId` field set to the default value for no parent. By default, the value is `null` and can be configured through the `dataSource.schema.model.fields[FIELD_NAME].defaultValue` option.
4545

46-
> If you use client-side paging together with editing, the user adds an item, and the `id` field of the model has to be nullable (for example, `int?`), then you have to configure the model so that it features a default `id` field value on the client-side which is different from the default `parentId` field value. In such cases, the default value of the `id` field (`null`) will equal the default `parentId` field value (`null`) which creates a circular dependency. To avoid this issue, set the default `id` field to a different value&mdash;for example, `zero`.
46+
> If you use client-side paging together with editing, the user adds an item, and the `id` field of the model has to be nullable (for example, `int?`), then you have to configure the model so that it features a default `id` field value on the client side which is different from the default `parentId` field value. In such cases, the default value of the `id` field (`null`) will equal the default `parentId` field value (`null`) which creates a circular dependency. To avoid this issue, set the default `id` field to a different value, for example, to `zero`.
4747
4848
@(Html.Kendo().TreeList<Kendo.Mvc.Examples.Models.TreeList.EmployeeDirectoryModel>()
4949
.Name("treelist")
@@ -69,4 +69,5 @@ The root TreeList items have their `parentId` field set to the default value for
6969

7070
## See Also
7171

72+
* [Client-Side paging by the TreeList HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/treelist/client-side-paging)
7273
* [Server-Side API](/api/treelist)

‎docs-aspnet-core/html-helpers/data-management/treelist/columns/column-menu.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: Column Menu
3+
page_title: Column Menu | Telerik UI TreeList HtmlHelper for ASP.NET Core
4+
description: "Get started with the Telerik UI TreeList HtmlHelper for ASP.NET Core and get to know how to enable the column menu."
5+
slug: htmlhelpers_treelist_aspnetcore_column_menu
6+
position: 2
7+
---
8+
9+
# Column Menu
10+
11+
The TreeList provides a built-in option for triggering column operations through a menu.
12+
13+
To enable the column-menu implementation, set `.ColumnMenu()`. As a result, the column headers of the TreeList will render a column menu which allows the user to sort, filter, or change the visibility of the column. The column menu also detects when a specific column operation is disabled through the column definition and excludes the corresponding UI from its rendering. For a runnable example, refer to the [demo on implementing a column menu in the TreeList](https://demos.telerik.com/aspnet-core/treelist/column-menu).
14+
15+
## See Also
16+
17+
* [Column Menu by the TreeList HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/treelist/column-menu)
18+
* [Server-Side API](/api/treelist)

0 commit comments

Comments
 (0)