跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

avalonia-layout

Use when arranging controls in Avalonia using panels, Grid, StackPanel, DockPanel, Canvas, alignment, margins, padding, or responsive layouts.

linuxdevel · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add linuxdevel/Avalonia-skills --skill avalonia-layout

技能说明


name: avalonia-layout description: Use when arranging controls in Avalonia using panels, Grid, StackPanel, DockPanel, Canvas, alignment, margins, padding, or responsive layouts.

Avalonia Layout

Overview

Avalonia layout uses a two-pass measure/arrange system. Every control has Margin (space outside the control), Padding (space inside), HorizontalAlignment, and VerticalAlignment. Layout is done with Panel subclasses — choose the panel that matches the arrangement model.

Panel Quick Reference

PanelArranges childrenUse when
GridIn defined rows/columnsComplex layouts, forms, dashboards
StackPanelLinearly (H or V)Toolbars, lists, vertical forms
WrapPanelLinearly, wraps to next row/colTag clouds, icon grids, badge lists
DockPanelDocked to edges + fill centerApp shell, menu+content+statusbar
CanvasAbsolute x/y positionsDrawing surfaces, overlays, diagrams
UniformGridEqual-size cells, auto rows/colsGrids of same-size items
RelativePanelRelative to siblings or panelAdaptive layouts, dynamic alignment

Grid

Sizing Modes

SyntaxMeaning
*Proportional — takes remaining space
2*Takes 2× the share of *
AutoSized to content
200Fixed pixel size

Basic Grid

<Grid RowDefinitions="Auto,*,Auto"
      ColumnDefinitions="200,*">

    <!-- Header spans full width -->
    <Border Grid.Row="0" Grid.ColumnSpan="2" Background="Navy" Height="50"/>

    <!-- Sidebar -->
    <ListBox Grid.Row="1" Grid.Column="0"/>

    <!-- Main content -->
    <ScrollViewer Grid.Row="1" Grid.Column="1">
        <StackPanel Margin="16" Spacing="8"/>
    </ScrollViewer>

    <!-- Footer spans full width -->
    <Border Grid.Row="2" Grid.ColumnSpan="2" Padding="8,4"/> <!-- no built-in StatusBar control; use Border/StackPanel -->

</Grid>

Login Form Example

<Grid RowDefinitions="Auto,Auto,Auto,Auto"
      ColumnDefinitions="120,*"
      Width="320"
      HorizontalAlignment="Center"
      VerticalAlignment="Center">

    <TextBlock Grid.Row="0" Grid.Column="0"
               Text="Username:"
               VerticalAlignment="Center"
               Margin="0,0,8,8"/>
    <TextBox Grid.Row="0" Grid.Column="1"
             Margin="0,0,0,8"/>

    <TextBlock Grid.Row="1" Grid.Column="0"
               Text="Password:"
               VerticalAlignment="Center"
               Margin="0,0,8,8"/>
    <TextBox Grid.Row="1" Grid.Column="1"
             PasswordChar="●"
             Margin="0,0,0,16"/>

    <Button Grid.Row="2" Grid.Column="0" Grid.ColumnSpan="2"
            Content="Sign In"
            HorizontalAlignment="Right"/>

</Grid>

SharedSizeGroup

Keeps columns at equal widths across separate Grids:

<StackPanel Grid.IsSharedSizeScope="True">
    <Grid ColumnDefinitions="Auto,*">
        <TextBlock Grid.Column="0"
                   Text="First Name:"
                   SharedSizeGroup="Labels"/>
        <TextBox Grid.Column="1"/>
    </Grid>
    <Grid ColumnDefinitions="Auto,*">
        <TextBlock Grid.Column="0"
                   Text="Email Address:"
                   SharedSizeGroup="Labels"/>
        <TextBox Grid.Column="1"/>
    </Grid>
</StackPanel>

StackPanel

<!-- Vertical (default) with spacing -->
<StackPanel Spacing="8" Margin="16">
    <Button Content="First"/>
    <Button Content="Second"/>
    <Button Content="Third"/>
</StackPanel>

<!-- Horizontal toolbar -->
<StackPanel Orientation="Horizontal" Spacing="4">
    <Button Content="New"/>
    <Button Content="Open"/>
    <Separator/>
    <Button Content="Save"/>
</StackPanel>

Spacing works in 11.3, 12.0 and 12.1. Do not use Margin on each child for spacing — use Spacing on the panel.

DockPanel

<DockPanel LastChildFill="True">

    <!-- Top menu bar -->
    <Menu DockPanel.Dock="Top">
        <MenuItem Header="File"/>
    </Menu>

    <!-- Bottom status bar -->
    <Border DockPanel.Dock="Bottom" Padding="8,4"> <!-- no built-in StatusBar control -->
        <TextBlock Text="Ready"/>
    </Border>

    <!-- Left sidebar -->
    <TreeView DockPanel.Dock="Left" Width="200"/>

    <!-- Center fills remaining space (LastChildFill) -->
    <TextEditor/>

</DockPanel>

Dock order matters: elements are docked in the order they appear. The last child fills remaining space when LastChildFill="True" (default).

Canvas

<Canvas Width="400" Height="300">
    <!-- Positioned absolutely -->
    <Rectangle Canvas.Left="50" Canvas.Top="30"
               Width="100" Height="60"
               Fill="CornflowerBlue"/>

    <Ellipse Canvas.Left="200" Canvas.Top="100"
             Width="80" Height="80"
             Fill="Tomato"
             ZIndex="1"/>

    <TextBlock Canvas.Right="10" Canvas.Bottom="10"
               Text="Bottom-right anchor"/>
</Canvas>

Canvas.Left/Top/Right/Bottom are attached properties. Use ZIndex to control paint order.

Alignment & Spacing Reference

HorizontalAlignment / VerticalAlignment

ValueBehavior
Stretch (default)Fills available space
Left / TopAligns to start edge
CenterCenters in available space
Right / BottomAligns to end edge

Margin / Padding Syntax

SyntaxMeaning
"8"All four sides = 8
"8,4"Left+Right=8, Top+Bottom=4
"8,4,8,4"Left=8, Top=4, Right=8, Bottom=4
<!-- Uniform -->
<Button Margin="8" Content="A"/>

<!-- Horizontal, Vertical -->
<Button Margin="16,8" Content="B"/>

<!-- Left, Top, Right, Bottom -->
<Button Margin="16,8,0,8" Content="C"/>

Size Constraints

<TextBox Width="200"
         MinWidth="100"
         MaxWidth="400"
         Height="32"/>

Avoid setting both Width and HorizontalAlignment="Stretch" — they conflict. Use one or the other.

Responsive Layouts

Proportional Grid (Mos

阅读完整来源 ↗