design-patterns-controls-ListView.md

ListView

Basics

The ListView displays a simple list of items

When to use

Best practices

Do

• Choose the appropriate ListView option - Simple, Template, Custom
• Use the Template ListView galleryview options (autofit, wrap) to show a card layout - aka card control

Don't

Developer tips and tricks

Learn how to use ListView in the SDK samples

• Simple ListView - https://df.onecloud.azure-test.net/?SamplesExtension=true#blade/SamplesExtension/ListViewIndexBlade/SimpleListViewBlade/selectedItem/ListViewIndexBlade/selectedValue/ListViewIndexBlade
• Template ListView - https://df.onecloud.azure-test.net/?SamplesExtension=true#blade/SamplesExtension/ListViewIndexBlade/TemplateListViewBlade/selectedItem/ListViewIndexBlade/selectedValue/ListViewIndexBlade
• Template ListView GalleryView (aka Card control) - https://df.onecloud.azure-test.net/?SamplesExtension=true#blade/SamplesExtension/ListViewIndexBlade/TemplateListViewGalleryModeBlade/selectedItem/ListViewIndexBlade/selectedValue/ListViewIndexBlade
• Custom ListView - https://df.onecloud.azure-test.net/?SamplesExtension=true#blade/SamplesExtension/ListViewIndexBlade/CustomListViewBlade/selectedItem/ListViewIndexBlade/selectedValue/ListViewIndexBlade

Interactive control and sample source code

Go to the playground site to use the latest control and get source code for your project. Learn more about playground.

The ListView control offers different create methods and has the following entries in the interactive controls playground

• ListView (SimpleListView)

• ListView (TemplateListView)

• ListView (CustomListView)

Related info

• Azure design guidance