# DOM 截图与打印 ## 交互示例 ::: details 查看示例源码 <<< @/../admin/src/views/demo/hooks/web-hooks.tsx ::: ## useDomToImage `useDomToImage(target, options?)` 返回 `create(format?)`。调用时从元素、ref 或 getter 解析目标,缺省格式为 `jpeg`,`options.imageType` 设置默认值,单次 `create(format)` 优先。Promise 按格式推断返回值: | 格式 | 返回 | | -------------------- | --------------------- | | `jpeg`、`png`、`svg` | 数据 URL 字符串。 | | `blob` | `Blob \| null`。 | | `canvas` | `HTMLCanvasElement`。 | | `pixelData` | `Uint8ClampedArray`。 | `options` 也可传 html-to-image 的选项,如 `backgroundColor`、`pixelRatio`、`filter`。`beforeCreate(element)` 在目标检查前调用,`created(result, element)` 在成功后调用;回调的结果类型涵盖全部格式,应先检查类型。`createdError(error)` 接收错误,Promise 仍以 `Error` 拒绝;`finally(element)` 每次都会调用,目标未解析时可能为空。截图要在目标挂载后执行,跨域图片和字体需满足浏览器加载限制。 渲染库在第一次 `create` 时按需加载,未使用截图的页面无需下载该依赖。依赖加载失败也会进入上述错误和清理回调。 ```ts import { useDomToImage } from '@/hooks' import { ref } from 'vue' export function useReportImage() { const report = ref() const { create } = useDomToImage(report, { imageType: 'png', pixelRatio: 2 }) return { report, exportPng: () => create(), exportCanvas: () => create('canvas'), } } ``` ## usePrint `usePrint(target, options?)` 返回 `print()`,调用时解包目标。接受 DOM 目标、URL 或字符串、`Blob`、`Uint8ClampedArray`、对象数组。`UsePrintOptions` 是 print-js 配置中除 `printable` 外的字段。 - DOM 默认以 `html` 打印。字符串默认按 `pdf` 处理;图片 URL、JSON 数组请分别指定 `type: 'image'`、`type: 'json'`(JSON 同时传 `properties`)。 - 图片 MIME 的 Blob 默认以 `image` 处理,其他 Blob 和字节数组默认以 `pdf` 处理。二进制目标会先异步转为数据 URL,PDF 会去掉数据 URL 前缀。 - 空目标或空字符串直接返回。DOM 等同步分支返回 `void`,二进制转换分支返回 Promise;统一使用 `await print()` 可以捕获转换错误。成功发起打印流程无法确认纸张输出。 ```ts import { usePrint } from '@/hooks' import { ref } from 'vue' export function useReportPrint() { const report = ref() const { print } = usePrint(report, { type: 'html', documentTitle: '库存报表', }) return { report, print } } ``` TablePro 内置打印按当前页和可见列生成报表。要保留自定义业务排版,参考 [TablePro 打印](../table-pro#打印与-csv)。 源码:[useDomToImage](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/composables/src/useDomToImage.ts) · [usePrint](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/composables/src/usePrint.ts)