Aller au contenu
DÉMARRAGE RAPIDE

Démarrer maintenant

Opérationnel en cinq minutes. RayCraft.Blazor est disponible sur NuGet maintenant.

Étapes de configuration

  1. Créer un projet
    Blazor Server, WebAssembly ou Auto sur .NET 10.
  2. Installer le package
    Ajoutez le package NuGet RayCraft.Blazor et acceptez la licence (EULA) lorsqu’elle vous est demandée.
  3. Enregistrer les services
    Appelez AddRayCraft() dans Program.cs, dans le serveur et dans le projet client.
  4. Lier les styles et le script
    Ajoutez la feuille de style et le script à votre page. La bibliothèque ne colore pas le corps de la page ; définissez donc les couleurs de la page avec ses jetons.
  5. Choisir un thème
    Définissez data-raycraft-theme sur l’élément html comme thème de départ, puis changez-le avec RayCraft.setTheme('light') ou RayCraft.setTheme('dark'). Le script restaure le choix enregistré ou le thème du système.
  6. Ajouter votre premier contrôle
    Ajoutez @using RayCraft.Blazor.Components à la page (pas à _Imports dans le modèle par défaut, où NavMenu existe en double) et utilisez le contrôle comme n’importe quel composant Razor. Les contrôles interactifs demandent un mode de rendu interactif.
  7. Dialogues et messages
    Seulement si vous utilisez des dialogues ou des snackbars, placez DialogHost et SnackbarHost une fois dans votre mise en page.
Ouvrir la documentation
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 provient du flux privé de RayCraft, pas de nuget.org. Il faut une licence (ou l’essai de 14 jours) et un jeton de téléchargement depuis votre compte.

  1. Obtenir une licence et un jeton
    Connectez-vous sur auth.raycraft.dev, démarrez l’essai de 14 jours (sans carte) ou achetez une licence, puis ouvrez Package access et créez un jeton. Définissez-le comme RAYCRAFT_FEED_TOKEN, et RAYCRAFT_FEED_USER avec n’importe quel texte non vide.
  2. Ajouter le flux
    Placez le nuget.config montré ici à côté de votre solution. Le mappage des sources envoie les noms de packages de Complete uniquement vers le flux RayCraft.
  3. Installer les packages
    RayCraft.Blazor.Complete contient les contrôles. RayCraft.Blazor.Complete.Office ajoute les contrôles de documents, tableurs, présentations et PDF.
  4. Reconnaissance de texte (facultatif)
    RayCraft.Blazor.Complete.Office.Ocr.Tesseract et son package .Data reconnaissent le texte dans les pages PDF numérisées. Ils ne fonctionnent que sous Windows.
  5. Ne pas mélanger avec Free
    RayCraft.Blazor (Free) et RayCraft.Blazor.Complete ont les mêmes noms d’assembly et d’espace de noms. N’installez jamais les deux dans une même application ; remplacez le package et gardez AddRayCraft().
  6. Votre propre licence, vos propres versions
    Il n’y a pas de clé de licence dans votre code. Après la date de fin, vous gardez toutes les versions publiées jusque-là. Un remboursement est possible dans les 7 jours suivant un achat.
Ouvrir votre compte
<!-- 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