鸿蒙跨设备协同开发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
标签
RichEditor
跨设备
相关推荐
鸿蒙UI系统组件16——富文本编辑器(RichEditor)
蓝亭书序
0
0鸿蒙跨设备协同开发01——跨设备获取照片
蓝亭书序
0
0华为鸿蒙走进企查查研发总部,企查查加快数据产品研发
向阳yyy
0
0从技术突破到产业共生,鸿蒙生态进入价值释放期
0
0鸿蒙星光盛典将于12月5日举行,讲述中国操作系统的成长与共创
112
0
蓝亭书序
我还没有写个人简介......
75
帖子
0
提问
236
粉丝
最新发布
鸿蒙跨设备协同开发02——RichEditor跨设备获取文件
2026-11-04 13:37:56 发布鸿蒙UI系统组件16——富文本编辑器(RichEditor)
2026-11-04 13:37:20 发布热门推荐
相关问题




京公网安备:11010502051901号