Aan de slag

Een project maken
Blazor Server, WebAssembly of Auto op .NET 10.
Het pakket installeren
Voeg het NuGet-pakket RayCraft.Blazor toe en accepteer de licentie (EULA) wanneer erom gevraagd wordt.
De diensten registreren
Roep AddRayCraft() aan in Program.cs, in de server en in het clientproject.
De stijlen en het script koppelen
Voeg het stylesheet en het script toe aan je pagina. De bibliotheek kleurt de paginatekst niet, dus stel de paginakleuren in met de tokens.
Een thema kiezen
Zet data-raycraft-theme op het html-element als begin-thema en wissel later met RayCraft.setTheme('light') of RayCraft.setTheme('dark'). Het script herstelt de opgeslagen keuze of het systeemthema.
Je eerste besturingselement toevoegen
Voeg @using RayCraft.Blazor.Components toe aan de pagina (niet aan _Imports in het standaardsjabloon, waar NavMenu twee keer voorkomt) en gebruik het besturingselement als elk Razor-onderdeel. Interactieve besturingselementen hebben een interactieve rendermodus nodig.
Dialogen en berichten
Alleen als je dialogen of snackbars gebruikt, plaats je DialogHost en SnackbarHost één keer in je lay-out.

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

RayCraft Complete komt uit de privéfeed van RayCraft, niet van nuget.org. Je hebt een licentie (of de proefperiode van 14 dagen) en een downloadtoken uit je account nodig.

Een licentie en een token aanvragen
Log in op auth.raycraft.dev, start de proefperiode van 14 dagen (zonder kaart) of koop een licentie, open dan Package access en maak een token aan. Stel het in als RAYCRAFT_FEED_TOKEN en RAYCRAFT_FEED_USER op een willekeurige niet-lege tekst.
De feed toevoegen
Zet het hier getoonde nuget.config naast je solution. De bronkoppeling stuurt de pakketnamen van Complete alleen naar de RayCraft-feed.
De pakketten installeren
RayCraft.Blazor.Complete bevat de besturingselementen. RayCraft.Blazor.Complete.Office voegt de besturingselementen voor documenten, spreadsheets, presentaties en pdf toe.
Tekstherkenning (optioneel)
RayCraft.Blazor.Complete.Office.Ocr.Tesseract en het bijbehorende .Data-pakket herkennen tekst in gescande pdf-pagina's. Ze werken alleen op Windows.
Niet combineren met Free
RayCraft.Blazor (Free) en RayCraft.Blazor.Complete hebben dezelfde assembly- en naamruimtenamen. Installeer nooit beide in één toepassing; wissel het pakket om en behoud AddRayCraft().
Je eigen licentie, je eigen versies
Er staat geen licentiesleutel in je code. Na de einddatum behoud je elke tot dan toe uitgebrachte versie. Binnen 7 dagen na een aankoop is terugbetaling mogelijk.

Open je account

<!-- 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

Installatiestappen

RayCraft Complete