華為鴻蒙HarmonyOS JavaUI 框架官網文檔內容更新：組件開發指南、補充組件開發說明

Posted on by

華為官方表示，Java UI 框架是 HarmonyOS 應用開發中諸多開發者需要關註的重要內容。近期，結合各位開發者反饋的聲音和改進建議，對官網文檔的 Java UI 框架內容進行瞭更新，主要體現在新增開發指南和補充開發說明。

一、新增組件開發指南

本次更新，新增瞭 PopupDialog 和 CommonDialog 組件的開發指南。

PopupDialog 和 CommonDialog 是兩款比較常用的交互類組件，給開發者提供瞭簡單且實用的對話框，下面將簡單介紹兩款組件的內容。

PopupDialog 組件

PopupDialog 是在當前界面之上彈出的氣泡對話框，可以參照組件或者屏幕顯示。開發者可以通過 PopupDialog 的構造方法創建一個氣泡對話框，使用 setArrowOffset、setArrowSize、setBackColor 等常用方法來設置氣泡對話框的尺寸、背景及箭頭樣式等。另外，也可以使用 setCustomComponent 來進行一些自定義設置。自定義氣泡對話框示例效果圖，如圖 1 所示：

圖 1 自定義氣泡對話框示例效果圖

詳細的 PopupDialog 組件開發指南，請訪問官網：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-popupdialog-0000001150714408#section1520718454241

CommonDialog 組件

CommonDialog 是一種在彈出框消失之前，用戶無法操作其他界面內容的對話框。通常用來展示用戶當前需要或用戶必須關註的信息或操作。

開發者可以使用 CommonDialog 的構造方法創建一個對話框，並通過 setSize、setOffset、setCornerRadius 等常用方法設置對話框的尺寸、偏移量、圓角值，再通過 setDuration 方法設置對話框自動關閉前的持續時間。開發者還可以使用 setCustomComponent 來進行一些自定義設置。自定義 CommonDialog 對話框示例效果圖，如圖 2 所示：

圖 2 自定義 CommonDialog 對話框示例效果圖

詳細的 CommonDialog 組件開發指南，請訪問官網：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-commondialog-0000001150874228

二、補充組件開發說明

本次更新，在原組件開發指南的基礎上，對 ToastDialog 組件、Picker 組件、TableLayout 佈局以及自定義組件的開發指南內容進行瞭補充說明，使開發者在閱讀文檔過程中能更容易地理解並掌握其開發過程。下面是本次補充說明的內容。

ToastDialog 組件

ToastDialog 組件是在窗口上方彈出的對話框，是通知操作的簡單反饋。本次更新，補充瞭 ToastDialog 組件的接口說明，開發者可獲取到對應的構造方法和常用方法，以便更好地進行 ToastDialog 的創建、使用及自定義設置等。ToastDialog 組件新增接口說明內容，如圖 3 所示：

圖 3 ToastDialog 新增接口說明內容

ToastDialog 組件官網指南：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-toastdialog-0000001060125963#section166052377612

Picker 組件

Picker 組件提供瞭滑動選擇器。本次更新，補充瞭 Picker 組件多級關聯的使用示例，以便開發者更好地開發實現多級 Picker 關聯相關的場景需求。Picker 組件多級關聯，如圖 4 所示：

圖 4 Picker 多級關聯示意圖

Picker 組件官網指南：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-picker-0000001059807909

TableLayout 佈局

TableLayout 使用表格的方式劃分子組件。本次更新，補充瞭 TableLayout 子組件行列屬性的使用示例，開發者可以通過設置 TableLayout 子組件的行列屬性來實現單元格合並的效果。使用 TableLayout 實現單元格合並，如圖 5 所示：

圖 5 使用 TableLayout 實現單元格合並的示意圖

TableLayout 佈局官網指南：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-layout-tablelayout-0000001060379893

自定義組件

自定義組件是開發者根據設計需求創建的組件。本次更新，補充瞭自定義組件的完整的示例代碼，並對文檔中自定義圓環組件的功能進行調整，實現每次點擊/抬起都可改變圓環顏色。自定義圓環組件的效果，如圖 6 所示：

圖 6 自定義圓環組件的效果示意圖

自定義組件官網指南：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-custom-components-0000001139369661

三、建議與反饋

華為稱堅持傾聽開發者聲音，持續優化文檔體驗。開發者在開發的過程中有任何文檔問題和建議，可通過以下兩種方式進行反饋：

直接點擊開發文檔下“意見反饋”按鈕進行反饋；

華為開發者論壇“HarmonyOS”版塊下，單擊“發表主題”進行反饋。 

以上便是小編為大傢帶來的華為鴻蒙 HarmonyOS JavaUI 框架官網文檔內容更新：組件開發指南、補充組件開發說明的全部內容，希望對大傢有所幫助，更多內容請繼續關註GuideAH。

閱讀更多: