2.7 KiB
2.7 KiB
DOCXviewer
控件功能：用于在网页中嵌入并显示 .docx 文档内容，通过 Mammoth.js 将 Word 文档转换为 HTML 并渲染。
类型：普通控件（继承自容器控件 VBox）
父类控件：bricks.VBox
初始化参数
| 参数名 | 类型 | 说明 |
|---|---|---|
url |
String | 指向 .docx 文件的 URL 地址，将在 on_parent 事件触发时加载 |
⚠️ 注意：需提前引入 Mammoth.js 库（如 CDN 资源）才能正常工作。
主要事件
| 事件名 | 触发时机 | 回调参数 | 说明 |
|---|---|---|---|
on_parent |
控件被添加到父容器后触发 | - | 自动调用 set_url(this.url) 开始加载并渲染文档 |
EXCELviewer
控件功能：用于查看 Excel 文件（.xlsx 或 .xls），支持多工作表切换展示表格数据。
类型：容器控件
父类控件：bricks.VBox
初始化参数
| 参数名 | 类型 | 说明 |
|---|---|---|
url |
String | 指向 Excel 文件的 URL 地址，在 on_parent 时加载 |
height |
String | 默认设置为 "100%"，确保高度占满父容器 |
主要事件
| 事件名 | 触发时机 | 回调参数 | 说明 |
|---|---|---|---|
on_parent |
控件挂载到父节点后 | - | 触发 set_url(url) 加载 Excel 数据 |
click（子 Text 控件） |
点击某个 sheet 标签时 | sheetname, widget | 切换并显示对应的工作表内容 |
✅ 支持特性：
- 动态生成工作表标签栏（HBox + Text）
- 可滚动区域展示表格 HTML 内容（VScrollPanel）
- 当前选中标签高亮（CSS 类
selected）
PDFviewer
控件功能：用于在页面中内嵌显示 PDF 文件，逐页渲染为 Canvas 图像。
类型：容器控件
父类控件：bricks.VBox
初始化参数
| 参数名 | 类型 | 说明 |
|---|---|---|
url |
String | PDF 文件的 URL 地址，由 set_url 使用 |
width |
String | 强制设为 '100%'，以适配父容器宽度 |
主要事件
| 事件名 | 触发时机 | 回调参数 | 说明 |
|---|---|---|---|
on_parent |
控件挂载完成后 | - | 调用 set_url() 启动 PDF 加载与渲染 |
| （内部 Promise） | PDF 成功加载后 | pdf 对象 | 遍历所有页调用 add_page_content(page) |
| （错误处理） | 加载失败时 | error | 输出 'error' 到控制台 |
✅ 渲染细节：
- 使用
pdfjsLib（Mozilla PDF.js）解析和绘制 PDF- 每页使用
<canvas>渲染，缩放比例固定为1.5- 页面之间插入
Splitter分隔条（视觉或布局用途）
⚠️ 注意：需确保全局已定义
pdfjsLib并正确配置。