Skip to content

Commit e216c2c

Browse files
Integrated latest changes at 12-20-2024 9:16:13 PM
1 parent 753511e commit e216c2c

File tree

21 files changed

+665
-19
lines changed

21 files changed

+665
-19
lines changed

ej2-react-toc.html

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1177,6 +1177,7 @@
11771177
<li><a href="/ej2-react/file-manager/virtualization">Virtualization</a></li>
11781178
<li><a href="/ej2-react/file-manager/accessibility">Accessibility</a></li>
11791179
<li><a href="/ej2-react/file-manager/access-control">Access Control</a></li>
1180+
<li><a href="/ej2-react/file-manager/upload">Upload</a></li>
11801181
<li>How To
11811182
<ul>
11821183
<li><a href="/ej2-react/file-manager/how-to/adding-custom-item-to-context-menu">Adding Custom Item To Context Menu</a></li>
@@ -1191,7 +1192,8 @@
11911192
</li>
11921193
<li><a href="https://ej2.syncfusion.com/react/documentation/api/file-manager/">API Reference</a></li>
11931194
</ul>
1194-
</li><li>
1195+
</li>
1196+
<li>
11951197
FloatingActionButton
11961198
<ul>
11971199
<li><a href="/ej2-react/floating-action-button/getting-started">Getting Started</a></li>
@@ -2006,6 +2008,7 @@
20062008
<li><a href="/ej2-react/pdfviewer/how-to/configure-annotation-selector-setting">Configure annotationSelector setting</a></li>
20072009
<li><a href="/ej2-react/pdfviewer/how-to/convert-pdf-library-bounds-to-pdf-viewer-bounds">Convert Pdf Library Bounds to Pdf viewer bounds</a></li>
20082010
<li><a href="/ej2-react/pdfviewer/how-to/show-custom-stamp-item">Display Custom stamp items in custom stamp</a></li>
2011+
<li><a href="/ej2-react/pdfviewer/how-to/enable-local-storage">Enable Local Storage</a></li>
20092012
</ul>
20102013
</li>
20112014
<li>Troubleshooting

ej2-react/appearance/css-variables.md

Lines changed: 55 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,19 @@ Syncfusion currently offers two modern and highly customizable themes using CSS
1717
* Material 3 Theme
1818
* Fluent 2 Theme
1919
* Bootstrap 5.3 Theme
20+
* Tailwind 3.4 Theme
2021

2122
## CSS themes - Syncfusion React components
2223

23-
[Material 3](https://m3.material.io/), [Fluent 2](https://fluent2.microsoft.design/get-started/whatisnew) and [Bootstrap 5.3](https://getbootstrap.com/docs/5.3/getting-started/introduction/) themes have been introduced across all EJ2 Controls, featuring both `light` and `dark` variants. This themes utilizes `CSS variables` to allow easy customization of control colors in CSS format. With this implementation, users can seamlessly switch between light and dark color schemes, providing a flexible solution to meet their preferences and application needs.
24+
[Material 3](https://m3.material.io/), [Fluent 2](https://fluent2.microsoft.design/get-started/whatisnew), [Bootstrap 5.3](https://getbootstrap.com/docs/5.3/getting-started/introduction/) and [Tailwind 3.4](https://tailwindcss.com/docs/installation) themes have been introduced across all EJ2 Controls, featuring both `light` and `dark` variants. This themes utilizes `CSS variables` to allow easy customization of control colors in CSS format. With this implementation, users can seamlessly switch between light and dark color schemes, providing a flexible solution to meet their preferences and application needs.
2425

2526
> Kindly note that in the Material 3 theme, CSS variables with rgb() values are used for color variables. The use of hex values in this context may lead to improper functionality. For example, in previous versions of the Material theme or other themes, the primary color variable was defined as follows: $primary: #6200ee;. However, in the Material 3 theme, the primary color variable is defined as follows: --color-sf-primary: 98, 0, 238;.
2627
2728
### Utilization of CSS variables in modern themes
2829

29-
Modern themes like Material 3, Fluent 2 and Bootstrap 5.3 incorporate support with CSS variables, where `Material 3` utilizes `rgb()` values for customizing colors while `Fluent 2` uses `hex` values for color customization. `Bootstrap 5.3` allows color customization with both `rgb()` and `hex` values. For more information you can refer this [documentation](./theme#syncfusion-material-3-theme) for color variables of these themes. The examples below shows CSS variables with their values used for the respective themes.
30+
Modern themes make it easy to change the colors of controls using CSS variables. Each theme has its own way of setting these variables, so it's important to follow the specific instructions for each theme. Doing this helps keep the styling consistent and efficient across different parts of your application.
31+
32+
Below are examples of how CSS variables can be defined for these themes:
3033

3134
{% tabs %}
3235
{% highlight ts tabtitle="material3.css" %}
@@ -38,6 +41,9 @@ Modern themes like Material 3, Fluent 2 and Bootstrap 5.3 incorporate support wi
3841
{% highlight ts tabtitle="bootstrap5.3.css" %}
3942
{% include code-snippet/common/css-value-cs1/bootstrap5.3.css %}
4043
{% endhighlight %}
44+
{% highlight ts tabtitle="tailwind3.4.css" %}
45+
{% include code-snippet/common/css-value-cs1/tailwind3.4.css %}
46+
{% endhighlight %}
4147
{% endtabs %}
4248

4349
### How to get these themes?
@@ -52,9 +58,11 @@ To access themes provided by Syncfusion, you have two primary options,
5258
|Package | [Material 3 Light](https://www.npmjs.com/package/@syncfusion/ej2-material3-theme) | [Material 3 Dark](https://www.npmjs.com/package/@syncfusion/ej2-material3-dark-theme) |
5359
| | [Fluent 2 Light](https://www.npmjs.com/package/@syncfusion/ej2-fluent2-theme) | [Fluent 2 Dark](https://www.npmjs.com/package/@syncfusion/ej2-fluent2-dark-theme) |
5460
| | [Bootstrap 5.3 Light](https://www.npmjs.com/package/@syncfusion/ej2-bootstrap5.3-theme) | [Bootstrap 5.3 Dark](https://www.npmjs.com/package/@syncfusion/ej2-bootstrap5.3-dark-theme) |
61+
| | [Tailwind 3.4 Light](https://www.npmjs.com/package/@syncfusion/ej2-tailwind3-theme) | [Tailwind 3.4 Dark](https://www.npmjs.com/package/@syncfusion/ej2-tailwind3-dark-theme) |
5562
| CDN | [Material 3 Light](https://cdn.syncfusion.com/ej2/27.1.48/material3.css) | [Material 3 Dark](https://cdn.syncfusion.com/ej2/27.1.48/material3-dark.css) |
5663
| | [Fluent 2 light](https://cdn.syncfusion.com/ej2/27.1.48/fluent2.css) | [Fluent 2 Dark](https://cdn.syncfusion.com/ej2/27.1.48/fluent2-dark.css) |
5764
| | [Bootstrap5.3 light](https://cdn.syncfusion.com/ej2/27.1.48/bootstrap5.3.css) | [Bootstrap 5.3 Dark](https://cdn.syncfusion.com/ej2/27.1.48/bootstrap5.3-dark.css) |
65+
| | [Tailwind 3.4 Light](https://cdn.syncfusion.com/ej2/28.1.33/tailwind3.css) | [Tailwind 3.4 Dark](https://cdn.syncfusion.com/ej2/28.1.33/tailwind3-dark.css) |
5866

5967
### Color Customization in themes
6068

@@ -134,11 +142,35 @@ Example for `Bootstrap 5.3` customization using CSS class.
134142

135143
![customized primary value](images/bootstrap5.3-customize.png)
136144

145+
Example for `Tailwind 3.4` customization using CSS class.
146+
147+
{% tabs %}
148+
{% highlight js tabtitle="index.jsx" %}
149+
{% include code-snippet/common/tailwind3.4-cs2/app/index.jsx %}
150+
{% endhighlight %}
151+
{% highlight ts tabtitle="index.tsx" %}
152+
{% include code-snippet/common/tailwind3.4-cs2/app/index.tsx %}
153+
{% endhighlight %}
154+
{% highlight ts tabtitle="index.css" %}
155+
{% include code-snippet/common/tailwind3.4-cs2/index.css %}
156+
{% endhighlight %}
157+
{% endtabs %}
158+
159+
{% previewsample "page.domainurl/code-snippet/common/tailwind3.4-cs2" %}
160+
161+
**Default Tailwind 3.4 primary value**
162+
163+
![default primary value](images/tailwind3-default.png)
164+
165+
**Customized Tailwind 3.4 primary value**
166+
167+
![customized primary value](images/tailwind3-customize.png)
168+
137169
With this CSS variable support, you can effortlessly customize the color variable values for Syncfusion React Components.
138170

139171
### Switching Light and Dark mode with CSS variables
140172

141-
Switching between modes has become easier with the updated modern themes, which offer Light and Dark variants. In both the `Material 3` and `Fluent 2` light themes, there are distinct class variables for light and dark modes in a `single file`, providing flexibility for seamless switching between the two modes within your application.
173+
Switching between modes has become easier with the updated modern themes, which offer Light and Dark variants. In all themes, there are distinct class variables for light and dark modes in a `single file`, providing flexibility for seamless switching between the two modes within your application.
142174

143175
{% tabs %}
144176
{% highlight js tabtitle="index.jsx" %}
@@ -181,9 +213,24 @@ Similar to `Fluent 2`, we offer both Light and Dark variants with `Bootstrap 5.3
181213

182214
{% previewsample "page.domainurl/code-snippet/common/bootstrap5.3-cs1" %}
183215

216+
### Mode switching in Tailwind 3.4 theme
217+
218+
Similar to `Fluent 2`, we offer both Light and Dark variants with `Tailwind 3.4`. In the Fluent 2 theme, there are distinct class variables for light and dark modes, as shown in the preview below.
219+
220+
{% tabs %}
221+
{% highlight js tabtitle="index.jsx" %}
222+
{% include code-snippet/common/tailwind3.4-cs1/app/index.jsx %}
223+
{% endhighlight %}
224+
{% highlight ts tabtitle="index.tsx" %}
225+
{% include code-snippet/common/tailwind3.4-cs1/app/index.tsx %}
226+
{% endhighlight %}
227+
{% endtabs %}
228+
229+
{% previewsample "page.domainurl/code-snippet/common/tailwind3.4-cs1" %}
230+
184231
### How to switch dark mode?
185232

186-
To activate dark mode, just append the `e-dark-mode` class to the body section of your application for both `Material 3`, `Fluent 2` and `Bootstrap 5.3` themes. Once applied, the theme seamlessly switches to dark mode. Please refer to the example image below for visual guidance.
233+
To activate dark mode, just append the `e-dark-mode` class to the body section of your application for both `Material 3`, `Fluent 2`, `Bootstrap 5.3` and `Tailwind 3.4` themes. Once applied, the theme seamlessly switches to dark mode. Please refer to the example image below for visual guidance.
187234

188235
`Material 3` dark mode
189236

@@ -197,6 +244,10 @@ To activate dark mode, just append the `e-dark-mode` class to the body section o
197244

198245
![dark mode](images/bootstrap5.3-dark.png)
199246

247+
`Tailwind 3.4` dark mode
248+
249+
![dark mode](images/tailwind3-dark.png)
250+
200251
### ThemeStudio Application
201252

202253
The ThemeStudio application now includes seamless integration with the Material 3 and Fluent 2 themes, offering a comprehensive solution for customization requirements. This enhancement enables users to effortlessly customize and personalize their themes.

ej2-react/appearance/icons.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -210,6 +210,10 @@ The complete package of Essential JS 2 icons is listed below. The corresponding
210210

211211
<iframe class="doc-sample-frame" src="https://ej2.syncfusion.com/products/icons/tailwind/demo.html" style="height:1000px;width:100%;"></iframe>
212212

213+
### Tailwind 3.4
214+
215+
<iframe class="doc-sample-frame" src="https://ej2.syncfusion.com/products/icons/tailwind3/demo.html" style="height:1000px;width:100%;"></iframe>
216+
213217
### Fluent 2
214218

215219
<iframe class="doc-sample-frame" src="https://ej2.syncfusion.com/products/icons/fluent2/demo.html" style="height:1000px;width:100%;"></iframe>
Loading
30.8 KB
Loading
Loading

ej2-react/appearance/theme.md

Lines changed: 213 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ The Syncfusion React UI can allow you to apply styles for the components. The fo
1414

1515
|Theme |Style Sheet Name|
1616
|--------|--------|
17+
|Tailwind 3.4 | tailwind3.css |
18+
|Tailwind 3.4 Dark | tailwind3-dark.css |
1719
|Bootstrap 5.3 | bootstrap5.3.css |
1820
|Bootstrap 5.3 Dark | bootstrap5.3-dark.css |
1921
|Fluent 2 | fluent2.css |
@@ -191,6 +193,8 @@ To refer to optimized CSS files, use the following syntax:
191193

192194
| Theme Name | CDN Reference |
193195
|--- | --- |
196+
| Tailwind 3.4 | [https://cdn.syncfusion.com/ej2/28.1.33/tailwind3.css](https://cdn.syncfusion.com/ej2/28.1.33/tailwind3.css) |
197+
| Tailwind 3.4 Dark | [https://cdn.syncfusion.com/ej2/28.1.33/tailwind3-dark.css](https://cdn.syncfusion.com/ej2/28.1.33/tailwind3-dark.css) |
194198
| Bootstrap 5.3 | [https://cdn.syncfusion.com/ej2/27.1.48/bootstrap5.3.css](https://cdn.syncfusion.com/ej2/27.1.48/bootstrap5.3.css) |
195199
| Bootstrap 5.3 Dark | [https://cdn.syncfusion.com/ej2/27.1.48/bootstrap5.3-dark.css](https://cdn.syncfusion.com/ej2/27.1.48/bootstrap5.3-dark.css) |
196200
| Fluent 2 | [https://cdn.syncfusion.com/ej2/27.1.48/fluent2.css](https://cdn.syncfusion.com/ej2/27.1.48/fluent2.css) |
@@ -218,6 +222,215 @@ The following list of common variables are used in the Syncfusion JavaScript lib
218222

219223
<!-- markdownlint-disable MD033 -->
220224

225+
### Syncfusion Tailwind 3.4 theme
226+
227+
<table>
228+
<style>
229+
.circle-color-indicator {
230+
width: 1.5em;
231+
height: 1.5em;
232+
border-radius: 50%;
233+
display: inline-block;
234+
border: 1px solid rgba(0, 0, 0, .08);
235+
vertical-align: middle;
236+
}
237+
th, td {
238+
text-align: left;
239+
padding: 5px 15px;
240+
vertical-align: top;
241+
}
242+
</style>
243+
<thead>
244+
<tr>
245+
<th>Name</th>
246+
<th>Value (Default Theme) </th>
247+
<th>Value (Dark Theme) </th>
248+
</tr>
249+
</thead>
250+
<tbody>
251+
<tr>
252+
<td>--color-sf-black</td>
253+
<td>
254+
<span class="circle-color-indicator" style="background: rgb(0,0,0)"></span> rgb(0,0,0)
255+
</td>
256+
<td>
257+
<span class="circle-color-indicator" style="background: rgb(0,0,0)"></span> rgb(0,0,0)
258+
</td>
259+
</tr>
260+
<tr>
261+
<td>--color-sf-white</td>
262+
<td>
263+
<span class="circle-color-indicator" style="background: rgb(255,255,255)"></span> rgb(255,255,255)
264+
</td>
265+
<td>
266+
<span class="circle-color-indicator" style="background: rgb(255,255,255)"></span> rgb(255,255,255)
267+
</td>
268+
</tr>
269+
<tr>
270+
<td>--color-sf-primary</td>
271+
<td>
272+
<span class="circle-color-indicator" style="background: rgba(79, 70, 229)"></span> rgba(79, 70, 229)
273+
</td>
274+
<td>
275+
<span class="circle-color-indicator" style="background: rgba(99, 102, 241)"></span> rgba(99, 102, 241)
276+
</td>
277+
</tr>
278+
<tr>
279+
<td>--color-sf-primary-text-color</td>
280+
<td>
281+
<span class="circle-color-indicator" style="background: #fff"></span> #fff
282+
</td>
283+
<td>
284+
<span class="circle-color-indicator" style="background: #fff"></span> #fff
285+
</td>
286+
</tr>
287+
<tr>
288+
<td>--color-sf-primary-light</td>
289+
<td>
290+
<span class="circle-color-indicator" style="background: #3730a3"></span> #3730a3
291+
</td>
292+
<td>
293+
<span class="circle-color-indicator" style="background: #3730a3"></span> #3730a3
294+
</td>
295+
</tr>
296+
<tr>
297+
<td>--color-sf-primary-lighter</td>
298+
<td>
299+
<span class="circle-color-indicator" style="background: #e0e7ff"></span> #e0e7ff
300+
</td>
301+
<td>
302+
<span class="circle-color-indicator" style="background: #1e1b4b"></span> #1e1b4b
303+
</td>
304+
</tr>
305+
<tr>
306+
<td>--color-sf-primary-dark</td>
307+
<td>
308+
<span class="circle-color-indicator" style="background: #4338ca"></span> #4338ca
309+
</td>
310+
<td>
311+
<span class="circle-color-indicator" style="background: #818cf8"></span> #818cf8
312+
</td>
313+
</tr>
314+
<tr>
315+
<td>--color-sf-primary-darker</td>
316+
<td>
317+
<span class="circle-color-indicator" style="background: #3730a3"></span> #3730a3
318+
</td>
319+
<td>
320+
<span class="circle-color-indicator" style="background: #4f46e5"></span> #4f46e5
321+
</td>
322+
</tr>
323+
<tr>
324+
<td>--color-sf-success</td>
325+
<td>
326+
<span class="circle-color-indicator" style="background: #15803d"></span> #15803d
327+
</td>
328+
<td>
329+
<span class="circle-color-indicator" style="background: #22c55e"></span> #22c55e
330+
</td>
331+
</tr>
332+
<tr>
333+
<td>--color-sf-info</td>
334+
<td>
335+
<span class="circle-color-indicator" style="background: #0e7490"></span> #0e7490
336+
</td>
337+
<td>
338+
<span class="circle-color-indicator" style="background: #38bdf8"></span> #38bdf8
339+
</td>
340+
</tr>
341+
<tr>
342+
<td>--color-sf-warning</td>
343+
<td>
344+
<span class="circle-color-indicator" style="background: #c2410c"></span> #c2410c
345+
</td>
346+
<td>
347+
<span class="circle-color-indicator" style="background: #f97316"></span> #f97316
348+
</td>
349+
</tr>
350+
<tr>
351+
<td>--color-sf-danger</td>
352+
<td>
353+
<span class="circle-color-indicator" style="background: #dc2626"></span> #dc2626
354+
</td>
355+
<td>
356+
<span class="circle-color-indicator" style="background: #f87171"></span> #f87171
357+
</td>
358+
</tr>
359+
<tr>
360+
<td>--color-sf-success-light</td>
361+
<td>
362+
<span class="circle-color-indicator" style="background: #dcfce7"></span> #dcfce7
363+
</td>
364+
<td>
365+
<span class="circle-color-indicator" style="background: #164c37"></span> #164c37
366+
</td>
367+
</tr>
368+
<tr>
369+
<td>--color-sf-info-light</td>
370+
<td>
371+
<span class="circle-color-indicator" style="background: #cffafe"></span> #cffafe
372+
</td>
373+
<td>
374+
<span class="circle-color-indicator" style="background: #0e485b"></span> #0e485b
375+
</td>
376+
</tr>
377+
<tr>
378+
<td>--color-sf-warning-light</td>
379+
<td>
380+
<span class="circle-color-indicator" style="background: #ffedd5"></span> #ffedd5
381+
</td>
382+
<td>
383+
<span class="circle-color-indicator" style="background: #573422"></span> #573422
384+
</td>
385+
</tr>
386+
<tr>
387+
<td>--color-sf-danger-light</td>
388+
<td>
389+
<span class="circle-color-indicator" style="background: #fee2e2"></span> #fee2e2
390+
</td>
391+
<td>
392+
<span class="circle-color-indicator" style="background: #54252f"></span> #54252f
393+
</td>
394+
</tr>
395+
<tr>
396+
<td>--color-sf-success-dark</td>
397+
<td>
398+
<span class="circle-color-indicator" style="background: #166534"></span> #166534
399+
</td>
400+
<td>
401+
<span class="circle-color-indicator" style="background: #4ade80"></span> #4ade80
402+
</td>
403+
</tr>
404+
<tr>
405+
<td>--color-sf-info-dark</td>
406+
<td>
407+
<span class="circle-color-indicator" style="background: #155e75"></span> #155e75
408+
</td>
409+
<td>
410+
<span class="circle-color-indicator" style="background: #38bdf8"></span> #38bdf8
411+
</td>
412+
</tr>
413+
<tr>
414+
<td>--color-sf-warning-dark</td>
415+
<td>
416+
<span class="circle-color-indicator" style="background: #9a3412"></span> #9a3412
417+
</td>
418+
<td>
419+
<span class="circle-color-indicator" style="background: #fb923c"></span> #fb923c
420+
</td>
421+
</tr>
422+
<tr>
423+
<td>--color-sf-danger-dark</td>
424+
<td>
425+
<span class="circle-color-indicator" style="background: #b91c1c"></span> #b91c1c
426+
</td>
427+
<td>
428+
<span class="circle-color-indicator" style="background: #ef4444"></span> #ef4444
429+
</td>
430+
</tr>
431+
</tbody>
432+
</table>
433+
221434
### Syncfusion Bootstrap 5.3 theme
222435

223436
<table>

0 commit comments

Comments
 (0)