sds-preview
v0.0.2
Published
基于Vue3+TypeScript+Vite实现的文件在线预览组件。基于开源组件file-viewer3,此包用于版本测试
Downloads
3
Maintainers
Readme
基于Vue3实现的文件在线预览 file-viewer
Vue3版本特性:
- 高质量的TypeScript代码重构模块,更加优雅的实现等你发现
- 使用极速响应的Vite架构,畅快开发
- 完全重构了部分模块,如Word,Excel,Pptx等组件
- 优化Excel主题颜色解析,完美还原Excel样式
- 优化Pptx响应速度,使用重用逻辑
- 优化Pptx加载项,解耦图表部分,待重构解耦相关NvD3依赖。
- 使用完全的组合式API构建应用,高性能低占用
- 解耦了样式依赖,FileViewer组件依赖父节点进行布局,自动填满
快速开始
1. 项目安装
npm install
2. 项目编译以及支持热加载的开发模式
npm run dev
3. 编译生产包并最小化文件资源
npm run build
4. 检测并修复 JavaScript 代码中的问题
npm run lint
集成指南
1. 项目引用集成
npm install --save sds-preview
常规情况下,请使用npm link
的方式进行集成。
假设您将本项目clone到了D:\Works\file-viewer
下,接下来请按照下面的步骤进行安装。
首先,打开命令行工具,cd [你的项目位置]
,然后执行npm link D:\Works\file-viewer
。最后,在您的项目中引用即可。
import { createApp } from 'vue'
import App from './App.vue'
import FileViewer from 'sds-preview'
createApp(App).use(FileViewer)
.mount('#app')
然后,只需要在您的项目中直接使用组件即可。
注意:您需要自己定义好预览器的父元素,预览器默认会占满父元素。
示例如下,该示例定义了一个全屏的预览控件,并传入了一个url用于展示:
<script setup lang='ts'>
import { onMounted, ref } from 'vue'
const url = ref<string>()
onMounted(() => {
url.value = 'http://flyfish.group/%E6%95%B0%E6%8D%AE%E4%B8%AD%E5%8F%B0%E7%AC%94%E8%AE%B0(1).docx';
})
</script>
<template>
<div class='simple-view'>
<file-viewer :url="url" />
</div>
</template>
<style scoped>
.simple-view {
height: 100vh;
}
</style>
此外,组件还支持直接传入文件或者二进制进行展示。具体请查看HelloWord.vue
。
2. 使用iframe集成(推荐)
注:本部分示例代码位于master
分支。
开发集成:
- 请按照“快速开始”章节运行您的示例项目
- 打开
example
文件夹中的embedded.html
,修改目标地址为本地调试地址
var context = {
// 查看器的源,当前示例为在线,本地测试请改为 http://localhost:8900
origin: 'http://localhost:8900',
// 目标frame
frame: null,
// 文件url
url: './word.docx'
};
- 直接打开该文件或者使用本地web服务访问。
- 具体请参考demo代码,原理是基于
iframe
跨域通信机制。
![image-20230228161454443](/Users/wangyu/Library/Application Support/typora-user-images/image-20230228161454443.png)