@progress/kendo-react-layout 10.0.0-develop.2 → 10.0.0-develop.4
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 +447 -40
- package/package-metadata.js +1 -1
- package/package-metadata.mjs +2 -2
- package/package.json +8 -8
package/README.md
CHANGED
|
@@ -6,152 +6,556 @@
|
|
|
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-layout)—
|
|
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-layout)—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-layout) 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-layout). 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-layout) 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-layout).
|
|
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-layout) and speed up your development process!
|
|
15
17
|
|
|
16
18
|
The React Layout components, part of KendoReact, enable you to create a perceptive and intuitive layout of web projects and provide an easier navigation.
|
|
17
19
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
- [React GridLayout component](#react-gridlayout-component)
|
|
27
|
-
- [React Menu component](#react-menu-component)
|
|
28
|
-
- [React PanelBar component](#react-panelbar-component)
|
|
29
|
-
- [React Splitter component](#react-splitter-component)
|
|
30
|
-
- [React StackLayout component](#react-stacklayout-component)
|
|
31
|
-
- [React Stepper component](#react-stepper-component)
|
|
32
|
-
- [React TabStrip component](#react-tabstrip-component)
|
|
33
|
-
- [React TileLayout component](#react-tilelayout-component)
|
|
20
|
+
How to start:
|
|
21
|
+
|
|
22
|
+
```sh
|
|
23
|
+
npm install --save @progress/kendo-react-layout @progress/kendo-licensing @progress/kendo-react-animation @progress/kendo-react-buttons @progress/kendo-react-common @progress/kendo-react-intl @progress/kendo-react-popup @progress/kendo-react-progressbars @progress/kendo-svg-icons
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
What's in this package:
|
|
27
|
+
|
|
34
28
|
- [React Layout Components Library Features](#react-layout-library-shared-features)
|
|
29
|
+
- [React ActionSheet component (free)](#react-actionsheet-component)
|
|
30
|
+
- [React AppBar component (free)](#react-appbar-component)
|
|
31
|
+
- [React Avatar component (free)](#react-avatar-component)
|
|
32
|
+
- [React BottomNavigation component (free)](#react-bottomnavigation-component)
|
|
33
|
+
- [React Breadcrumb component (free)](#react-breadcrumb-component)
|
|
34
|
+
- [React Card component (free)](#react-card-component)
|
|
35
|
+
- [React ContextMenu component (free)](#react-contextmenu-component)
|
|
36
|
+
- [React Drawer component (free)](#react-drawer-component)
|
|
37
|
+
- [React ExpansionPanel component (free)](#react-expansionpanel-component)
|
|
38
|
+
- [React GridLayout component (free)](#react-gridlayout-component)
|
|
39
|
+
- [React Menu component (free)](#react-menu-component)
|
|
40
|
+
- [React PanelBar component (free)](#react-panelbar-component)
|
|
41
|
+
- [React Splitter component (premium)](#react-splitter-component)
|
|
42
|
+
- [React StackLayout component (free)](#react-stacklayout-component)
|
|
43
|
+
- [React Stepper component (free)](#react-stepper-component)
|
|
44
|
+
- [React TabStrip component (free)](#react-tabstrip-component)
|
|
45
|
+
- [React TileLayout component (free)](#react-tilelayout-component)
|
|
46
|
+
- [React TimeLine component (premium)](#react-timeline-component)
|
|
47
|
+
|
|
48
|
+
Additional information:
|
|
49
|
+
|
|
35
50
|
- [Support Options](#support-options)
|
|
36
51
|
- [Resources](#resources)
|
|
52
|
+
- [KendoReact Layout API](https://www.telerik.com/kendo-react-ui/components/layout/api)
|
|
53
|
+
|
|
54
|
+
## React Layout Components Library Features
|
|
55
|
+
|
|
56
|
+
Among the many features which the KendoReact Layout deliver are:
|
|
57
|
+
|
|
58
|
+
- **Routing**—You can use most of the Layout components as a navigational component by wiring it with the React router.
|
|
59
|
+
- **Data binding**—The layout components enables you to bind a data collection to them.
|
|
60
|
+
- **Keyboard navigation**—You can interact with the layout components using only the keyboard.
|
|
61
|
+
- **Custom Rendering**—You can replace the content of the layout components with custom elements.
|
|
62
|
+
- **Accessibility support**—The Layout are compliant with WAI-ARIA and Section 508.
|
|
63
|
+
- [Theme support](https://www.telerik.com/kendo-react-ui/components/styling/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout)—The KendoReact Layout, as well as all 100+ components in the KendoReact suite, are styled in three polished themes (Bootstrap, Material, and Default) and can be further customized to match your specific design guidelines.
|
|
64
|
+
|
|
65
|
+
## React ActionSheet Component
|
|
66
|
+
|
|
67
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
68
|
+
|
|
69
|
+
[The KendoReact ActionSheet component](https://www.telerik.com/kendo-react-ui/components/layout/actionsheet?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) lets you display a
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
The ActionSheet component allows you to display a mobile-friendly quick menu with user actions. The options display in a modal view.
|
|
73
|
+
|
|
74
|
+
Key features:
|
|
75
|
+
|
|
76
|
+
* **Items**—The ActionSheet enables you to configure the items based on specific project requirements.
|
|
77
|
+
* **Animation**—You can add opening and closing animations to the ActionSheet.
|
|
78
|
+
|
|
79
|
+
How to use the ActionSheet layout in your apps (no data binding):
|
|
80
|
+
|
|
81
|
+
```tsx
|
|
82
|
+
import { ActionSheet, ActionSheetItem } from '@progress/kendo-react-layout';
|
|
83
|
+
...
|
|
84
|
+
/**
|
|
85
|
+
* Handle the open and close logic. Handle item selection.
|
|
86
|
+
*/
|
|
87
|
+
<ActionSheet open={open}>
|
|
88
|
+
<ActionSheetItem text="Option 1" onClick={handleItemClick} />
|
|
89
|
+
/**
|
|
90
|
+
* Add as many ActionSheetItems as needed.
|
|
91
|
+
*/
|
|
92
|
+
</ActionSheet>
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
How to use the ActionSheet layout in your apps (simple data binding):
|
|
96
|
+
|
|
97
|
+
```tsx
|
|
98
|
+
import { ActionSheet, ActionSheetItemProps } from '@progress/kendo-react-layout';
|
|
99
|
+
...
|
|
100
|
+
/**
|
|
101
|
+
* Provide a list of actions to show in the ActionSheet. These must be provided in a format that matches ActionSheetItemProps.
|
|
102
|
+
* Handle the open and close logic. Handle item selection.
|
|
103
|
+
*/
|
|
104
|
+
<ActionSheet
|
|
105
|
+
open={open}
|
|
106
|
+
items={items}
|
|
107
|
+
/>
|
|
108
|
+
```
|
|
37
109
|
|
|
38
110
|
## React AppBar Component
|
|
39
111
|
|
|
112
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
113
|
+
|
|
40
114
|
[The KendoReact AppBar component](https://www.telerik.com/kendo-react-ui/components/layout/appbar/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) serves as the main navigation of your application, containing navigation elements and the title of the application or current page.
|
|
41
115
|
|
|
42
|
-
|
|
116
|
+
Key features:
|
|
43
117
|
|
|
44
118
|
- **Positioning**—The AppBar can be positioned either at the top or bottom of any React application.
|
|
45
119
|
- **Content Arrangement**—To assist with arranging the content of the React AppBar, there are several layout components like the Section, Spacing and Separator, which can be used to make the KendoReact AppBar fit any design.
|
|
46
120
|
- **Responsive Design**—The KendoReact AppBar component can adhere to any responsive design rules provided by the React application.
|
|
47
121
|
|
|
122
|
+
How to use the AppBar layout in your apps:
|
|
123
|
+
|
|
124
|
+
```tsx
|
|
125
|
+
import {
|
|
126
|
+
AppBar,
|
|
127
|
+
AppBarSection,
|
|
128
|
+
AppBarSpacer,
|
|
129
|
+
} from '@progress/kendo-react-layout';
|
|
130
|
+
...
|
|
131
|
+
<AppBar themeColor={color}>
|
|
132
|
+
<AppBarSection>
|
|
133
|
+
/**
|
|
134
|
+
* Implement the sections in your AppBar. Add as many buttons or other elements as you need.
|
|
135
|
+
*/
|
|
136
|
+
</AppBarSection>
|
|
137
|
+
<AppBarSpacer/>
|
|
138
|
+
/**
|
|
139
|
+
* Implement as many sections, separated with AppBarSpacers as you need.
|
|
140
|
+
*/
|
|
141
|
+
</AppBar>
|
|
142
|
+
```
|
|
143
|
+
|
|
48
144
|
## React Avatar Component
|
|
49
145
|
|
|
146
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
147
|
+
|
|
50
148
|
[The KendoReact Avatar component](https://www.telerik.com/kendo-react-ui/components/layout/avatar/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) is a perfect for displaying images, icons or initials to represent people or other entities within your React applications.
|
|
51
149
|
|
|
150
|
+
How to use the Avatar layout in your apps:
|
|
151
|
+
|
|
152
|
+
```tsx
|
|
153
|
+
import { Avatar } from '@progress/kendo-react-layout';
|
|
154
|
+
...
|
|
155
|
+
<Avatar type="text|icon|image">
|
|
156
|
+
/**
|
|
157
|
+
* Wrap the Avatar around the image, icon, or text that you will want to display as an Avatar.
|
|
158
|
+
*/
|
|
159
|
+
</Avatar>
|
|
160
|
+
```
|
|
161
|
+
|
|
52
162
|
## React BottomNavigation Component
|
|
53
163
|
|
|
164
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
165
|
+
|
|
54
166
|
[The KendoReact BottomNavigation component](https://www.telerik.com/kendo-react-ui/components/layout/bottomnavigation/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) is the perfect navigation UI element for responsive web and mobile applications. Each navigation item within the React component features the ability to define a combination of icons and text to best illustrate where it leads.
|
|
55
167
|
|
|
56
|
-
|
|
168
|
+
Key features:
|
|
57
169
|
|
|
58
170
|
- **Content Types**—Through a few simple configuration options, the items of the KendoReact Bottom Navigation component can be set up to show icons, text or a mix of both.
|
|
59
171
|
- **Positioning**—Positioning HTML elements can be tricky, but the React Bottom Navigation component can be easily positioned through a single configuration option.
|
|
60
172
|
- **Appearance**—Options like filling in each item with a solid color or just rendering an outline, as well as appearance options associated with success, warning, error, primary and more common scenarios let React developers make the React Bottom Navigation component fit any design requirements.
|
|
61
173
|
|
|
174
|
+
How to use the BottomNavigation layout in your apps:
|
|
175
|
+
|
|
176
|
+
```tsx
|
|
177
|
+
import { BottomNavigation } from '@progress/kendo-react-layout';
|
|
178
|
+
...
|
|
179
|
+
/**
|
|
180
|
+
* Provide a list of items to show in the BottomNavigation.
|
|
181
|
+
*/
|
|
182
|
+
<BottomNavigation
|
|
183
|
+
items={items}
|
|
184
|
+
/>
|
|
185
|
+
```
|
|
186
|
+
|
|
62
187
|
## React Breadcrumb Component
|
|
63
188
|
|
|
189
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
190
|
+
|
|
64
191
|
[The KendoReact Breadcrumb component](https://www.telerik.com/kendo-react-ui/components/layout/breadcrumb/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) allows you to navigate within a folder structure or web page. It provides an easy way to navigate backwards by one or multiple steps.
|
|
65
192
|
|
|
193
|
+
How to use the Breadcrumb layout in your apps:
|
|
194
|
+
|
|
195
|
+
```tsx
|
|
196
|
+
import { Breadcrumb } from "@progress/kendo-react-layout";
|
|
197
|
+
...
|
|
198
|
+
/**
|
|
199
|
+
* Provide a list of items to show in the Breadcrumb.
|
|
200
|
+
*/
|
|
201
|
+
<Breadcrumb
|
|
202
|
+
data={items}
|
|
203
|
+
/>
|
|
204
|
+
```
|
|
205
|
+
|
|
66
206
|
## React Card Component
|
|
67
207
|
|
|
208
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
209
|
+
|
|
68
210
|
[The KendoReact Card component](https://www.telerik.com/kendo-react-ui/components/layout/card/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) represents a common layout item in many modern design languages. The React Card component contains content and actions about a single subject and can work well on its own, as well as when combined with components like the KendoReact ListView to display a collection of cards.
|
|
69
211
|
|
|
70
|
-
|
|
212
|
+
Key features:
|
|
71
213
|
|
|
72
214
|
- **Card Types**—While the KendoReact Card component has a default look -and -feel which can be customized to fit any UX requirements, it does also come with several built-in styles to cut down on the number of customizations needed.
|
|
73
215
|
- **Action Buttons**—Every React Card has a dedicated area for action buttons related to the content.
|
|
74
216
|
- **Layouts**—When rendering multiple KendoReact Card components, there are several built-in layouts to help display cards in various ways, including building a list from top to bottom as well as rendering the cards side-by-side.
|
|
75
217
|
|
|
218
|
+
How to use the Card layout in your apps:
|
|
219
|
+
|
|
220
|
+
```tsx
|
|
221
|
+
import {
|
|
222
|
+
Card,
|
|
223
|
+
CardHeader,
|
|
224
|
+
CardTitle,
|
|
225
|
+
CardSubtitle,
|
|
226
|
+
CardBody,
|
|
227
|
+
CardActions
|
|
228
|
+
} from '@progress/kendo-react-layout';
|
|
229
|
+
...
|
|
230
|
+
/**
|
|
231
|
+
* Provide an image for the CardImage part of the Card.
|
|
232
|
+
*/
|
|
233
|
+
<Card>
|
|
234
|
+
<CardImage src={image} />
|
|
235
|
+
<CardHeader>
|
|
236
|
+
<CardTitle>Title</CardTitle>
|
|
237
|
+
<CardSubtitle>Subtitle</CardSubtitle>
|
|
238
|
+
</CardHeader>
|
|
239
|
+
<CardBody>
|
|
240
|
+
/**
|
|
241
|
+
* The contens of the CardBody.
|
|
242
|
+
*/
|
|
243
|
+
</CardBody>
|
|
244
|
+
<CardActions>
|
|
245
|
+
/**
|
|
246
|
+
* The contens of the actions related to the Card.
|
|
247
|
+
*/
|
|
248
|
+
</CardActions>
|
|
249
|
+
</Card>
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
## React ContextMenu Component
|
|
253
|
+
|
|
254
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
255
|
+
|
|
256
|
+
[The KendoReact ContextMenu component](https://www.telerik.com/kendo-react-ui/components/layout/contextmenu?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) delivers a context menu that pops when a user right-clicks within the UI. It’s best used when you want to add common or advanced commands for the user to execute while preserving screen space for more important information.
|
|
257
|
+
|
|
258
|
+
How to use the ContextMenu layout in your apps:
|
|
259
|
+
|
|
260
|
+
```tsx
|
|
261
|
+
import {
|
|
262
|
+
ContextMenu,
|
|
263
|
+
MenuItem
|
|
264
|
+
} from '@progress/kendo-react-layout';
|
|
265
|
+
...
|
|
266
|
+
/**
|
|
267
|
+
* Handle the logic for showing the menu and item selection.
|
|
268
|
+
*/
|
|
269
|
+
<ContextMenu
|
|
270
|
+
onSelect={handleOnSelect}
|
|
271
|
+
show={show}
|
|
272
|
+
>
|
|
273
|
+
<MenuItem text="Option" />
|
|
274
|
+
/**
|
|
275
|
+
* Provide as many menu items as needed.
|
|
276
|
+
*/
|
|
277
|
+
</ContextMenu>
|
|
278
|
+
```
|
|
279
|
+
|
|
76
280
|
## React Drawer Component
|
|
77
281
|
|
|
282
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
283
|
+
|
|
78
284
|
[The KendoReact Drawer component](https://www.telerik.com/kendo-react-ui/components/layout/drawer/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) offers a navigation that can be permanently displayed, shown and hidden on command, and offers various styles for presenting navigation items.
|
|
79
285
|
|
|
80
|
-
|
|
286
|
+
Key features:
|
|
81
287
|
|
|
82
288
|
- **Display Modes**—The KendoReact Drawer component offers several display modes. This includes controlling if the React Drawer pushes content to the side as it expands or if it is displayed as an overlay on top of the content.
|
|
83
289
|
- **Positioning**—Thanks to its position property, the KendoReact Drawer can be specified to be rendered in any position in relation to the page content.
|
|
84
290
|
|
|
291
|
+
How to use the Drawer layout in your apps:
|
|
292
|
+
|
|
293
|
+
```tsx
|
|
294
|
+
import {
|
|
295
|
+
Drawer,
|
|
296
|
+
DrawerContent
|
|
297
|
+
} from '@progress/kendo-react-layout';
|
|
298
|
+
...
|
|
299
|
+
/**
|
|
300
|
+
* Provide a list of items to show when the Drawer is expanded.
|
|
301
|
+
* Handle the logic for showing the menu and item selection.
|
|
302
|
+
*/
|
|
303
|
+
<Drawer
|
|
304
|
+
expanded={expanded}
|
|
305
|
+
position='end|start'
|
|
306
|
+
mode='push|overlay'
|
|
307
|
+
items={items}
|
|
308
|
+
onSelect={handleSelect}
|
|
309
|
+
>
|
|
310
|
+
<DrawerContent>
|
|
311
|
+
/**
|
|
312
|
+
* Render the drawer content.
|
|
313
|
+
*/
|
|
314
|
+
</DrawerContent>
|
|
315
|
+
</Drawer>
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
## React ExpansionPanel Component
|
|
319
|
+
|
|
320
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
321
|
+
|
|
322
|
+
[The KendoReact ExpansionPanel component](https://www.telerik.com/kendo-react-ui/components/layout/expansionpanel?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) delivers an easy way for implementing what’s usually a tedious process—a context menu that pops when a user right-clicks on your UI. It’s best used when you want to add common or advanced commands for the user to execute while preserving screen space for more important information.
|
|
323
|
+
|
|
324
|
+
How to use the ExpansionPanel layout in your apps:
|
|
325
|
+
|
|
326
|
+
```tsx
|
|
327
|
+
import { ExpansionPanel, ExpansionPanelContent } from '@progress/kendo-react-layout';
|
|
328
|
+
...
|
|
329
|
+
<ExpansionPanel
|
|
330
|
+
title="Expansion Panel Title"
|
|
331
|
+
subtitle="Subtitle"
|
|
332
|
+
>
|
|
333
|
+
<ExpansionPanelContent>
|
|
334
|
+
/**
|
|
335
|
+
* Render the content that shows when the panel is expanded.
|
|
336
|
+
* You can also wrap the entire ExpansionPanelContent component in an animation.
|
|
337
|
+
*/
|
|
338
|
+
</ExpansionPanelContent>
|
|
339
|
+
</ExpansionPanel>
|
|
340
|
+
```
|
|
341
|
+
|
|
85
342
|
## React GridLayout Component
|
|
86
343
|
|
|
344
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
345
|
+
|
|
87
346
|
[The KendoReact GridLayout component](https://www.telerik.com/kendo-react-ui/components/layout/gridlayout/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) allows you to easily arrange the contents of the component in rows and columns in a grid structure.
|
|
88
347
|
|
|
348
|
+
How to use the GridLayout layout in your apps:
|
|
349
|
+
|
|
350
|
+
```tsx
|
|
351
|
+
import { GridLayout, GridLayoutItem } from '@progress/kendo-react-layout';
|
|
352
|
+
...
|
|
353
|
+
<GridLayout
|
|
354
|
+
cols={[{width: 150}, {width: 150}]}
|
|
355
|
+
gap={10}
|
|
356
|
+
>
|
|
357
|
+
<GridLayoutItem>Item </GridLayoutItem>
|
|
358
|
+
<GridLayoutItem>Item</GridLayoutItem>
|
|
359
|
+
</GridLayout>
|
|
360
|
+
```
|
|
361
|
+
|
|
89
362
|
## React Menu Component
|
|
90
363
|
|
|
364
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
365
|
+
|
|
91
366
|
[The KendoReact Menu component](https://www.telerik.com/kendo-react-ui/components/layout/menu/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) is great to provide nice navigation for the web application. The component can have many sub-menu options making it very easy to navigate through applications with multiple levels of pages.
|
|
92
367
|
|
|
93
|
-
|
|
368
|
+
Key features:
|
|
94
369
|
|
|
95
370
|
- **Menu Items**—The KendoReact Menu Items provide many customization options, making it easy to add additional elements like icons, images and more.
|
|
96
371
|
- **Vertical Menu**—The KendoReact Menu is rendered horizontally by default, but it can render vertically by setting just a single property.
|
|
97
372
|
- **Context Menu**—The ContextMenu gives the user a beautifully styled list of options for navigation or executing commands like, copy, paste, download etc.
|
|
98
373
|
|
|
374
|
+
How to use the Menu layout in your apps:
|
|
375
|
+
|
|
376
|
+
```tsx
|
|
377
|
+
import { Menu, MenuItem } from '@progress/kendo-react-layout';
|
|
378
|
+
...
|
|
379
|
+
<Menu>
|
|
380
|
+
<MenuItem text="Item 1" />
|
|
381
|
+
<MenuItem text="Item 2" />
|
|
382
|
+
</Menu>
|
|
383
|
+
```
|
|
384
|
+
|
|
99
385
|
## React PanelBar Component
|
|
100
386
|
|
|
387
|
+
> This is a KendoReact **premium component** and requires a commercial license or an active trial license.
|
|
388
|
+
|
|
101
389
|
[The KendoReact PanelBar component](https://www.telerik.com/kendo-react-ui/components/layout/panelbar/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) is a great choice when we must show hierarchical expandable data.
|
|
102
390
|
|
|
103
|
-
|
|
391
|
+
Key features:
|
|
104
392
|
|
|
105
393
|
- **Expand Modes**—The component provides two built-in expand modes, allowing the user to expand multiple elements at once, or only one.
|
|
106
394
|
- **Animations**—The React PanelBar component comes with a wide variety of eye catching and slick animations. These result in more fluent transitions between sections.
|
|
107
395
|
|
|
396
|
+
How to use the PanelBar layout in your apps:
|
|
397
|
+
|
|
398
|
+
```tsx
|
|
399
|
+
import { PanelBar, PanelBarItem } from '@progress/kendo-react-layout';
|
|
400
|
+
...
|
|
401
|
+
<PanelBar>
|
|
402
|
+
<PanelBarItem title="Item 1">
|
|
403
|
+
/**
|
|
404
|
+
* Render the contens shown within the panel.
|
|
405
|
+
*/
|
|
406
|
+
</PanelBarItem>
|
|
407
|
+
/**
|
|
408
|
+
* Add as many PanelBarItems as needed.
|
|
409
|
+
*/
|
|
410
|
+
</PanelBar>
|
|
411
|
+
```
|
|
412
|
+
|
|
108
413
|
## React Splitter Component
|
|
109
414
|
|
|
415
|
+
> This is a KendoReact **premium component** and requires a commercial license or an active trial license.
|
|
416
|
+
|
|
110
417
|
[The KendoReact Splitter component](https://www.telerik.com/kendo-react-ui/components/layout/splitter/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) enables developers to define sections of a page in a column and row structure.
|
|
111
418
|
|
|
112
|
-
|
|
419
|
+
Key features:
|
|
113
420
|
|
|
114
421
|
- **Panes**—Each content area of the React Splitter is a Pane, and each Pane has options to help define dimensions and allow for resizing, collapsing or scrolling on a pane-by-pane basis.
|
|
115
422
|
- **Orientation**—The KendoReact Splitter allows for each Pane to be arranged either horizontally or vertically.
|
|
116
423
|
|
|
424
|
+
How to use the Splitter layout in your apps:
|
|
425
|
+
|
|
426
|
+
```tsx
|
|
427
|
+
import { Splitter, SplitterOnChangeEvent } from '@progress/kendo-react-layout';
|
|
428
|
+
...
|
|
429
|
+
/**
|
|
430
|
+
* Define your panes and their initial state.
|
|
431
|
+
* Handle the logic for pane resizing when the end user interacts with the Splitter.
|
|
432
|
+
*/
|
|
433
|
+
<Splitter
|
|
434
|
+
panes={panes}
|
|
435
|
+
onChange={onHorizontalChange}
|
|
436
|
+
>
|
|
437
|
+
/**
|
|
438
|
+
* Provide the content that will be used to populate the panes. For example: <h> or <div> elements. The number of provided elements must match the number of panes.
|
|
439
|
+
*/
|
|
440
|
+
</Splitter>
|
|
441
|
+
```
|
|
442
|
+
|
|
117
443
|
## React StackLayout Component
|
|
118
444
|
|
|
445
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
446
|
+
|
|
119
447
|
[The KendoReact StackLayout component](https://www.telerik.com/kendo-react-ui/components/layout/stacklayout/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) allows you to easily align vertically or horizontally multiple elements in a stack.
|
|
120
448
|
|
|
449
|
+
How to use the StackLayout in your apps:
|
|
450
|
+
|
|
451
|
+
```tsx
|
|
452
|
+
import { StackLayout } from '@progress/kendo-react-layout';
|
|
453
|
+
...
|
|
454
|
+
<StackLayout>
|
|
455
|
+
/**
|
|
456
|
+
* Wrap the content that you need to show with the StackLayout component.
|
|
457
|
+
*/
|
|
458
|
+
</StackLayout>
|
|
459
|
+
```
|
|
460
|
+
|
|
121
461
|
## React Stepper Component
|
|
122
462
|
|
|
463
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
464
|
+
|
|
123
465
|
[The KendoReact Stepper component](https://www.telerik.com/kendo-react-ui/components/layout/stepper/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) enables developers to create a set of logical steps in sequential order and visualizes the progress throughout the steps.
|
|
124
466
|
|
|
125
|
-
|
|
467
|
+
Key features:
|
|
126
468
|
|
|
127
469
|
- **Display Modes**—With the KendoReact Stepper component there are several ways to display each step. This includes simple steps numbered in sequential order, to using icons or custom text within each step, as well as providing labels underneath each step.
|
|
128
470
|
- **Linear Mode**—There may be requirements that enforce a progression from the first to the last step in order, and this is where the linear mode of the KendoReact Stepper comes in to play.
|
|
129
471
|
- **Orientation**—The KendoReact Stepper supports both horizontal and vertical orientations and can dynamically switch between them with a single configuration option.
|
|
130
472
|
|
|
473
|
+
How to use the Stepper layout in your apps:
|
|
474
|
+
|
|
475
|
+
```tsx
|
|
476
|
+
import { Stepper, StepperChangeEvent } from '@progress/kendo-react-layout';
|
|
477
|
+
...
|
|
478
|
+
/**
|
|
479
|
+
* Provide the items that you want to show in the Stepper.
|
|
480
|
+
* Handle the logic for step selection.
|
|
481
|
+
*/
|
|
482
|
+
<Stepper items={items} />
|
|
483
|
+
```
|
|
484
|
+
|
|
131
485
|
## React TabStrip Component
|
|
132
486
|
|
|
487
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
488
|
+
|
|
133
489
|
With [the KendoReact TabStrip component](https://www.telerik.com/kendo-react-ui/components/layout/tabstrip/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) you can display a collection of tabs each with its own associated content. Each tab within the KendoReact TabStrip component comes with multiple configuration options. This includes setting the text of the tabs, displaying or not displaying tabs on initial loading, setting the tab position, as well as implementing closable tabs.
|
|
134
490
|
|
|
491
|
+
How to use the TabStrip layout in your apps:
|
|
492
|
+
|
|
493
|
+
```tsx
|
|
494
|
+
import {
|
|
495
|
+
TabStrip,
|
|
496
|
+
TabStripSelectEventArguments,
|
|
497
|
+
TabStripTab
|
|
498
|
+
} from '@progress/kendo-react-layout';
|
|
499
|
+
...
|
|
500
|
+
/**
|
|
501
|
+
* Handle the logic for tab selection.
|
|
502
|
+
*/
|
|
503
|
+
<TabStrip onSelect={handleSelect}>
|
|
504
|
+
<TabStripItem></TabStripItem>
|
|
505
|
+
/**
|
|
506
|
+
* Show as many TabStripItems as needed.
|
|
507
|
+
*/
|
|
508
|
+
</TabStripItem>
|
|
509
|
+
</TabStrip>
|
|
510
|
+
```
|
|
511
|
+
|
|
135
512
|
## React TileLayout Component
|
|
136
513
|
|
|
514
|
+
> This is a **free React component**—no sign-up or license required, even in production.
|
|
515
|
+
|
|
137
516
|
[The KendoReact TileLayout component](https://www.telerik.com/kendo-react-ui/components/layout/tilelayout/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) is perfect for creating interactive dashboards using a single UI component with a flexible set of configuration options.
|
|
138
517
|
|
|
139
|
-
|
|
518
|
+
Key features:
|
|
140
519
|
|
|
141
520
|
- **Tile Interactions**—With end-user interactivity being the primary driver of the component, the KendoReact TileLayout component gives users the flexibility of rearranging and resizing the available tiles.
|
|
142
521
|
- **Tile Configuration Options**—The Tiles can be static, resized with a resize handler, dragged & dropped to change their location, as well as edited. The layout of the React TileLayout component is defined through a set number of columns and then the available Tile collection will auto-populate the available columns and rows within the TileLayout component.
|
|
143
522
|
- **Auto Flows**—The KendoReact TileLayout component provides out-of-the-box defaults for how tiles should behave when they are placed within the component. In addition to the default AutoFlow, React developers can also customize the flow to their liking, based on the industry-standard CSS grid-auto-flow property.
|
|
144
523
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
524
|
+
How to use the TabStrip layout in your apps:
|
|
525
|
+
|
|
526
|
+
```tsx
|
|
527
|
+
import { TileLayout, TileLayoutRepositionEvent } from '@progress/kendo-react-layout';
|
|
528
|
+
...
|
|
529
|
+
/**
|
|
530
|
+
* Handle the logic for tile repositioning.
|
|
531
|
+
* Provide the content for the tiles that you want to show.
|
|
532
|
+
*/
|
|
533
|
+
<TileLayout
|
|
534
|
+
columns={4}
|
|
535
|
+
rowHeight={255}
|
|
536
|
+
positions={data}
|
|
537
|
+
gap={{ rows: 10, columns: 10 }}
|
|
538
|
+
items={tiles}
|
|
539
|
+
onReposition={handleReposition}
|
|
540
|
+
/>
|
|
541
|
+
```
|
|
542
|
+
|
|
543
|
+
## React Timeline Component
|
|
544
|
+
|
|
545
|
+
> This is a KendoReact **premium component** and requires a commercial license or an active trial license.
|
|
546
|
+
|
|
547
|
+
[The KendoReact Timeline component](https://www.telerik.com/kendo-react-ui/components/layout/timeline?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout) enables you to display events in chronological order, making it suitable for showcasing company history or visualizing significant milestones. The component offers a horizontal and a vertical mode in which the events can be collapsed for a neat and structured view.
|
|
548
|
+
|
|
549
|
+
How to use the Timeline layout in your apps:
|
|
550
|
+
|
|
551
|
+
```tsx
|
|
552
|
+
import { Timeline } from '@progress/kendo-react-layout';
|
|
553
|
+
...
|
|
554
|
+
/**
|
|
555
|
+
* Provide the list of events that you want to show on the Timeline.
|
|
556
|
+
*/
|
|
557
|
+
<Timeline events={events} />
|
|
558
|
+
```
|
|
155
559
|
|
|
156
560
|
## Support Options
|
|
157
561
|
|
|
@@ -164,6 +568,7 @@ For any issues you might encounter while working with the KendoReact Layout, use
|
|
|
164
568
|
## Resources
|
|
165
569
|
|
|
166
570
|
- [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-layout)
|
|
571
|
+
- [Get Started with KendoReact Free: 50+ Free React Components](https://www.telerik.com/kendo-react-ui/components/free)
|
|
167
572
|
- [Getting Started with the KendoReact Layout](https://www.telerik.com/kendo-react-ui/components/layout/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout)
|
|
168
573
|
- [API Reference of the KendoReact Layout](https://www.telerik.com/kendo-react-ui/components/layout/api/?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout)
|
|
169
574
|
- [KendoReact Roadmap](https://www.telerik.com/support/whats-new/kendo-react-ui/roadmap?utm_medium=referral&utm_source=npm&utm_campaign=kendo-ui-react-trial-npm-layout)
|
|
@@ -172,23 +577,25 @@ For any issues you might encounter while working with the KendoReact Layout, use
|
|
|
172
577
|
- [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-layout)
|
|
173
578
|
- [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-layout)
|
|
174
579
|
|
|
175
|
-
High-level component overview pages
|
|
580
|
+
High-level component overview pages:
|
|
176
581
|
|
|
177
582
|
- [React AppBar Component](https://www.telerik.com/kendo-react-ui/appbar)
|
|
178
583
|
- [React Avatar Component](https://www.telerik.com/kendo-react-ui/avatar)
|
|
179
584
|
- [React BottomNavigation Component](https://www.telerik.com/kendo-react-ui/bottomnavigation)
|
|
180
585
|
- [React BreadCrumb Component](https://www.telerik.com/kendo-react-ui/breadcrumb)
|
|
181
586
|
- [React Card Component](https://www.telerik.com/kendo-react-ui/card)
|
|
587
|
+
- [React ContextMenu Component](https://www.telerik.com/kendo-react-ui/contextmenu)
|
|
182
588
|
- [React Drawer Component](https://www.telerik.com/kendo-react-ui/drawer)
|
|
183
589
|
- [React ExpansionPanel Component](https://www.telerik.com/kendo-react-ui/expansionpanel)
|
|
184
590
|
- [React Grid Layout Component](https://www.telerik.com/kendo-react-ui/gridlayout)
|
|
185
591
|
- [React Menu Component](https://www.telerik.com/kendo-react-ui/menu)
|
|
186
592
|
- [React PanelBar Component](https://www.telerik.com/kendo-react-ui/panelbar)
|
|
187
593
|
- [React Splitter Component](https://www.telerik.com/kendo-react-ui/splitter)
|
|
188
|
-
- [React
|
|
594
|
+
- [React StackLayout Component](https://www.telerik.com/kendo-react-ui/stacklayout)
|
|
189
595
|
- [React Stepper Component](https://www.telerik.com/kendo-react-ui/stepper)
|
|
190
596
|
- [React TabStrip Component](https://www.telerik.com/kendo-react-ui/tabstrip)
|
|
191
597
|
- [React TileLayout Component](https://www.telerik.com/kendo-react-ui/tilelayout)
|
|
598
|
+
- [React Timeline Component](https://www.telerik.com/kendo-react-ui/timeline)
|
|
192
599
|
|
|
193
600
|
_Copyright © 2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved._
|
|
194
601
|
|
package/package-metadata.js
CHANGED
|
@@ -5,4 +5,4 @@
|
|
|
5
5
|
* Licensed under commercial license. See LICENSE.md in the package root for more information
|
|
6
6
|
*-------------------------------------------------------------------------------------------
|
|
7
7
|
*/
|
|
8
|
-
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={name:"@progress/kendo-react-layout",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate:
|
|
8
|
+
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={name:"@progress/kendo-react-layout",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1741334988,version:"10.0.0-develop.4",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"};exports.packageMetadata=e;
|
package/package-metadata.mjs
CHANGED
|
@@ -10,8 +10,8 @@ const e = {
|
|
|
10
10
|
productName: "KendoReact",
|
|
11
11
|
productCode: "KENDOUIREACT",
|
|
12
12
|
productCodes: ["KENDOUIREACT"],
|
|
13
|
-
publishDate:
|
|
14
|
-
version: "10.0.0-develop.
|
|
13
|
+
publishDate: 1741334988,
|
|
14
|
+
version: "10.0.0-develop.4",
|
|
15
15
|
licensingDocsUrl: "https://www.telerik.com/kendo-react-ui/components/my-license/"
|
|
16
16
|
};
|
|
17
17
|
export {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@progress/kendo-react-layout",
|
|
3
|
-
"version": "10.0.0-develop.
|
|
3
|
+
"version": "10.0.0-develop.4",
|
|
4
4
|
"description": "React Layout components enable you to create a perceptive and intuitive layout of web projects. KendoReact Layout package",
|
|
5
5
|
"author": "Progress",
|
|
6
6
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
@@ -26,12 +26,12 @@
|
|
|
26
26
|
"sideEffects": false,
|
|
27
27
|
"peerDependencies": {
|
|
28
28
|
"@progress/kendo-licensing": "^1.5.0",
|
|
29
|
-
"@progress/kendo-react-animation": "10.0.0-develop.
|
|
30
|
-
"@progress/kendo-react-buttons": "10.0.0-develop.
|
|
31
|
-
"@progress/kendo-react-common": "10.0.0-develop.
|
|
32
|
-
"@progress/kendo-react-intl": "10.0.0-develop.
|
|
33
|
-
"@progress/kendo-react-popup": "10.0.0-develop.
|
|
34
|
-
"@progress/kendo-react-progressbars": "10.0.0-develop.
|
|
29
|
+
"@progress/kendo-react-animation": "10.0.0-develop.4",
|
|
30
|
+
"@progress/kendo-react-buttons": "10.0.0-develop.4",
|
|
31
|
+
"@progress/kendo-react-common": "10.0.0-develop.4",
|
|
32
|
+
"@progress/kendo-react-intl": "10.0.0-develop.4",
|
|
33
|
+
"@progress/kendo-react-popup": "10.0.0-develop.4",
|
|
34
|
+
"@progress/kendo-react-progressbars": "10.0.0-develop.4",
|
|
35
35
|
"@progress/kendo-svg-icons": "^4.0.0",
|
|
36
36
|
"react": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc",
|
|
37
37
|
"react-dom": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
"package": {
|
|
62
62
|
"productName": "KendoReact",
|
|
63
63
|
"productCode": "KENDOUIREACT",
|
|
64
|
-
"publishDate":
|
|
64
|
+
"publishDate": 1741334988,
|
|
65
65
|
"licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
|
|
66
66
|
}
|
|
67
67
|
},
|