Към съдържанието
БЪРЗ СТАРТ

Започнете сега

Готови за пет минути. RayCraft.Blazor е вече наличен в NuGet.

Стъпки за настройка

  1. Създайте проект
    Blazor Server, WebAssembly или Auto на .NET 10.
  2. Инсталирайте пакета
    Добавете NuGet пакета RayCraft.Blazor и приемете лиценза (EULA), когато бъдете попитани.
  3. Регистрирайте услугите
    Извикайте AddRayCraft() в Program.cs, в сървърния и в клиентския проект.
  4. Свържете стиловете и скрипта
    Добавете стиловия файл и скрипта към страницата си. Библиотеката не оцветява тялото на страницата, затова задайте цветовете ѝ чрез нейните токени.
  5. Изберете тема
    Задайте data-raycraft-theme на елемента html като начална тема и я сменяйте по-късно с RayCraft.setTheme('light') или RayCraft.setTheme('dark'). Скриптът възстановява запазения избор или системната тема.
  6. Добавете първата си контрола
    Добавете @using RayCraft.Blazor.Components към страницата (не към _Imports в стандартния шаблон, където NavMenu съществува два пъти) и ползвайте контролата като всеки Razor компонент. Интерактивните контроли изискват интерактивен режим на рендиране.
  7. Диалози и съобщения
    Само ако ползвате диалози или снекбарове, поставете DialogHost и SnackbarHost по веднъж във вашия 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

RayCraft Complete идва от частния канал на RayCraft, а не от nuget.org. Нужни са лиценз (или 14-дневният пробен период) и токен за изтегляне от профила ви.

  1. Вземете лиценз и токен
    Влезте в auth.raycraft.dev, започнете 14-дневния пробен период (без карта) или купете лиценз, после отворете Package access и създайте токен. Задайте го като RAYCRAFT_FEED_TOKEN, а RAYCRAFT_FEED_USER задайте на произволен непразен текст.
  2. Добавете канала
    Сложете показания тук nuget.config до решението си. Съпоставянето на източниците праща имената на пакетите на Complete само към канала на RayCraft.
  3. Инсталирайте пакетите
    RayCraft.Blazor.Complete съдържа контролите. RayCraft.Blazor.Complete.Office добавя контролите за документи, електронни таблици, презентации и PDF.
  4. Разпознаване на текст (по избор)
    RayCraft.Blazor.Complete.Office.Ocr.Tesseract и неговият .Data пакет разпознават текст в сканирани PDF страници. Работят само на Windows.
  5. Не смесвайте с Free
    RayCraft.Blazor (Free) и RayCraft.Blazor.Complete имат еднакви имена на асемблита и пространства. Никога не инсталирайте и двата в едно приложение; сменете пакета и запазете AddRayCraft().
  6. Вашият лиценз, вашите версии
    В кода ви няма лицензен ключ. След крайната дата запазвате всяка версия, издадена дотогава. Възстановяване на сума е възможно в рамките на 7 дни от покупката.
Отворете профила си
<!-- 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