鸿蒙UI开发——上拉抽屉的更新与事件回调

1、背 景

在上一篇文章中(鸿蒙UI开发------实现一个上拉抽屉效果),我们讨论了如何实现一个上拉抽屉效果:

有朋友私信我说:在上拉抽屉完成后,如何实现动态更新上拉抽屉的样式,以及抽屉中的数据如何回调到对应的父组件。针对这个问题,我们做一下讨论。

示例效果如下:

2、更新抽屉样式

如果我们想更新抽屉样式,可以通过updateBindSheet来实现,updateBindSheet接口定义如下:

功能:更新bindSheetContent对应的半模态页面的样式,使用Promise异步回调。

复制代码
updateBindSheet<T extends Object>(bindSheetContent: ComponentContent<T>, sheetOptions: SheetOptions, partialUpdate?: boolean ): Promise<void>

其中有三个参数,分别是:

  • bindSheetContent: 半模态页面中显示的组件内容。

  • sheetOptions: 半模态页面样式。

  • partialUpdate:半模态页面更新方式, 默认值为false。true为增量更新,保留当前值,更新SheetOptions中的指定属性。false为全量更新,除SheetOptions中的指定属性,其他属性恢复默认值。

其中sheetOptions是配置参数,我们在上一篇文章中已经有介绍,参见鸿蒙UI开发------实现一个上拉抽屉效果

另外,bindSheetContent参数是组件内容对象(ComponentContent),构建一个ComponentContent对象,我们可以通过类似如下的方式:

复制代码
contentNode =  new ComponentContent(this.getUIContext(), wrapBuilder(xxxBuilderFunciton), new Params(this.message));

其中有几个重要的入参:

  • uiContext,我们可以通过this.getUIContext()方法得到,
  • 第二个参数是一个builder,我们可以通过wrapBuilder(xxxBuilderFunciton)构建出来(后文会有示例)。

  • 第三个是可选参数,表示builder构建函数的入参(后文会有示例)。

3、回调父组件

回调父组件我们可以通过param传入callback的形式来实现,代码示例如下(第16行):

复制代码
class Params {  text: string = ""  updateText = (str: string) => {    // do nothing  };  constructor(text: string, callback: (str: string) => void) {    this.text = text;    this.updateText = callback;  }}@Builderfunction buildText(params: Params) {  Column() {    Button('更新父组件')      .onClick(() => {          params.updateText('callback: 抽屉关闭成功!')      })  }}

在buildText方法中,我们的Params里面定义一个callback,通过callback可以触发上层组件的更新。

4、示 例

一个示例效果如下:

  1. 我们点击「打开抽屉界面」按钮后,弹出上拉抽屉并插入了上层组件的默认参数"父组件初始默认参数"文本。

  2. 在抽屉面板中,展示出了上层组件的插入文本;

  3. 在抽屉面板中,点击「将背景色改为粉色」后,抽屉面板背景色发生变化;

  4. 点击「点我关闭抽屉」后,抽屉收起并调用了父组件的callback,让父组件""父组件初始默认参数"文本改为了"callback: 抽屉关闭成功"文本。

代码如下(22 ~ 24行代码更新抽屉样式,36行代码回调上层组件):​​​​​​​

复制代码
import { FrameNode, ComponentContent } from "@kit.ArkUI";import { BusinessError } from '@kit.BasicServicesKit';class Params {  text: string = ""  updateText = (str: string) => {    // do nothing  };  constructor(text: string, callback: (str: string) => void) {    this.text = text;    this.updateText = callback;  }}let contentNode: ComponentContent<Params>;let uiContext: UIContext;@Builderfunction buildText(params: Params) {  Column() {    Text(params.text).margin(10)    Button('将背景色改为粉色')      .fontSize(20)      .onClick(() => {        uiContext.updateBindSheet(contentNode, {          backgroundColor: Color.Pink,        }, true)          .then(() => console.info('更新抽屉成功'))          .catch((err: BusinessError) => {            console.info('更新抽屉错误: ' + err.code + ' ' + err.message);          })      })      .margin(10)    Button('点我关闭抽屉')      .fontSize(20)      .onClick(() => {        uiContext.closeBindSheet(contentNode)          .then(() => {            params.updateText('callback: 抽屉关闭成功!')            console.info('关闭抽屉成功');          })          .catch((err: BusinessError) => {            console.info('关闭抽屉失败: ' + err.code + ' ' + err.message);          })      })  }}@Entry@Componentstruct UIContextBindSheet {  @State message: string = '父组件初始默认参数';  aboutToAppear() {    uiContext = this.getUIContext();    contentNode =      new ComponentContent(this.getUIContext(), wrapBuilder(buildText), new Params(this.message, (str: string) => {        this.message = str;      }));  }  build() {    RelativeContainer() {      Column() {        Text('下面是父组件的入参文本').margin(10)        Text(this.message).margin(10)        Button('打开抽屉界面')          .fontSize(20)          .onClick(() => {            let uiContext = this.getUIContext();            let uniqueId = this.getUniqueId();            let frameNode: FrameNode | null = uiContext.getFrameNodeByUniqueId(uniqueId);            let targetId = frameNode?.getFirstChild()?.getUniqueId();            uiContext.openBindSheet(contentNode, {              height: SheetSize.MEDIUM,              backgroundColor: Color.White,              title: { title: "标题", subtitle: "副标题" }            }, targetId)              .then(() => {                console.info('抽屉界面打开成功!');              })              .catch((err: BusinessError) => {                console.info('打开抽屉失败: ' + err.code + ' ' + err.message);              })          })      }.width('100%')    }    .height('100%')    .width('100%')  }}
相关推荐
弓.长.12 分钟前
ReactNative for OpenHarmony项目鸿蒙化三方库:react-native-svg(CAPI) — 矢量图形组件
react native·react.js·harmonyos
不爱吃糖的程序媛13 分钟前
鸿蒙三方库适配HPKCHECK 文件执行流程详解
华为·harmonyos
见山是山-见水是水21 分钟前
Flutter 框架跨平台鸿蒙开发 - 电子发票智能管理
flutter·华为·harmonyos
HarmonyOS_SDK31 分钟前
化繁为简:顺丰速运App如何通过 HarmonyOS SDK实现专业级空间测量
harmonyos
不爱吃糖的程序媛1 小时前
鸿蒙三方库适配读懂 `HPKBUILD`:lycium 怎么知道「下载谁、怎么编、装到哪」?
服务器·华为·harmonyos
李游Leo1 小时前
别让压图拖垮首帧:系统 Picker + TaskPool + ImagePacker,把 HarmonyOS 图片整理链路做顺
harmonyos
2401_839633912 小时前
鸿蒙flutter第三方库适配 - 存储空间分析
flutter·华为·harmonyos
星辰即远方2 小时前
UI学习2
学习·ui
加农炮手Jinx2 小时前
Flutter 三方库 better_commit 的鸿蒙化适配指南 - 实现具备语义化提交规范与自动化交互的 Git 工作流插件、支持端侧版本工程的高效规范化审计实战
flutter·harmonyos·鸿蒙·openharmony·better_commit
麒麟ZHAO2 小时前
鸿蒙flutter第三方库适配 - 文件搜索工具
flutter·华为·harmonyos