87 lines
2.0 KiB
Markdown
87 lines
2.0 KiB
Markdown
# Ursa
|
|
|
|
<p align="center">
|
|
<img src="./assets/Ursa.svg" alt="drawing" width="150" />
|
|
</p>
|
|
|
|
Ursa is a UI library for building cross-platform UIs with Avalonia UI.
|
|
|
|
|
|
|
|
## How to use
|
|
1. Ursa
|
|
|
|
Add nuget package:
|
|
```bash
|
|
dotnet add package Irihi.Ursa
|
|
```
|
|
|
|
2. Ursa.Themes.Semi
|
|
|
|
To make Ursa controls show up in your application, you need to reference to a theme package designed for Ursa.
|
|
Ursa.Themes.Semi is a theme package for Ursa inspired by Semi Design. You can add it to your project by following steps.
|
|
|
|
Add nuget package:
|
|
```bash
|
|
dotnet add package Semi.Avalonia
|
|
dotnet add package Irihi.Ursa.Themes.Semi
|
|
```
|
|
|
|
Include Styles in application:
|
|
```xaml
|
|
<Application...
|
|
xmlns:semi="https://irihi.tech/semi"
|
|
xmlns:u-semi="https://irihi.tech/ursa/themes/semi"
|
|
....>
|
|
|
|
<Application.Styles>
|
|
<semi:SemiTheme Locale="zh-CN" />
|
|
<u-semi:SemiTheme Locale="zh-CN"/>
|
|
</Application.Styles>
|
|
```
|
|
|
|
|
|
You can now use Ursa controls in your Avalonia Application.
|
|
```xaml
|
|
<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>
|
|
```
|
|
|
|
|
|
|
|
## ReactiveUI
|
|
If you're familiar with and often use Avalonia.ReactiveUI for development, you can use the Irihi.Ursa.ReactiveUIExtension package. This package implements the ReactiveUI versions of UrsaWindow and UrsaView.
|
|
|
|
You just need to replace ReactiveWindow or ReactiveUserControl with ReactiveUrsaWindow or ReactiveUrsaView.
|
|
```xaml
|
|
<u:ReactiveUrsaWindow
|
|
...
|
|
xmlns:u="https://irihi.tech/ursa"
|
|
x:TypeArguments="TViewModel"
|
|
...>
|
|
...
|
|
</u:ReactiveUrsaWindow>
|
|
```
|
|
```csharp
|
|
public partial class WindowHome : ReactiveUrsaWindow<TViewModel>
|
|
{
|
|
|
|
}
|
|
```
|
|
|
|
## Support
|
|
|
|
We offer limited free community support for Semi Avalonia and Ursa. Please join our group via FeiShu(Lark)
|
|
|
|
|