npm - @ibiz-template-plugin/ibiz-file-previewer - Versions diffs - 0.0.5 → 0.0.7 - Mend

@ibiz-template-plugin/ibiz-file-previewer 0.0.5 → 0.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (56) hide show

package/README.md CHANGED Viewed

@@ -2,13 +2,13 @@
 ## 项目初始化
-1. 使用 Vite 创建 Vue 3 + TypeScript 项目
-2. 安装必要依赖：sass（SCSS 支持）、vue-tsc（TypeScript 类型检查）
+1. 使用 Vite 创建 preact + TypeScript 项目
+2. 安装必要依赖：sass（SCSS 支持）、tsc（TypeScript 类型检查）
 3. 配置项目结构，创建组件目录和样式目录
 ## 预览壳组件
-1. 创建 `file-preview-shell.vue` 组件
+1. 创建 `file-preview-shell.tsx` 组件
 2. 创建 `file-preview-controller.ts` 控制器模块
 3. 实现参数处理逻辑：
    - 接收 name、id、url 参数
@@ -25,7 +25,7 @@
    - 导出为 MD（非 MD 文件）
 6. 实现文件类型处理：
    - 基于文件后缀解析文件类型
-   - 支持 html、md、txt、json、pdf 等类型
+   - 基于文件类型计算文件引擎
    - 动态分发至对应预览组件
 7. 逻辑与 UI 分离：
    - 预览壳组件负责界面绘制
@@ -35,11 +35,11 @@
 | 参数名称              | 类型                                                         | 说明                                                         | 默认值 |
 | --------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------ |
-| theme                 | `'light' | 'dark'`                                           | 主题                                                         | 'dark' |
+| theme                 | `'light' \| 'dark'`                                           | 主题                                                         | 'dark' |
 | selector              | string                                                       | 预览组件的挂载点（必填）                                     | ---    |
-| getContent            | `(id: string,type: string,cat: string): Promise<string | object | undefined>` | 获取预览文件的内容，参数依次为：文件标识，文件类型，存储位置名称 | ---    |
-| getImgContent         | `(id: string, type: FileType, cat: string) => Promise<string>`   | 获取预览图片内容，参数依次为：文件标识，文件类型，存储目录        | ---    |
-| upLoadFileToOss       | `(url: string): Promise<{ id: string; name: string; cat: string } | undefined>` | 上传文件至oss，参数为上传路径                                | ---    |
+| getContent            | `(id: string,type: string,cat: string): Promise<string \| object \| undefined>` | 获取预览文件的内容，参数依次为：文件标识，文件类型，存储位置名称 | ---    |
+| getImgContent         | `(id: string, type: FileType, cat: string): Promise<string>` | 获取预览图片内容，参数依次为：文件标识，文件类型，存储目录，标准图片返回值必须为：图片url路径或者图片Base64内容，SVG图片必须为：图片html内容 | ---    |
+| upLoadFileToOss       | `(url: string): Promise<{ id: string; name: string; cat: string } \| undefined>` | 上传文件至oss，参数为上传路径                                | ---    |
 | downLoadFile          | `(id: string, name: string, cat: string): Promise<void>`     | 下载文件，参数依次为：文件标识，文件名称，存储位置名称       | ---    |
 | actionSuccessCallBack | `(type: string): Promise<void>`                              | 文件操作成功回调，参数为文件类型                             | ---    |
@@ -61,7 +61,7 @@
      PDF引擎类型：预览、缩略图、顺/逆时针旋转、上/下一页、引擎模式切换、显示模式切换、缩小/放大、重置、下载源文件
-     图片引擎类型：预览、顺/逆时针旋转、图片拖拽、显示模式切换、缩小/放大、重置、下载源文件、复制文本内容
+     IMG引擎类型：预览、顺/逆时针旋转、图片拖拽、显示模式切换、缩小/放大、重置、下载源文件、复制文本内容
 3. 逻辑与 UI 分离：
@@ -76,11 +76,49 @@
 ## 技术实现规范
 - 使用 TypeScript 实现类型安全的组件开发
-- 采用 Vue 3 Composition API 进行逻辑组织
 - 使用 SCSS 实现响应式样式及组件主题
 - 确保 HTML 结构语义化且符合可访问性标准
-## 文件预览支持
+## 文件引擎
+### MD引擎
+| 文件扩展名 | 支持情况 |
+| ---------- | -------- |
+| html       | 已支持   |
+| md         | 已支持   |
+### HTML引擎
+| 文件扩展名 | 支持情况 |
+| ---------- | -------- |
+| xls        | 已支持   |
+| xlsx       | 已支持   |
+| et         | 已支持   |
+| doc        | 已支持   |
+| docx       | 已支持   |
+| wps        | 已支持   |
+### TXT引擎
+| 文件扩展名 | 支持情况 |
+| ---------- | -------- |
+| txt        | 已支持   |
+| xml        | 已支持   |
+| json       | 已支持   |
+### PDF引擎
+| 文件扩展名 | 支持情况 |
+| ---------- | -------- |
+| pdf        | 已支持   |
+| doc        | 已支持   |
+| docx       | 已支持   |
+| wps        | 已支持   |
+| ppt        | 已支持   |
+| pptx       | 已支持   |
+### IMG引擎
 | 文件扩展名 | 支持情况 |
 | ---------- | -------- |
@@ -92,18 +130,5 @@
 | webp       | 已支持   |
 | ico        | 已支持   |
 | svg        | 已支持   |
-| xls        | 前端支持，后端未支持                       |
-| xlsx       | 前端支持，后端未支持                       |
-| et         | 前端支持，后端未支持（未找到该格式的文件）   |
-| html       | 已支持                                     |
-| md         | 已支持                                     |
-| json       | 前端支持，后端未支持                       |
-| xml        | 前端支持，后端未支持                       |
-| txt        | 前端支持，后端未支持                       |
-| pdf        | 已支持                                     |
-| doc        | 已支持                                     |
-| docx       | 已支持                                     |
-| wps        | 已支持                                     |
-| ppt        | 已支持                                     |
-| pptx       | 已支持                                     |
+**注意**：同一个文件扩展名可能有多个引擎，如：**doc**，**docx**，**wps** 等，这些文件均可通过切换引擎的方式更改预览内容