简介

fs-file-preview 文件预览组件，基于 FsFrame（SSO 认证 iframe 容器）封装，用于在小程序中直接预览附件文件。

支持自动获取预览 URL，通过 FsFrame 渲染展示文件内容。

使用方式

在页面的 index.json 中声明组件：

{
  "usingComponents": {
    "fs-file-preview": "ava-ui/fxui/fs-file-preview/index"
  }
}

在 WXML 中使用：

<fs-file-preview
  path="{{filePath}}"
  ext="{{fileExt}}"
  previewUrl="{{previewUrl}}"
  isAliCloud="{{isAliCloud}}"
  height="100%"
  bind:load="onPreviewLoad"
/>

属性

属性	类型	默认值	必填	说明
path	String	''	是	文件路径（npath）
ext	String	''	否	文件扩展名（如 docx、png），path 无后缀时使用
filename	String	''	否	文件名称
previewUrl	String	''	否	预览 URL，传入后直接使用，无需自动获取
isAliCloud	Boolean	false	否	是否为阿里云存储
height	String	'100%'	否	预览区域高度

事件

事件名	说明	detail
load	FsFrame 加载成功	{ url }
message	收到 iframe 消息	iframe postMessage 内容

说明

1. 组件依赖 FsFrame 组件和 fs-hera-api，请确保项目已正确引入
2. 预览 URL 的获取支持两种模式：直接传入 previewUrl，或传入 path 由组件自动通过 npath2Url 获取
3. 阿里云存储的文件通过 dps/preview/getPreviewConfigV2 接口获取预览地址
4. 组件自带 SSO 登录处理（通过 FsFrame 的 login-iframe 组件）
5. path 和 ext 变化时自动重新解析预览 URL