logo
积分中心
鸿蒙跨设备协同开发02——RichEditor跨设备获取文件
头像 蓝亭书序 2026-11-04 13:37:56    发布
0 浏览 0 点赞 0 收藏

1、前言

鸿蒙UI系统组件16——富文本编辑器(RichEditor)内容选中、用户预设样式、背景板高亮等。

除此之外,RichEditor组件还集成了另一种重要功能 —— 跨设备互通能力,通过使用富文本控件RichEditor的右键菜单即可使用跨设备互通能力。跨设备互通提供跨设备的相机、扫描、图库访问能力,平板或2in1设备可以调用手机的相机、扫描、图库等功能。

需要注意的是,RichEditor默认集成了跨设备互通能力,因此,如果我们想使用跨设备能力时,不需要额外做配置和开发,只需要设置对应的回调监听即可。

2、实现跨设备获取文件

默认情况下RichEditor已经支持了跨设备互通的能力,我们使用时只需要设置onWillChange即可。在onWillChange中处理跨设备回传的文件。

onWillChange接口定义如下:


onWillChange(callback: Callback<RichEditorChangeValue, boolean>)


其中,RichEditorChangeValue  类相关的定义总结如下:

图片

一个处理示例代码如下:


@Entry
@Component
struct Index {
  controller: RichEditorController = new RichEditorController()
  options: RichEditorOptions = { controller: this.controller }

  build() {
    Column() {
      Column() {
        RichEditor(this.options)
          .onWillChange((value: RichEditorChangeValue) => {
            if (value.replacedImageSpans[0].imageStyle.objectFit != 0) {
              return true;
            }
            for(let item of value.replacedImageSpans) {
              this.controller.addImageSpan(item.valuePixelMap, {
                imageStyle: {
                  size: ["500px", "500px"],
                  layoutStyle: {
                    borderRadius: '10px',
                  }
                }
              })
            }
            return false;
          })
          .borderWidth(1)
          .borderColor(Color.Green)
          .width("100%")
          .height("100%")
      }
      .borderWidth(1)
      .borderColor(Color.Red)
      .width("100%")
      .height("70%")
    }
  }
}


使用效果如下图:

图片

👉🏻 如果你希望关闭跨设备互通能力

如果需要关闭富文本右键菜单跨设备互通能力,可通过editMenuOptions属性自定义菜单内容去除跨设备互通菜单项即可规避,示例如下:


@Entry
@Component
struct Index {
  controller: RichEditorController = new RichEditorController()
  options: RichEditorOptions = { controller: this.controller }

  build() {
    Column() {
      Column() {
        RichEditor(this.options)
          .editMenuOptions({
            onCreateMenu: (menuItems: Array<TextMenuItem>) => {
              if (menuItems.length === 0) {
                return menuItems;
              }
              let newMenuItems: TextMenuItem[] = [];
              // 去除跨设备互通菜单
              menuItems.forEach((item, index) => {
                if(!item.id.equals(TextMenuItemId.COLLABORATION_SERVICE)) {
                  newMenuItems.push(item);
                }
              })
              return newMenuItems;
            },
            onMenuItemClick: (menuItem: TextMenuItem, textRange: TextRange) => {
              return false;
            }
          })
          .borderWidth(1)
          .borderColor(Color.Green)
          .width("100%")
          .height("100%")
      }
      .borderWidth(1)
      .borderColor(Color.Red)
      .width("100%")
      .height("70%")
    }
  }
}



©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS
地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255