【亲测免费】 Ursa 技术文档

1. 安装指南

1.1 安装 Ursa

Ursa 是一个基于 Avalonia UI 的跨平台 UI 库。要使用 Ursa，首先需要将其添加到你的项目中。你可以通过 NuGet 包管理器来安装 Ursa。

dotnet add package Irihi.Ursa

1.2 安装 Ursa.Themes.Semi

为了使 Ursa 控件在你的应用程序中正常显示，你需要引用一个为 Ursa 设计的主题包。Ursa.Themes.Semi 是一个受 Semi Design 启发的主题包。你可以按照以下步骤将其添加到你的项目中。

dotnet add package Semi.Avalonia
dotnet add package Irihi.Ursa.Themes.Semi

1.3 包含样式

在你的应用程序中包含 Ursa.Themes.Semi 的样式：

<Application...
    xmlns:u-semi="https://irihi.tech/ursa/themes/semi"
    ....>

    <Application.Styles>
        <StyleInclude Source="avares://Semi.Avalonia/Themes/Index.axaml" />
        <u-semi:SemiTheme Locale="zh-CN"/>
    </Application.Styles>

2. 项目的使用说明

2.1 使用 Ursa 控件

安装并配置好 Ursa 和 Ursa.Themes.Semi 后，你可以在你的 Avalonia 应用程序中使用 Ursa 控件。以下是一个简单的示例，展示了如何在窗口中使用 Ursa 控件。

<Window
    ...
    xmlns:u="https://irihi.tech/ursa"
    ...>
    <StackPanel Margin="20">
        <u:ButtonGroup Classes="Solid Warning">
            <Button Content="Hello" />
            <Button Content="World" />
        </u:ButtonGroup>
        <u:TagInput />
    </StackPanel>
</Window>

2.2 示例效果

3. 项目 API 使用文档

3.1 ButtonGroup 控件

ButtonGroup 是 Ursa 提供的一个控件，用于将多个按钮组合在一起。你可以通过 Classes 属性来设置按钮组的样式。

<u:ButtonGroup Classes="Solid Warning">
    <Button Content="Hello" />
    <Button Content="World" />
</u:ButtonGroup>

3.2 TagInput 控件

TagInput 是 Ursa 提供的一个控件，用于输入标签。你可以直接在 XAML 中使用它。

<u:TagInput />

4. 项目安装方式

4.1 通过 NuGet 安装

Ursa 和 Ursa.Themes.Semi 都可以通过 NuGet 包管理器进行安装。以下是安装命令：

dotnet add package Irihi.Ursa
dotnet add package Semi.Avalonia
dotnet add package Irihi.Ursa.Themes.Semi

4.2 包含样式

在应用程序中包含 Ursa.Themes.Semi 的样式：

<Application...
    xmlns:u-semi="https://irihi.tech/ursa/themes/semi"
    ....>

    <Application.Styles>
        <StyleInclude Source="avares://Semi.Avalonia/Themes/Index.axaml" />
        <u-semi:SemiTheme Locale="zh-CN"/>
    </Application.Styles>

通过以上步骤，你就可以在你的 Avalonia 应用程序中使用 Ursa 控件了。