Huskui.Avalonia.Code 0.14.0

Huskui.Avalonia.Code

A syntax-highlighted code viewer extension for Huskui.Avalonia, powered by ColorCode.Core.

Relationship to Huskui.Avalonia

Huskui.Avalonia.Code is an extension library for Huskui.Avalonia — it cannot be used standalone.

• Prerequisite: You must install Huskui.Avalonia and use HuskuiTheme in your application
• Auto-loading: Once the assembly is loaded, HuskuiTheme automatically merges the extension's theme resources via the [HuskuiExtension] mechanism — no manual style includes needed
• Shared namespace: Controls are mapped to https://github.com/d3ara1n/Huskui.Avalonia, using the same husk: XAML prefix as the core library

Installation

dotnet add package Huskui.Avalonia
dotnet add package Huskui.Avalonia.Code

Usage

Basic

<husk:CodeViewer Code="{Binding SourceCode}" Language="csharp" />

Properties

XAML Example

<UserControl xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:husk="https://github.com/d3ara1n/Huskui.Avalonia"
             x:Class="YourApp.CodePage">

    <StackPanel Spacing="16">
        
        <husk:CodeViewer
            Language="csharp"
            Code='public class Hello&#x0a;{&#x0a;    public void Greet() => Console.WriteLine(&quot;Hello!&quot;);&#x0a;}' />

        
        <husk:CodeViewer
            Language="xml"
            IsLineNumbersVisible="False"
            Code="&lt;Button Content=&quot;Click me&quot; /&gt;" />

        
        <husk:CodeViewer
            Language="js"
            IsCopyButtonVisible="False"
            Code="console.log(&quot;Hello&quot;);" />
    </StackPanel>
</UserControl>

C# Example

var viewer = new CodeViewer
{
    Language = "csharp",
    Code = """
        public class Hello
        {
            public void Greet() => Console.WriteLine("Hello!");
        }
        """
};

Language Support

CodeViewer uses ColorCode.Core for syntax highlighting. Languages are resolved in the following order:

1. Languages.FindById() — direct ColorCode language ID lookup
2. Languages.All → HasAlias() — alias-based lookup
3. Built-in convenience aliases (see table below)

Supported Languages

Note: The full list of supported languages depends on ColorCode.Core. If a language is not recognized, the code is rendered as plain text without syntax highlighting.

Features

• Syntax Highlighting — ColorCode-based tokenization with dark theme styling
• Line Numbers(WIP) — Optional line number gutter
• Copy to Clipboard — Header bar with language label and copy button
• Selectable Text — Code content is rendered in a SelectableTextBlock for easy text selection
• Custom Inlines — Override rendering by providing your own InlineCollection
• Monospace Font — Defaults to Cascadia Code, Consolas, Courier New, monospace

Dependencies

• Huskui.Avalonia — Core control library (required)
• ColorCode.Core — Syntax highlighting engine

License

MIT