ArkUI子系统Changelog

cl.arkui.1 属性字符串TextStyle类型fontStyle、fontWeight字段返回类型变更

访问级别

公开接口

变更原因

接口实际行为与文档描述不一致。

变更影响

此变更涉及应用适配。

起始API Level

接口起始版本为API version 12。

变更发生版本

从OpenHarmony SDK 5.1.0.49开始，API version 18及以上生效。

变更的接口/组件

属性字符串的getStyles接口。

适配指导

变更后，使用getStyles接口获得的TextStyle类型变量中fontStyle、fontWeight字段将会返回FontStyle和number类型而非之前的string类型，应用需要使用新的返回类型来进行判断。

@Entry
@Component
struct styled_string_demo1 {
  scroll: Scroller = new Scroller();
  fontStyleAttr1: TextStyle = new TextStyle({ fontColor: Color.Blue, fontWeight: FontWeight.Bolder, fontStyle: FontStyle.Normal });
  fontStyleAttr2: StyledStringValue = new TextStyle({ fontColor: Color.Orange, fontStyle: FontStyle.Italic, fontWeight: FontWeight.Lighter });
  mutableStyledString1: MutableStyledString = new MutableStyledString("运动45分钟", [{
    start: 0,
    length: 3,
    styledKey: StyledStringKey.FONT,
    styledValue: this.fontStyleAttr1
  }, {
    start: 3,
    length: 3,
    styledKey: StyledStringKey.FONT,
    styledValue: this.fontStyleAttr2
  }]);
  controller1: TextController = new TextController();

  build() {
    Column() {
      Scroll(this.scroll) {
        Column() {
          // 显示属性字符串
          Text(undefined, { controller: this.controller1 })
            .onAppear(() => {
              this.controller1.setStyledString(this.mutableStyledString1)
            })

          Button('查询样式')
            .onClick(() => {
              let styles = this.mutableStyledString1.getStyles(0, this.mutableStyledString1.length)
              for (let i = 0; i < styles.length; i++) {
                console.info('StyledString style object start:' + styles[i].start)
                console.info('StyledString style object length:' + styles[i].length)
                console.info('StyledString style object key:' + styles[i].styledKey)
                if (styles[i].styledKey === 0) {
                  let fontAttr = styles[i].styledValue as TextStyle;
                  console.info('StyledString fontStyle type:' + typeof fontAttr.fontStyle)
                  console.info('StyledString fontWeight type:' + typeof fontAttr.fontWeight)
                }
              }
            })
            .margin({ top: 10 })
        }.width('100%')
      }
    }
    .width('100%')
  }
}

cl.arkui.2 CanvasRenderer的measureText方法传undefined参数时返回值变更

访问级别

公开接口

变更原因

measureText方法传undefined参数时，返回的textMetrics为undefined，和W3C标准行为不一致。

变更影响

变更前： measureText方法传undefined参数时，返回的textMetrics为undefined。

变更后： measureText方法传undefined参数时，返回值为按照字符串”undefined”测量的textMetrics。

起始API Level

API 8

变更发生版本

从OpenHarmony SDK 5.1.0.49开始。

变更的接口/组件

CanvasRenderingContext2D和OffscreenCanvasRenderingContext2D的measureText方法

适配指导

如果应用无需获取undefined参数的textMetrics，可在调用measureText方法前对参数做判断。

示例

@Entry
@Component
struct Demo {
  private settings: RenderingContextSettings = new RenderingContextSettings(true)
  private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)

  measureText(text: string)
  {
    if (text != undefined) {
      let metrics = this.context.measureText(text);
      console.info('width = ' + metrics.width);
    }
  }

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Canvas(this.context)
        .width('100%')
        .height('100%')
        .onReady(() => {
          this.measureText(undefined)
          this.measureText('Hello World')
        })
    }
    .width('100%')
    .height('100%')
  }
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙全球化子系统Changelog