Java UI框架是HarmonyOS應用開發中諸多開發者需要關注的重要內容。近期，文檔君結合各位開發者反饋的聲音和改進建議，對官網文檔的Java UI框架內容進行了更新，主要體現在新增開發指南和補充開發說明。歡迎廣大開發者使用并反饋建議。話不多說，快來看看本次更新的具體內容吧！

一、新增組件開發指南

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

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

PopupDialog組件

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

CommonDialog組件

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

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

二、補充組件開發說明

本次更新，在原組件開發指南的基礎上，對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所示：

Picker組件官網指南：

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

TableLayout布局

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

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，正是因為有你們的建議和反饋，我們在文檔體驗提升的道路上，走得更加堅定和從容。讓我們攜手共同打造面向萬物互聯的超級終端新體驗。

責任編輯：haq