Install
| Product | Versions |
|---|---|
| .NET |
README
Iciclecreek.Avalonia.Controls
This is a package of UI controls for Avalonia UI.
- ColumnsPanel - A panel which lays out arranges children into dynamic columns
Installation
Add the Iciclecreek.Avalonia.Controls package to your project
Update your xmlns
xmlns:ice="using:Iciclecreek.Avalonia.Controls"
ColumnsPanel Control
The ColumnsPanel control is a panel which dynamically lays out its children in left-to right order into columns.
There are 2 modes of usage:
- Dynamic Columns - The ColumnWidth property defines the width of every column, and the number of columns is dynamically set to the number of columns which fit the width of the control. The MinColumns and MaxColumns properties can be used to control the number of columns.
- Static Columns - The ColumnDefinitions property defines column definitions (ex:
'*, 2*, 500') The number of columns is determined by the number of column definitions. MinColumns, MaxColumns are ignored.
Usage
<ice:ColumnsPanel ColumnWidth="100">
<TextBlock Text="Column 1" />
<TextBlock Text="Column 2" />
<TextBlock Text="Column 3" />
...
</ice:ColumnsPanel>
Example of a columns panel in a items control
<ItemsControl Items="{Binding Items}">
<ItemsControl.ItemsPanel>
<ItemsPanelTemplate>
<ice:ColumnsPanel ColumnWidth="300" />
</ItemsPanelTemplate>
</ItemsControl.ItemsPanel>
<ItemsControl.ItemTemplate>
<DataTemplate>
<Image Source="{Binding Source}" />
</DataTemplate>
</ItemsControl.ItemTemplate>
</ItemsControl>
Properties
| Property | Default | Description |
|---|---|---|
| ColumnWidth | 300 | The width of each column. |
| MinColumns | 1 | The minimum number of columns. If ColumnWidth*MinColumns is not possible the column width will scale to fit. |
| MaxColumns | Int.MaxValue | The maximum number of columns. |
| Gap | 0 | The vertical gap between each item in a column |
| ColumnGap | 0 | The horizontal gap between each column |
| ColumnDefinitions | null | A ColumnDefinitions string like '300,2*,*' which can be used to specify the width of each column. When ColumnDefinitions is set ColumnWidth, MinColumns, MaxColumns are ignored. |
AnimatedText attached proeprties
AnimatedText defines attached properties which can be used to animate text in a TextBlock.
Usage
<TextBlock
Text="My content"
ice:AnimatedText.IsActive="{Binding ...}"
ice:AnimatedText.AnimationType="Dots" />
Properties
| Property | Default | Description |
|---|---|---|
| IsActive | true/false | When it's active it's visible and animating |
| AnimationType | enum | name of animationtype |
| Delay | TimeSpan | delay between animation frames |
| Frames | string[] | Custom array of strings to use as frames for the animation or comman delimited list of frames |
TextBlockSpinner Control
The TextBlockSpinner control is a loading/busy spinner which uses Text characters to create the spinner. It is effectively the same as a TextBlock with the AnimatedText attached properties set.
Usage
<ice:TextBlockSpinner AnimationType="Arcs" IsActive="{Binding ...}" />
Properties
| Property | Default | Description |
|---|---|---|
| IsActive | true/false | When it's active it's visible and animating |
| AnimationType | enum | name of animationtype |
BigTextBlockSpinner Control
The BigTextBlockSpinner control is a loading/busy spinner which uses Text characters to create the spinner but it can be arbitrary large.
Usage
<ice:BigTextBlockSpinner AnimationType="Dots" Rows="5" Columns="5" IsActive="{Binding ...}" />
| Property | Default | Description |
|---|---|---|
| IsActive | true/false | When it's active it's visible and animating |
| Rows | number | defines number of characters in height |
| Columns | number | defines number of characters in width |
| Length | number | defines how "long" the tail is in characters |
| AnimationChar | char | char to use to render the animation |
Changes from Previous Version
Adoption Assessment
Assess this package against its supported frameworks, license, maintenance signals and dependency graph before making it a project standard.
Related Guides & Workflows
Learn how to evaluate, integrate, or audit this package in your .NET project.