JavaUI框架新增组件开发指南

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