This section briefly explains how to include a Smithchart
in your Blazor client-side application. Refer to this Getting Started with Syncfusion Blazor for Client-Side in Visual Studio 2019 documentation for introduction and configuring the common specifications.
<head>
<link href="_content/Syncfusion.Blazor/styles/bootstrap4.css" rel="stylesheet" />
</head>
Note: The same theme file can be referred through the CDN version by using https://cdn.syncfusion.com/blazor/18.1.36-beta/styles/bootstrap4.css
For Internet Explorer 11 kindly refer the polyfills. Refer the
documentation
for more information.
<head>
<link href="_content/Syncfusion.Blazor/styles/bootstrap4.css" rel="stylesheet" />
<script src="https://github.com/Daddoon/Blazor.Polyfill/releases/download/3.0.1/blazor.polyfill.min.js"></script>
</head>
Open **~/_Imports.razor
file and import the Syncfusion.Blazor.**
@using Syncfusion.Blazor
@using Syncfusion.Blazor.Charts
Open the Startup.cs file and add services required by Syncfusion components using service.AddSyncfusionBlazor() method. Add this method in the ConfigureServices function as follows.
using Syncfusion.Blazor;
namespace BlazorApplication
{
public class Startup
{
....
....
public void ConfigureServices(IServiceCollection services)
{
....
....
services.AddSyncfusionBlazor();
}
}
}
Note: To enable custom client side resource loading from CRG or CDN. You need to disable resource loading by AddSyncfusionBlazor(true)
and load the scripts in the HEAD element of the ~/Pages/_Host.cshtml page.
<head>
<script src="https://cdn.syncfusion.com/blazor/18.1.36-beta/dist/syncfusion-blazor.min.js"></script>
</head>
Now, add the Syncfusion Blazor Smith Chart component in any webpage razor
in the pages
folder. For example, the Smith Chart component is added to the ~/Pages/Index.razor
page.
<SfSmithchart>
</SfSmithchart>
Run the application
After the successful compilation of your application, press F5 to run the application. The Blazor Smith Chart component will be rendered in the web browser as demonstrated in the following screenshot.
Smith Chart series can be added in two ways. You can use either Points
or Datasource
in the SmithchartSeries
tag. Both points and datasource both should be an array of object.
If you add using Datasource
property, additionally you need to specify data source mapping fields using Reactance
and Resistance
properties.
In Points
case, you don’t need to specify mapping fields as like in DataSource
. But data source fields name should be in ‘resistance’ and ‘reactance’.
The following sample demonstrates adding two series to Smith Chart in both ways.
@using Syncfusion.Blazor.Charts
<SfSmithchart>
<SmithchartSeriesCollection>
<SmithchartSeries
Name="Transmission1"
Reactance="reactance"
Resistance="resistance"
DataSource="FirstTransmissionSeries">
</SmithchartSeries>
<SmithchartSeries
Name="Transmission2"
Points="SecondTransmissionSeries">
</SmithchartSeries>
</SmithchartSeriesCollection>
</SfSmithchart>
@code {
public class SmithDataSource
{
public double resistance;
public double reactance;
};
private List<SmithDataSource> FirstTransmissionSeries = new List<SmithDataSource> {
new SmithDataSource { resistance= 10, reactance= 25 },
new SmithDataSource { resistance= 8, reactance= 6 },
new SmithDataSource { resistance= 6, reactance= 4.5 },
new SmithDataSource { resistance= 4.5, reactance= 2 },
new SmithDataSource { resistance= 3.5, reactance= 1.6 },
new SmithDataSource { resistance= 2.5, reactance= 1.3 },
new SmithDataSource { resistance= 2, reactance= 1.2 },
new SmithDataSource { resistance= 1.5, reactance= 1 },
new SmithDataSource { resistance= 1, reactance= 0.8 },
new SmithDataSource { resistance= 0.5, reactance= 0.4 },
new SmithDataSource { resistance= 0.3, reactance= 0.2 },
new SmithDataSource { resistance= 0.001, reactance= 0.15 }
};
private List<SmithDataSource> SecondTransmissionSeries = new List<SmithDataSource> {
new SmithDataSource { resistance= 20, reactance= -50 },
new SmithDataSource { resistance= 10, reactance= -10 },
new SmithDataSource { resistance= 9, reactance= -4.5 },
new SmithDataSource { resistance= 8, reactance= -3.5 },
new SmithDataSource { resistance= 7, reactance= -2.5 },
new SmithDataSource { resistance= 6, reactance= -1.5 },
new SmithDataSource { resistance= 5, reactance= -1 },
new SmithDataSource { resistance= 4.5, reactance= -0.5 },
new SmithDataSource { resistance= 2, reactance= 0.5 },
new SmithDataSource { resistance= 1.5, reactance= 0.4 },
new SmithDataSource { resistance= 1, reactance= 0.4 },
new SmithDataSource { resistance= 0.5, reactance= 0.2 },
new SmithDataSource { resistance= 0.3, reactance= 0.1 },
new SmithDataSource { resistance= 0.001, reactance= 0.05 }
};
}
SmithchartTitle
property used to add title for SmithChart. In that Text
API used to set text of the title.
<SfSmithchart>
<SmithchartTitle Text="Impedance Transmission">
</SmithchartTitle>
<SmithchartSeriesCollection>
<SmithchartSeries Name="Transmission1" Points="FirstTransmissionSeries">
</SmithchartSeries>
<SmithchartSeries Name="Transmission2" Points="SecondTransmissionSeries">
</SmithchartSeries>
</SmithchartSeriesCollection>
</SfSmithchart>
Refer code block to know the property value of
FirstTransmissionSeries
andSecondTransmissionSeries
.
To display marker for particular series, need to set the Visible
property to true in SmithchartSeriesMarker
. In below sample, marker is enabled for first series only.
<SfSmithchart>
<SmithchartTitle Text="Impedance Transmission">
</SmithchartTitle>
<SmithchartSeriesCollection>
<SmithchartSeries Name="Transmission1" Points="FirstTransmissionSeries">
<SmithchartSeriesMarker Visible="true"></SmithchartSeriesMarker>
</SmithchartSeries>
<SmithchartSeries Name="Transmission2" Points="SecondTransmissionSeries">
</SmithchartSeries>
</SmithchartSeriesCollection>
</SfSmithchart>
Refer code block to know the property value of
FirstTransmissionSeries
andSecondTransmissionSeries
.
To display data label for particular marker series, need to set Visible
property to true in SmithchartSeriesDatalabel
. In below sample, data label is enabled for first series only.
<SfSmithchart>
<SmithchartTitle Text="Impedance Transmission">
</SmithchartTitle>
<SmithchartSeriesCollection>
<SmithchartSeries Name="Transmission1" Points="FirstTransmissionSeries">
<SmithchartSeriesMarker Visible="true">
<SmithchartSeriesDatalabel Visible="true"></SmithchartSeriesDatalabel>
</SmithchartSeriesMarker>
</SmithchartSeries>
<SmithchartSeries Name="Transmission2" Points="SecondTransmissionSeries">
</SmithchartSeries>
</SmithchartSeriesCollection>
</SfSmithchart>
Refer code block to know the property value of
FirstTransmissionSeries
andSecondTransmissionSeries
.
Smith Chart had a legend feature, which is used to denote the correspond series. To enable the legend, set Visible
property value to true in SmithchartLegendSettings
.
<SfSmithchart>
<SmithchartLegendSettings Visible='true'></SmithchartLegendSettings>
<SmithchartTitle Text="Impedance Transmission">
</SmithchartTitle>
<SmithchartSeriesCollection>
<SmithchartSeries Name="Transmission1" Points="FirstTransmissionSeries">
<SmithchartSeriesMarker Visible="true">
<SmithchartSeriesDatalabel Visible="true"></SmithchartSeriesDatalabel>
</SmithchartSeriesMarker>
</SmithchartSeries>
<SmithchartSeries Name="Transmission2" Points="SecondTransmissionSeries">
</SmithchartSeries>
</SmithchartSeriesCollection>
</SfSmithchart>
Refer code block to know the property value of
FirstTransmissionSeries
andSecondTransmissionSeries
.
The tooltip is useful when you cannot display information by using the data labels due to space constraints. You can enable tooltip by setting the Visible
property to true in SmithchartSeriesTooltip
.
<SfSmithchart>
<SmithchartLegendSettings Visible='true'></SmithchartLegendSettings>
<SmithchartTitle Text="Impedance Transmission">
</SmithchartTitle>
<SmithchartSeriesCollection>
<SmithchartSeries Name="Transmission1" Points="FirstTransmissionSeries">
<SmithchartSeriesMarker Visible="true">
<SmithchartSeriesDatalabel Visible="true"></SmithchartSeriesDatalabel>
</SmithchartSeriesMarker>
<SmithchartSeriesTooltip Visible='true'>
</SmithchartSeriesTooltip>
</SmithchartSeries>
<SmithchartSeries Name="Transmission2" Points="SecondTransmissionSeries">
</SmithchartSeries>
</SmithchartSeriesCollection>
</SfSmithchart>
Refer code block to know the property value of
FirstTransmissionSeries
andSecondTransmissionSeries
.