New to Kendo UI for jQuery? Download free 30-day trial

React

Kendo UI provides integration support for React.

To use any jQuery component in a React application, you need a trial of the Kendo UI for jQuery library or a valid Kendo UI license.

Kendo UI Wrappers for React

Since 20 Dec 2021, the Kendo UI Wrappers for React have been deprecated.

Instead of using the Kendo UI Wrappers for React, you can use over 100 native and actively supported KendoReact components. While you can still use the Kendo UI for jQuery components in React apps, we strongly recommend that you use the KendoReact UI component library, which is 100% React.

For the few React components still missing, we recommend the approach below for using Kendo UI for jQuery components in React applications.

KendoReact Suite

If you are looking for native React components (no jQuery dependency), please visit KendoReact. KendoReact is a UI component library of 100+ native React components, from Data Grid, Scheduler and Charts to DatePickers, Menus and Buttons.

To access the native components, you need to sign up for a KendoReact trial or purchase a KendoReact or Kendo UI license.

Almost all Kendo UI for jQuery components can be found as native equivalents in KendoReact. The Spreadsheet is one exception and you can use the jQuery equivalent in your React applications following the instructions below.

The KendoReact Roadmap page provides information about the development plans of the team with regard to new components and features.

Kendo UI for jQuery in React Applications

The Kendo UI for jQuery widgets can be used inside a React application following the steps below. Please note, that our recommendation is to use the native React equivalents as they offer much better performance in React applications.

  1. Import the Kendo UI files or a single file if only one or two widgets will be used in order to reduce the bundle size:

        import '@progress/kendo-ui' // import the entire Kendo UI
        //or
        import '@progress/kendo-ui/js/kendo.spreadsheet.js'
    
  2. Add the DOM element that will be used to render the Kendo UI for jQuery widget.

        <div id="spreadsheet"></div>
    
  3. On the ComponentDidMount event initialize the widget with its options.

        componentDidMount(){
            this.kendoSpreadsheetInstance = $('#spreadsheet').kendoSpreadsheet({
                ...Add options
            }).data('kendoSpreadsheet')
        }
    
  4. The jQuery widgets are not automatically controlled by the changes in the state or the props. If the component has to be changed, the public API methods of the component can be utilized on the componentDidUpdate lifecycle method.

        componentDidUpdate(){
            spreadsheet.fromJSON({
                sheets: [{
                    name: "Food Order",
                    mergedCells: [
                        "A1:G1"
                    ],
                    rows: [{
                        height: 70,
                        cells: [{
                            value: "My Company", fontSize: 32, textAlign: "center"
                        }]
                    }]
                }]
            });
        }
    
  5. To prevent performance issues and memory leaks, destroy the widget on the componentWillUnmount lifecycle method.

        this.kendoSpreadsheetInstance.destroy()
        $('#spreadsheet').empty()
    

See Also

In this article