指南
打印机教程
使用 @capgo/capacitor-printer
Capacitor 打印插件，支持打印文档、HTML、PDF、图片和网页视图。
安装
bun add @capgo/capacitor-printer
bunx cap sync
此插件暴露的内容
printBase64- 提供打印 UI 打印 base64 编码的文件。printFile- 提供打印 UI 打印设备文件。printHtml- 提供打印 UI 打印 HTML 文档。printPdf- 提供打印 UI 打印 PDF 文档。
示例用途
printBase64
提供打印 UI 打印以 base64 编码的文件。
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
提供打印 UI 打印设备文件。
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
提供打印 UI 打印 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
提供打印 UI 打印 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/