如何在.NET MAUI中实现Editor仅按Enter换行、禁止文本自动换行

.NET MAUI 原生 Editor 控件没有提供直接关闭自动换行的公开属性，需要通过平台 Handler 修改原生控件配置，配合滚动容器适配长文本显示，具体实现步骤如下：

• 首先调整XAML布局，为长文本添加横向滚动支持
• 再通过Handler修改各平台原生输入控件的换行规则

1. XAML 布局调整 #

禁止自动换行后，单行长文本会超出控件宽度，需要将Editor放在支持双向滚动的ScrollView中，替换你原有Border节点内的代码即可：

<Border Stroke= "Black" StrokeThickness="2" Background="Pink" >
    <!-- 双向滚动容器，支持横向查看长行、纵向查看多行内容 -->
    <ScrollView Orientation="Both" HeightRequest="300" WidthRequest="380">
        <Editor 
            x:Name="NoWrapEditor"
            BackgroundColor="Aqua"
            AutoSize="TextChanges"
            HorizontalOptions="Start"
            VerticalOptions="Start" />
    </ScrollView>
</Border>

配置说明：

• Orientation="Both"：开启横向+纵向滚动，避免超出范围的文本被裁切
• AutoSize="TextChanges"：让Editor高度随输入的行数自动适配，不会出现内容挤压
• HorizontalOptions="Start"：让Editor宽度随输入文本自适应，不会强制拉伸到容器宽度

2. 平台原生配置修改 #

可以选择全局生效配置，或者单页面单独配置两种方式：

方式一：全局配置（推荐，项目内所有Editor统一生效） #

打开MauiProgram.cs文件，在CreateMauiApp方法中添加Handler映射配置：

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
    })
    // 新增以下配置
    .ConfigureMauiHandlers(handlers =>
    {
        handlers.AddHandler<Editor, EditorHandler>(mapper =>
        {
            mapper.PlatformViewHandler.Mapper.AppendToMapping("DisableAutoWrap", (handler, view) =>
            {
#if ANDROID
                // Android端禁用自动换行
                handler.PlatformView.SetHorizontallyScrolling(true);
                handler.PlatformView.InputType = Android.Text.InputTypes.ClassText 
                    | Android.Text.InputTypes.TextFlagMultiLine 
                    | Android.Text.InputTypes.TextVariationNormal;
#elif IOS || MACCATALYST
                // iOS/Mac Catalyst端禁用自动换行
                handler.PlatformView.TextContainer.WidthTracksTextView = false;
                handler.PlatformView.ScrollEnabled = true;
                handler.PlatformView.ShowsHorizontalScrollIndicator = true;
#elif WINDOWS
                // Windows端禁用自动换行
                handler.PlatformView.TextWrapping = Microsoft.UI.Xaml.TextWrapping.NoWrap;
                handler.PlatformView.AcceptsReturn = true;
#endif
            });
        });
    });

return builder.Build();

方式二：单页面配置（仅当前页面的Editor生效） #

如果不需要全局修改，只需要在当前页面的后台代码（MainPage.xaml.cs）中，给目标Editor添加HandlerChanged事件处理：

public MainPage()
{
    InitializeComponent();
    // 给目标Editor添加原生配置修改逻辑
    NoWrapEditor.HandlerChanged += (s, e) =>
    {
#if ANDROID
        var androidEditor = NoWrapEditor.Handler.PlatformView as AndroidX.AppCompat.Widget.AppCompatEditText;
        androidEditor.SetHorizontallyScrolling(true);
        androidEditor.InputType = Android.Text.InputTypes.ClassText 
            | Android.Text.InputTypes.TextFlagMultiLine 
            | Android.Text.InputTypes.TextVariationNormal;
#elif IOS || MACCATALYST
        var iosEditor = NoWrapEditor.Handler.PlatformView as UIKit.UITextView;
        iosEditor.TextContainer.WidthTracksTextView = false;
        iosEditor.ScrollEnabled = true;
#elif WINDOWS
        var winEditor = NoWrapEditor.Handler.PlatformView as Microsoft.UI.Xaml.Controls.TextBox;
        winEditor.TextWrapping = Microsoft.UI.Xaml.TextWrapping.NoWrap;
        winEditor.AcceptsReturn = true;
#endif
    };
}

效果说明 #

配置完成后部署到各平台运行，Editor将不会在文本到达控件宽度边缘时自动折行，仅当用户按下Enter键时才会触发换行，超出控件宽度的单行文本可以通过横向滚动查看，完全匹配需求。

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