Docs about ItemsPanelTemplate usage

AvaloniaUI / avalonia-docs

https://docs.avaloniaui.net/docs/welcome

63 stars 209 forks source link

Docs about ItemsPanelTemplate usage #326

Closed timunie closed 9 months ago

timunie commented 9 months ago

@cerobe you could add a page under docs > DeepDrives and describe how to use a custom ItemsPanel For ItemsControl and friends. From the ItemsControl-page please add a link to that docs.

Originally posted by @timunie in https://github.com/AvaloniaUI/Avalonia/discussions/14296#discussioncomment-8219936

cerobe commented 9 months ago

@timunie If I understand well the task for this Issue are:

Create a page under docs > DeeDives on custom ItemsPanel. There should be a description, most used properties and an example.
The controls that use this should have a link to that new page. So far i have identified: ItemsControl, ItemPresenter, TreeView, Carousel, Menu, MenuFlyoutPresenter, ComboBox ListBox. I'm pretty sure this list is not exhaustive or even correct, could you confirm please?
Remove the duplicate examples (if any) in the basic controls

timunie commented 9 months ago

Yes, that was the idea behind it. Presenters are not a control the user should be using outside a control template, so you can skip these controls. I'd suggest to use your current PR. You can add Fixes #TheIssueNumber to automatically close an open issue linked to anything.

Thank you for your time ❤️

cerobe commented 9 months ago

All right, I have modified my current PR with the scope discussed above. Please have a good look at the PR as there are a few things that I am unsure about.