Skip to content

Commit 9e4d797

Browse files
committed
Sync with Kendo UI Professional
1 parent cc50532 commit 9e4d797

File tree

96 files changed

+1123
-311
lines changed

Some content is hidden

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

96 files changed

+1123
-311
lines changed

docs-aspnet/backwards-compatibility/2025-backwards-compatibility.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,11 @@ The [`IconClass()`](/api/kendo.mvc.ui.fluent/popoveractionbuilder#iconclasssyste
5151
</actions>
5252
</kendo-popover>
5353
```
54+
55+
### Pager Position in Grid TagHelper
56+
57+
The [`position`](/api/kendo.mvc.taghelpers/gridpageablesettingstaghelper#attributes) attribute of the Grid TagHelper `pageable` configuration accepts a `PagerPosition` enum type instead of the previously used `GridPagerPosition`.
58+
5459
{% else %}
5560

5661
### Kendo.Mvc.Export
@@ -73,6 +78,17 @@ As of the Q2 2025 release, the following NuGet packages and assemblies no longer
7378

7479
The `Telerik.Zip` library will continue to be shipped as a standalone library.
7580

81+
### Pager
82+
83+
The [responsive behavior]({% slug responsive_pager_aspnet%}) of the Pager has been enhanced, which introduces the following changes:
84+
85+
* The Pager's sizing is no longer based on breakpoints. Instead, the optimized responsive behavior renders as many elements as possible within the available space.
86+
* `Input` Type&mdash;When the [`Input()`](/api/kendo.mvc.ui.fluent/pagerbuilder#inputsystemboolean) option of the Pager is enabled, the TextBox next to the navigation arrows is replaced with a NumericTextBox, and the numeric page number buttons are no longer rendered.
87+
* Page Selection&mdash;The page selection drop-down has been replaced with a NumericTextBox for improved user interaction.
88+
* `NumbersSelectLabel()` Property&mdash;The [`NumbersSelectLabel()`](/api/kendo.mvc.ui.fluent/pagermessagessettingsbuilder#numbersselectlabelsystemstring) option in the `Messages()` configuration has been removed as it is no longer needed with the replacement of the page selection drop-down.
89+
90+
> These changes to the Pager affect all components that use a built-in pager, including the Grid, PDFViewer, and other data management components.
91+
7692
## {{ site.product }} Q1 2025
7793

7894
### License Activation
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Adaptive Mode
3+
page_title: Adaptive Mode
4+
description: "Learn how to configure the adaptive behavior of the the Telerik UI Pager component for {{ site.framework }}."
5+
slug: htmlhelpers_pager_adaptive_mode
6+
position: 4
7+
---
8+
9+
# Adaptive Mode
10+
11+
The Telerik UI for {{ site.framework }} Pager supports an adaptive mode that provides a mobile-friendly rendering of its [built-in drop-down that allows the user to change the page size]({% slug settings_pager_aspnet%}#settings).
12+
13+
To enable the adaptive rendering mode, set the `AdaptiveMode()` property to `AdaptiveMode.Auto`.
14+
15+
The Pager component automatically adapts to the current screen size and changes the rendering of the drop-down for page size selection accordingly. On medium-sized screens, the options list is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard popup is rendered docked to the input of the drop-down.
16+
17+
The adaptive mode changes the rendering of the Pager's drop-down element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:
18+
19+
* Small screens&mdash;up to 500 px.
20+
* Medium screens&mdash;between 501 px and 768 px.
21+
* Large screens&mdash;over 768 px.
22+
23+
The following example demonstrates how to enable the adaptive mode of the Pager by using the `AdaptiveMode()` option.
24+
25+
<demo metaUrl="pager/adaptive_mode/" height="600"></demo>
26+
27+
## See Also
28+
29+
* [Adaptive Rendering of the Components]({% slug adaptive_rendering%})
30+
* [Server-Side API of the Pager HtmlHelper](/api/pager)
31+
{% if site.core %}
32+
* [Server-Side API of the Pager TagHelper](/api/taghelpers/pager)
33+
{% endif %}

docs-aspnet/html-helpers/data-management/pager/events.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Events
33
page_title: Events
44
description: "Learn how to handle the events of the Telerik UI Pager component for {{ site.framework }}."
55
slug: pager_events
6-
position: 5
6+
position: 6
77
---
88

99
# Events

docs-aspnet/html-helpers/data-management/pager/overview.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -111,12 +111,12 @@ The following example demonstrates how to tie a pager to a data source and enabl
111111

112112
## Functionality and Features
113113

114-
* [Pager Settings and Types]({% slug settings_pager_aspnet %})—You can choose between the available settings and types.
115-
* [Responsive Pager]({% slug responsive_pager_aspnet %})The Pager supports responsive design by default.
116-
* [Pager Templates]({% slug templates_pager_aspnet %})—Customize the look and feel of the Pager with Kendo Templates.
117-
* [Globalization and Messages]({% slug globalization_pager_aspnet %})—The globalization process combines the translation of component messages (localization) with adapting them to specific cultures (internationalization and right-to-left support).
118-
* [Accessibility]({% slug htmlhelpers_pager_accessibility %})—The Pager is accessible by screen readers and provides WAI-ARIA, Section 508, WCAG 2.2, and keyboard support.
119-
114+
* [Pager Settings and Types]({% slug settings_pager_aspnet %})&mdash;Control the Pager functions and rendering.
115+
* [Responsiveness]({% slug responsive_pager_aspnet %})&mdash;The Pager supports responsive design by default.
116+
* [Adaptive Mode]({% slug htmlhelpers_pager_adaptive_mode %})&mdash;Enable the adaptive mode that changes the rendering of the Pager based on the screen resolution of the device.
117+
* [Templates]({% slug templates_pager_aspnet %})&mdash;Customize the look and feel of the Pager.
118+
* [Globalization]({% slug globalization_pager_aspnet %})&mdash;Localize the texts and tooltips of the Pager.
119+
* [Accessibility]({% slug htmlhelpers_pager_accessibility %})&mdash;The Pager is accessible by screen readers and provides WAI-ARIA, Section 508, WCAG 2.2, and keyboard support.
120120

121121
## Next Steps
122122

Lines changed: 20 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,37 @@
11
---
2-
title: Responsive Pager
2+
title: Responsiveness
33
page_title: Responsive Telerik UI Pager component for {{ site.framework }}
44
description: "Get started with the Pager component for {{ site.framework }} and learn about its responsive feature."
55
slug: responsive_pager_aspnet
6-
position: 4
6+
position: 3
77
---
88

9-
# Responsive Design
9+
# Responsiveness
1010

11-
The Pager component for {{ site.framework }} is responsive by default. To disable the responsive behavior and have all of its elements visible at all times use the `Responsive()` method and pass `false` as a parameter.
11+
The Pager component is responsive by default.
1212

13-
## Visible Elements
13+
To disable the responsive behavior, set the [`Responsive()`](/api/kendo.mvc.ui.fluent/pagerbuilder#responsivesystemboolean) option to `false`. As a result, all Pager elements are visible, no matter the screen resolution of the device.
1414

15-
The Pager widget determines which internal elements to render based on its width. When the Pager width is greater than or equal to 600 pixels, all elements are visible:
15+
> Starting with version Q2 2025, the Pager's sizing is no longer based on fixed breakpoints. Instead, the optimized responsive behavior renders as many elements as possible within the available space. For more information, refer to the [Breaking Changes section]({% slug breakingchanges_2025%}#pager).
1616
17-
- `Page Sizes Dropdown`
18-
- `Numeric Page Number Buttons` or a `Numeric Input` if the pager is an `Input` one.
19-
- `Info element`
17+
The responsive Pager determines which elements to render based on the available space. The component's elements are displayed in the following order:
2018

21-
## Breaking Points
19+
* [Numeric Page Number Buttons](/api/kendo.mvc.ui.fluent/pagerbuilder#numericsystemboolean) or a [Numeric Input](/api/kendo.mvc.ui.fluent/pagerbuilder#numericsystemboolean), if the Pager type is set to `Input()`.
20+
* [Page Sizes Dropdown](/api/kendo.mvc.ui.fluent/pagerbuilder#pagesizessystemboolean)
21+
* [Info label](/api/kendo.mvc.ui.fluent/pagerbuilder#infosystemboolean)
22+
* [Refresh button](/api/kendo.mvc.ui.fluent/pagerbuilder#refreshsystemboolean) (if enabled)
2223

23-
When the Pager width is greater than or equal to 600 pixels, all elements are visible:
24+
As the screen size decreases, the elements are hidden from the bottom to the top of this list, starting with the `Refresh` button, to maintain optimal layout within the available space.
2425

25-
![{{ site.product_short }} A Pager widget at over 600px resolution](../../../images/pager-responsive/pager-width-over-600.png)
26+
On smaller screens, when using the default [`Numeric()`](/api/kendo.mvc.ui.fluent/pagerbuilder#numericsystemboolean) Pager type, the numeric page buttons are automatically replaced with a single input field that functions the same way as when the [`Input()`](/api/kendo.mvc.ui.fluent/pagerbuilder#numericsystemboolean) option is enabled.
2627

27-
When the Pager width is greater than 480 and less than 600 pixels, the label showing the current paging information is hidden:
28-
29-
![{{ site.product_short }} A Pager widget between 480 and 600px resolution](../../../images/pager-responsive/pager-width-480-600.png)
30-
31-
When the Pager width is greater than 360 and less than 480 pixels, the current page is represented by a native `<select/>` element. The `pageSizes` dropdown and the label showing the current paging information are hidden.
32-
33-
![{{ site.product_short }} A Pager widget between 360 and 480px resolution](../../../images/pager-responsive/pager-width-360-480.png)
34-
35-
When the Pager width is less than 360 pixels, the current page is represented by a native `<select/>` element. The `pageSizes` dropdown and the label showing the current paging information are hidden.
28+
## See Also
3629

37-
![{{ site.product_short }} A Pager widget under 360 pixels](../../../images/pager-responsive/pager-width-under-360.png)
30+
* [Use the Pager in Adaptive Mode]({% slug htmlhelpers_pager_adaptive_mode %})
31+
* [Server-Side API of the Pager HtmlHelper](/api/pager)
32+
{% if site.core %}
33+
* [Server-Side API of the Pager TagHelper](/api/taghelpers/pager)
34+
{% endif %}
35+
* [Client-Side API of the Pager](https://docs.telerik.com/kendo-ui/api/javascript/ui/pager)
3836

39-
## See Also
4037

41-
* [Pager Client-Side API](https://docs.telerik.com/kendo-ui/api/javascript/ui/pager)
42-
* [Pager Server-Side API](/api/pager)
43-
* [Pager Settings and Types]({% slug settings_pager_aspnet %})
44-
* [Pager Templates]({% slug templates_pager_aspnet %})
45-
* [Globalization and Messages]({% slug globalization_pager_aspnet %})

docs-aspnet/html-helpers/data-management/pager/templates.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: Pager Templates
2+
title: Templates
33
page_title: Pager Templates
44
description: "Get started with the {{ site.framework }} Pager and learn about its templating options."
55
slug: templates_pager_aspnet
6-
position: 3
6+
position: 5
77
---
88

9-
# Pager Templates
9+
# Templates
1010

1111
The {{ site.framework }} Pager component features templates for its page number links.
1212

docs-aspnet/html-helpers/editors/autocomplete/adaptive-mode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Adaptiveness is an advanced capability that enhances the Telerik UI for {{ site.
1616

1717
The AutoComplete supports an adaptive mode that provides a mobile-friendly rendering of its popup. To enable the adaptive rendering mode, set the [`AdaptiveMode()`](/api/kendo.mvc.ui.fluent/autocompletebuilder#adaptivemodekendomvcuiadaptivemode) property to `AdaptiveMode.Auto`.
1818

19+
> Starting with the 2025 Q2 release, when the adaptive rendering mode is enabled and the component is accessed on a mobile device, the popup will open as soon as the component receives focus. In previous versions, the popup only opened once the user began typing.
20+
1921
The AutoComplete component automatically adapts to the current screen size and changes its rendering accordingly. On medium-sized screens, the suggestion list is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard popup is rendered docked to the input of the component.
2022

2123
The adaptive mode changes the rendering of the AutoComplete popup element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:

docs-aspnet/html-helpers/editors/colorpicker/adaptive-mode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ position: 7
1010

1111
The Telerik UI for {{ site.framework }} ColorPicker supports an adaptive mode that renders a mobile-friendly popup. To enable the adaptive rendering mode, set the `AdaptiveMode()` property to `AdaptiveMode.Auto`.
1212

13+
> Starting with the 2025 Q2 release, when the adaptive rendering mode is enabled and the component is accessed on a mobile device, the popup will open as soon as the component receives focus. In previous versions, the popup only opened once the user began typing.
14+
1315
The ColorPicker component automatically adapts to the current screen size and changes its rendering accordingly. On medium-sized screens, the suggestion list is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard popup is rendered docked to the input of the component.
1416
The adaptive mode changes the rendering of the ColorPicker popup element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:
1517

docs-aspnet/html-helpers/editors/combobox/adaptive-mode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ Adaptiveness is an advanced capability that enhances the Telerik UI for {{ site.
1414

1515
The ComboBox supports an adaptive mode that provides a mobile-friendly rendering of its popup. To enable the adaptive rendering mode, set the [`AdaptiveMode()`](/api/kendo.mvc.ui.fluent/comboboxbuilder#adaptivemodekendomvcuiadaptivemode) property to `AdaptiveMode.Auto`.
1616

17+
> Starting with the 2025 Q2 release, when the adaptive rendering mode is enabled and the component is accessed on a mobile device, the popup will open as soon as the component receives focus. In previous versions, the popup only opened once the user began typing.
18+
1719
The ComboBox component automatically adapts to the current screen size and changes its rendering accordingly. On medium-sized screens, the suggestion list is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard popup is rendered docked to the input of the component.
1820

1921
The adaptive mode changes the rendering of the ComboBox popup element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:

docs-aspnet/html-helpers/editors/datepicker/adaptive-mode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ Adaptiveness is an advanced capability that enhances the Telerik UI for {{ site.
1414

1515
The DatePicker supports an adaptive mode that provides a mobile-friendly rendering of its calendar popup. To enable the adaptive rendering mode, set the [`AdaptiveMode()`](/api/kendo.mvc.ui.fluent/datepickerbuilder#adaptivemodekendomvcuiadaptivemode) property to `AdaptiveMode.Auto`.
1616

17+
> Starting with the 2025 Q2 release, when the adaptive rendering mode is enabled and the component is accessed on a mobile device, the popup will open as soon as the component receives focus. In previous versions, the popup only opened once the user began typing.
18+
1719
The DatePicker component automatically adapts to the current screen size and changes its rendering accordingly. On medium-sized screens, the calendar is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard calendar popup is rendered docked to the input of the component.
1820

1921
The adaptive mode changes the rendering of the DatePicker popup element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:

docs-aspnet/html-helpers/editors/daterangepicker/adaptive-mode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ Adaptiveness is an advanced capability that enhances the Telerik UI for {{ site.
1414

1515
The DateRangePicker supports an adaptive mode that provides a mobile-friendly rendering of its calendar popup. To enable the adaptive rendering mode, set the [`AdaptiveMode()`](/api/kendo.mvc.ui.fluent/daterangepickerbuilder#adaptivemodekendomvcuiadaptivemode) property to `AdaptiveMode.Auto`.
1616

17+
> Starting with the 2025 Q2 release, when the adaptive rendering mode is enabled and the component is accessed on a mobile device, the popup will open as soon as the component receives focus. In previous versions, the popup only opened once the user began typing.
18+
1719
The DateRangePicker component automatically adapts to the current screen size and changes its rendering accordingly. On medium-sized screens, the calendar is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard calendar popup is rendered docked to the input of the component.
1820

1921
The adaptive mode changes the rendering of the DateRangePicker popup element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:

docs-aspnet/html-helpers/editors/datetimepicker/adaptive-mode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ Adaptiveness is an advanced capability that enhances the Telerik UI for {{ site.
1414

1515
The DateTimePicker supports an adaptive mode that provides a mobile-friendly rendering of its calendar popup. To enable the adaptive rendering mode, set the [`AdaptiveMode()`](/api/kendo.mvc.ui.fluent/datetimepickerbuilder#adaptivemodekendomvcuiadaptivemode) property to `AdaptiveMode.Auto`.
1616

17+
> Starting with the 2025 Q2 release, when the adaptive rendering mode is enabled and the component is accessed on a mobile device, the popup will open as soon as the component receives focus. In previous versions, the popup only opened once the user began typing.
18+
1719
The DateTimePicker component automatically adapts to the current screen size and changes its rendering accordingly. On medium-sized screens, the calendar is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard calendar popup is rendered docked to the input of the component.
1820

1921
The adaptive mode changes the rendering of the DateTimePicker popup element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:

docs-aspnet/html-helpers/editors/dropdownlist/adaptive-mode.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ position: 5
1010

1111
The Telerik UI for {{ site.framework }} DropDownList supports an adaptive mode that renders a mobile-friendly rendering of its popup. To enable the adaptive rendering mode, set the [`AdaptiveMode()`](/api/kendo.mvc.ui.fluent/dropdownlistbuilder#adaptivemodekendomvcuiadaptivemode) property to `AdaptiveMode.Auto`.
1212

13+
> Starting with the 2025 Q2 release, when the adaptive rendering mode is enabled and the component is accessed on a mobile device, the popup will open as soon as the component receives focus. In previous versions, the popup only opened once the user began typing.
14+
1315
The DropDownList component automatically adapts to the current screen size and changes its rendering accordingly. On medium-sized screens, the suggestion list is displayed as docked to the bottom of the screen, while on smaller screens, it is rendered as a full-screen modal dialog. In all other scenarios, including when the `AdaptiveMode()` option is not specified or is set to its default value of `AdaptiveMode.None`, the standard popup is rendered docked to the input of the component.
1416

1517
The adaptive mode changes the rendering of the DropDownList popup element based on the screen resolution of the device (the horizontal value in `px`) with the following breakpoints:

0 commit comments

Comments
 (0)