huypanha
/
flutter-quill
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Dev new doc (#1577)

Browse Source 
* Update README.md and the doc
pull/1601/head
Ellet 1 year ago committed by GitHub
parent c02699071a
commit 8f9b36ea2f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 127 additions and 161 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 22
      README.md
  2. 8
      doc/custom_embed_blocks.md
  3. 140
      doc/custom_toolbar.md
  4. 18
      doc/translation.md

22
README.md
Unescape View File

@ -96,10 +96,9 @@ dependencies:
<!-- Compatible versions: <!-- Compatible versions:
| flutter_quill | flutter_quill_extensions | flutter_quill_test | | flutter_quill | Flutter | Dart |
|-------------------------|--------------------------|-------------------------| |---------------|---------|-------|
| 8.6.x | 0.7.x | 0.0.5 | | 9.0.x | 3.16.x | 3.2.x |
| 8.5.x | 0.6.x | 0.0.5 |
These versions are tested and well-supported, you shouldn't get a build failure --> These versions are tested and well-supported, you shouldn't get a build failure -->
@ -126,24 +125,23 @@ connect the `QuillController` to them
using `QuillProvider` inherited widget using `QuillProvider` inherited widget
```dart ```dart
QuillProvider( QuillToolbar.simple(
configurations: QuillConfigurations( configurations: QuillSimpleToolbarConfigurations(
controller: _controller, controller: _controller,
sharedConfigurations: const QuillSharedConfigurations( sharedConfigurations: const QuillSharedConfigurations(
locale: Locale('de'), locale: Locale('de'),
), ),
), ),
child: Column( ),
children: [
const QuillToolbar(),
Expanded( Expanded(
child: QuillEditor.basic( child: QuillEditor.basic(
configurations: const QuillEditorConfigurations( configurations: QuillEditorConfigurations(
controller: _controller,
readOnly: false, readOnly: false,
sharedConfigurations: const QuillSharedConfigurations(
locale: Locale('de'),
), ),
), ),
)
],
), ),
) )
``` ```

8
doc/custom_embed_blocks.md
Unescape View File

@ -88,17 +88,13 @@ Future<void> _addEditNote(BuildContext context, {Document? document}) async {
) )
], ],
), ),
content: QuillProvider( content: QuillEditor.basic(
configurations: QuillConfigurations(
controller: quillEditorController,
),
child: QuillEditor.basic(
configurations: const QuillEditorConfigurations( configurations: const QuillEditorConfigurations(
controller: quillEditorController,
readOnly: false, readOnly: false,
), ),
), ),
), ),
),
); );
if (quillEditorController.document.isEmpty()) return; if (quillEditorController.document.isEmpty()) return;

140
doc/custom_toolbar.md
Unescape View File

@ -6,135 +6,109 @@ You can use the `QuillBaseToolbar` which is the base for the `QuillToolbar`
Example: Example:
```dart ```dart
QuillProvider( QuillToolbar(
configurations: QuillConfigurations( configurations: const QuillToolbarConfigurations(
controller: _controller, buttonOptions: QuillToolbarButtonOptions(
sharedConfigurations: const QuillSharedConfigurations(), base: QuillToolbarBaseButtonOptions(
globalIconSize: 20,
globalIconButtonFactor: 1.4,
), ),
child: Column( ),
),
child: SingleChildScrollView(
scrollDirection: Axis.horizontal,
child: Row(
children: [ children: [
QuillBaseToolbar( IconButton(
configurations: QuillBaseToolbarConfigurations( onPressed: () => context
toolbarSize: 15 * 2, .read<SettingsCubit>()
multiRowsDisplay: false, .updateSettings(
childrenBuilder: (context) { state.copyWith(useCustomQuillToolbar: false)),
final controller = context.requireQuillController; icon: const Icon(
return [ Icons.width_normal,
QuillToolbarImageButton( ),
controller: controller,
options: const QuillToolbarImageButtonOptions(),
), ),
QuillToolbarHistoryButton( QuillToolbarHistoryButton(
isUndo: true,
controller: controller, controller: controller,
options:
const QuillToolbarHistoryButtonOptions(isUndo: true),
), ),
QuillToolbarHistoryButton( QuillToolbarHistoryButton(
isUndo: false,
controller: controller, controller: controller,
options:
const QuillToolbarHistoryButtonOptions(isUndo: false),
), ),
QuillToolbarToggleStyleButton( QuillToolbarToggleStyleButton(
attribute: Attribute.bold, options: const QuillToolbarToggleStyleButtonOptions(),
controller: controller, controller: controller,
options: const QuillToolbarToggleStyleButtonOptions( attribute: Attribute.bold,
iconData: Icons.format_bold,
iconSize: 20,
),
), ),
QuillToolbarToggleStyleButton( QuillToolbarToggleStyleButton(
attribute: Attribute.italic, options: const QuillToolbarToggleStyleButtonOptions(),
controller: controller, controller: controller,
options: const QuillToolbarToggleStyleButtonOptions( attribute: Attribute.italic,
iconData: Icons.format_italic,
iconSize: 20,
),
), ),
QuillToolbarToggleStyleButton( QuillToolbarToggleStyleButton(
attribute: Attribute.underline,
controller: controller, controller: controller,
options: const QuillToolbarToggleStyleButtonOptions( attribute: Attribute.underline,
iconData: Icons.format_underline,
iconSize: 20,
),
), ),
QuillToolbarClearFormatButton( QuillToolbarClearFormatButton(
controller: controller, controller: controller,
options: const QuillToolbarClearFormatButtonOptions(
iconData: Icons.format_clear,
iconSize: 20,
), ),
const VerticalDivider(),
QuillToolbarImageButton(
controller: controller,
), ),
VerticalDivider( QuillToolbarCameraButton(
indent: 12, controller: controller,
endIndent: 12,
color: Colors.grey.shade400,
), ),
QuillToolbarSelectHeaderStyleButtons( QuillToolbarVideoButton(
controller: controller, controller: controller,
options: const QuillToolbarSelectHeaderStyleButtonsOptions(
iconSize: 20,
), ),
const VerticalDivider(),
QuillToolbarColorButton(
controller: controller,
isBackground: false,
), ),
QuillToolbarToggleStyleButton( QuillToolbarColorButton(
attribute: Attribute.ol,
controller: controller, controller: controller,
options: const QuillToolbarToggleStyleButtonOptions( isBackground: true,
iconData: Icons.format_list_numbered,
iconSize: 20,
), ),
const VerticalDivider(),
QuillToolbarSelectHeaderStyleButton(
controller: controller,
), ),
QuillToolbarToggleStyleButton( const VerticalDivider(),
attribute: Attribute.ul, QuillToolbarToggleCheckListButton(
controller: controller, controller: controller,
options: const QuillToolbarToggleStyleButtonOptions(
iconData: Icons.format_list_bulleted,
iconSize: 20,
), ),
QuillToolbarToggleStyleButton(
controller: controller,
attribute: Attribute.ol,
), ),
QuillToolbarToggleStyleButton( QuillToolbarToggleStyleButton(
attribute: Attribute.blockQuote,
controller: controller, controller: controller,
options: const QuillToolbarToggleStyleButtonOptions( attribute: Attribute.ul,
iconData: Icons.format_quote,
iconSize: 20,
), ),
QuillToolbarToggleStyleButton(
controller: controller,
attribute: Attribute.inlineCode,
), ),
VerticalDivider( QuillToolbarToggleStyleButton(
indent: 12, controller: controller,
endIndent: 12, attribute: Attribute.blockQuote,
color: Colors.grey.shade400,
), ),
QuillToolbarIndentButton( QuillToolbarIndentButton(
controller: controller, controller: controller,
isIncrease: true, isIncrease: true,
options: const QuillToolbarIndentButtonOptions( ),
iconData: Icons.format_indent_increase,
iconSize: 20,
)),
QuillToolbarIndentButton( QuillToolbarIndentButton(
controller: controller, controller: controller,
isIncrease: false, isIncrease: false,
options: const QuillToolbarIndentButtonOptions(
iconData: Icons.format_indent_decrease,
iconSize: 20,
),
),
];
},
), ),
), const VerticalDivider(),
Expanded( QuillToolbarLinkStyleButton(controller: controller),
child: QuillEditor.basic(
configurations: const QuillEditorConfigurations(
readOnly: false,
placeholder: 'Write your notes',
padding: EdgeInsets.all(16),
),
),
)
], ],
), ),
),
) )
``` ```

18
doc/translation.md
Unescape View File

@ -3,24 +3,22 @@
The package offers translations for the quill toolbar and editor, it will follow the locale that is defined in your `WidgetsApp` for example `MaterialApp` which usually follows the system locally unless you set your own locale with: The package offers translations for the quill toolbar and editor, it will follow the locale that is defined in your `WidgetsApp` for example `MaterialApp` which usually follows the system locally unless you set your own locale with:
```dart ```dart
QuillProvider( QuillToolbar.simple(
configurations: QuillConfigurations( configurations: QuillSimpleToolbarConfigurations(
controller: _controller, controller: _controller,
sharedConfigurations: const QuillSharedConfigurations( sharedConfigurations: const QuillSharedConfigurations(
locale: Locale('fr'), // will take affect only if FlutterQuillLocalizations.delegate is not defined in the Widget app locale: Locale('de'),
), ),
), ),
child: Column(
children: [
const QuillToolbar(
configurations: QuillToolbarConfigurations(),
), ),
Expanded( Expanded(
child: QuillEditor.basic( child: QuillEditor.basic(
configurations: const QuillEditorConfigurations(), configurations: QuillEditorConfigurations(
controller: _controller,
sharedConfigurations: const QuillSharedConfigurations(
locale: Locale('de'),
),
), ),
)
],
), ),
) )
``` ```

Write Preview
Loading…
Cancel
Save