Java UI框架是HarmonyOS應(yīng)用開發(fā)中諸多開發(fā)者需要關(guān)注的重要內(nèi)容。近期，文檔君結(jié)合各位開發(fā)者反饋的聲音和改進(jìn)建議，對(duì)官網(wǎng)文檔的Java UI框架內(nèi)容進(jìn)行了更新，主要體現(xiàn)在新增開發(fā)指南和補(bǔ)充開發(fā)說明。歡迎廣大開發(fā)者使用并反饋建議。話不多說，快來看看本次更新的具體內(nèi)容吧！

一、新增組件開發(fā)指南

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

PopupDialog和CommonDialog是兩款比較常用的交互類組件，給開發(fā)者提供了簡單且實(shí)用的對(duì)話框，下面將簡單介紹兩款組件的內(nèi)容。

PopupDialog組件

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

CommonDialog組件

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

開發(fā)者可以使用CommonDialog的構(gòu)造方法創(chuàng)建一個(gè)對(duì)話框，并通過setSize、setOffset、setCornerRadius等常用方法設(shè)置對(duì)話框的尺寸、偏移量、圓角值，再通過setDuration方法設(shè)置對(duì)話框自動(dòng)關(guān)閉前的持續(xù)時(shí)間。開發(fā)者還可以使用setCustomComponent來進(jìn)行一些自定義設(shè)置。自定義CommonDialog對(duì)話框示例效果圖

二、補(bǔ)充組件開發(fā)說明

本次更新，在原組件開發(fā)指南的基礎(chǔ)上，對(duì)ToastDialog組件、Picker組件、TableLayout布局以及自定義組件的開發(fā)指南內(nèi)容進(jìn)行了補(bǔ)充說明，使開發(fā)者在閱讀文檔過程中能更容易地理解并掌握其開發(fā)過程。下面是本次補(bǔ)充說明的內(nèi)容。

ToastDialog組件

ToastDialog組件是在窗口上方彈出的對(duì)話框，是通知操作的簡單反饋。本次更新，補(bǔ)充了ToastDialog組件的接口說明，開發(fā)者可獲取到對(duì)應(yīng)的構(gòu)造方法和常用方法，以便更好地進(jìn)行ToastDialog的創(chuàng)建、使用及自定義設(shè)置等。ToastDialog組件新增接口說明內(nèi)容，如圖3所示：

圖3 ToastDialog新增接口說明內(nèi)容

ToastDialog組件官網(wǎng)指南：

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

Picker組件

Picker組件提供了滑動(dòng)選擇器。本次更新，補(bǔ)充了Picker組件多級(jí)關(guān)聯(lián)的使用示例，以便開發(fā)者更好地開發(fā)實(shí)現(xiàn)多級(jí)Picker關(guān)聯(lián)相關(guān)的場景需求。Picker組件多級(jí)關(guān)聯(lián)，如圖4所示：

Picker組件官網(wǎng)指南：

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

TableLayout布局

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

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

自定義組件

自定義組件是開發(fā)者根據(jù)設(shè)計(jì)需求創(chuàng)建的組件。本次更新，補(bǔ)充了自定義組件的完整的示例代碼，并對(duì)文檔中自定義圓環(huán)組件的功能進(jìn)行調(diào)整，實(shí)現(xiàn)每次點(diǎn)擊/抬起都可改變圓環(huán)顏色。自定義圓環(huán)組件的效果，如圖6所示：

圖6 自定義圓環(huán)組件的效果示意圖

自定義組件官網(wǎng)指南：

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

三、建議與反饋

我們堅(jiān)持傾聽開發(fā)者聲音，持續(xù)優(yōu)化文檔體驗(yàn)。開發(fā)者在開發(fā)的過程中有任何文檔問題和建議，可通過以下兩種方式進(jìn)行反饋：

直接點(diǎn)擊開發(fā)文檔下“意見反饋”按鈕進(jìn)行反饋；

華為開發(fā)者論壇“HarmonyOS”版塊下，單擊“發(fā)表主題”進(jìn)行反饋。

“沒有人能夠熄滅滿天星光，每一位開發(fā)者，都是華為要匯聚的星星之火”，期待更多的開發(fā)者加入HarmonyOS，正是因?yàn)橛心銈兊慕ㄗh和反饋，我們在文檔體驗(yàn)提升的道路上，走得更加堅(jiān)定和從容。讓我們攜手共同打造面向萬物互聯(lián)的超級(jí)終端新體驗(yàn)。

責(zé)任編輯：haq