openharmony 鸿蒙 changelogs-arkui

2025-06-16 浏览 (1)

cl.arkui.1 RichEditor菜单弹出时滚动组件后菜单显隐规格变更

访问级别

公开接口

变更原因

RichEditor菜单弹出后，滚动停止时菜单是否显示的UX默认行为改变

变更影响

变更前：RichEditor菜单弹出后，滚动组件时菜单隐藏，停止滚动时菜单不自动重新显示。

变更后：RichEditor菜单弹出后，滚动组件时菜单隐藏，停止滚动时会自动重新显示。

变更前变更后
alt textalt text
起始API Level

该特性变更起始支持版本为 API 12。

变更发生版本

从OpenHarmony SDK 5.0.0.24开始。

适配指导

UX默认行为变更，无需适配。不影响功能逻辑，请关注当前富文本菜单在停止滚动时的UX表现。

cl.arkui.2 bindMenu、bindContextMenu菜单允许自定义圆角

访问级别

公开接口

变更原因

功能增强

变更影响

该变更为兼容性变更。

API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.24 版本开始。

变更的接口/组件

bindMenu、bindContextMenu

适配指导

该变更为兼容性变更，无需适配。如需使用该功能，请查阅菜单控制文档。

cl.arkui.3 在UI上下文不明确的地方，promptAction.showToast使用方式规格变更

访问级别

公开接口

变更原因

本模块功能依赖UI的执行上下文，不可在UI上下文不明确的地方使用，若在非UI页面中或者一些异步回调中调用此接口，可能无法跟踪到当前UI的上下文，导致toast位置计算错误。

变更影响

变更前：在UI上下文不明确的地方，可以直接弹出toast，但是位置可能错误。

变更后：在UI上下文不明确的地方，需要用户指定相应的UIContext来获取promptAction对象，来弹出toast。

起始API Level

该特性变更起始支持版本为 API 9。

变更发生版本

从OpenHarmony SDK 5.0.0.24开始。

适配指导

在http、延时或者子窗口中弹toast，可能不会显示toast，并且日志中能看到窗口返回11的错误码，此时就需要用户自行指定上下文，代码如下

import promptAction from '@ohos.promptAction';
import http from '@ohos.net.http';

@Entry
@Component
struct Index {
  @State message: string = '点这里会弹个toast';

  build() {
    Row() {
      Button() {
        Text(this.message)
          .fontSize(20)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
      .onClick(()=>{
        let httpRequest = http.createHttp()
        let uiContext = this.getUIContext()
        httpRequest.request('https://xxx.com', { method: http.RequestMethod.GET }).then((res: http.HttpResponse) => {
          let promptAction1 = uiContext.getPromptAction()
          promptAction1.showToast({
            message:"ok，我是toast",
            duration:1000,
            showMode: promptAction.ToastShowMode.TOP_MOST
          })
        }).catch((err: Error)=>{
          let promptAction1 = uiContext.getPromptAction()
          promptAction1.showToast({
            message:"error，我是toast",
            duration:1000,
            showMode: promptAction.ToastShowMode.TOP_MOST
          })
          httpRequest.destroy()
        })
      })
    }
    .height('100%')
  }
}

cl.arkui.4 backgroundImagePosition传入参数默认单位规格变更

访问级别

公开接口

变更原因

接口默认单位值与文档描述不符。

变更影响

变更前：position类型传入的数字值，默认单位当作px。

变更后：position类型传入的数字值，默认单位当作vp。

起始API Level

该特性版本为API 7,变更版本为API 12。

变更发生版本

从OpenHarmony SDK 5.0.0.24开始。

适配指导

默认行为变更，无需适配，但应注意变更后的默认效果是否符合开发者预期，如需设置px单位的值，可拼接成数字加px的字符串，或者px2vp后设置。

cl.arkui.5 RicEditor组件RichEditorTextStyle通用属性默认值变更

访问级别

公开接口

变更原因

UX规格增强

变更影响

该变更为非兼容性变更。

  1. 修改RichEditorTextStyle通用属性中设置字体大小为0时的字体显示大小

变更前，设置字体大小为0时內容不显示；

变更后，设置字体大小为0时，显示为默认字体大小16fp。

  1. 修改RichEditorTextStyle通用属性中默认字体颜色

变更前，默认字体颜色是Color.Black；

变更后，默认字体颜色是是系统资源中的font_primary。

  1. 修改RichEditorTextStyle通用属性中默认字体颜色

变更前，默认装饰线颜色是Color.Black；

变更后，默认装饰线颜色为跟随字体颜色。

起始API Level

10

变更发生版本

从OpenHarmony SDK 5.0.0.24开始。

适配指导

默认行为变更，无需适配，但应注意变更后的默认效果是否符合开发者预期，如不符合则自定义修改效果控制变量以达到预期。

cl.arkui.6 @Builder函数中使用自定义组件关于父子关系的变更

访问级别

公开接口

变更原因

在子组件中传入Builder函数时，子组件的this会指向Builder函数所在的父组件，在某种场景下会导致运行报错，所以进行变更。

变更影响

示例如下1：

@Entry
@Component
struct Index {
  @Builder thirdBuilder() {
    Third()
  }
  build() {
    Column() {
      Second({secondBuilder: this.thirdBuilder.bind(this)})
    }
  }
}

@Component
struct Second {
  @Provide message: string = 'Hello';
  @BuilderParam secondBuilder: ()=>void;
  build() {
    Column() {
      this.secondBuilder()
    }
  }
}

@Component
struct Third {
  @Consume message: string;
  build() {
    Column() {
      Text(this.message).fontSize(30)
    }
  }
}

变更前：

执行以上代码会报运行时错误

ScreenShot

变更后：

无报错

涉及场景示例

弹窗嵌套

@Builder
function customDialogBuilderFunc(){}

@CustomDialog
struct CustomDialogExampleTwo {
  @BuilderParam grandsonBuilderFunc: ()=>void;
  grandsonFunc: ()=>void = ()=>{};
  controllerTwo?: CustomDialogController;
  @State message: string = "I'm the second dialog box.";
  @State showIf: boolean = false;
  build() {
    Column() {
      this.grandsonBuilderFunc()
      Button("show/hide Text")
        .onClick(()=>{
          this.grandsonFunc()
        })
      Button ('Close Second Dialog Box')
        .onClick(() => {
          if (this.controllerTwo != undefined) {
            this.controllerTwo.close()
          }
        })
        .margin(20)
    }
  }
}

@CustomDialog
struct CustomDialogExample {
  @BuilderParam childBuilderFunc: ()=>void = customDialogBuilderFunc;
  childFunc: null|(()=>void) = null;
  dialogControllerTwo: CustomDialogController|null = new CustomDialogController({
    builder: CustomDialogExampleTwo({grandsonBuilderFunc: this.childBuilderFunc, grandsonFunc: this.childFunc!}),
    alignment: DialogAlignment.Bottom,
    offset: { dx: 0, dy: -25 } })
  controller?: CustomDialogController;

  build() {
    Column() {
      Button ('Open Second Dialog Box and close this box')
        .onClick(() => {
          this.controller!.close();
          this.dialogControllerTwo!.open();
        })
        .margin(20)
    }.borderRadius(10)
  }
}

@Entry
@Component
struct CustomDialogUser {
  @State inputValue: string = 'Click Me';
  @State styleFlag: boolean = false;
  @Builder parentBuilderFunc() {
    if (this.styleFlag) {
      Text(this.inputValue).fontSize(35)
    }
  }
  parentFunc() {
    this.styleFlag = !this.styleFlag;
  }
  dialogController: CustomDialogController|null = new CustomDialogController({
    builder: CustomDialogExample({childBuilderFunc: this.parentBuilderFunc.bind(this), childFunc: this.parentFunc.bind(this),}),
    cancel: this.exitApp,
    autoCancel: true,
    alignment: DialogAlignment.Bottom,
    offset: { dx: 0, dy: -20 },
    gridCount: 4,
    customStyle: false
  })


  aboutToDisappear() {
    this.dialogController = null;
  }

  onCancel() {
    console.info('Callback when the first button is clicked');
  }

  onAccept() {
    console.info('Callback when the second button is clicked');
  }

  exitApp() {
    console.info('Click the callback in the blank area');
  }
  build() {
    Column() {
      Button(this.inputValue)
        .onClick(() => {
          if (this.dialogController != null) {
            this.dialogController.open()
          }
        }).backgroundColor(0x317aff)
    }.width('100%').margin({ top: 5 })
  }
}

组件冻结

@Entry
@Component
struct Index {
  @Builder
  parentComponent() {
    Third()
  }
  build() {
    Column() {
      Second({childBuilderParam: this.parentComponent.bind(this)})
    }.width('100%').margin({ top: 5 })
  }
}

@Component({freezeWhenInactive: true})
struct Second {
  @BuilderParam childBuilderParam: ()=>void;
  build() {
    Column() {
      this.childBuilderParam();
    }.width('100%').margin({ top: 5 })
  }
}

@Component
struct Third {
  @State message: string = '111';
  build() {
    Column() {
      Text(this.message)
    }.width('100%').margin({ top: 5 })
  }
}

起始API Level

9

变更发生版本

从OpenHarmony SDK 5.0.0.24 版本开始。

变更的接口/组件

@Builder

适配指导

该变更为兼容性变更，无需适配。

cl.arkui.7 Menu组件radius接口边界值处理规则变更

访问级别

公开接口

变更原因

UX规格增强

变更影响

该变更为非兼容性变更。

变更前：当水平方向两个圆角半径之和的最大值大于等于菜单宽度时，菜单四个圆角均采用菜单默认圆角半径值；

变更后：当水平方向两个圆角半径之和的最大值大于菜单宽度，或垂直方向两个圆角半径之和的最大值大于菜单高度时，菜单四个圆角均采用菜单默认圆角半径值。

API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.24 版本开始。

变更的接口/组件

Menu组件中的radius接口

适配指导

若预期是使用菜单默认圆角，则无需给Menu组件设置radius属性； 若预期使用自定义圆角，可通过radius接口设置为自定义值，且自定义值不超出边界值。

cl.arkui.8 RichEditor的onWillChange、onDidChange接口规格变更

访问级别

公开接口

变更原因

接口能力增强

变更影响

该变更为非兼容性变更。

变更前：

OnWillChange回调函数的参数RichEditorChangeValue，是被替换的Span与新Span的信息。 OnDidChange回调函数的返回值是新Span的信息。

变更后：

OnWillChange回调函数的参数RichEditorChangeValue，是被替换内容的索引范围与新Span的信息。 OnDidChange回调函数的返回值，是被替换内容的索引范围与新内容的索引范围。

API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.24 版本开始。

变更的接口/组件

RichEditor的OnWillChange、OnDidChange接口。

适配指导

增强后的接口使用见接口文档

你可能感兴趣的鸿蒙文章

harmony 鸿蒙API模型转换清单

harmony 鸿蒙包管理子系统变更说明

harmony 鸿蒙媒体子系统Changelog

harmony 鸿蒙SDK子系统Changelog

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/qK4mfM