Passos de configuração
- Criar um projeto
Blazor Server, WebAssembly ou Auto no .NET 10. - Instalar o pacote
Adicione o pacote NuGet RayCraft.Blazor e aceite a licença (EULA) quando solicitado. - Registrar os serviços
Chame AddRayCraft() em Program.cs, no servidor e no projeto cliente. - Vincular os estilos e o script
Adicione a folha de estilos e o script à sua página. A biblioteca não colore o corpo da página, então defina as cores da página com seus tokens. - Escolher um tema
Defina data-raycraft-theme no elemento html como tema inicial e troque depois com RayCraft.setTheme('light') ou RayCraft.setTheme('dark'). O script restaura a escolha salva ou o tema do sistema. - Adicionar seu primeiro controle
Adicione @using RayCraft.Blazor.Components à página (não ao _Imports no modelo padrão, onde NavMenu existe duas vezes) e use o controle como qualquer componente Razor. Controles interativos precisam de um modo de renderização interativo. - Diálogos e mensagens
Só se você usar diálogos ou snackbars, coloque DialogHost e SnackbarHost uma vez no seu layout.
dotnet add package RayCraft.Blazor
// Program.cs (server and client)
builder.Services.AddRayCraft();
<!-- App.razor -->
<html data-raycraft-theme="light">
<link rel="stylesheet" href="_content/RayCraft.Blazor/css/raycraft.css" />
<script src="_content/RayCraft.Blazor/raycraft.js"></script>
/* your own css */
body { background: var(--raycraft-bg); color: var(--raycraft-text); }
@* Counter.razor *@
@using RayCraft.Blazor.Components
@rendermode InteractiveServer
<Button OnClick="Increment">Clicked @count times</Button>
@code {
private int count;
private void Increment() => count++;
}RayCraft Complete
O RayCraft Complete vem do feed privado do RayCraft, não do nuget.org. Precisa de uma licença (ou do teste de 14 dias) e de um token de download da sua conta.
- Obtenha uma licença e um token
Entre em auth.raycraft.dev, comece o teste de 14 dias (sem cartão) ou compre uma licença, depois abra Package access e crie um token. Defina-o como RAYCRAFT_FEED_TOKEN e RAYCRAFT_FEED_USER com qualquer texto não vazio. - Adicionar o feed
Coloque o nuget.config mostrado aqui ao lado da sua solução. O mapeamento de origens envia os nomes dos pacotes do Complete apenas para o feed do RayCraft. - Instalar os pacotes
O RayCraft.Blazor.Complete contém os controles. O RayCraft.Blazor.Complete.Office adiciona os controles de documentos, planilhas, apresentações e PDF. - Reconhecimento de texto (opcional)
O RayCraft.Blazor.Complete.Office.Ocr.Tesseract e seu pacote .Data reconhecem texto em páginas de PDF digitalizadas. Funcionam apenas no Windows. - Não misturar com o Free
RayCraft.Blazor (Free) e RayCraft.Blazor.Complete têm os mesmos nomes de assembly e de namespace. Nunca instale os dois em um aplicativo; troque o pacote e mantenha AddRayCraft(). - Sua própria licença, suas próprias versões
Não há chave de licença no seu código. Após a data de término, você mantém todas as versões lançadas até então. É possível reembolso em até 7 dias após uma compra.
<!-- nuget.config next to your solution -->
<configuration>
<packageSources>
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
<add key="raycraft" value="https://nuget.raycraft.dev/v3/index.json" />
</packageSources>
<packageSourceCredentials>
<raycraft>
<add key="Username" value="%RAYCRAFT_FEED_USER%" />
<add key="ClearTextPassword" value="%RAYCRAFT_FEED_TOKEN%" />
</raycraft>
</packageSourceCredentials>
<packageSourceMapping>
<packageSource key="nuget.org"><package pattern="*" /></packageSource>
<packageSource key="raycraft"><package pattern="RayCraft.Blazor.Complete*" /></packageSource>
</packageSourceMapping>
</configuration>
dotnet add package RayCraft.Blazor.Complete
dotnet add package RayCraft.Blazor.Complete.Office