sds-preview

基于Vue3实现的文件在线预览 file-viewer

Vue3版本特性：

1. 高质量的TypeScript代码重构模块，更加优雅的实现等你发现
2. 使用极速响应的Vite架构，畅快开发
3. 完全重构了部分模块，如Word，Excel，Pptx等组件
4. 优化Excel主题颜色解析，完美还原Excel样式
5. 优化Pptx响应速度，使用重用逻辑
6. 优化Pptx加载项，解耦图表部分，待重构解耦相关NvD3依赖。
7. 使用完全的组合式API构建应用，高性能低占用
8. 解耦了样式依赖，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分支。

开发集成：

1. 请按照“快速开始”章节运行您的示例项目
2. 打开example文件夹中的embedded.html，修改目标地址为本地调试地址

var context = {
    // 查看器的源，当前示例为在线，本地测试请改为 http://localhost:8900
    origin: 'http://localhost:8900',
    // 目标frame
    frame: null,
    // 文件url
    url: './word.docx'
};

3. 直接打开该文件或者使用本地web服务访问。
4. 具体请参考demo代码，原理是基于iframe跨域通信机制。