@progress/kendo-react-layout 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 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)—a commercial UI library.
10
- > - You will need to install a license key when adding the package to your project. For more information, please refer to 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).
11
- > - To receive a license key, you need to either [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). Doing so 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).
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
- What's in this package (ToC):
19
-
20
- - [React AppBar component](#react-appbar-component)
21
- - [React Avatar component](#react-avatar-component)
22
- - [React BottomNavigation component](#react-bottomnavigation-component)
23
- - [React Breadcrumb component](#react-breadcrumb-component)
24
- - [React Card component](#react-card-component)
25
- - [React Drawer component](#react-drawer-component)
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**&mdash;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
- ### Key Features
116
+ Key features:
43
117
 
44
118
  - **Positioning**&mdash;The AppBar can be positioned either at the top or bottom of any React application.
45
119
  - **Content Arrangement**&mdash;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**&mdash;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**&mdash;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**&mdash;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
- ### Key Features
168
+ Key features:
57
169
 
58
170
  - **Content Types**&mdash;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**&mdash;Positioning HTML elements can be tricky, but the React Bottom Navigation component can be easily positioned through a single configuration option.
60
172
  - **Appearance**&mdash;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**&mdash;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**&mdash;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
- ### Key Features
212
+ Key features:
71
213
 
72
214
  - **Card Types**&mdash;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**&mdash;Every React Card has a dedicated area for action buttons related to the content.
74
216
  - **Layouts**&mdash;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**&mdash;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**&mdash;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
- ### Key Features
286
+ Key features:
81
287
 
82
288
  - **Display Modes**&mdash;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**&mdash;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**&mdash;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**&mdash;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**&mdash;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
- ### Key Features
368
+ Key features:
94
369
 
95
370
  - **Menu Items**&mdash;The KendoReact Menu Items provide many customization options, making it easy to add additional elements like icons, images and more.
96
371
  - **Vertical Menu**&mdash;The KendoReact Menu is rendered horizontally by default, but it can render vertically by setting just a single property.
97
372
  - **Context Menu**&mdash;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
- ### Key Features
391
+ Key features:
104
392
 
105
393
  - **Expand Modes**&mdash;The component provides two built-in expand modes, allowing the user to expand multiple elements at once, or only one.
106
394
  - **Animations**&mdash;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
- ### Key Features
419
+ Key features:
113
420
 
114
421
  - **Panes**&mdash;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**&mdash;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**&mdash;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**&mdash;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
- ### Key Features
467
+ Key features:
126
468
 
127
469
  - **Display Modes**&mdash;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**&mdash;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**&mdash;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**&mdash;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**&mdash;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
- ### Key Features
518
+ Key features:
140
519
 
141
520
  - **Tile Interactions**&mdash;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**&mdash;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**&mdash;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
- ## React Layout Components Library Features
146
-
147
- Among the many features which the KendoReact Layout deliver are:
148
-
149
- - **Routing**&mdash;You can use most of the Layout components as a navigational component by wiring it with the React router.
150
- - **Data binding**&mdash;The layout components enables you to bind a data collection to them.
151
- - **Keyboard navigation**&mdash;You can interact with the layout components using only the keyboard.
152
- - **Custom Rendering**&mdash;You can replace the content of the layout components with custom elements.
153
- - **Accessibility support**&mdash;The Layout are compliant with WAI-ARIA and Section 508.
154
- - [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)&mdash;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.
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 Stack Layout Component](https://www.telerik.com/kendo-react-ui/stacklayout)
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
 
@@ -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: 1741269039,version:"10.0.0-develop.3",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"};exports.packageMetadata=e;
8
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={name:"@progress/kendo-react-layout",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1741611291,version:"10.0.0-develop.5",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"};exports.packageMetadata=e;
@@ -10,8 +10,8 @@ const e = {
10
10
  productName: "KendoReact",
11
11
  productCode: "KENDOUIREACT",
12
12
  productCodes: ["KENDOUIREACT"],
13
- publishDate: 1741269039,
14
- version: "10.0.0-develop.3",
13
+ publishDate: 1741611291,
14
+ version: "10.0.0-develop.5",
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",
3
+ "version": "10.0.0-develop.5",
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.3",
30
- "@progress/kendo-react-buttons": "10.0.0-develop.3",
31
- "@progress/kendo-react-common": "10.0.0-develop.3",
32
- "@progress/kendo-react-intl": "10.0.0-develop.3",
33
- "@progress/kendo-react-popup": "10.0.0-develop.3",
34
- "@progress/kendo-react-progressbars": "10.0.0-develop.3",
29
+ "@progress/kendo-react-animation": "10.0.0-develop.5",
30
+ "@progress/kendo-react-buttons": "10.0.0-develop.5",
31
+ "@progress/kendo-react-common": "10.0.0-develop.5",
32
+ "@progress/kendo-react-intl": "10.0.0-develop.5",
33
+ "@progress/kendo-react-popup": "10.0.0-develop.5",
34
+ "@progress/kendo-react-progressbars": "10.0.0-develop.5",
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": 1741269039,
64
+ "publishDate": 1741611291,
65
65
  "licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
66
66
  }
67
67
  },