Skip to content

Commit 69e1475

Browse files
author
Kendo Bot
committed
Sync with Kendo UI Professional
1 parent 7961206 commit 69e1475

36 files changed

+1062
-575
lines changed

‎docs-aspnet/_config-mvc.yml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ knowledge-base/grid-ajax-editing.md,
4040
knowledge-base/grid-bind-a-dropdownlist-editor.md,
4141
knowledge-base/grid-custom-datasource-razor-pages.md,
4242
knowledge-base/grid-custom-datasource.md,
43+
knowledge-base/grid-dynamic-popup-editing.md,
4344
knowledge-base/grid-dynamic.md,
4445
knowledge-base/grid-editing-upload-in-popup,
4546
knowledge-base/grid-enable-operations-for-object-column.md,

‎docs-aspnet/html-helpers/data-management/grid/export/excel-export.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,7 @@ By default, the Telerik UI Grid for {{ site.framework }} exports only the curren
117117

118118
## Customizing Excel Documents
119119

120-
The [`ExcelExport()`](/api/Kendo.Mvc.UI.Fluent/GridEventBuilder#excelexportsystemstring) event allows the customization of the generated Excel document. The `workbook` event argument exposes the generated Excel workbook configuration. For more information on how the Excel documents work, refer to the article on [Excel export in Kendo UI for jQuery]({% slug introduction_excelexport_kendoui %}).
120+
The [`ExcelExport()`](/api/Kendo.Mvc.UI.Fluent/GridEventBuilder#excelexportsystemstring) event allows the customization of the generated Excel document. The `workbook` event argument exposes the generated Excel workbook configuration. For more information on how the Excel documents work, refer to the article on [Excel export in Kendo UI for jQuery](https://docs.telerik.com/kendo-ui/framework/excel/introduction).
121121

122122
1. Attach an excel export handler.
123123

‎docs-aspnet/html-helpers/data-management/grid/scrolling/endless.md‎

Lines changed: 65 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -10,31 +10,32 @@ position: 3
1010

1111
Endless scrolling is suitable when you display large number of items and use editing, grouping, filtering, sorting, or hierarchy.
1212

13-
For runnable examples, refer to:
14-
* [Demo on endless scrolling of remote data by the Grid](https://demos.telerik.com/{{ site.platform }}/grid/endless-scrolling-remote)
13+
For a runnable example, refer to the [demo on endless scrolling of remote data in the Grid](https://demos.telerik.com/{{ site.platform }}/grid/endless-scrolling-remote).
1514

1615
## Getting Started
1716

1817
To enable endless scrolling, set the [`Scrollable.Endless(true)`](/api/Kendo.Mvc.UI.Fluent/GridScrollSettingsBuilder#endlesssystemboolean) property to `true`.
1918

20-
> For the functionality to work as expected there are two requirements:
21-
> - There needs to be a vertical scrollbar
22-
> - The height of the grid should be constant
19+
> For the functionality to work as expected, provide for the following requirements:
20+
> - Implement a vertical scrollbar.
21+
> - Set a constant height to the Grid.
2322
2423
The Grid supports endless scrolling both when it is bound to local and remote data:
2524
* When bound to local data arrays, the Grid serializes all items to the client and while the user scrolls, the widget displays new items.
2625
* When bound to remote data, the Grid serializes only the items for one page. When the user scrolls to the end of the list, the Grid sends an AJAX request to get the items for the next page. When the data is returned, the Grid renders only the new items and appends them to the old ones.
2726

2827
```HtmlHelper
29-
@(Html.Kendo().Grid<AspNetCoreGrid.Models.OrderViewModel>()
30-
.Name("grid")
31-
.Scrollable(sc => sc.Endless(true))
32-
/* Other configuration. */
33-
)
28+
@(Html.Kendo().Grid<AspNetCoreGrid.Models.OrderViewModel>()
29+
.Name("grid")
30+
.Scrollable(sc => sc.Endless(true))
31+
/* Other configuration. */
32+
)
33+
```
3434
{% if site.core %}
3535
```TagHelper
3636
<kendo-grid name="grid" >
3737
<scrollable enabled="true" endless="true"/>
38+
<!--Other configuration.-->
3839
</kendo-grid>
3940
```
4041
{% endif %}
@@ -46,17 +47,69 @@ Endless scrolling works with editing in a similar way as it works with regular p
4647
## Using with Grouping
4748

4849
Out of the box, endless scrolling works together with grouping. However, when the two features are used together, the Grid behaves in the following specific way:
49-
* If the Grid is scrolled to the bottom, the number of the items it will request will be equal to the number of items and the page size.
50+
* If the Grid is scrolled to the bottom, the number of the items it will request will be equal to the number of items on the page size.
5051
* If the last group of items is collapsed, the Grid will still make requests for the items from that group.
5152
* If a group of items spans across multiple pages, the Grid will make multiple requests.
5253
* When a particular subset of items is returned, the items will be rendered and hidden because the group is collapsed. The Grid will continue to request the items until a new group is reached or until none of the items are present for to be requested.
5354

5455
## Using with Hierarchy
5556

56-
If the Grid displays hierarchical data and an item gets expanded, it will not be collapsed when the items are scrolled and a new page will be requested.
57+
If the Grid displays hierarchical data and an item gets expanded, it will not be collapsed when the items are scrolled, and a new page will be requested.
5758

5859
> The filtering, sorting, and grouping operations reset the scroll position.
5960
61+
## Using with DataSource Operations
62+
63+
When a filter, sort, or group is applied through the [`DataSource` methods](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource#methods) and not through the Grid UI, the scroll position will not be automatically reset.
64+
65+
In such cases, you have to manually update the scroll position and [`pageSize`](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/pagesize).
66+
67+
```HtmlHelper
68+
@(Html.Kendo().Grid<AspNetCoreGrid.Models.OrderViewModel>()
69+
.Name("grid")
70+
.Scrollable(sc => sc.Endless(true))
71+
/* Other configuration. */
72+
)
73+
74+
<script>
75+
let grid = $("#grid").data("kendoGrid");
76+
77+
// Reset the scroll position and update the pageSize before invoking the operation.
78+
grid.dataSource.options.endless = null;
79+
grid._endlessPageSize = grid.dataSource.options.pageSize;
80+
grid.dataSource.pageSize(grid.dataSource.options.pageSize);
81+
82+
// Apply a filter, sort, or group after that.
83+
let filter = {field: "exampleField", operator: "eq", value: "example value"}
84+
grid.dataSource.filter(filter);
85+
</script>
86+
```
87+
{% if site.core %}
88+
```TagHelper
89+
<kendo-grid name="grid" >
90+
<scrollable enabled="true" endless="true"/>
91+
<!--Other configuration.-->
92+
</kendo-grid>
93+
94+
<script>
95+
let grid = $("#grid").data("kendoGrid");
96+
97+
// Reset the scroll position and update the pageSize before invoking the operation.
98+
grid.dataSource.options.endless = null;
99+
grid._endlessPageSize = grid.dataSource.options.pageSize;
100+
grid.dataSource.pageSize(grid.dataSource.options.pageSize);
101+
102+
// Apply a filter, sort, or group after that.
103+
let filter = {field: "exampleField", operator: "eq", value: "example value"}
104+
grid.dataSource.filter(filter);
105+
</script>
106+
```
107+
{% endif %}
108+
109+
## Known Limitations
110+
111+
Either enable endless scrolling or paging, and do not use both features simultaneously.
112+
60113
## See Also
61114

62115
* [Endless Scrolling of Remote Data by the Grid HtmlHelper for {{ site.framework }} (Demo)](https://demos.telerik.com/{{ site.platform }}/grid/endless-scrolling-remote)

‎docs-aspnet/html-helpers/editors/colorpalette/images/basic-presets.png‎

1.89 KB
Loading

‎docs-aspnet/html-helpers/editors/colorpalette/images/custom-presets.png‎

14.2 KB
Loading

‎docs-aspnet/html-helpers/editors/colorpalette/images/websafe-presets.png‎

13.3 KB
Loading

‎docs-aspnet/html-helpers/editors/colorpalette/presets.md‎

Lines changed: 46 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,48 @@ position: 2
88

99
# Color Presets
1010

11-
The ColorPalette provides a set of predefined color palettes such as `basic` (default) and `websafe`. You can also configure a custom set of palettes.
11+
The ColorPalette provides a set of predefined color palettes - `basic` (default) and `websafe`. You can also configure a custom set of palettes.
1212

13-
The example below demonstrates how to use the presets and add custom palettes:
13+
### Basic Palette
14+
15+
The example below demonstrates how to use the `basic` palettes:
16+
17+
```HtmlHelper
18+
@(Html.Kendo().ColorPalette()
19+
.Name("basic")
20+
.Palette(ColorPickerPalette.Basic))
21+
```
22+
```TagHelper
23+
<kendo-colorpalette name="basic"
24+
palette="ColorPickerPalette.Basic">
25+
</kendo-colorpalette>
26+
```
27+
The result from the configuration is :
28+
29+
![Basic Presets](./images/basic-presets.png)
30+
31+
### WebSafe Palette
32+
33+
The example below demonstrates how to use the `websafe` palettes:
34+
35+
```HtmlHelper
36+
@(Html.Kendo().ColorPalette()
37+
.Name("websafe")
38+
.Palette(ColorPickerPalette.WebSafe))
39+
```
40+
```TagHelper
41+
<kendo-colorpalette name="websafe"
42+
palette="ColorPickerPalette.WebSafe">
43+
</kendo-colorpalette>
44+
```
45+
46+
The result from the configuration is :
47+
48+
![WebSafe Presets](./images/websafe-presets.png)
49+
50+
### Custom Palette
51+
52+
The following example demonstrates how to add custom palettes:
1453

1554
```HtmlHelper
1655
<div id="example">
@@ -41,8 +80,6 @@ The example below demonstrates how to use the presets and add custom palettes:
4180
"#7f7f7f", "#0c0c0c", "#635672", "#343336", "#746425", "#4e5d3c", "#295e70", "#243c75", "#372970", "#533366"
4281
}))
4382
</div>
44-
45-
4683
<div class="box-col">
4784
<h4>Austin</h4>
4885
@(Html.Kendo().ColorPalette()
@@ -56,21 +93,6 @@ The example below demonstrates how to use the presets and add custom palettes:
5693
"#7f7f7f", "#0c0c0c", "#74a50f", "#1f1e16", "#4a6300", "#38342d", "#7f3300", "#484a32", "#4a3521", "#8f5200"
5794
}))
5895
</div>
59-
60-
<br style="clear:both">
61-
62-
<div class="box-col">
63-
<h4>WebSafe</h4>
64-
@(Html.Kendo().ColorPalette()
65-
.Name("websafe")
66-
.Palette(ColorPickerPalette.WebSafe))
67-
</div>
68-
<div class="box-col">
69-
<h4>Basic</h4>
70-
@(Html.Kendo().ColorPalette()
71-
.Name("basic")
72-
.Palette(ColorPickerPalette.Basic))
73-
</div>
7496
</div>
7597
</div>
7698
```
@@ -124,6 +146,11 @@ The example below demonstrates how to use the presets and add custom palettes:
124146
```
125147
{% endif %}
126148

149+
The result from the configuration is :
150+
151+
![Custom Presets](./images/custom-presets.png)
152+
153+
127154
## See Also
128155

129156
* [Palette Presets of the ColorPalette (Demo)](https://demos.telerik.com/{{ site.platform }}/colorpalette/palette-presets)

‎docs-aspnet/html-helpers/scheduling/scheduler/overview.md‎

Lines changed: 49 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,41 @@ The following example demonstrates how to define the Scheduler.
5858
```
5959
{% if site.core %}
6060
```TagHelper
61-
<kendo-scheduler name="scheduler"></kendo-scheduler>
61+
@addTagHelper *, Kendo.Mvc
62+
63+
@{
64+
string defaultTitle = "No Title";
65+
}
66+
67+
<kendo-scheduler name="scheduler"
68+
date="new DateTime(2013, 6, 13)"
69+
start-time="new DateTime(2013, 6, 13, 7, 0, 0, 0)"
70+
height="600"
71+
timezone="Etc/UTC">
72+
<views>
73+
<view type="day"></view>
74+
<view type="week" selected="true"></view>
75+
<view type="timeline"></view>
76+
</views>
77+
<scheduler-datasource type="@DataSourceTagHelperType.Ajax">
78+
<transport>
79+
<read url="@Url.Action("Read", "Scheduler")" />
80+
<create url="@Url.Action("Create", "Scheduler")" />
81+
<destroy url="@Url.Action("Destroy", "Scheduler")" />
82+
<update url="@Url.Action("Update", "Scheduler")" />
83+
</transport>
84+
<schema data="Data" total="Total" errors="Errors">
85+
<scheduler-model id="TaskID">
86+
<fields>
87+
<field name="TaskID" type="number"></field>
88+
<field name="recurrenceId" from="RecurrenceID" type="number"></field>
89+
<field name="title" from="Title" type="string" default-value="@defaultTitle"></field>
90+
<field name="OwnerID" type="number" default-value="1"></field>
91+
</fields>
92+
</scheduler-model>
93+
</schema>
94+
</scheduler-datasource>
95+
</kendo-scheduler>
6296
```
6397
{% endif %}
6498
```Controller
@@ -187,25 +221,25 @@ The following example demonstrates the basic configuration of the Scheduler.
187221
}
188222
<kendo-scheduler name="scheduler" height="600" date="new DateTime(2013, 6, 13)" start-time="new DateTime(2013, 6, 13, 7, 0, 0, 0)" timezone="Etc/UTC">
189223
<views>
190-
<view type="day"></view>
191-
<view type="workWeek" selected="true"></view>
192-
<view type="week"></view>
193-
<view type="month"></view>
194-
<view type="agenda"></view>
195-
<view type="timeline"></view>
224+
<view type="day"></view>
225+
<view type="workWeek" selected="true"></view>
226+
<view type="week"></view>
227+
<view type="month"></view>
228+
<view type="agenda"></view>
229+
<view type="timeline"></view>
196230
</views>
197231
<resources>
198-
<resource name="Owner" datacolorfield="Color" datatextfield="Text" datavaluefield="Value" field="OwnerID" bind-to="@resources">
199-
</resource>
232+
<resource name="Owner" datacolorfield="Color" datatextfield="Text" datavaluefield="Value" field="OwnerID" bind-to="@resources">
233+
</resource>
200234
</resources>
201235
<scheduler-datasource>
202-
<transport>
236+
<transport>
203237
<read url="https://demos.telerik.com/kendo-ui/service/tasks" type="jsonp" />
204238
<update url="https://demos.telerik.com/kendo-ui/service/tasks/update" type="jsonp" />
205-
</transport>
206-
<schema data="Data" total="Total" errors="Errors">
239+
</transport>
240+
<schema data="Data" total="Total" errors="Errors">
207241
<scheduler-model id="TaskID">
208-
<fields>
242+
<fields>
209243
<field name="TaskID" type="number"></field>
210244
<field name="title" from="Title" type="string"></field>
211245
<field name="start" from="Start" type="date"></field>
@@ -218,9 +252,9 @@ The following example demonstrates the basic configuration of the Scheduler.
218252
<field name="startTimezone" from="StartTimeZone" type="string"></field>
219253
<field name="endTimezone" from="EndTimeZone" type="string"></field>
220254
<field name="isAllDay" from="IsAllDay" type="boolean"></field>
221-
</fields>
255+
</fields>
222256
</scheduler-model>
223-
</schema>
257+
</schema>
224258
</scheduler-datasource>
225259
</kendo-scheduler>
226260
```

0 commit comments

Comments
 (0)