更新记录

1.0.3（2026-06-11）

1. 修复预览excel时高度撑开兼容性问题

1.0.2（2026-05-18）

1. 优化鸿蒙

1.0.1（2026-05-16）

• 支持预览pdf、word、excel、ppt、md、txt等文件
• 支持本地文件和云端文件
• 支持uniapp、uniapp-x
• 支持自定义UI
• 支持苹果、安卓、鸿蒙

平台兼容性

uni-app(3.7.12)

uni-app x(3.7.12)

其他

预览pdf、word、excel、ppt、md、txt、视频等文件，支持3端

功能介绍

• 支持预览pdf、word、excel、ppt、md、txt、视频等文件
• 支持本地文件和云端文件
• 支持uniapp、uniapp-x
• 支持自定义UI
• 支持苹果、安卓、鸿蒙

集成步骤

1. 拷贝demo里的AndroidManifest.xml、harmony-configs文件到项目根目录
2. 本页面右上角可以点击"使用HBuilderX导入示例项目"下载demo，导入demo的时候选vue3,插件支持vue2和vue3
3. 插件详细集成步骤可以参考https://www.jianshu.com/p/c1615a7880a7
4. 如需定制或增加功能请点击插件标题下方的"进入交流群"私聊作者

组件

        <!--  #ifdef  APP-HARMONY -->
<embed :style="'width:'+width+'px;height:'+height+'px;'" tag="viewfile" :options="options"
    @onevent="onEvent"></embed>
<!--  #endif -->
<!--  #ifndef  APP-HARMONY -->
<wrs-uts-viewfile ref='videoplayer' :params="params" :style="'width:'+width+'px;height:'+height+'px;'"
    @onLoadView="onLoadView" @onEvent="onEvent"></wrs-uts-viewfile>
<!--  #endif -->

• 使用了该组件的页面需要用nvue或uvue

• 通过修改绑定的属性来切换预览文件

建议将云端文件下载到本地再渲染，方便控制云端文件的下载进度

let url = "http://www.xxxx" // 支持云端文件和本地文件(本地文件传文件的绝对路径,如/xxx/xxx/xxx.pdf)
let params = {}
params.businessArray = [{
    business: "renderFile", // 渲染文件业务
    params: {
        url: url
    }
}]
let paramsStr = JSON.stringify(params)
return {
    fileWebPath: fileWebPath,
    width: windowWidth,
    height: height,
    params: paramsStr,
    options: {
        params: paramsStr
    },
    title: 'Hello'
}

• 事件

            onEvent(event) {
    console.log("onEvent:" + JSON.stringify(event))
    let detail = event.detail 
    let opt = detail.opt
    switch (opt){
        case "onRender":
        {
            console.log("渲染成功")
        }
            break;
        case "onError": {
            let msg = detail.msg 
            console.log("渲染失败")
        }
        default:
            break;
    }
},