501351981 /vue-office

支持word(.docx)、excel(.xlsx,.xls)、pdf、pptx等各类型office文件预览的vue组件集合,提供一站式office文件预览方案,支持vue2和3,也支持React等非Vue框架。Web-based pdf, excel, word, pptx preview library

★ 5,756⑂ 617👁 23⑃ 7● 506▤ 0
JavaScriptMITCreated 2022-11-09501351981.github.io/vue-office/examples/docs/
+0
Daily
5,756
stars
617
forks
23
watchers
7
prs
506
issues
0
releases

README

vue-office

支持多种文件(docx、excel、pdf、pptx)预览的vue组件库,支持vue2/3。也支持非Vue框架的预览。

《演示效果》

《使用非Vue框架(原生js、React等)、或者Vue里面报错,看这里》
 功能特色
- 一站式:提供word(.docx)、pdf、excel(.xlsx, .xls)、ppt(.pptx)多种文档的在线预览方案,有它就够了
- 简单:只需提供文档的src(网络地址)即可完成文档预览
- 体验好:选择每个文档的最佳预览方案,保证用户体验和性能都达到最佳状态
- 性能好:针对数据量较大做了优化

 安装
shell
docx文档预览组件
npm install @vue-office/docx [email protected]

excel文档预览组件
npm install @vue-office/excel [email protected]

pdf文档预览组件
npm install @vue-office/pdf [email protected]

pptx文档预览组件
npm install @vue-office/pptx [email protected]

如果是vue2.6版本或以下还需要额外安装 @vue/composition-api
shell
npm install @vue/composition-api


 使用示例

文档预览场景大致可以分为三种:
- 有文档CDN地址,比如 https://.docx,将文档地址字符串传给组件的src属性
- 通过接口请求获取文件内容,此时可以获取文件的ArrayBuffer或Blob格式数据传给组件的src属性
- 文件上传时预览,此时可以获取文件的ArrayBuffer或Blob格式数据传给组件的src属性


docx文件预览示例 (三种使用方式均有示例)

1. 使用网络地址预览
vue

    



//引入VueOfficeDocx组件
import VueOfficeDocx from '@vue-office/docx'
//引入相关样式
import '@vue-office/docx/lib/index.css'

export default {
    components:{
        VueOfficeDocx
    },
    data(){
        return {
            docx: 'http://static.shanhuxueyuan.com/test6.docx' //设置文档网络地址,可以是相对地址
        }
    },
    methods:{
        rendered(){
            console.log("渲染完成")
        }
    }
}



2. 上传文件预览

读取文件的ArrayBuffer
vue

    
        
        
    



import VueOfficeDocx from '@vue-office/docx'
import '@vue-office/docx/lib/index.css'

export default {
    components: {
        VueOfficeDocx
    },
    data(){
        return {
            src: ''
        }
    },
    methods:{
        changeHandle(event){
            let file = event.target.files[0]
            let fileReader = new FileReader()
            fileReader.readAsArrayBuffer(file)
            fileReader.onload =  () = {
                this.src = fileReader.result
            }
        }
    }
}



3. 二进制文件预览

如果后端给的不是CDN地址,而是一些POST接口,该接口返回二进制流,则可以调用接口获取文件的ArrayBuffer数据,传递给src属性。

vue

    



//引入VueOfficeDocx组件
import VueOfficeDocx from '@vue-office/docx'
//引入相关样式
import '@vue-office/docx/lib/index.css'

export default {
    components:{
        VueOfficeDocx
    },
    data(){
        return {
            docx: ''
        }
    },
    mounted(){
        fetch('你的API文件地址', {
            method: 'post'
        }).then(res={
            //读取文件的arrayBuffer
            res.arrayBuffer().then(res={
                this.docx = res
            })
        })
    },
    methods:{
        rendered(){
            console.log("渲染完成")
        }
    }
}






excel 文件预览示例 

通过网络地址预览示例如下,通过文件ArrayBuffer预览和上面docx的使用方式一致。
vue

    



//引入VueOfficeExcel组件
import VueOfficeExcel from '@vue-office/excel'
//引入相关样式
import '@vue-office/excel/lib/index.css'

export default {
    components: {
        VueOfficeExcel
    },
    data() {
        return {
            excel: 'http://static.shanhuxueyuan.com/demo/excel.xlsx'//设置文档地址
        }
    },
    methods: {
        renderedHandler() {
            console.log("渲染完成")
        },
        errorHandler() {
            console.log("渲染失败")
        

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON