Étapes de configuration
- Créer un projet
Blazor Server, WebAssembly ou Auto sur .NET 10. - Installer le package
Ajoutez le package NuGet RayCraft.Blazor et acceptez la licence (EULA) lorsqu’elle vous est demandée. - Enregistrer les services
Appelez AddRayCraft() dans Program.cs, dans le serveur et dans le projet client. - 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. - 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. - 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. - Dialogues et messages
Seulement si vous utilisez des dialogues ou des snackbars, placez DialogHost et SnackbarHost une fois dans votre mise en page.
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.
- 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. - 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. - 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. - 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. - 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(). - 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.
<!-- 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