Getting Started with the KendoReact Buttons
This guide provides essential information about using the KendoReact Buttons package—you will learn how to install the Buttons package, add a Button component to your project, and style the component.
Use React Buttons for FreeYou can use the free components from the React Buttons package in production—no sign-up or license required. Buttons are part of KendoReact, an enterprise-grade UI library with 120+ free and premium components. To test-drive premium components, start a 30-day trial.After completing this guide, you will be able to reproduce the following example.
Before You Begin
To follow the steps in this guide, you need to have a React project set up. If you don't have one, you can create a new React application using the following command:
npm create vite@latest my-app -- --template react-ts
This guide requires that you have basic knowledge of React and TypeScript, and that you have already created a blank React project.
You can accelerate your Buttons journey with the KendoReact Agentic UI Generator and the Component Assistant prompts.
Install the Component
The KendoReact Buttons package is distributed via npm and can be installed using the npm package manager.
To install the Buttons package along with its dependencies and Kendo theme, run the following command in the root folder of your React project:
npm i @progress/kendo-react-buttons @progress/kendo-theme-meridian
Import the CSS file from the package in src/App.tsx. Add this import before your existing App.css import:
import '@progress/kendo-theme-meridian/dist/all.css';
With this import in place, you already have professionally designed styling applied to your app out-of-box. You can also try any of the other available Kendo UI Themes.
Are you looking for guidance around how to create visually appealing and consistent user interfaces with Telerik UI components? Check out the Progress Design System.
Use the Component
After installing the Buttons npm package, import the desired components in the React App. This guide shows how to add the Button.
Place the import statement in the App component file of your React project (for example, src/App.tsx):
import { Button } from '@progress/kendo-react-buttons';
-
After installing the Buttons package and importing the components, add the Button tags to the App component file of your React project (for example,
src/App.tsx).tsx<Button>My Button</Button> -
Optionally, handle the
onClickevent by adding aButtonContainerand then defining the action that occurs when the Button generates theonClickevent.tsxconst ButtonContainer = () => { const handleButtonClick = () => { console.log('click'); alert('KendoReact Button was clicked.'); }; return <Button onClick={handleButtonClick}>My Button</Button>; }; export default ButtonContainer;
KendoReact Button Dependencies
The Buttons package requires you to install the following peer dependencies in your application:
| Package Name | Description |
|---|---|
| react 18.0.0* | Contains the functionality necessary to define React components. |
| react-dom | Contains the React renderer for the web. |
| @progress/kendo-licensing | Contains the internal infrastructure related to licensing. |
| @progress/kendo-svg-icons | Contains the KendoReact SVG icons. |
| @progress/kendo-react-common | Contains common utilities that enhance the performance and functionalities of the KendoReact UI components. |
| @progress/kendo-react-popup | Contains positioning logic for the Popup component. |
| @progress/kendo-react-intl | Contains Internationalization Component |
Activating Your License Key
Important: The KendoReact Buttons have both free and premium features. Only the premium features require a license key file to be installed in your project:
- Trial usage: Start a free trial and download a trial license key file
- Commercial usage: Purchase a license and download a commercial license key file
Without a valid license key file, the premium features will display licensing warnings and watermarks.
Follow the instructions on the KendoReact My License page to download and install your license key file. You can skip this step if your application already contains a KendoReact license file.
Next Steps
The Button package provides the following components:
- ButtonGroup
- Chip
- ChipList
- DropdownButton (premium)
- SplitButton (premium)
- FloatingActionButton
- FloatingToolbar (premium)
- Toolbar