MAUI ListView自定义Header无法显示的解决方法咨询

问题分析 #

你的ListView Header/Footer无法正常显示，核心原因包括：

• Header内的StackLayout未明确设置高度或垂直布局属性，导致控件被压缩至不可见
• Label未指定文本颜色，在部分主题模式下可能与背景色对比度不足
• ItemTemplate中存在列绑定错误（Column3/Column4均绑定到Grid.Column="1"），虽不直接影响Header，但会导致列表内容显示异常

修复后的代码 #

<ListView x:Name="lvRegistrosHorarios" Grid.Row="2" Margin="0,20,0,0"
          ItemsSource="{Binding MyCollection}"
          IsPullToRefreshEnabled="true"
          RefreshCommand="{Binding MyrefreshCommand}"
          IsRefreshing="{Binding isRefreshing}"
          BackgroundColor="Transparent"
          SeparatorColor="DarkBlue">

    <ListView.Header>
        <StackLayout BackgroundColor="Red" HeightRequest="40" VerticalOptions="Fill">
            <Label Margin="10,0,0,0"
                   Text="Monkeys"
                   FontSize="12"
                   FontAttributes="Bold"
                   TextColor="White" />
        </StackLayout>
    </ListView.Header>
    <ListView.Footer>
        <StackLayout BackgroundColor="Red" HeightRequest="40" VerticalOptions="Fill">
            <Label Margin="10,0,0,0"
                   Text="Friends of Monkey"
                   FontSize="12"
                   FontAttributes="Bold"
                   TextColor="White" />
        </StackLayout>
    </ListView.Footer>

    <ListView.ItemTemplate>
        <DataTemplate>
            <ViewCell>
                <Grid VerticalOptions="Center" HeightRequest="40">
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="1*"/>
                        <ColumnDefinition Width="1*"/>
                        <ColumnDefinition Width="1*"/>
                        <ColumnDefinition Width="1*"/>
                    </Grid.ColumnDefinitions>

                    <Label Text="{Binding COlumn1}" TextColor="Black" Grid.Column="0" VerticalOptions="Center" HorizontalOptions="Center"/>
                    <Label Text="{Binding COlumn2}" TextColor="Black" Grid.Column="1" VerticalOptions="Center" HorizontalOptions="Center"/>
                    <Label Text="{Binding COlumn3}" TextColor="Black" Grid.Column="2" VerticalOptions="Center" HorizontalOptions="Center"/>
                    <Label Text="{Binding COlumn4}" TextColor="Black" Grid.Column="3" VerticalOptions="Center" HorizontalOptions="Center"/>
                </Grid>
            </ViewCell>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

关键修改说明 #

• 为Header/Footer的StackLayout添加HeightRequest="40"和VerticalOptions="Fill"，强制控件撑开显示
• 给Label设置TextColor="White"，确保红色背景上文本清晰可见
• 修正ItemTemplate中Label的Grid.Column索引，匹配Grid的4列定义，保证多列布局正常

内容的提问来源于stack exchange，提问作者Álvaro García