Skip to content

Commit d02879d

Browse files
Merge pull request #9 from Mohamed7Imran/master
Update readme.md
2 parents fabe12f + 575009d commit d02879d

File tree

31 files changed

+693
-322
lines changed

31 files changed

+693
-322
lines changed

components/base/README.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,15 @@ The `@syncfusion/react-base` package is a foundational library for Syncfusion's
1010
- `Localization`: Adaptable content for region-specific requirements.
1111
- `Right-to-Left (RTL)`: Built-in support for RTL languages like Arabic and Hebrew.
1212

13-
## Installation
13+
**Setup**
1414

1515
To install `@syncfusion/react-base` and its dependencies, run the following command:
1616

1717
```sh
1818
npm install @syncfusion/react-base
1919
```
2020

21-
## Usage
21+
**Usage**
2222

2323
This package serves as a dependency for other Syncfusion® React components. Import the necessary utilities or providers as needed in your React application. For example:
2424

@@ -31,7 +31,10 @@ import { Button } from '@syncfusion/react-buttons';
3131
</Provider>
3232
```
3333

34-
Refer to the [Syncfusion® Documentation](https://react.syncfusion.com/overview/introduction) for detailed usage instructions and examples.
34+
**Resources**
35+
36+
- [Base Demo/Docs](https://react.syncfusion.com/common-features/right-to-left)
37+
- [Base API](https://react-api.syncfusion.com/base/overview)
3538

3639
## Support
3740

@@ -51,4 +54,4 @@ Check the changelog [here](https://github.com/syncfusion/react-ui-components/blo
5154
5255
See [LICENSE FILE](https://github.com/syncfusion/react-ui-components/blob/master/license?utm_source=npm&utm_campaign=notification) for more info.
5356

54-
&copy; Copyright 2025 Syncfusion, Inc. All Rights Reserved. The Syncfusion® Essential® Studio license and copyright applies to this distribution.
57+
&copy; Copyright 2025 Syncfusion®, Inc. All Rights Reserved. The Syncfusion® Essential® Studio license and copyright applies to this distribution.

components/buttons/README.md

Lines changed: 113 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,18 @@
1-
# React Buttons Components
1+
# Syncfusion React Button Components
22

3-
## What's Included in the React Button Package
3+
The Syncfusion React Buttons package provides a feature-rich collection of UI components, including Button, CheckBox, RadioButton, Switch, Chip, ChipList, and Floating Action Button, for building modern, interactive React applications.
44

5-
The React Button package includes the following list of components.
5+
## Setup
66

7-
### React Button
7+
To install `buttons` and its dependent packages, use the following command,
88

9-
The Button component is designed to create highly customizable and interactive button elements with a variety of styling and functional options. It allows for tailored interactions through different configurations such as size, color, icon positioning, and toggle capability.
9+
```sh
10+
npm install @syncfusion/react-buttons
11+
```
1012

11-
Explore the demo [here](https://react.syncfusion.com/button).
13+
## React Button
14+
15+
The Button component is designed to create highly customizable and interactive button elements with a variety of styling and functional options. It allows for tailored interactions through different configurations such as size, color, icon positioning, and toggle capability.
1216

1317
**Key features**
1418

@@ -24,11 +28,26 @@ Explore the demo [here](https://react.syncfusion.com/button).
2428

2529
- **Selection Management:** Include prop configurations to set initial states, making it simple to handle selection states, especially useful for toggle buttons.
2630

27-
### React Checkbox
31+
**Usage**
2832

29-
The Checkbox component offers a flexible and user-friendly way to allow users to make binary selections. It supports various states and configurations to accommodate different use cases in applications.
33+
```tsx
34+
import { Button } from '@syncfusion/react-buttons';
35+
36+
export default function App() {
37+
return (
38+
<Button>Default Button</Button>
39+
);
40+
};
41+
```
42+
43+
**Resources**
3044

31-
Explore the demo [here](https://react.syncfusion.com/checkbox).
45+
- [Button Demo/Docs](https://react.syncfusion.com/button)
46+
- [Button API](https://react-api.syncfusion.com/button/overview)
47+
48+
## React Checkbox
49+
50+
The Checkbox component offers a flexible and user-friendly way to allow users to make binary selections. It supports various states and configurations to accommodate different use cases in applications.
3251

3352
**Key features**
3453

@@ -38,11 +57,26 @@ Explore the demo [here](https://react.syncfusion.com/checkbox).
3857

3958
- **Label Positioning:** Configure the label placement with the `labelPlacement` prop, choosing whether the label appears before or after the Checkbox.
4059

41-
### React Chip
60+
**Usage**
4261

43-
The Chip component represents information in a compact form, such as entity attribute, text, or action. It provides a versatile way to display content in a contained, interactive element.
62+
```tsx
63+
import { Checkbox } from '@syncfusion/react-buttons';
64+
65+
export default function App() {
66+
return (
67+
<Checkbox label='Checkbox' defaultChecked/>
68+
);
69+
}
70+
```
71+
72+
**Resources**
4473

45-
Explore the demo [here](https://react.syncfusion.com/chip).
74+
- [Checkbox Demo/Docs](https://react.syncfusion.com/checkbox)
75+
- [Checkbox API](https://react-api.syncfusion.com/checkbox/overview)
76+
77+
## React Chip
78+
79+
The Chip component represents information in a compact form, such as entity attribute, text, or action. It provides a versatile way to display content in a contained, interactive element.
4680

4781
**Key features**
4882

@@ -52,11 +86,26 @@ Explore the demo [here](https://react.syncfusion.com/chip).
5286

5387
- **Icons and Avatars:** Enhance visual representation with leading icons, trailing icons, or avatars to provide additional context.
5488

55-
### React ChipList
89+
**Usage**
5690

57-
The ChipList component displays a collection of chips that can be used to represent multiple items in a compact form. It provides a flexible way to manage and interact with a group of chip elements.
91+
```tsx
92+
import { Chip } from '@syncfusion/react-buttons';
93+
94+
export default function App() {
95+
return (
96+
<Chip>Anne</Chip>
97+
);
98+
}
99+
```
100+
101+
**Resources**
58102

59-
Explore the demo [here](https://react.syncfusion.com/chiplist).
103+
- [Chip Demo/Docs](https://react.syncfusion.com/chip)
104+
- [Chip API](https://react-api.syncfusion.com/chip/overview)
105+
106+
## React ChipList
107+
108+
The ChipList component displays a collection of chips that can be used to represent multiple items in a compact form. It provides a flexible way to manage and interact with a group of chip elements.
60109

61110
**Key features**
62111

@@ -70,11 +119,26 @@ Explore the demo [here](https://react.syncfusion.com/chiplist).
70119

71120
- **Controlled & Uncontrolled Modes:** Supports both controlled and uncontrolled component patterns for selection and deletion.
72121

73-
### React Floating Action Button
122+
**Usage**
74123

75-
The Floating Action Button (FAB) component provides a prominent primary action within an application interface, positioned for high visibility and customizable with various styling options.
124+
```tsx
125+
import { ChipList } from "@syncfusion/react-buttons";
126+
127+
export default function App() {
128+
return (
129+
<ChipList chips={['Apple', 'Banana', 'Cherry']} selection='Multiple' removable={true} />
130+
);
131+
}
132+
```
133+
134+
**Resources**
76135

77-
Explore the demo [here](https://react.syncfusion.com/floating-action-button).
136+
- [ChipList Demo/Docs](https://react.syncfusion.com/chipList)
137+
- [ChipList API](https://react-api.syncfusion.com/chipList/overview)
138+
139+
## React Floating Action Button
140+
141+
The Floating Action Button (FAB) component provides a prominent primary action within an application interface, positioned for high visibility and customizable with various styling options.
78142

79143
**Key features**
80144

@@ -90,53 +154,53 @@ Explore the demo [here](https://react.syncfusion.com/floating-action-button).
90154

91155
- **Toggle Functionality:** Activate toggle behavior for the FAB to allow it to switch states on each user interaction, which can be useful for certain UI scenarios.
92156

93-
### React RadioButton
157+
**Usage**
94158

95-
The RadioButton component enables users to select a single option from a group, offering a clear circular interface for making selections. It is a simple and efficient way to present mutually exclusive choices to users.
96-
97-
Explore the demo [here](https://react.syncfusion.com/radio-button).
98-
99-
**Key features**
100-
101-
- **Selection State:** Easily configure the RadioButton to be in a checked or unchecked state, indicating selected or unselected options within a group.
102-
103-
- **Label Customization:** The RadioButton can be accompanied by a text label to describe its function, which helps users understand the purpose of the radio selection.
159+
```tsx
160+
import { Fab, Color, FabPosition } from "@syncfusion/react-buttons";
104161

105-
- **Label Positioning:** Flexibly position the label relative to the RadioButton with options available for placing it before or after the button, enhancing UI layout consistency.
162+
export default function App() {
163+
return (
164+
<Fab color={Color.Success} position={FabPosition.BottomLeft}>FAB</Fab>
165+
);
166+
}
167+
```
106168

107-
- **Form Integration:** The value attribute of the RadioButton can be included as part of form data submitted to the server, facilitating efficient data processing.
169+
**Resources**
108170

109-
### React Switch
171+
- [Floating Action Button Demo/Docs](https://react.syncfusion.com/floating-action-button)
172+
- [Floating Action Button API](https://react-api.syncfusion.com/floating-action-button/overview)
110173

111-
The Switch component is a toggle interface offering a binary decision between on and off states, visually represented with an optional label for clarity. Its intuitive design makes it ideal for user interactions requiring a straightforward choice.
174+
## React RadioButton
112175

113-
Explore the demo [here](https://react.syncfusion.com/switch).
176+
The RadioButton component enables users to select a single option from a group, offering a clear circular interface for making selections. It is a simple and efficient way to present mutually exclusive choices to users.
114177

115178
**Key features**
116179

117-
- **State Control:** Easily configure the switch to be in a checked (on) or unchecked (off) state, providing an immediate visual cue of its current position to users.
180+
- **Selection State:** Easily configure the RadioButton to be in a checked or unchecked state, indicating selected or unselected options within a group.
118181

119-
- **Label Customization:** Customize the on and off labels to provide additional context for users, clarifying what each state signifies within the application's workflow.
182+
- **Label Customization:** The RadioButton can be accompanied by a text label to describe its function, which helps users understand the purpose of the radio selection.
120183

121-
- **Size Options:** Adapt the size of the switch to fit various UI designs with available size options such as 'small', 'medium' and 'bigger', ensuring seamless integration with different interfaces.
184+
- **Label Positioning:** Flexibly position the label relative to the RadioButton with options available for placing it before or after the button, enhancing UI layout consistency.
122185

123-
- **Form Integration:** Utilize the switch within forms by setting name and value attributes, ensuring that user selections are included in form submissions for backend processing.
186+
- **Form Integration:** The value attribute of the RadioButton can be included as part of form data submitted to the server, facilitating efficient data processing.
124187

188+
**Usage**
125189

126-
<p align="center">
127-
Trusted by the world's leading companies
128-
<a href="https://www.syncfusion.com/">
129-
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/syncfusion/syncfusion-trusted-companies.webp" alt="Syncfusion logo">
130-
</a>
131-
</p>
190+
```tsx
191+
import { RadioButton } from "@syncfusion/react-buttons";
132192

133-
## Setup
193+
export default function App() {
194+
return (
195+
<RadioButton checked={true} label="Choose this option" name="choices" />
196+
);
197+
}
198+
```
134199

135-
To install `buttons` and its dependent packages, use the following command,
200+
**Resources**
136201

137-
```sh
138-
npm install @syncfusion/react-buttons
139-
```
202+
- [RadioButton Demo/Docs](https://react.syncfusion.com/radio-button)
203+
- [RadioButton API](https://react-api.syncfusion.com/radio-button/overview)
140204

141205
## Support
142206

@@ -156,4 +220,4 @@ Check the changelog [here](https://github.com/syncfusion/react-ui-components/blo
156220
157221
See [LICENSE FILE](https://github.com/syncfusion/react-ui-components/blob/master/license?utm_source=npm&utm_campaign=notification) for more info.
158222

159-
&copy; Copyright 2025 Syncfusion, Inc. All Rights Reserved. The Syncfusion Essential Studio license and copyright applies to this distribution.
223+
&copy; Copyright 2025 Syncfusion®, Inc. All Rights Reserved. The Syncfusion® Essential Studio® license and copyright applies to this distribution.

components/buttons/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@syncfusion/react-buttons",
33
"version": "31.1.17",
4-
"description": "A package of feature-rich React components such as Button, CheckBox and RadioButton.",
4+
"description": "Syncfusion React Buttons package is a feature-rich collection of UI components including Button, CheckBox, RadioButton, Switch, Chip, and more for building modern, interactive React applications.",
55
"author": "Syncfusion Inc.",
66
"license": "SEE LICENSE IN license",
77
"keywords": [

components/calendars/README.md

Lines changed: 43 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,74 +1,70 @@
1-
# React Calendars Components
2-
3-
## What's Included in the React Calendar Package
4-
5-
The React Calendar package includes the following list of components.
6-
7-
### React Calendar
8-
1+
# Syncfusion React Calendar Components
2+
3+
The Syncfusion React Calendar components for managing date and time with features like date formatting, inline editing, multiple (range) selection, range restriction, month and year selection, strict mode, and globalization.
4+
5+
## React Calendar
6+
97
The Calendar component provides a versatile and interactive date selection interface with support for multiple views, customizations, and selection modes. It is designed to handle a wide range of scheduling and planning use cases.
10-
11-
Explore the demo [here](https://react.syncfusion.com/calendar).
12-
8+
139
**Key features**
14-
10+
1511
- **View Modes:** Switch between month, year, and decade views using the start and depth properties to control the initial view and navigation depth.
16-
12+
1713
- **Date Range Control:** Restrict selectable dates using minDate and maxDate to ensure users can only choose valid dates within a defined range.
18-
14+
1915
- **Custom Cell Templates:** Use the cellTemplate property to customize the appearance of specific dates, including disabling dates to prevent selection.
20-
16+
2117
- **Week Number Display:** Enable the weekNumber property to show week numbers alongside calendar dates for better context in scheduling.
22-
18+
2319
- **Multi-Date Selection:** Activate the multiSelect property to allow users to select multiple non-consecutive dates, ideal for marking events or selecting custom date ranges.
24-
25-
### React DatePicker
26-
20+
21+
## React DatePicker
22+
2723
The DatePicker component offers a streamlined and customizable interface for selecting dates, supporting various formats, view modes, and styling options. It is ideal for forms, scheduling tools, and any application requiring precise date input.
28-
29-
Explore the demo [here](https://react.syncfusion.com/date-picker).
30-
24+
3125
**Key features**
32-
26+
3327
- **Custom Date Formats:** Display and receive date values in formats that suit your application using the format property, which supports standard date format patterns.
34-
28+
3529
- **Read-Only Mode:** Prevent user edits while displaying a selected date by enabling the readOnly property—useful for forms or scenarios where the date is system-generated.
36-
30+
3731
- **View Modes:** Navigate through Month, Year, and Decade views to provide flexible date selection experiences.
38-
32+
3933
- **Custom Cell Templates:** Highlight important dates, events, or special occasions using the cellTemplate property to apply custom styling, icons, or indicators.
40-
41-
<p align="center">
42-
Trusted by the world's leading companies
43-
<a href="https://www.syncfusion.com/">
44-
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/syncfusion/syncfusion-trusted-companies.webp" alt="Syncfusion logo">
45-
</a>
46-
</p>
47-
34+
4835
## Setup
49-
36+
5037
To install `Calendars` and its dependent packages, use the following command,
51-
38+
5239
```sh
5340
npm install @syncfusion/react-calendars
5441
```
55-
42+
43+
<p align="center">
44+
Trusted by the world's leading companies
45+
<a href="https://www.syncfusion.com/">
46+
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/syncfusion/syncfusion-trusted… alt="Syncfusion logo">
47+
</a>
48+
</p>
49+
5650
## Support
57-
51+
5852
Product support is available through following mediums.
59-
53+
6054
* [Support ticket](https://support.syncfusion.com/support/tickets/create) - Guaranteed Response in 24 hours | Unlimited tickets | Holiday support
6155
* Live chat
62-
56+
6357
## Changelog
58+
6459
Check the changelog [here](https://github.com/syncfusion/react-ui-components/blob/master/components/calendars/CHANGELOG.md). Get minor improvements and bug fixes every week to stay up to date with frequent updates.
65-
60+
6661
## License and copyright
67-
62+
6863
> This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this component, is subject to the terms and conditions of Syncfusion's [EULA](https://www.syncfusion.com/eula/es/). To acquire a license for [React UI components](https://www.syncfusion.com/react-components), you can [purchase](https://www.syncfusion.com/sales/products) or [start a free 30-day trial](https://www.syncfusion.com/account/manage-trials/start-trials).
69-
64+
7065
> A [free community license](https://www.syncfusion.com/products/communitylicense) is also available for companies and individuals whose organizations have less than $1 million USD in annual gross revenue and five or fewer developers.
71-
72-
See [LICENSE FILE](https://github.com/syncfusion/react-ui-components/blob/master/license?utm_source=npm&utm_campaign=notification) for more info.
73-
74-
&copy; Copyright 2025 Syncfusion, Inc. All Rights Reserved. The Syncfusion Essential Studio license and copyright applies to this distribution.
66+
67+
See [LICENSE FILE](https://github.com/syncfusion/react-ui-components/blob/master/license?utm_source=npm&utm_campai…) for more info.
68+
69+
&copy; Copyright 2025 Syncfusion®, Inc. All Rights Reserved. The Syncfusion® Essential Studio® license and copyright applies to this distribution.
70+

0 commit comments

Comments
 (0)