MAUI Entry组件ClearButton点击无法清除文本问题求助

问题描述 #

尝试使用Entry组件的ClearButtonVisibility="WhileEditing"属性实现文本清除功能，代码如下：

<Entry
   Placeholder="This is a freaky entry"
   TextColor="Purple"
   ClearButtonVisibility="WhileEditing"
   FontSize="Large"
   Keyboard="Chat"/>

但点击清除按钮后无任何反应，不确定是否遗漏配置，或是需要手动实现该功能。

环境版本信息：

• .NET版本：dotnet --version显示6.0.400
• Visual Studio 2022 for Mac Preview 17.4 (build 715)，完整配置如下：

Visual Studio Enterprise 2022 for Mac Preview
Version 17.4 Preview (17.4 build 715)
Installation UUID: 2aec5c48-b274-4de3-a48e-fb97472a4bd5

运行时
.NET 6.0.5 (64-bit)
Architecture: Arm64

Roslyn (语言服务)
4.4.0-1.22371.1+c07f2571612b471671c809b5b0db59b0c37aab57

NuGet
Version: 6.2.1.2

.NET SDK (Arm64)
SDK: /usr/local/share/dotnet/sdk/6.0.400/Sdks
SDK版本:
    6.0.400
    6.0.301
MSBuild SDKs: /Applications/Visual Studio (Preview).app/Contents/MonoBundle/MSBuild/Current/bin/Sdks

.NET SDK (x64)
SDK版本:
    3.1.422
    3.1.420

.NET Runtime (Arm64)
Runtime: /usr/local/share/dotnet/dotnet
Runtime版本:
    6.0.8
    6.0.6

.NET Runtime (x64)
Runtime: /usr/local/share/dotnet/x64/dotnet
Runtime版本:
    3.1.28
    3.1.26

Xamarin.Profiler
Version: 1.8.0.19
位置: /Applications/Xamarin Profiler.app/Contents/MacOS/Xamarin Profiler

Updater
Version: 11

Apple开发者工具
Xcode 13.4.1 (20504)
Build 13F100

Xamarin.Mac
Version: 8.12.0.2 (Visual Studio Enterprise)
Hash: 87f98a75e
Branch: d17-3
构建日期: 2022-07-25 20:18:54-0400

Xamarin.Android
Version: 13.0.99.36 (Visual Studio Enterprise)
Commit: xamarin-android/main/b4998c8
Android SDK: /Users/jimtiyg/Library/Developer/Xamarin/android-sdk-macosx
    支持的Android版本:
        12.0 (API level 31)
        11.0 (API level 30)

SDK命令行工具版本: 7.0
SDK平台工具版本: 33.0.2
SDK构建工具版本: 33.0.0

构建信息: 
Mono: dffa5ab
Java.Interop: xamarin/java.interop/main@032f1e71
SQLite: xamarin/sqlite/3.39.2@40e8743
Xamarin.Android Tools: xamarin/xamarin-android-tools/main@9c641b3

Microsoft Build of OpenJDK
Java SDK: /Library/Java/JavaVirtualMachines/microsoft-11.jdk
11.0.12
Android Designer EPL代码可在此获取:
https://github.com/xamarin/AndroidDesigner.EPL

Eclipse Temurin JDK
Java SDK: /Library/Java/JavaVirtualMachines/temurin-8.jdk
1.8.0.302
Android Designer EPL代码可在此获取:
https://github.com/xamarin/AndroidDesigner.EPL

Android SDK管理器
Version: 17.4.0.24
Hash: b3b6672
Branch: remotes/origin/HEAD~1
构建日期: 2022-08-04 16:29:21 UTC

Android设备管理器
Version: 0.0.0.1179
Hash: 0f220c0
Branch: main
构建日期: 2022-08-04 16:29:21 UTC

Xamarin Designer
Version: 17.4.0.32
Hash: 439b92ed7b
Branch: remotes/origin/d17-4
构建日期: 2022-08-04 16:29:17 UTC

Xamarin.iOS
Version: 15.12.0.2 (Visual Studio Enterprise)
Hash: 87f98a75e
Branch: d17-3
构建日期: 2022-07-25 20:18:55-0400

构建信息
Release ID: 1704000715
Git revision: 09071dadfc1b81e4f0e2c9505cd8a5ef0b41d312
构建日期: 2022-08-04 16:26:39+00
构建分支: release-17.4
构建通道: release-17.4

操作系统
Mac OS X 12.5.1
Darwin 21.6.0 Darwin Kernel Version 21.6.0
    Wed Aug 10 14:28:23 PDT 2022
    root:xnu-8020.141.5~2/RELEASE_ARM64_T6000 arm64

原因分析与解决方案 #

1. 绑定模式问题 #

如果Entry的Text属性使用了OneWay绑定模式，清除按钮点击后不会更新绑定源，导致文本看起来无变化。必须使用TwoWay绑定（默认模式，但若手动指定OneWay则会触发问题）。

修正后的XAML代码（显式指定绑定模式）：

<Entry
   Placeholder="This is a freaky entry"
   TextColor="Purple"
   ClearButtonVisibility="WhileEditing"
   FontSize="Large"
   Keyboard="Chat"
   Text="{Binding YourTextProperty, Mode=TwoWay}"/>

2. MAUI版本Bug #

你使用的.NET 6.0.400对应MAUI版本存在已知的清除按钮失效问题，该问题在后续的.NET 7版本中已修复。可选择升级到.NET 7及以上版本，或临时手动实现清除功能：

手动实现清除功能的方法

通过Grid组合Entry和自定义清除按钮：

<Grid>
    <Entry x:Name="MyEntry"
           Placeholder="This is a freaky entry"
           TextColor="Purple"
           FontSize="Large"
           Keyboard="Chat"
           TextChanged="MyEntry_TextChanged"/>
    <Button x:Name="ClearBtn"
            Text="X"
            WidthRequest="30"
            HeightRequest="30"
            HorizontalOptions="End"
            VerticalOptions="Center"
            IsVisible="False"
            Clicked="ClearBtn_Clicked"/>
</Grid>

后台逻辑代码：

private void MyEntry_TextChanged(object sender, TextChangedEventArgs e)
{
    ClearBtn.IsVisible = !string.IsNullOrEmpty(e.NewTextValue);
}

private void ClearBtn_Clicked(object sender, EventArgs e)
{
    MyEntry.Text = string.Empty;
}

3. 平台特定问题 #

在iOS平台上，原生Entry的清除按钮依赖正确的视图层级和渲染器配置。若自定义了Entry渲染器，可能会覆盖默认清除按钮逻辑，需检查自定义渲染器代码是否干扰了原生行为。

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