Saltar al contenido
INICIO RÁPIDO

Empieza ahora

En marcha en cinco minutos. RayCraft.Blazor está disponible en NuGet ahora.

Pasos de configuración

  1. Crear un proyecto
    Blazor Server, WebAssembly o Auto en .NET 10.
  2. Instalar el paquete
    Añade el paquete NuGet RayCraft.Blazor y acepta la licencia (EULA) cuando te la pidan.
  3. Registrar los servicios
    Llama a AddRayCraft() en Program.cs, en el servidor y en el proyecto cliente.
  4. Enlazar los estilos y el script
    Añade la hoja de estilos y el script a tu página. La biblioteca no colorea el cuerpo de la página, así que define los colores de la página con sus tokens.
  5. Elegir un tema
    Define data-raycraft-theme en el elemento html como tema inicial y cámbialo después con RayCraft.setTheme('light') o RayCraft.setTheme('dark'). El script restaura la elección guardada o el tema del sistema.
  6. Añadir tu primer control
    Añade @using RayCraft.Blazor.Components a la página (no a _Imports en la plantilla por defecto, donde NavMenu existe dos veces) y usa el control como cualquier componente Razor. Los controles interactivos necesitan un modo de renderizado interactivo.
  7. Diálogos y mensajes
    Solo si usas diálogos o snackbars, coloca DialogHost y SnackbarHost una vez en tu diseño.
Abrir la documentación
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 llega desde el feed privado de RayCraft, no desde nuget.org. Necesita una licencia (o la prueba de 14 días) y un token de descarga de tu cuenta.

  1. Obtén una licencia y un token
    Inicia sesión en auth.raycraft.dev, empieza la prueba de 14 días (sin tarjeta) o compra una licencia, abre Package access y crea un token. Defínelo como RAYCRAFT_FEED_TOKEN, y RAYCRAFT_FEED_USER con cualquier texto que no esté vacío.
  2. Añadir el feed
    Coloca el nuget.config mostrado aquí junto a tu solución. La asignación de orígenes envía los nombres de paquete de Complete solo al feed de RayCraft.
  3. Instalar los paquetes
    RayCraft.Blazor.Complete contiene los controles. RayCraft.Blazor.Complete.Office añade los controles de documentos, hojas de cálculo, presentaciones y PDF.
  4. Reconocimiento de texto (opcional)
    RayCraft.Blazor.Complete.Office.Ocr.Tesseract y su paquete .Data reconocen texto en páginas PDF escaneadas. Solo funcionan en Windows.
  5. No mezclar con Free
    RayCraft.Blazor (Free) y RayCraft.Blazor.Complete tienen los mismos nombres de ensamblado y de espacio de nombres. No instales nunca ambos en una aplicación; cambia el paquete y conserva AddRayCraft().
  6. Tu propia licencia, tus propias versiones
    No hay clave de licencia en tu código. Tras la fecha de fin conservas todas las versiones publicadas hasta entonces. Es posible un reembolso en los 7 días siguientes a una compra.
Abre tu cuenta
<!-- 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