Windows Dev Center

TabView Control

The TabView control provides a way to organize content into multiple sections, each accessible through a distinct tab. This is ideal for presenting complex information or user interfaces in a structured and navigable manner, improving usability and reducing screen clutter.

Key Features:
  • Multiple selectable tabs.
  • Easy content switching between tabs.
  • Customizable tab appearance and behavior.
  • Supports dynamic addition and removal of tabs.

Basic Implementation

Here's a simple example of how to implement a TabView using WinUI 3:


<Page
    x:Class="WinUI_Docs.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:WinUI_Docs"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d"
    Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">

    <Grid>
        <TabView>
            <TabViewItem Header="Tab One">
                <TextBlock Text="Content for the first tab." FontSize="20" Margin="10"/>
            </TabViewItem>
            <TabViewItem Header="Tab Two">
                <Button Content="A button in Tab Two" Margin="10"/>
            </TabViewItem>
            <TabViewItem Header="Tab Three">
                <StackPanel Margin="10">
                    <TextBlock Text="More complex content."/>
                    <TextBox Header="Input Field"/>
                </StackPanel>
            </TabViewItem>
        </TabView>
    </Grid>
</Page>

Interactive Example

The following is a visual representation of a TabView. Click on the tabs to switch between their content.

This is the Overview tab. Here you can find general information about the TabView control, its purpose, and its main benefits in application development. It helps in organizing content logically and provides a user-friendly interface.

The TabView is a versatile control suitable for various scenarios, from simple tabbed navigation to complex dashboard layouts.

API Reference (Simplified)

Properties:

  • SelectedItem: Gets or sets the currently selected TabViewItem.
  • TabItemsSource: Provides an efficient way to bind data to the tabs.
  • IsAddTabButtonVisible: Controls the visibility of the button to add new tabs.

Events:

  • TabCloseRequested: Fired when a user attempts to close a tab.
  • SelectionChanged: Fired when the selected tab changes.

Code Examples

Creating a Tab Dynamically (Conceptual C#):


var newTab = new TabViewItem();
newTab.Header = "New Dynamic Tab";
newTab.Content = new TextBlock { Text = "Content added programmatically." };
MyTabViewControl.TabItems.Add(newTab);

Handling Tab Close Request:


void MyTabViewControl_TabCloseRequested(TabView sender, TabViewTabCloseRequestedEventArgs args)
{
    // Logic to confirm or prevent tab closure
    var tabItem = args.Item as TabViewItem;
    if (tabItem != null)
    {
        // Optional: Show a confirmation dialog
        // sender.TabItems.Remove(tabItem);
    }
}

Best Practices