New UWP Community Toolkit 6.0

概述

UWP Community Toolkit 是一個 UWP App 自定義控件、應用服務和幫助方法的集合，能夠很大程度的簡化和指引開發者的開發工作，相信廣大 UWPer 并不陌生。

下面是截取自 GitHub 的項目概覽，可以看出這個工具包的影響力和更新頻率都是比較理想的：

開發者可以通過 VS Package Management 來安裝?UWP Community Toolkit NuGet 包，輸入“Microsoft.Toolkit”會列出一個集合，下面是摘自官方的 NuGet 包集合和描述，大家根據需求選擇使用哪幾個包：

更詳細的功能描述信息可以參考官方文檔：Microsoft - UWP Community Toolkit Documentation

UWP Community Toolkit 同樣在 GitHub 開源：GitHub -?Microsoft/UWPCommunityToolkit

對于功能使用和代碼實現有任何的疑問，可以在 Stack Overflow 的?uwp-community-toolkit?專區提問，如有新的功能需求，可以在?Microsoft Forums Uservoice??提出；

如果大家想先了解一下?UWP Community Toolkit 的功能演示，也可以直接在 Microsoft Store 下載?UWP Toolkit Sample App?使用體驗：

開發體驗

版本更新

從 2016 年 8 月份 1.0 版本正式推出，UWP Community Toolkit 到現在已經經歷了十幾個版本的迭代，目前最新版本是 V6.0，2019 年 11 月份正式發布。

大家可以在 GitHub 主頁上查看 V6.0 的發布日志：UWP Community Toolkit V6.0 Release note. 根據 Release note，V6.0 的更新主要體現在 Controls、Extensions、Helpers、Parsers、Brushes、Animations、Services、Notifications 和 Sample App 這幾個方面，而今天我們也會針對這幾個方面的主要更新做開發體驗。

開發體驗

1. Staggered panel

Namespace:?Microsoft.Toolkit.Uwp.UI.Controls

Staggered panel 允許分列列表中的元素被自動添加到當前占用空間最小的那一列，可以在編寫樣式的時候，作為?ItemsPanelTemplate 的值。它很適合作為信息類或圖片類應用的瀑布流來使用，還可以根據當前視圖的尺寸來調節列的數量。來看一下簡單的 XAML 實現和顯示效果：

第一張圖中，test04 被添加到 test03 下面，而不是 test01 下面，這也驗證了上面關于占用空間最小的列的論斷。

2.?MarkDownTextBlock

Namespace:?Microsoft.Toolkit.Uwp.UI.Controls

MarkdownTextBlock 控件對 markdown 的解析和渲染在 UWP 中做了完整的支持，可以自定義 markdown 解析器和渲染，保證流暢的 UI 體驗，即使是在低配置的硬件上使用復雜的 markdown 規則。

Markdown 是一種非常常用的標記語言，對于編寫文檔或者文章有很大幫助：Markdown 維基百科。關于 Markdown 語法，大家可以去查詢，很容易上手。

關于 MarkdownTextBlock 的完整文檔，大家可以在?MarkdownTextBlock XAML Control?中查看。

下面看一下針對一段 markdown 標記，MarkdownTextBlock 的解析和渲染結果，以及針對 LInk 的點擊操作：

3. MarkdownDocument

Namespace:?Microsoft.Toolkit.Parsers.Markdown

上面我們看到 MarkdownTextBlock 控件對 markdown 標記的解析和渲染，而?MarkdownDocument 就是負責 markdown 解析工作的類，它可以從 markdown 字符串解析 MarkdownDocument，然后使用 MarkdownRenderer 來渲染到 UI 中。

來看一下一段簡單 markdown 字符串（This is?Markdown）的解析代碼和結果：

This is 和 Markdown 被解析為兩個 Inline，Type = 'TextRun'，其中 Markdown 的 顯示 Type = 'Bold'，這個預期的一致，Markdown 顯示為加粗。

string?md?=?"This?is?**Markdown**"; MarkdownDocument?Document?=?new?MarkdownDocument(); Document.Parse(md);//?Takes?note?of?all?of?the?Top?Level?Headers.foreach?(var?element?in?document.Blocks) {????if?(element?is?HeaderBlock?header) ????{ ????????Console.WriteLine($"Header:?{header.ToString()}"); ????} }

4.?RangeSelector

RangeSelector 是一個范圍選擇控件，不同于 ProgressBar，它有上下限兩個選擇值，確定一個選擇區間，注意下限是小于等于上限的。通過?RangeMin?和?RangeMax?來取得當前的區間范圍。

5. New XAML Brushes

Namespace:?Microsoft.Toolkit.Uwp.UI.Media

Community Toolkit 共支持 7 種畫刷：

BackdropBlurBrush - 可以把置于后面的顯示物模糊化

BackdropGammaTransferBrush - 修改置于后面的顯示物的顏色值

BackfropInvertBrush - 把置于后面的顯示物顏色反轉

BackdropSaturaionBrush - 調整置于后面的顯示物飽和度

BackdropSepiaBrush - 調整置于后面的顯示物色調

ImageBlendBrush - 使用圖像的畫刷，與顯示物混合

RadialGradientBrush - 徑向漸變畫刷

書寫的方法很簡單，都是基于對控件 Background 或 Fill 的定義來實現的，我們來簡單看一個?BackdropBlurBrush 的示例，其他的大家可以在 Sample App 中具體查看：

?????? ???????? ?????? ????

6.?Added new toast features for My People shoulder tap

關于人脈通知，我們摘錄一段官方文檔的說明：

“我的人脈”通知是將人脈放在首位的一種新手勢。 它們提供了一種新的方式，可讓用戶通過快速、簡潔的表意手勢與他們所關心的人員進行聯系。

作為常規 Toast 通知的替代方法，應用程序開發人員現在可以通過“我的人脈”功能發送通知，以向用戶提供更加個性化的體驗。 這是從固定到用戶任務欄的聯系人發送的一種新型 Toast。

收到通知時，將在任務欄中動態顯示發件人的聯系人圖片并且將播放聲音，這表示“我的人脈”通知正在啟動。 然后，負載中指定的動畫或圖像將顯示 5 秒鐘（如果負載是持續時間少于 5 秒的動畫，則將循環顯示，直到 5 秒鐘過后為止）。

更詳細的信息，以及如何正確集成人脈通知，可以參考：My People Notification.

本次 Community Toolkie 加入了對人脈通知類的支持，我們從官網看到一個人脈類的 Toast 模板，拿來測試一下；其中 experienceType='shoulderTap' 表示這是一個人脈通知。

???? ???????? ????????????Toast?fallback ????????????Add?your?fallback?toast?content?here ???????? ???????? ???????????? ???????? ????

可以看到，ToastNotification 觸發時，人脈應用收到了通知并顯示出來。（因為是在虛擬機做的測試，Windows 并沒有激活。。

在某些情況下，編碼為“我的人脈”通知的通知將改為顯示為常規 Toast。 在以下情況下，“我的人脈”通知將回退到 Toast：

通知無法顯示

收件人未啟用“我的人脈”通知

發件人的聯系人未固定到收件人的任務欄

如果“我的人脈”通知回退到 Toast，則將忽略第二個特定于“我的人脈”的綁定，并且僅使用第一個綁定來顯示 Toast。 這意味著，如之前所述，必須在第一個 Toast 綁定中提供回退負載。

7. OneDrive Service and Twitter Service Support

服務方面，6.0 版本加入了對 OneDrive 和 Twitter 服務的支持。

Added MSAL support add .NET Standard support

Added support to tweets with 280 characters

到這里我們就把 UWP Community Toolkit 6.0 版本的幾個重要更新介紹完了，后面結合工作中實際用到的新功能可以再做深入的研究，歡迎大家多多交流，謝謝！

Markdown https

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。