搜索插件、代码仓与 APP 分类

插件详情v0.4.1

flutter_to_pdf

一个将任何 Flutter 小部件导出为 PDF 文档、PDF 页面或 PDF 文件的包。通过导出选项可以进一步自定义导出过程。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
5470
喜欢数
80
Pub 分数
150

安装插件

flutter pub add flutter_to_pdf

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

flutter_to_pdf 是一个 Flutter 包,可让开发者将任何 Flutter widget 转换为 PDF 文档、页面或文件。它通过可配置选项支持广泛的导出过程自定义,非常适合生成报告、发票和可打印内容。该包可在所有主要平台(包括 Android、iOS、Web、macOS、Windows 和 Linux)上运行,确保在不同目标环境中输出一致。

适合场景

  • 生成可打印的报告
  • 创建发票和收据
  • 导出表单和文档
  • 从动态 UI 生成 PDF
  • 共享由 Flutter 生成的内容作为 PDF

主要特点

  • 将任何 Flutter 小部件转换为 PDF
  • 可自定义的导出选项
  • 跨平台支持
  • 支持多种输出格式
  • 高质量渲染
  • 与现有代码的轻松集成

适合对象

  • 开发文档密集型应用的开发者
  • 需要打印就绪输出的应用程序
  • 需要PDF生成的业务应用
  • 带有可下载内容的教育工具
  • 具有报告功能的网页和移动应用

使用建议

  • 性能可能因复杂控件而异
  • 大型 PDF 文件可能会影响内存使用
  • 需要仔细处理字体和图像
  • 有限的原生PDF编辑功能
  • 可能需要额外配置以支持高级布局

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

codecov Pub

The FlutterToPDF package lets you export any Flutter widget to PDF Documents and is written natively in Dart.

Installing

Depend on it

Run this command:

$ flutter pub add flutter_to_pdf

This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):

dependencies:
  flutter_to_pdf: ^0.4.1

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

Import it

Now in your Dart code, you can use:

import 'package:flutter_to_pdf/flutter_to_pdf.dart';

Features

  • export to PDF Document
  • export to PDF Page
  • export to PDF Widget
  • export with options
    • Page format options
    • Text field options
    • Checkbox options

Usage

Create an instance of the ExportDelegate, wrap your widget with a ExportFrame widget and provide a frameId, as well as the exportDelegate.

When you want to export the widget call the desired export function (either exportToPdfDocument, exportToPdfPage or exportToPdfWidget) and pass in the frameId.

// create instance of ExportDelegate
final ExportDelegate exportDelegate = ExportDelegate();

ExportFrame(
  frameId: 'someFrameId',
  exportDelegate: exportDelegate,
  child: SomeWidget(), // the widget you want to export
)

// export the frame to a PDF Document
final pdf = await exportDelegate.exportToPdfDocument('someFrameId');

// export the frame to a PDF Page
final page = await exportDelegate.exportToPdfPage('someFrameId');

// export the frame to a PDF Widget
final widget = await exportDelegate.exportToPdfWidget('someFrameId');

Note: If you wish to use types on the variables pdf, page and widget, you can use the Document, Page and Widget classes provided by PDF-package.

Custom TTF Fonts

If the widget you want to export contains any custom TTF fonts, you must provide the used ttfFonts to the ExportDelegate.

final ExportDelegate exportDelegate = ExportDelegate(
  ttfFonts: {
    'SomeFontFamily': 'assets/fonts/someFont.ttf',
  },
);
TextFields and Checkboxes

If the widget you want to export contains any TextField, TextFormField or Checkbox, a unique Key must be provided to each TextField, TextFormField and Checkbox.

TextField(
  key: Key('someUniqueTextFieldKey'),
  controller: TextEditingController(),
  ...
)

Checkbox(
  key: Key('someUniqueCheckboxKey'),
  value: false,
  ...
)
Other widgets like CustomPaint and Charts

If the widget you want to export contains any custom widgets like CustomPaint or Charts, the widgets you want to export must be wrapped in a CaptureWrapper widget. Furthermore, the CaptureWrapper must have a unique Key. These widgets will then be captured as an image and exported to the PDF Document.

CaptureWrapper(
  key: const Key('someUniqueCustomPaintKey'),
  child: CustomPaint(
    size: const Size(300, 300),
    painter: SomePainter(),
  ),
)

Export Options

The ExportDelegate´s constructor has a named optional parameter options which can be used to customize the export process.

final ExportOptions options = ExportOptions(
  pageFormatOptions: PageFormatOptions.a3(),
  textFieldOptions: TextFieldOptions.uniform(
    interactive: false,
  ),
  checkboxOptions: CheckboxOptions.uniform(
    interactive: false,
  ),
);

final ExportDelegate exportDelegate = ExportDelegate(options: options);

The ExportDelegate´s options can also be overriden using the named optional parameter overrideOptions in the export function.

final ExportOptions options = ExportOptions(
  pageFormatOptions: PageFormatOptions.a3(),
  textFieldOptions: TextFieldOptions.uniform(
    interactive: false,
  ),
  checkboxOptions: CheckboxOptions.uniform(
    interactive: false,
  ),
);

final ExportDelegate exportDelegate = ExportDelegate(options: options);

final ExportOptions overrideOptions = ExportOptions(
  pageFormatOptions: PageFormatOptions.a4(),
  textFieldOptions: TextFieldOptions.uniform(
    interactive: true,
  ),
  checkboxOptions: CheckboxOptions.uniform(
    interactive: true,
  ),
);

// export the frame to a PDF Document, using the override options
final pdf = await exportDelegate.exportToPdfDocument('someFrameId', overrideOptions: overrideOptions);

// export the frame to a PDF Page, using the override options
final page = await exportDelegate.exportToPdfPage('someFrameId', overrideOptions: overrideOptions);

// export the frame to a PDF Widget, using the override options
final widget = await exportDelegate.exportToPdfWidget('someFrameId', overrideOptions: overrideOptions);
Page Format Options

The PageFormatOptions class can be used to customize the page format of the exported PDF Document.

All constructors have an optional parameter clip which can be used to define if the content of the page should be clipped to the page format. The default value is true.

For the PageFormatOptions class there are several predefined constructors available:

  • PageFormatOptions.a3 - A3 page format
  • PageFormatOptions.a4 - A4 page format
  • PageFormatOptions.a5 - A5 page format
  • PageFormatOptions.a6 - A6 page format
  • PageFormatOptions.letter - Letter page format
  • PageFormatOptions.legal - Legal page format
  • PageFormatOptions.roll57 - Roll57 page format
  • PageFormatOptions.roll80 - Roll80 page format
  • PageFormatOptions.custom - Custom page format

    The custom page format can be used to define a custom page format.
    It therefore requires at least the width parameter, and has the following optional parameters: height, marginTop, marginBottom, marginLeft, marginRight and marginAll.

Text Field Options

The TextFieldOptions class can be used to customize the text fields of the exported PDF Document.

All constructors have an optional parameter interactive which can be used to define if the text fields should be interactive. The default value is true. If interactive is set to false, the text fields will be rendered as Text.

For the TextFieldOptions class there are several predefined constructors available:

  • TextFieldOptions.uniform - Uniform text field options

    The uniform text field options can be used to define a uniform TextStyle for all text fields.
    It therefore has an optional parameter textstyle which can be used to define a custom TextStyle for all text fields.

  • TextFieldOptions.individual - Individual text field options

    The individual text field options can be used to define an individual TextStyle for each text field.
    It has an optional parameter styleMap which maps the textfield´s Key to a TextStyle.
    Note: The TextField therefore requires a Key to be able to map the TextStyle to the text field.

  • TextFieldOptions.none - No text field options

    The text fields will be interactive and will be styled as found in the widget tree.

Checkbox Options

The CheckboxOptions class can be used to customize the checkboxes of the exported PDF Document.

All constructors have an optional parameter interactive which can be used to define if the checkboxes should be interactive. The default value is true. If interactive is set to false, the checkboxes will be rendered as a Container and will not be clickable.

For the CheckboxOptions class there are several predefined constructors available:

  • CheckboxOptions.uniform - Uniform checkbox options

    The uniform checkbox options can be used to define a uniform BoxDecoration for all checkboxes.
    It therefore has an optional parameter boxDecoration which can be used to define a custom BoxDecoration for all checkboxes.

  • CheckboxOptions.individual - Individual checkbox options

    The individual checkbox options can be used to define an individual BoxDecoration for each checkbox.
    It has an optional parameter decorationMap which maps the checkbox´s Key to a BoxDecoration.
    Note: The Checkbox therefore requires a Key to be able to map the BoxDecoration to the checkbox.

  • CheckboxOptions.none - No checkbox options

    The checkboxes will be interactive and will be styled as found in the widget tree.

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目

暂无相关数据。