flutter_quill_to_pdf 2.1.11 flutter_quill_to_pdf: ^2.1.11 copied to clipboard
Create PDF'S using deltas from Quill, with configurable attributes, fonts, and custom pdf widgets
Flutter Quill to PDF #
This package allow us create PDF's using Deltas
from Quill
.
Some options that can be configured:
DeltaAttributesOptions
(this attributes will be applied to whole delta)- We can use custom fonts. Using
onRequestFont
functions inPDFConverter
we can detect the font family detected, and use a custom implementation to return aFont
valid topdf
package Just works automatically with the default library implementation CustomWidget
, which helps you create customPDF
widgets using theParagraph
implementation fromflutter_quill_delta_easy_parser
.- Optional front matter and back matter
- Page format using
PDFPageFormat
class PDFWidgetBuilder
functions inPDFConverter
that let us customize the detected style, and create a custom pdf widget implementationThemeData
optional theme data that let us changes the theme for to pdf document
By default, the delta is processed by a local implementation that uses
DeltaAttributesOptions
to apply custom attributes (if it is not null), making it easier to add an attribute to the entire delta. If you want to create your own implementation or simply use a default delta, usePDFConverter(...params).createDocument(shouldProcessDeltas: false)
.
Tap to show/hide screenshots
Add dependencies #
dependencies:
flutter_quill_to_pdf: ^2.1.11
Import package #
import 'package:flutter_quill_to_pdf/flutter_quill_to_pdf.dart':
Personalize the settings of the page (height, width and margins) #
We can use two types differents constructors of the same PDFPageFormat
class
The common, with all set params:
final PDFPageFormat pageFormat = PDFPageFormat(
width: ..., //max width of the page
height: ..., //max height of the page,
marginTop: ...,
marginBottom: ...,
marginLeft: ...,
marginRight: ...,
);
The factory to marginize all PDFPageFormat
final PDFPageFormat pageFormat = PDFPageFormat.all(
width: ..., //max width of the page
height: ..., //max height of the page,
margin: ..., //will set the property to the others margins
);
Using PDFConverter to create finally our document #
PDFConverter pdfConverter = PDFConverter(
backMatterDelta: null,
frontMatterDelta: null,
document: QuillController.basic().document.toDelta(),
fallbacks: [...your global fonts],
onRequestBoldFont: (String fontFamily) async {
// this is optional
...your local font implementation
},
onRequestBoldItalicFont: (String fontFamily) async {
// this is optional
...your local font implementation
},
onRequestFallbackFont: (String fontFamily) async {
// this is optional
...your local font implementation
},
onRequestItalicFont: (String fontFamily) async {
// this is optional
...your local font implementation
},
onRequestFont: (String fontFamily) async {
// this is optional
...your local font implementation
},
params: pageFormat,
);
To create it, we have two options : #
createDocument
returns the PDF document associated
final pw.Document? document = await pdfConverter.createDocument();
createDocumentFile
makes the same of the before one, write in the selected file path
// [isWeb] is used to know how save automatically the PDF generated
await pdfConverter.createDocumentFile(path: filepath, isWeb: kIsWeb,...other optional params);
Supported #
- Font family
- Size
- Bold
- Italic
- Strikethrough
- Underline
- Link
- Color
- Background Color
- Line-height (custom attribute used from this package)
- Code block
- Blockquote
- Align
- Embed image
- Embed video (Just the URL of the Video will be pasted as a text)
- Header
- List
- Indent
No supported #
- Superscript/Subscript (Not planned since is not supported by pdf package)
- Embed formula (Not planned)
You can contribute reporting issues or requesting to add new features on flutter_quill_to_pdf