使用 @capgo/capacitor-printer
使用 Capacitor 插件打印文档、HTML、PDF、图片及 Web View。
安装
bun add @capgo/capacitor-printer
bunx cap sync
插件暴露的内容
printBase64- 调用打印界面以打印 base64 编码的字符串。printFile- 调用打印界面以打印设备本地文件。printHtml- 调用打印界面以打印 HTML 文档。printPdf- 提供用于打印 PDF 文档的打印界面。
用法示例
printBase64
展示用于打印 base64 编码文件的打印 UI。
import { Printer } from '@capgo/capacitor-printer';
// Print a base64 encoded PDF
await Printer.printBase64({
name: 'Invoice #12345',
data: 'base64-encoded-pdf-data',
mimeType: 'application/pdf',
});
// Print a base64 encoded image
await Printer.printBase64({
name: 'Product Photo',
data: '/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDA...',
mimeType: 'image/jpeg',
});
printFile
提供用于打印设备文件的打印界面。
import { Printer } from '@capgo/capacitor-printer';
// iOS: Print from app documents directory
await Printer.printFile({
name: 'Contract',
path: 'file:///var/mobile/Containers/Data/Application/.../Documents/contract.pdf',
});
// Android: Print from content URI
await Printer.printFile({
name: 'Receipt',
path: 'content://com.android.providers.downloads.documents/document/123',
mimeType: 'application/pdf',
});
// Android: Print from file path
await Printer.printFile({
name: 'Photo',
path: 'file:///storage/emulated/0/Download/photo.jpg',
mimeType: 'image/jpeg',
});
printHtml
提供用于打印 HTML 文档的打印界面。
import { Printer } from '@capgo/capacitor-printer';
// Simple HTML document
await Printer.printHtml({
name: 'Sales Report',
html: '<html><body><h1>Q4 Sales Report</h1><p>Revenue: $125,000</p></body></html>',
});
// HTML with print-specific CSS
await Printer.printHtml({
name: 'Styled Invoice',
html: `
<html>
<head>
<style>
printPdf
提供用于打印 PDF 文档的打印界面。
import { Printer } from '@capgo/capacitor-printer';
// Print PDF from app storage
await Printer.printPdf({
name: 'Annual Report 2024',
path: 'file:///var/mobile/Containers/Data/Application/.../Documents/report.pdf',
});
// Print PDF from Android downloads
await Printer.printPdf({
name: 'Downloaded Document',
path: 'content://com.android.providers.downloads.documents/document/123',
});
完整参考
- GitHub: https://github.com/Cap-go/capacitor-printer/
- 文档: /docs/plugins/printer/
继续学习 使用 @capgo/capacitor-printer
如果你正在使用 使用 @capgo/capacitor-printer 要规划原生插件工作，请将其与 @capgo/capacitor-printer 有关 @capgo/capacitor-printer 的实现细节， 快速入门 有关“入门指南”中的实现细节， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节，以及 添加或更新插件 有关“添加或更新插件”的实现细节。