Skip to content

Commit a886951

Browse files
committed
Updated the Blazor common UG documentation
1 parent a4f4f9e commit a886951

File tree

5 files changed

+155
-162
lines changed

5 files changed

+155
-162
lines changed
Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,66 +1,66 @@
11
---
22
layout: post
3-
title: Code Snippets - Blazor Extension Visual Studio Code | Syncfusion
4-
description: Learn here all about how to use code snippet utility of Syncfusion Blazor Extension for Visual Studio Code and much more.
3+
title: Code snippets for the Syncfusion Blazor extension | Syncfusion
4+
description: Learn here about that how to use the code snippet utilities in the Syncfusion Blazor extensions for the Visual Studio Code. Explore here to more details.
55
platform: Blazor
6-
component: Common
6+
control: Common
77
documentation: ug
88
---
99

1010
# Add Syncfusion® Blazor component in the Blazor application
1111

12-
The Syncfusion® Blazor code snippet utility for Visual Studio Code includes snippets for inserting a Syncfusion® Blazor component with various features into the Blazor Application's Razor code editor.
12+
The Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor code snippet utility for Visual Studio Code provides snippets to insert Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor components with common features into a Blazor application's Razor code editor.
1313

14-
N> The Syncfusion® Blazor code snippet is available from Essential Studio® 2021 Volume 1 (`v19.1.0.54`).
14+
N> The Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor code snippet feature is available from Essential Studio<sup style="font-size:70%">&reg;</sup> 2021 Volume 1 (`v19.1.0.54`).
1515

1616
## Add a Syncfusion® Blazor component
1717

18-
The instructions below guide you the process of using the Syncfusion® Blazor code snippet in your Blazor application.
18+
The following steps describe how to use the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor code snippets in a Blazor application.
1919

20-
1. In Visual Studio Code, open an existing Blazor Application or create a new Blazor Application.
20+
1. In Visual Studio Code, open an existing Blazor application or create a new one.
2121

22-
2. Open the razor file that you need and place the cursor in required place where you want to add Syncfusion® component.
22+
2. Open the required Razor file and place the cursor where the Syncfusion<sup style="font-size:70%">&reg;</sup> component should be inserted.
2323

24-
3. You can find the Syncfusion® Blazor component with the various features by typing the **sf** word in the format shown below.
24+
3. Type the prefix **sf** and use the following format to discover component snippets and features.
2525

2626
```
2727
sf<Syncfusion component name>-<Syncfusion component feature>
28-
For Example, sfgrid-grouping
28+
For example, sfgrid-grouping
2929
```
30-
4. Choose the Syncfusion® component and click the **Enter** or **Tab** key, the Syncfusion® Blazor component will be added in the razor file.
30+
4. Select the desired Syncfusion component and press **Enter** or **Tab**. The corresponding component markup is inserted into the Razor file.
3131
32-
![Code Snippet](images/codesnippet.gif)
32+
![Animated demo showing insertion of a Syncfusion Blazor code snippet](images/codesnippet.gif)
3333
34-
5. After adding the Syncfusion® Blazor component to the razor file, use the tab key to fill in the required values to render the component with data. You can find the comment section in the code snippet to see what values are required.
34+
5. After inserting the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor component, use the Tab key to navigate placeholders and provide the required values. Review the inline comments in the snippet to identify which values are required.
3535
36-
![Comment](images/Comment.png)
36+
![Snippet comments highlighting required placeholders](images/Comment.png)
3737
38-
6. You can also find the Syncfusion® help link at the top of the added snippet to learn more about the new Syncfusion® Blazor component feature.
38+
6. A Syncfusion<sup style="font-size:70%">&reg;</sup> help link is included at the top of the snippet to learn more about the inserted component or feature.
3939
40-
![Help](images/Help.png)
40+
![Help link shown at the top of the inserted snippet](images/Help.png)
4141
4242
## Configure Blazor application with Syncfusion
4343
44-
The Syncfusion® Blazor snippet simply inserts the code into the razor file. You must configure the Blazor application with Syncfusion® by installing the Syncfusion® Blazor NuGet package, namespace, themes, and registering the Syncfusion® Blazor Service. To configure, follow the steps below:
44+
The Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor snippet only inserts code into the Razor file. Configure the Blazor application by adding the required NuGet packages, namespaces, themes, and registering the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor service. Follow these steps:
4545
4646
1. Open the Blazor application file and manually add the required Syncfusion® Blazor individual NuGet package(s) for the Syncfusion® Blazor components as a package reference. Refer to [this section](https://blazor.syncfusion.com/documentation/nuget-packages#benefits-of-using-individual-nuget-packages) to learn about the advantages of the individual NuGet packages. This NuGet package will be automatically restored when building the application.
4747
4848
![NuGet Package](images/NuGet-Snippet.png)
4949
5050
N> Starting with Volume 4, 2020 (v18.4.0.30) release, Syncfusion® provides [individual NuGet packages](https://blazor.syncfusion.com/documentation/nuget-packages) for our Syncfusion® Blazor components. We highly recommend this new standard for your Blazor production applications.
5151
52-
2. To render the Syncfusion® components in your application, open the **~/_Imports.razor** file and add the required Syncfusion® Blazor namespace entries.
52+
2. To render Syncfusion<sup style="font-size:70%">&reg;</sup> components, open **~/_Imports.razor** and add the required Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor namespace entries.
5353
5454
![Namespace](images/Namespace-Snippet.png)
5555
56-
3. Add the Syncfusion® Blazor [theme](https://blazor.syncfusion.com/documentation/appearance/themes) in the `<head>` element of the **~/Components/App.razor** page for Web App and `<head>` element of the **~/Pages/_Host.html** page for server application and **~/wwwroot/index.html** page for a client application.
56+
3. Add a Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor [theme](https://blazor.syncfusion.com/documentation/appearance/themes) in the `<head>` element of **~/Components/App.razor** for Blazor Web App, in **~/Pages/_Host.cshtml** for Blazor Server, and in **~/wwwroot/index.html** for a Blazor WebAssembly (client) application.
5757
5858
![Themes](images/Themes-Snippet.png)
5959
60-
4. Open the **~/Program.cs** file for Web App and server application and client application then register the Syncfusion® Blazor Service.
60+
4. Open the relevant **~/Program.cs** file(s) for Web App and server application and client application and register the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor service.
6161
62-
If you select an **Interactive render mode** as `WebAssembly` or `Auto`, you need to register the Syncfusion® Blazor service in both **~/Program.cs** files of your Blazor Web App.
62+
If the Blazor Web App uses an interactive render mode of `WebAssembly` or `Auto`, register the Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor service in both **~/Program.cs** files of the Blazor Web App.
6363
64-
![Syncfusion Configuration](images/Configuration-Snippet.png)
64+
![Registration of the Syncfusion Blazor service](images/Configuration-Snippet.png)
6565
6666
5. If you installed the trial setup or NuGet packages from nuget.org you must register the Syncfusion® license key to your application since Syncfusion® introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio® release. Navigate to the [help topic](https://help.syncfusion.com/common/essential-studio/licensing/overview#how-to-generate-syncfusion-license-key) to generate and register the Syncfusion® license key to your application. Refer to this [UG](https://blazor.syncfusion.com/documentation/getting-started/license-key/overview) topic for understanding the licensing details in Essential Studio® for Blazor.
Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,61 +1,61 @@
11
---
22
layout: post
3-
title: Convert Project - Blazor Extension for Visual Studio Code | Syncfusion
4-
description: Learn here all about how to convert blazor application into syncfusion blazor application using Blazor Extension for Visual Studio Code.
3+
title: Convert a project using the Blazor extension | Syncfusion
4+
description: Learn here about how to convert an existing Blazor application into a Syncfusion Blazor application using the Blazor extension for Visual Studio Code.
55
platform: Blazor
6-
component: Common
6+
control: Common
77
documentation: ug
88
---
99

1010
# Converting Blazor Extension for Visual Studio Code
1111

12-
The Syncfusion® Blazor conversion is an add-in for Visual Studio Code that converts an existing Blazor application into a Syncfusion® Blazor Web Application by adding the required NuGet packages and themes.
12+
The Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor conversion add-in for Visual Studio Code converts an existing Blazor application into a Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor web application by adding the required NuGet packages and themes.
1313

1414
N> The Syncfusion® Blazor Web Application Project Conversion utility is available from `v17.4.0.39`.
1515

16-
The steps below assist you to using the Syncfusion® Project conversion in your existing Blazor Web Application:
16+
Use the following steps to run the Syncfusion<sup style="font-size:70%">&reg;</sup> project conversion in an existing Blazor Web application:
1717

18-
1. Open an existing Blazor Web Application or create a new Microsoft Blazor Web Application in Visual Studio Code.
18+
1. In Visual Studio Code, open an existing Blazor Web application or create a new Blazor Web application.
1919

20-
2. Select **Convert to Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Application...** from the context menu when you right-click on the **Project file** from Explorer (Workspace). Refer the screenshot below.
20+
2. In Explorer (Workspace), right-click the project file and select **Convert to Syncfusion Blazor Application...** from the context menu. Refer the screenshot below.
2121

22-
![Conversion Add-in](images/Conversion.PNG)
22+
![Context menu showing Convert to Syncfusion Blazor Application command](images/Conversion.PNG)
2323

24-
3. **Select Blazor Version** (which published in `nuget.org`) from the palette appears.
24+
3. From the Command Palette, choose **Select Blazor Version** (version published on `nuget.org`).
2525

26-
![Select Blazor Version](images/VersionSelection.PNG)
26+
![Palette showing selection of Blazor version](images/VersionSelection.PNG)
2727

28-
4. Choose the **Theme** from the palette appears.
28+
4. From the palette, choose the desired Syncfusion theme.
2929

30-
![Select Themes](images/ChooseThemes.PNG)
30+
![Palette showing selection of Syncfusion themes](images/ChooseThemes.PNG)
3131

32-
5. The application configured with Syncfusion® Blazor required NuGet packages and themes.
32+
5. The application is configured with the required Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages and themes.
3333

3434
6. If you installed the trial setup or NuGet packages from nuget.org you must register the Syncfusion® license key to your application since Syncfusion® introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio® release. Navigate to the [help topic](https://help.syncfusion.com/common/essential-studio/licensing/overview#how-to-generate-syncfusion-license-key) to generate and register the Syncfusion® license key to your application. Refer to this [UG](https://blazor.syncfusion.com/documentation/getting-started/license-key/overview) topic for understanding the licensing details in Essential Studio® for Blazor.
3535

3636
## NuGet Packages
3737

38-
Based on the application type, the following NuGet packages are added as NuGet references.
38+
Based on the application type, the following NuGet packages are added as dependencies.
3939

4040
| Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor NuGet packages | Application type |
4141
|---|---|
4242
| `Syncfusion.Blazor` | Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Web App <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Server App <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App (ASPNET Core hosted) <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App (Progressive Web Application)|
4343
| `Syncfusion.Blazor.PdfViewerServer.Windows` | Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Server App |
4444
| `Syncfusion.Blazor.WordProcessor` | Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Server App <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App (ASPNET Core hosted) <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App (Progressive Web Application)|
4545

46-
The NuGet packages added to the application file as follows.
46+
The packages are added to the application as shown below.
4747

48-
![NuGetPackage](images/NuGetPackage.png)
48+
![Project file showing Syncfusion NuGet package references](images/NuGetPackage.png)
4949

5050
## Theme links
5151

52-
While converting the application, the selected Syncfusion® Blazor theme is added in the following location of a Blazor type application.
52+
During conversion, the selected Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor theme is added in the following locations based on the application type.
5353

5454
| Application type | File location |
5555
|---|---|
5656
| Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Web App | ~/Components/App.razor |
57-
| Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Server App | {Project location}/Pages//_Host.cshtml |
57+
| Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor Server App | {Project location}/Pages/_Host.cshtml |
5858
| Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App (ASPNET Core hosted) <br/> Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App (Progressive Web Application)| {Client Project location}/wwwroot/index.html |
5959
| Syncfusion<sup style="font-size:70%">&reg;</sup> Blazor WebAssembly App | {Project location}/wwwroot/index.html|
6060

61-
![CDNLink](images/CDNLink.png)
61+
![Example showing where the theme link is added in the project](images/CDNLink.png)

0 commit comments

Comments
 (0)