浏览示例

.NET 多平台应用 UI (.NET MAUI) 应用可以针对特定平台和设备自定义其 UI。 这使你的应用能够：

针对特定平台和设备习惯优化应用的 UI 时，你将创建响应式 UI。 在 .NET MAUI 中创建响应式 UI 的主要方法涉及使用 OnPlatform 标记扩展和 OnIdiom 标记扩展。

注意

有一类触发器（称为状态触发器），可用于在特定方案中（例如设备方向更改时）自定义 UI 外观。 有关详细信息，请参阅 状态触发器。

通过 OnPlatform 标记扩展可基于每个平台自定义 UI 外观。 它提供与 和 On 类相同的功能OnPlatform，但具有更简洁的表示形式。

OnPlatformExtension 类支持 OnPlatform 标记扩展，并定义以下属性：

注意

XAML 分析程序允许将 OnPlatformExtension 类缩写为 OnPlatform。

属性 Default 是 的内容 OnPlatformExtension属性。 因此，对于用大括号表示的 XAML 标记表达式，如果表达式是第一个参数，则可以消除 Default= 表达式的 部分。 如果未设置 属性 Default ，则它将默认为 BindableProperty.DefaultValue 属性值，前提是标记扩展面向 BindableProperty。

重要

XAML 分析程序要求向使用 OnPlatform 标记扩展的属性提供正确类型的值。 如果需要类型转换，标记 OnPlatform 扩展将尝试使用 .NET MAUI 提供的默认转换器执行该转换。 但是，某些类型转换不能由默认转换器执行，在这些情况下， Converter 属性应设置为 IValueConverter 实现。

OnPlatform 演示页显示如何使用OnPlatform标记扩展：

在此示例中，所有三个 OnPlatform 表达式都使用类名的 OnPlatformExtension 缩写版本。 这三个OnPlatform标记扩展在 xref:Microsoft.Maui.Graphics.ColoriOS 和 Android 上将 的 BoxView 、 WidthRequest和 HeightRequest 属性设置为不同的值。 标记扩展还为未指定的平台上的这些属性提供默认值，同时消除 Default= 表达式的 部分。

标记 OnIdiom 扩展使你能够基于运行应用的设备的成语自定义 UI 外观。 它受 OnIdiomExtension 类的支持，类定义以下属性：

注意

XAML 分析程序允许将 OnIdiomExtension 类缩写为 OnIdiom。

属性 Default 是 的内容 OnIdiomExtension属性。 因此，对于用大括号表示的 XAML 标记表达式，如果表达式是第一个参数，则可以消除 Default= 表达式的 部分。

重要

XAML 分析程序要求向使用 OnIdiom 标记扩展的属性提供正确类型的值。 如果需要类型转换，标记 OnIdiom 扩展将尝试使用 .NET MAUI 提供的默认转换器执行该转换。 但是，某些类型转换不能由默认转换器执行，在这些情况下， Converter 属性应设置为 IValueConverter 实现。

以下 XAML 示例演示如何使用 OnIdiom 标记扩展：

在此示例中，所有三个 OnIdiom 表达式都使用类名的 OnIdiomExtension 缩写版本。 这三个OnIdiom标记扩展将 Color的 BoxView 、 WidthRequest和 HeightRequest 属性设置为手机、平板电脑和桌面习惯用语上的不同值。 标记扩展还为未指定的习惯用语上的这些属性提供默认值，同时消除表达式的 部分 Default= 。