@progress/kendo-react-common 10.0.0-develop.3 → 10.0.0-develop.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +97 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,43 +6,122 @@
|
|
|
6
6
|
|
|
7
7
|
> **Important**
|
|
8
8
|
>
|
|
9
|
-
> - This package is а part of [KendoReact](https://www.telerik.com/kendo-react-ui?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)—
|
|
10
|
-
> -
|
|
11
|
-
> -
|
|
9
|
+
> - This package is а part of [KendoReact](https://www.telerik.com/kendo-react-ui?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)—an enterprise-grade UI library with 120+ free and premium components.
|
|
10
|
+
> - This package contains both free and premium KendoReact components and tools. To use the premium components, you will need to [purchase a license](https://www.telerik.com/kendo-react-ui/pricing?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) or register for a [free trial](https://www.telerik.com/try/kendo-react-ui?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common). You can use the free components even in production, no sign-up or license required.
|
|
11
|
+
> - If you're looking for free React components, check out [Get Started with KendoReact Free: 50+ Free React Components](https://www.telerik.com/kendo-react-ui/components/free).
|
|
12
|
+
> - If you have an active license, visit the [KendoReact My License page](https://www.telerik.com/kendo-react-ui/components/my-license/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) to learn how to configure your KendoReact licensing.
|
|
13
|
+
> - Installing and working with this package indicates that you [accept the KendoReact License Agreement](https://www.telerik.com/purchase/license-agreement/progress-kendoreact?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common).
|
|
12
14
|
> - The 30-day free trial gives you access to all the KendoReact components and their full functionality. Additionally, for the period of your license, you get access to our legendary technical support provided directly by the KendoReact dev team!
|
|
13
15
|
>
|
|
14
16
|
> [Start using KendoReact](https://www.telerik.com/try/kendo-react-ui?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) and speed up your development process!
|
|
15
17
|
|
|
16
18
|
The React Common package, part of KendoReact, delivers common utilities that can be used with the KendoReact UI components to enhance their performance and functionality.
|
|
17
19
|
|
|
18
|
-
|
|
20
|
+
How to start:
|
|
21
|
+
|
|
22
|
+
```sh
|
|
23
|
+
npm install --save @progress/kendo-react-common @progress/kendo-licensing @progress/kendo-svg-icons
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
What's in this package:
|
|
27
|
+
|
|
28
|
+
- [React Draggable component (premium)](#react-draggable-component)
|
|
29
|
+
- [React Icon component (free)](#react-icon-component)
|
|
30
|
+
- [React SvgIcon component (free)](#react-svgicon-component)
|
|
31
|
+
- [React Typography component (free)](#react-typography-component)
|
|
32
|
+
- [React AdaptiveModeContext (free)](#react-typography-component)
|
|
33
|
+
|
|
34
|
+
Additional information:
|
|
19
35
|
|
|
20
|
-
- [React Draggable component](#react-draggable-component)
|
|
21
|
-
- [React Icon component](#react-icon-component)
|
|
22
|
-
- [React SvgIcon component](#react-svgicon-component)
|
|
23
|
-
- [React Typography component](#react-typography-component)
|
|
24
36
|
- [Support Options](#support-options)
|
|
25
37
|
- [Resources](#resources)
|
|
38
|
+
- [KendoReact Common API](https://www.telerik.com/kendo-react-ui/components/common/api)
|
|
26
39
|
|
|
27
40
|
## React Draggable Component
|
|
28
41
|
|
|
29
|
-
|
|
42
|
+
> This is a KendoReact **premium component** and requires a commercial license or an active trial license.
|
|
43
|
+
|
|
44
|
+
[The KendoReact Draggable component](https://www.telerik.com/kendo-react-ui/components/common/drag-and-drop?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) enables the drag-and-drop functionality and enables the user to drag and drop component elements.
|
|
45
|
+
|
|
46
|
+
How to use the Draggable component in your apps:
|
|
47
|
+
|
|
48
|
+
```tsx
|
|
49
|
+
import { DragAndDrop, useDroppable, NormalizedDragEvent } from '@progress/kendo-react-common';
|
|
50
|
+
...
|
|
51
|
+
<DragAndDrop>
|
|
52
|
+
/**
|
|
53
|
+
* Handle drag-and-drop logic and containers.
|
|
54
|
+
*/
|
|
55
|
+
</DragAndDrop>
|
|
56
|
+
```
|
|
30
57
|
|
|
31
58
|
## React Icon Component
|
|
32
59
|
|
|
33
|
-
|
|
60
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
61
|
+
|
|
62
|
+
[The KendoReact Icon component](https://www.telerik.com/kendo-react-ui/components/utils/icon/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) is used to display font icons. [All Kendo UI Icons](https://www.telerik.com/kendo-react-ui/components/styling/icons/#list-of-font-icons/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) are supported. To ensure React developers can use these icons in any scenario, the KendoReact Icon component displays icons as font icons.
|
|
63
|
+
|
|
64
|
+
How to use the Icon component in your apps:
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
import { Icon } from '@progress/kendo-react-common';
|
|
68
|
+
...
|
|
69
|
+
<link rel="stylesheet" href="https://unpkg.com/@progress/kendo-font-icons/dist/index.css" />
|
|
70
|
+
<Icon name="home"/>
|
|
71
|
+
```
|
|
34
72
|
|
|
35
73
|
## React SvgIcon Component
|
|
36
74
|
|
|
37
|
-
|
|
75
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
76
|
+
|
|
77
|
+
[The KendoReact SvgIcon component](https://www.telerik.com/kendo-react-ui/components/utils/svgicon/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) is used to display SVG icons. KendoReact delivers more than 500 SVG icons. The size, color and orientation of the KendoReact SvgIcon component can be easily customized through the available properties.
|
|
78
|
+
|
|
79
|
+
How to use the SvgIcon component in your apps:
|
|
80
|
+
|
|
81
|
+
```tsx
|
|
82
|
+
import { SvgIcon } from '@progress/kendo-react-common';
|
|
83
|
+
import { home } from '@progress/kendo-svg-icons'; // This dependency is not automatically installed.
|
|
84
|
+
...
|
|
85
|
+
<SvgIcon icon={home} />
|
|
86
|
+
```
|
|
38
87
|
|
|
39
88
|
## React Typography Component
|
|
40
89
|
|
|
41
|
-
|
|
90
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
91
|
+
|
|
92
|
+
[The KendoReact Typography component](https://www.telerik.com/kendo-react-ui/components/utils/typography/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) is a reusable component that helps presenting the content in a React application. It could trim down a lot of time as the application grows. You can quickly add additional style to the Typography by choosing from the predefined styling options.
|
|
93
|
+
|
|
94
|
+
How to use the SvgIcon component in your apps:
|
|
95
|
+
|
|
96
|
+
```tsx
|
|
97
|
+
import { Typography } from '@progress/kendo-react-common';
|
|
98
|
+
...
|
|
99
|
+
<Typography.p>
|
|
100
|
+
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec semper.
|
|
101
|
+
</Typography.p>
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## React AdaptiveModeContext
|
|
105
|
+
|
|
106
|
+
> This is a **free React utility**—no sign-up or license required, even in production.
|
|
107
|
+
|
|
108
|
+
[The KendoReact AdaptiveModeContext utility](https://www.telerik.com/kendo-react-ui/components/common/adaptive-mode?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) is a React context that provides a global configuration for adaptive rendering across various components. It lets you define breakpoints for small and medium screen sizes. This context is essential for implementing responsive layouts, where UI components such as DatePicker, DropDownList, ComboBox, and others may need to adapt.
|
|
109
|
+
|
|
110
|
+
How to use AdaptiveModeContext in your apps:
|
|
111
|
+
|
|
112
|
+
```tsx
|
|
113
|
+
import { AdaptiveModeContext } from '@progress/kendo-react-common';
|
|
114
|
+
...
|
|
115
|
+
<AdaptiveModeContext.Provider value={{ small: 320, medium: 1024 }}>
|
|
116
|
+
/**
|
|
117
|
+
* Place the UI component that needs to be adaptive here.
|
|
118
|
+
*/
|
|
119
|
+
</AdaptiveModeContext.Provider>
|
|
120
|
+
```
|
|
42
121
|
|
|
43
122
|
## Support Options
|
|
44
123
|
|
|
45
|
-
For any issues you might encounter while working with the KendoReact
|
|
124
|
+
For any issues you might encounter while working with the KendoReact Common package, use any of the available support channels:
|
|
46
125
|
|
|
47
126
|
- Industry-leading technical support—KendoReact paid license holders and users with an active (free) trial license can take advantage of our outstanding customer support. To submit a ticket, use [the dedicated KendoReact support system](https://www.telerik.com/account/support-tickets?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common).
|
|
48
127
|
- Product forums—The [KendoReact forums](https://www.telerik.com/forums/kendo-ui-react?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common) are part of the free support you can get from the community and from the KendoReact team.
|
|
@@ -50,14 +129,17 @@ For any issues you might encounter while working with the KendoReact common, use
|
|
|
50
129
|
|
|
51
130
|
## Resources
|
|
52
131
|
|
|
132
|
+
General resources:
|
|
133
|
+
|
|
53
134
|
- [Getting Started with KendoReact](https://www.telerik.com/kendo-react-ui/components/getting-started/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
|
|
135
|
+
- [Get Started with KendoReact Free: 50+ Free React Components](https://www.telerik.com/kendo-react-ui/components/free)
|
|
54
136
|
- [KendoReact Roadmap](https://www.telerik.com/kendo-react-ui/roadmap/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
|
|
55
137
|
- [Blogs](https://www.telerik.com/blogs/tag/kendoreact?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
|
|
56
138
|
- [Demos, documentation, and component reference](https://www.telerik.com/kendo-react-ui/components/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
|
|
57
139
|
- [KendoReact pricing and licensing](https://www.telerik.com/kendo-react-ui/pricing?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
|
|
58
140
|
- [Changelog](https://www.telerik.com/kendo-react-ui/components/changelogs/ui-for-react/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-common)
|
|
59
141
|
|
|
60
|
-
High-level component overview pages
|
|
142
|
+
High-level component overview pages:
|
|
61
143
|
|
|
62
144
|
- [React Drag & Drop Utilities](https://www.telerik.com/kendo-react-ui/drag-and-drop)
|
|
63
145
|
- [React Icon & SvgIcon Components](https://www.telerik.com/kendo-react-ui/icon-svgicon)
|
|
@@ -65,4 +147,4 @@ High-level component overview pages
|
|
|
65
147
|
|
|
66
148
|
_Copyright © 2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved._
|
|
67
149
|
|
|
68
|
-
_Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries._
|
|
150
|
+
_Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries._
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@progress/kendo-react-common",
|
|
3
|
-
"version": "10.0.0-develop.
|
|
3
|
+
"version": "10.0.0-develop.5",
|
|
4
4
|
"description": "React Common package delivers common utilities that can be used with the KendoReact UI components. KendoReact Common Utilities package",
|
|
5
5
|
"author": "Progress",
|
|
6
6
|
"license": "SEE LICENSE IN LICENSE.md",
|