WinUI 2.1

2025-04-30

WinUI 的第一个开源版本 – WinUI 2.1（2019 年 4 月发布）。

WinUI 提供了许多最新的 Windows UX 平台功能，包括 up-to-date Fluent 控件和样式，你可以立即使用，向后兼容 Windows 10 周年更新（14393）。 WinUI 2 Gallery 提供了示例来探索添加到示例库的所有酷炫新功能。

下载 WinUI 2.1 NuGet 包

可以选择使用 NuGet 包管理器在应用中使用 WinUI 包：有关详细信息，请参阅 WinUI 2 入门。

WinUI 托管在 GitHub 上，我们建议你提交 bug 报告。

此版本中的新增功能

ItemsRepeater

使用 ItemsRepeater 通过灵活的布局系统、自定义视图和虚拟化创建自定义集合体验。与 ListView 不同，ItemsRepeater 不提供全面的最终用户体验 - 它没有默认 UI，也没有围绕焦点、选择或用户交互的策略。相反，它是一个构建基块，可用于创建自己的基于集合的独特体验和自定义控件。它支持构建更丰富、更高性能的体验。

显示 Items Repeater 控件行为的简短视频。

文档

AnimatedVisualPlayer

AnimatedVisualPlayer 托管和控制动画视觉对象的播放，使你可以向应用添加高性能自定义运动图形。例如，AnimatedVisualPlayer 用于显示和控制 Lottie 动画。

显示动画视觉播放器控件行为的简短视频。

文档

教学提示

TeachingTip 为应用程序提供了一种引人入胜的 Fluent 方法，可指导和通知用户使用非侵入性和内容丰富的提示。 TeachingTip 可以专注于新的或重要的功能，教用户如何执行任务，并通过向手头的任务提供上下文相关信息来增强工作流。

显示教学提示控件的行为的短视频。

文档

Radio菜单下拉项

支持在菜单栏中使用“单选按钮”样式的选项。这样，您可以将带有项目符号的选项组像单选按钮组一样绑定在一起。为开发人员处理了逻辑。

显示单选菜单浮出项控件行为的屏幕截图。

文档

CompactDensity

压缩模式使开发人员能够为任意数量的方案创建舒适的体验。只需添加资源字典，应用程序就可以平均容纳大约 33% 更多的 UI。

显示 Compact Density 控件行为的屏幕截图。

文档

阴影

在 UI 中创建元素的视觉层次结构使 UI 易于扫描并传达关注的重要内容。提升是将 UI 选择元素向前引入的行为，通常用于在软件中实现此类层次结构。

随着 Windows 10 2019 年 5 月更新的发布，我们的许多常见控件默认使用 z 深度和阴影来增加层次感。 WinUI 2.1 中的 NavigationView 和 TeachingTip 控件在具有 Windows 10 2019 年 5 月更新的操作系统上运行时也具有默认阴影。有关具有默认阴影的控件列表以及如何使用其他 API，请参阅 Z 深度和阴影。

例子

小窍门

有关详细信息、设计指南和代码示例，请参阅适用于 Windows 应用的设计。

应用程序WinUI 2 画廊包括大多数 WinUI 2 控件、特性和功能的交互式示例。

如果已安装图库应用，请单击 WinUI 2 Gallery 打开它。

如果未安装，请从 Microsoft 应用商店下载 WinUI 2 库 。

您还可以从 GitHub（选择 winui2 分支）获取源代码。

文档

适用于 WinUI 控件的操作方法文章包含在 Windows 应用控件文档中。

API 参考文档位于此处： WinUI API。

Microsoft.UI.Xaml 2.1 版本历史记录

Microsoft.UI.Xaml 2.1 官方版本

2019 年 4 月

GitHub 发布页面

NuGet 包下载

新功能（不包括在早期发行版中）

CompactDensity：紧凑模式使开发人员能够为任意数量的方案创造舒适的用户体验。只需添加资源字典，应用程序就可以平均容纳大约 33% 更多的 UI。
阴影：在 UI 中创建元素的视觉层次结构使 UI 易于扫描并传达关注的重要内容。提升是将 UI 选择元素向前引入的行为，通常用于在软件中实现此类层次结构。我们的许多常见控件默认通过使用 z 轴深度和阴影来增加高度。