.NET MAUI中Label控件MaxLines与LineBreakMode属性失效问题

问题 #

在Xamarin.Forms中，通过Label控件的MaxLines和LineBreakMode属性可实现限制文本最大行数并在末尾显示省略号的功能，但迁移到.NET MAUI后该功能异常：Android端仅显示省略号但不展示第二行，iOS端也无法达到“显示两行文本，第二行末尾带省略号”的预期效果。

复现代码（MainPage.xaml） #

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="Maui_POC.MainPage">

    <ScrollView>
        <StackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Image
                Source="dotnet_bot.png"
                SemanticProperties.Description="Cute dot net bot waving hi to you!"
                HeightRequest="200"
                HorizontalOptions="Center" />

            <Label
                Text="Hello, World!"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="32"
                HorizontalOptions="Center" />

            <Label
                Text="Welcome to .NET Multi-platform App UI, Cute dot net bot waving hi to you!"
                SemanticProperties.HeadingLevel="Level2"
                FontSize="18"
                MaxLines="2"
                LineBreakMode="TailTruncation"
                HorizontalOptions="Center" />

            <Button
                x:Name="CounterBtn"
                Text="Click me"
                SemanticProperties.Hint="Counts the number of times you click"
                Clicked="OnCounterClicked"
                HorizontalOptions="Center" />

        </StackLayout>
    </ScrollView>

</ContentPage>

预期效果 #

Label应显示两行文本，第二行末尾显示“...”。

解决方案 #

问题根源是HorizontalOptions="Center"导致Label的宽度被限制为文本的最小宽度，无法触发换行逻辑。以下是两种修复方式：

方式1：让Label占满父容器宽度，同时保持文本居中 #

将Label的HorizontalOptions改为Fill，并设置HorizontalTextAlignment="Center"让文本居中，这样Label有足够宽度换行：

<Label
    Text="Welcome to .NET Multi-platform App UI, Cute dot net bot waving hi to you!"
    SemanticProperties.HeadingLevel="Level2"
    FontSize="18"
    MaxLines="2"
    LineBreakMode="TailTruncation"
    HorizontalOptions="Fill"
    HorizontalTextAlignment="Center" />

方式2：保留控件居中，同时指定宽度约束 #

如果需要Label控件保持居中，可通过WidthRequest给Label设置固定宽度，或用布局容器（如Grid）给Label分配足够宽度：

<Label
    Text="Welcome to .NET Multi-platform App UI, Cute dot net bot waving hi to you!"
    SemanticProperties.HeadingLevel="Level2"
    FontSize="18"
    MaxLines="2"
    LineBreakMode="TailTruncation"
    HorizontalOptions="Center"
    WidthRequest="300"
    HorizontalTextAlignment="Center" />

原理说明 #

在.NET MAUI中，当Label设置HorizontalOptions="Center"时，控件的宽度会自适应文本的最小显示宽度，文本没有足够空间换行，只能在一行内截断，表现为仅显示省略号而无第二行。给Label分配足够宽度后，文本会先换行到第二行，再触发TailTruncation的截断逻辑，符合预期效果。

内容的提问来源于stack exchange，提问作者Divyesh