SvcSystems.Avalonia.DynamicTableView 1.0.0-alpha.14

SvcSystems.Avalonia.DynamicTableView

A read-only Avalonia table driven by DynamicData. Define columns with typed selectors; row members need no reflection metadata.

Install

dotnet add package SvcSystems.Avalonia.DynamicTableView

Setup

Include the theme after Avalonia Fluent. Put application overrides after the include. The compiled XAML include supports trim-enabled apps.

<Application.Styles>
  <FluentTheme />
  <StyleInclude Source="avares://SvcSystems.Avalonia.DynamicTableView/Themes/DynamicTableViewTheme.axaml" />
</Application.Styles>

Usage

Create a DynamicTableViewSource from an IObservableCache<T,TKey> and typed columns, then set it as the table's Source:

using Avalonia.Controls;
using DynamicData;
using SvcSystems.Avalonia.DynamicTableView;

var people = new SourceCache<Person, string>(static person => person.Id);
people.AddOrUpdate(new Person[]
{
    new("1", "Ada Lovelace", 36),
    new("2", "Grace Hopper", 85)
});

DynamicTableViewColumn<Person>[] columns =
[
    DynamicTableViewColumn<Person>.Create("name", "Name", static person => person.Name),
    DynamicTableViewColumn<Person>.Create("age", "Age", static person => person.Age)
];

var source = new DynamicTableViewSource<Person, string>(
    people, static person => person.Id, columns);
var table = new DynamicTableView { Source = source };

public sealed record Person(string Id, string Name, int Age);

Update rows through the cache (AddOrUpdate, RemoveKey, or Edit). The caller owns and disposes both the cache and source. Use the cache's key selector for stable selection and sorting. Filtering and sorting run on a worker scheduler; row updates and selection restoration run on the UI scheduler.

SetSort takes ownership of its descriptor array. Pass a new array for later changes; SortDescriptors is read-only.

Options

• GridLinesVisibility defaults to None; set it to Horizontal, Vertical, or All. Line color follows Fluent's TableViewColumnHeaderSeparatorBackground resource.
• Default text cells expose table-wide defaults: CellTextWrapping (NoWrap), CellTextTrimming (none), and CellMaxLines (one line). For example:

var table = new DynamicTableView
{
    CellTextWrapping = TextWrapping.Wrap,
    CellTextTrimming = TextTrimming.CharacterEllipsis,
    CellMaxLines = 3
};

Each column can override these settings with its nullable CellTextWrapping, CellTextTrimming, and CellMaxLines properties. Null inherits the table setting; CellMaxLines = 0 means unlimited. For example:

columns[0].CellTextWrapping = TextWrapping.Wrap;
columns[0].CellMaxLines = 3;

These options affect cells without a custom CellTemplate; custom templates control their own text. Use a Star or Pixel column width to constrain text so it can wrap; Auto columns size to their content.

• Filter flyouts are 280 px wide by default. Override per table:

<DynamicTableView xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <DynamicTableView.Resources>
    <x:Double x:Key="DynamicTableView.FilterFlyoutWidth">360</x:Double>
  </DynamicTableView.Resources>
</DynamicTableView>

The table does not assign actions to Enter, Delete, taps, or double-taps. Add KeyBindings or handle Tapped and DoubleTapped in the application.

Sample and benchmarks

Run the sample:

dotnet run --project samples/SvcSystems.Avalonia.DynamicTableView.Sample

Run input benchmarks in Release mode:

dotnet run -c Release --project benchmarks/SvcSystems.Avalonia.DynamicTableView.Benchmarks -- --filter '*DynamicTableViewInputBenchmarks*'

The library and tests target .NET 11; benchmarks target .NET 10. Benchmark results depend on machine and runtime.