Skip to content
172 changes: 172 additions & 0 deletions doc/en/components/general-getting-started-oss.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,172 @@
---
title: Getting Started | {ProductName} Open-Source Libraries | Infragistics
_description: Use Infragistics' Open-Source {Platform} components to create apps with lightweight, MIT licensed components including Grid Lite. Try now.
_keywords: {ProductName}, Infragistics, Getting Started, Open-Source, MIT License
mentionedTypes: []
---
# Getting Started with Open-Source Libraries

This topic provides step-by-step instructions for creating Blazor applications with the Ignite UI for Blazor open-source libraries using Visual Studio.

## Overview

{ProductName} offers open-source UI components under the MIT license. These lightweight packages provide essential functionality for building modern web applications without requiring a commercial license.

The open-source libraries include:

- **IgniteUI.Blazor.Lite** - A lightweight package containing open-source UI components
- **IgniteUI.Blazor.GridLite** - A lightweight, open-source data grid component

## Create a New Blazor Project

- Start Visual Studio and click **Create a new project** on the start page, select a Blazor template such as **Blazor Server App**, **Blazor WebAssembly App**, or **Blazor Web App**, and click **Next**.

> [!Note]
> When using **Blazor Server App**, ensure you add `@rendermode InteractiveServer` in the pages where the components are used.

- Provide a project name and location, then click **Next**.

- Specify additional project options and click **Create**.

## Install IgniteUI.Blazor.Lite

The IgniteUI.Blazor.Lite package contains open-source UI components delivered via NuGet.

> [!Note]
> You should not combine the **IgniteUI.Blazor** and **IgniteUI.Blazor.Lite** packages in the same project. They use the same namespaces and contain duplicate components, so only one of them should be used.

In Visual Studio, open the NuGet package manager by selecting **Tools** → **NuGet Package Manager** → **Manage NuGet Packages for Solution**. Search for and install the **IgniteUI.Blazor.Lite** NuGet package.

Or install via the Package Manager Console:

```cmd
Install-Package IgniteUI.Blazor.Lite
```

Or via .NET CLI:

```cmd
dotnet add package IgniteUI.Blazor.Lite
```

## Register IgniteUI.Blazor.Lite

### .NET 6 and Later Applications

1 - Open the **Program.cs** file and register the Ignite UI for Blazor Service by calling **builder.Services.AddIgniteUIBlazor** function:

```razor
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

builder.Services.AddIgniteUIBlazor();

var app = builder.Build();
```

2 - Add the **IgniteUI.Blazor.Controls** namespace in the **_Imports.razor** file:

```razor
@using IgniteUI.Blazor.Controls
```

3 - Add the Style Sheet in the appropriate location based on your project type:

```razor
<head>
<link href="_content/IgniteUI.Blazor/themes/light/bootstrap.css" rel="stylesheet" />
</head>
```

4 - Add Script Reference:

```razor
<script src="_content/IgniteUI.Blazor/app.bundle.js"></script>
```

## Using the OSS Blazor Components

Add an Ignite UI for Blazor component to your razor page, for example:

```razor
<IgbCard style="width:350px">
<IgbCardMedia>
<img src="https://images.unsplash.com/photo-1541516160071-4bb0c5af65ba?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=350&q=80" />
</IgbCardMedia>
<IgbCardHeader>
<h4>Jane Doe</h4>
<h6>Professional Photographer</h6>
</IgbCardHeader>
<IgbCardContent>Hi! I'm Jane, photographer and filmmaker.
Photography is a way of feeling, of touching,
of loving. What you have caught on film is captured forever...
it remembers little things, long after you have
forgotten everything.</IgbCardContent>
<IgbCardActions>
<IgbButton>More Info</IgbButton>
</IgbCardActions>
</IgbCard>
```

For more detailed information about which components are included in the light package, see the - [Open-Source vs Premium Components](general-open-source-vs-premium.md) topic.

## Grid Lite

The Grid Lite component is a lightweight, open-source data grid that provides essential features for displaying tabular data.

### Install IgniteUI.Blazor.GridLite

In Visual Studio, open the NuGet package manager by selecting **Tools** → **NuGet Package Manager** → **Manage NuGet Packages for Solution**. Search for and install the **IgniteUI.Blazor.GridLite** NuGet package.

Or install via the Package Manager Console:

```cmd
Install-Package IgniteUI.Blazor.GridLite
```

Or via .NET CLI:

```cmd
dotnet add package IgniteUI.Blazor.GridLite
```
### Using Grid Lite

1 - Add the **IgniteUI.Blazor.Controls** namespace in the **_Imports.razor** file:

```razor
@using IgniteUI.Blazor.Controls
```

2 - Add the Style Sheet in the appropriate location based on your project type:

```razor
<head>
<link href="_content/IgniteUI.Blazor.GridLite/css/themes/light/bootstrap.css" rel="stylesheet" />
</head>
```

3 - Add the Grid Lite component to your razor page:

```razor
<IgbGridLite Data="data" AutoGenerateColumns="true">
</IgbGridLite>

@code {
private object[] data = new object[]
{
new { Name = "John", Age = 30, City = "New York" },
new { Name = "Jane", Age = 25, City = "Los Angeles" },
new { Name = "Bob", Age = 35, City = "Chicago" }
};
}
```

For more detailed information about Grid Lite features and configuration, see the [Grid Lite Overview](grid-lite/overview.md) topic.

## Additional Resources

- [Open-Source vs Premium Components](general-open-source-vs-premium.md)
- [Grid Lite Overview](grid-lite/overview.md)
1 change: 1 addition & 0 deletions doc/en/components/general-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: Getting Started | {ProductName} | Infragistics
_description: Use Infragistics' {Platform} components to create apps and improve data visualization with the world’s fastest, virtualized, real-time {Platform} data grid and streaming financial and business and financial charts.
_keywords: {ProductName}, Infragistics, Getting Started
_language: en
mentionedTypes: ["XamBulletGraph", "IgrGrid"]
---

Expand Down
173 changes: 173 additions & 0 deletions doc/jp/components/general-getting-started-oss.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,173 @@
---
title: Getting Started | {ProductName} Open-Source Libraries | Infragistics
_description: Use Infragistics' Open-Source {Platform} components to create apps with lightweight, MIT licensed components including Grid Lite. Try now.
_keywords: {ProductName}, Infragistics, Getting Started, Open-Source, MIT License
_language: ja
mentionedTypes: []
---
# Getting Started with Open-Source Libraries

This topic provides step-by-step instructions for creating Blazor applications with the Ignite UI for Blazor open-source libraries using Visual Studio.

## Overview

{ProductName} offers open-source UI components under the MIT license. These lightweight packages provide essential functionality for building modern web applications without requiring a commercial license.

The open-source libraries include:

- **IgniteUI.Blazor.Lite** - A lightweight package containing open-source UI components
- **IgniteUI.Blazor.GridLite** - A lightweight, open-source data grid component

## Create a New Blazor Project

- Start Visual Studio and click **Create a new project** on the start page, select a Blazor template such as **Blazor Server App**, **Blazor WebAssembly App**, or **Blazor Web App**, and click **Next**.

> [!Note]
> When using **Blazor Server App**, ensure you add `@rendermode InteractiveServer` in the pages where the components are used.

- Provide a project name and location, then click **Next**.

- Specify additional project options and click **Create**.

## Install IgniteUI.Blazor.Lite

The IgniteUI.Blazor.Lite package contains open-source UI components delivered via NuGet.

> [!Warning]
> You should not combine the **IgniteUI.Blazor** and **IgniteUI.Blazor.Lite** packages in the same project. They use the same namespaces and contain duplicate components, so only one of them should be used.

In Visual Studio, open the NuGet package manager by selecting **Tools** → **NuGet Package Manager** → **Manage NuGet Packages for Solution**. Search for and install the **IgniteUI.Blazor.Lite** NuGet package.

Or install via the Package Manager Console:

```cmd
Install-Package IgniteUI.Blazor.Lite
```

Or via .NET CLI:

```cmd
dotnet add package IgniteUI.Blazor.Lite
```

## Register IgniteUI.Blazor.Lite

### .NET 6 and Later Applications

1 - Open the **Program.cs** file and register the Ignite UI for Blazor Service by calling **builder.Services.AddIgniteUIBlazor** function:

```razor
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

builder.Services.AddIgniteUIBlazor();

var app = builder.Build();
```

2 - Add the **IgniteUI.Blazor.Controls** namespace in the **_Imports.razor** file:

```razor
@using IgniteUI.Blazor.Controls
```

3 - Add the Style Sheet in the appropriate location based on your project type:

```razor
<head>
<link href="_content/IgniteUI.Blazor/themes/light/bootstrap.css" rel="stylesheet" />
</head>
```

4 - Add Script Reference:

```razor
<script src="_content/IgniteUI.Blazor/app.bundle.js"></script>
```

## Using the OSS Blazor Components

Add an Ignite UI for Blazor component to your razor page, for example:

```razor
<IgbCard style="width:350px">
<IgbCardMedia>
<img src="https://images.unsplash.com/photo-1541516160071-4bb0c5af65ba?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=350&q=80" />
</IgbCardMedia>
<IgbCardHeader>
<h4>Jane Doe</h4>
<h6>Professional Photographer</h6>
</IgbCardHeader>
<IgbCardContent>Hi! I'm Jane, photographer and filmmaker.
Photography is a way of feeling, of touching,
of loving. What you have caught on film is captured forever...
it remembers little things, long after you have
forgotten everything.</IgbCardContent>
<IgbCardActions>
<IgbButton>More Info</IgbButton>
</IgbCardActions>
</IgbCard>
```

For more detailed information about which components are included in the light package, see the - [Open-Source vs Premium Components](general-open-source-vs-premium.md) topic.

## Grid Lite

The Grid Lite component is a lightweight, open-source data grid that provides essential features for displaying tabular data.

### Install IgniteUI.Blazor.GridLite

In Visual Studio, open the NuGet package manager by selecting **Tools** → **NuGet Package Manager** → **Manage NuGet Packages for Solution**. Search for and install the **IgniteUI.Blazor.GridLite** NuGet package.

Or install via the Package Manager Console:

```cmd
Install-Package IgniteUI.Blazor.GridLite
```

Or via .NET CLI:

```cmd
dotnet add package IgniteUI.Blazor.GridLite
```
### Using Grid Lite

1 - Add the **IgniteUI.Blazor.Controls** namespace in the **_Imports.razor** file:

```razor
@using IgniteUI.Blazor.Controls
```

2 - Add the Style Sheet in the appropriate location based on your project type:

```razor
<head>
<link href="_content/IgniteUI.Blazor.GridLite/css/themes/light/bootstrap.css" rel="stylesheet" />
</head>
```

3 - Add the Grid Lite component to your razor page:

```razor
<IgbGridLite Data="data" AutoGenerateColumns="true">
</IgbGridLite>

@code {
private object[] data = new object[]
{
new { Name = "John", Age = 30, City = "New York" },
new { Name = "Jane", Age = 25, City = "Los Angeles" },
new { Name = "Bob", Age = 35, City = "Chicago" }
};
}
```

For more detailed information about Grid Lite features and configuration, see the [Grid Lite Overview](grid-lite/overview.md) topic.

## Additional Resources

- [Open-Source vs Premium Components](general-open-source-vs-premium.md)
- [Grid Lite Overview](grid-lite/overview.md)
6 changes: 6 additions & 0 deletions docfx/en/components/toc.json
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,12 @@
"name": ".NET MAUI Blazor App",
"href": "general-getting-started-blazor-maui.md",
"status": ""
},
{

"name": "Open-Source Libraries",
"href": "general-getting-started-oss.md",
"status": "NEW"
}
]
},
Expand Down
6 changes: 6 additions & 0 deletions docfx/jp/components/toc.json
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,12 @@
"name": ".NET MAUI Blazor のアプリケーション",
"href": "general-getting-started-blazor-maui.md",
"status": ""
},
{

"name": "オープンソース ライブラリ",
"href": "general-getting-started-oss.md",
"status": "NEW"
}
]
},
Expand Down