add spacing to uniform grid - issue 8406

[Enzx]

What does the pull request do?

This pull request addresses this Issue:
#8406 (Marked as Enhancement)

This pull request adds RowSpacing and ColumnSpacing properties to the UniformGrid control in Avalonia. These properties allow developers to define the spacing between rows and columns, making creating consistent and flexible layouts easier. This update addresses limitations in the current UniformGrid implementation, such as the lack of built-in support for spacing, which previously required cumbersome workarounds.

What is the current behavior?

Currently, UniformGrid does not support row or column spacing. Developers often use workarounds such as:

• Adding fake spacing rows/columns in Grid.
• Manually adjusting Margin values for individual children.
  These methods are error-prone, hard to maintain, and do not scale well for larger layouts.

What is the updated/expected behavior with this PR?

With this PR, developers can set the RowSpacing and ColumnSpacing properties directly on UniformGrid. The grid will automatically apply the specified spacing while maintaining uniform child sizes and alignment.

How to test the PR:

1. Add a UniformGrid with various children.
2. Set RowSpacing and ColumnSpacing to non-zero values.
3. Verify that:
   • Spacing is applied correctly between rows and columns.
   • Child elements remain uniformly sized and aligned.
   • Invisible children are ignored while maintaining the proper layout.

How was the solution implemented (if it's not obvious)?

• New Properties: Added RowSpacing and ColumnSpacing as styled properties with a default value of 0.
• MeasureOverride: Adjusts available size for children to account for spacing when calculating the desired size.
• ArrangeOverride: Includes spacing when positioning children within the grid.
• UpdateRowsAndColumns: Ensures spacing compatibility with dynamically calculated row/column counts.
• Unit Tests: Added extensive tests to verify layout behavior with and without spacing.

Checklist

• Added unit tests (if possible)?
• Added XML documentation to any related classes?
• Consider submitting a PR to https://github.com/AvaloniaUI/avalonia-docs with user documentation

Breaking changes

None. The default values for RowSpacing and ColumnSpacing are 0, preserving existing behavior for layouts that do not use these properties.

Obsoletions / Deprecations

None.

Fixed issues

#8406

[avaloniaui-bot]

You can test this PR using the following package version. 11.3.999-cibuild0054317-alpha. (feed url: https://nuget-feed-all.avaloniaui.net/v3/index.json) [PRBUILDID]

[cla-avalonia]

• All contributors have signed the CLA.

[Enzx]

@cla-avalonia agree

[DoubleDBE]

Awesome! These properties are for certain missing on a regular Grid as well. But, yeah... 🙄

#5152
#8406

[MrJul]

Diff for API review:

 namespace Avalonia.Controls.Primitives
 {
     public class UniformGrid
     {
+        public static readonly StyledProperty<double> RowSpacingProperty;
+        public static readonly StyledProperty<double> ColumnSpacingProperty;
+        public double RowSpacing { get; set; }
+        public double ColumnSpacing { get; set; }
     }
 }

[avaloniaui-bot]

You can test this PR using the following package version. 11.3.999-cibuild0054369-alpha. (feed url: https://nuget-feed-all.avaloniaui.net/v3/index.json) [PRBUILDID]

[MrJul]

Notes from the API review:

We're happy with the proposed API, which matches WinUI.
(Ideally we'd like to add it to Grid in the future.)

[MrJul]

A couple of changes are needed and this PR will be good to merge.
The unit tests are really appreciated!

[avaloniaui-bot]

You can test this PR using the following package version. 11.3.999-cibuild0054419-alpha. (feed url: https://nuget-feed-all.avaloniaui.net/v3/index.json) [PRBUILDID]

[MrJul]

LGTM, thank you!