Ellet
1 year ago
committed by
GitHub
parent
363437deaf
commit
c02699071a
196 changed files with 9714 additions and 3359 deletions
@ -1,3 +1,9 @@ |
|||||||
# Development notes |
# Development notes |
||||||
|
|
||||||
- When updating the translations or localizations in the app, please take a look at the [Translation](./translation.md) page as it has important notes in order to work, if you also add a feature that adds new localizations then you need to the instructions of it in order for the translations to take effect |
- When updating the translations or localizations in the app, please take a look at the [Translation](./translation.md) page as it has important notes in order to work, if you also add a feature that adds new localizations then you need to the instructions of it in order for the translations to take effect |
||||||
|
- Only update the `version.dart` and `CHANGELOG.md` at the root folder of the repo, then run the script: |
||||||
|
|
||||||
|
```console |
||||||
|
dart ./scripts/regenerate_versions.dart |
||||||
|
``` |
||||||
|
You must mention the changes of the other packages in the repo in the root `CHANGELOG.md` only and the script will replace the `CHANGELOG.md` in the other packages with the root one, and change the version in `pubspec.yaml` with the one in `version.dart` in the root folder |
||||||
@ -0,0 +1,429 @@ |
|||||||
|
We have refactored a lot of the base code to allow you to customize everything you want, and it allows us to add new configurations very easily using inherited widgets without passing configurations all over the constructors everywhere which will be very hard to test, fix bugs, and maintain |
||||||
|
|
||||||
|
1. Passing the controller |
||||||
|
|
||||||
|
The controller code (should be the same) |
||||||
|
```dart |
||||||
|
QuillController _controller = QuillController.basic(); |
||||||
|
``` |
||||||
|
|
||||||
|
**Old code**: |
||||||
|
```dart |
||||||
|
|
||||||
|
Column( |
||||||
|
children: [ |
||||||
|
QuillToolbar.basic(controller: _controller), |
||||||
|
Expanded( |
||||||
|
child: QuillEditor.basic( |
||||||
|
controller: _controller, |
||||||
|
readOnly: false, // true for view only mode |
||||||
|
), |
||||||
|
) |
||||||
|
], |
||||||
|
) |
||||||
|
|
||||||
|
``` |
||||||
|
|
||||||
|
**New code**: |
||||||
|
|
||||||
|
```dart |
||||||
|
QuillProvider( |
||||||
|
configurations: QuillConfigurations( |
||||||
|
controller: _controller, |
||||||
|
sharedConfigurations: const QuillSharedConfigurations(), |
||||||
|
), |
||||||
|
child: Column( |
||||||
|
children: [ |
||||||
|
const QuillToolbar(), |
||||||
|
Expanded( |
||||||
|
child: QuillEditor.basic( |
||||||
|
configurations: const QuillEditorConfigurations( |
||||||
|
readOnly: false, // true for view only mode |
||||||
|
), |
||||||
|
), |
||||||
|
) |
||||||
|
], |
||||||
|
), |
||||||
|
) |
||||||
|
``` |
||||||
|
|
||||||
|
The `QuillProvider` is an inherited widget that allows you to pass configurations once and use them in the children of it. here we are passing the `_controller` once in the configurations of `QuillProvider` and the `QuillToolbar` and `QuillEditor` will get the `QuillConfigurations` internally, if it doesn't exist you will get an exception. |
||||||
|
|
||||||
|
we also added the `sharedConfigurations` which allow you to configure shared things like the `Local` so you don't have to define them twice, we have removed those from the `QuillToolbar` and `QuillEditor` |
||||||
|
|
||||||
|
2. Regarding The QuillToolbar buttons, we have renamed almost all the buttons, examples: |
||||||
|
- `QuillHistory` to `QuillToolbarHistoryButton` |
||||||
|
- `IndentButton` to `QuillToolbarIndentButton` |
||||||
|
|
||||||
|
and they usually have two parameters, `controller` and `options`, for example the type for the buttons |
||||||
|
- `QuillToolbarHistoryButton` have `QuillToolbarHistoryButtonOptions` |
||||||
|
- `QuillToolbarIndentButton` have `QuillToolbarIndentButtonOptions` |
||||||
|
- `QuillToolbarClearFormatButton` have `QuillToolbarClearFormatButtonOptions` |
||||||
|
|
||||||
|
All the options have parent `QuillToolbarBaseButtonOptions` which have common things like |
||||||
|
|
||||||
|
```dart |
||||||
|
/// By default it will use Icon data from Icons that come from material |
||||||
|
/// library for each button, to change this, please pass a different value |
||||||
|
/// If there is no Icon in this button then pass null in the child class |
||||||
|
final IconData? iconData; |
||||||
|
|
||||||
|
/// To change the icon size pass a different value, by default will be |
||||||
|
/// [kDefaultIconSize]. |
||||||
|
/// This will be used for all the buttons but you can override this |
||||||
|
final double globalIconSize; |
||||||
|
|
||||||
|
/// The factor of how much larger the button is in relation to the icon, |
||||||
|
/// by default it will be [kIconButtonFactor]. |
||||||
|
final double globalIconButtonFactor; |
||||||
|
|
||||||
|
/// To do extra logic after pressing the button |
||||||
|
final VoidCallback? afterButtonPressed; |
||||||
|
|
||||||
|
/// By default it will use the default tooltip which already localized |
||||||
|
final String? tooltip; |
||||||
|
|
||||||
|
/// Use custom theme |
||||||
|
final QuillIconTheme? iconTheme; |
||||||
|
|
||||||
|
/// If you want to dispaly a differnet widget based using a builder |
||||||
|
final QuillToolbarButtonOptionsChildBuilder<T, I> childBuilder; |
||||||
|
|
||||||
|
/// By default it will be from the one in [QuillProvider] |
||||||
|
/// To override it you must pass not null controller |
||||||
|
/// if you wish to use the controller in the [childBuilder], please use the |
||||||
|
/// one from the extraOptions since it will be not null and will be the one |
||||||
|
/// which will be used from the quill toolbar |
||||||
|
final QuillController? controller; |
||||||
|
``` |
||||||
|
|
||||||
|
The `QuillToolbarBaseButtonOptions is`: |
||||||
|
```dart |
||||||
|
/// The [T] is the option for the button, usually should reference itself |
||||||
|
/// it's used in [childBuilder] so the developer can customize this when using it |
||||||
|
/// The [I] is an extra option for the button, usually for its state |
||||||
|
@immutable |
||||||
|
class QuillToolbarBaseButtonOptions<T, I> extends Equatable |
||||||
|
``` |
||||||
|
|
||||||
|
Example for the clear format button: |
||||||
|
|
||||||
|
```dart |
||||||
|
class QuillToolbarClearFormatButtonExtraOptions |
||||||
|
extends QuillToolbarBaseButtonExtraOptions { |
||||||
|
const QuillToolbarClearFormatButtonExtraOptions({ |
||||||
|
required super.controller, |
||||||
|
required super.context, |
||||||
|
required super.onPressed, |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
class QuillToolbarClearFormatButtonOptions |
||||||
|
extends QuillToolbarBaseButtonOptions<QuillToolbarClearFormatButtonOptions, |
||||||
|
QuillToolbarClearFormatButtonExtraOptions> { |
||||||
|
const QuillToolbarClearFormatButtonOptions({ |
||||||
|
super.iconData, |
||||||
|
super.afterButtonPressed, |
||||||
|
super.childBuilder, |
||||||
|
super.controller, |
||||||
|
super.iconTheme, |
||||||
|
super.tooltip, |
||||||
|
this.iconSize, |
||||||
|
}); |
||||||
|
|
||||||
|
final double? iconSize; |
||||||
|
} |
||||||
|
|
||||||
|
``` |
||||||
|
|
||||||
|
The base for extra options: |
||||||
|
```dart |
||||||
|
@immutable |
||||||
|
class QuillToolbarBaseButtonExtraOptions extends Equatable { |
||||||
|
const QuillToolbarBaseButtonExtraOptions({ |
||||||
|
required this.controller, |
||||||
|
required this.context, |
||||||
|
required this.onPressed, |
||||||
|
}); |
||||||
|
|
||||||
|
/// If you need the not null controller for some usage in the [childBuilder] |
||||||
|
/// Then please use this instead of the one in the [options] |
||||||
|
final QuillController controller; |
||||||
|
|
||||||
|
/// If the child builder you must use this when the widget is tapped or pressed |
||||||
|
/// in order to do what it expected to do |
||||||
|
final VoidCallback? onPressed; |
||||||
|
|
||||||
|
final BuildContext context; |
||||||
|
@override |
||||||
|
List<Object?> get props => [ |
||||||
|
controller, |
||||||
|
]; |
||||||
|
} |
||||||
|
``` |
||||||
|
|
||||||
|
which usually share common things, it also add an extra property which was not exist, which is `childBuilder` which allow to rendering of custom widget based on the state of the button and the options it |
||||||
|
|
||||||
|
```dart |
||||||
|
QuillToolbar( |
||||||
|
configurations: QuillToolbarConfigurations( |
||||||
|
buttonOptions: QuillToolbarButtonOptions( |
||||||
|
clearFormat: QuillToolbarClearFormatButtonOptions( |
||||||
|
childBuilder: (options, extraOptions) { |
||||||
|
return IconButton.filled( |
||||||
|
onPressed: extraOptions.onPressed, |
||||||
|
icon: const Icon( |
||||||
|
CupertinoIcons.clear // or options.iconData |
||||||
|
), |
||||||
|
); |
||||||
|
}, |
||||||
|
), |
||||||
|
), |
||||||
|
), |
||||||
|
), |
||||||
|
``` |
||||||
|
|
||||||
|
the `extraOptions` usually contains the state variables and the events that you need to trigger like the `onPressed`, it also has the end context and the controller that will be used |
||||||
|
while the `options` has the custom controller for each button and it's nullable because there could be no custom controller so we will just use the global one |
||||||
|
|
||||||
|
3. The `QuillToolbar` and `QuillToolbar.basic()` factory constructor |
||||||
|
|
||||||
|
since the basic factory constructor has more options than the original `QuillToolbar` which doesn't make much sense, at least to some developers, we have refactored the `QuillToolbar.basic()` to a different widget called the `QuillToolbar` and the `QuillToolbar` has been renamed to `QuillBaseToolbar` which is the base for `QuillToolbar` or any custom toolbar, sure you can create custom toolbar from scratch by just using the `controller` but if you want more support from the library use the `QuillBaseToolbar` |
||||||
|
|
||||||
|
the children widgets of the new `QuillToolbar` and `QuillEditor` access to their configurations by another two inherited widgets |
||||||
|
since `QuillToolbar` and `QuillEditor` take the configuration class and provide them internally using `QuillToolbarProvider` and `QuillEditorProvider` |
||||||
|
however the `QuillBaseToolbar` has a little bit different configurations so it has a different provider called `QuillBaseToolbarProvider` and it also already provided by default |
||||||
|
|
||||||
|
But there is one **note**: |
||||||
|
> If you are using the toolbar buttons like `QuillToolbarHistoryButton`, `QuillToolbarToggleStyleButton` somewhere like the the custom toolbar (using `QuillBaseToolbar` or any custom widget) then you must provide them with `QuillToolbarProvider` inherited widget, you don't have to do this if you are using the `QuillToolbar` since it will be done for you |
||||||
|
> |
||||||
|
|
||||||
|
Example of a custom toolbar: |
||||||
|
|
||||||
|
```dart |
||||||
|
QuillProvider( |
||||||
|
configurations: QuillConfigurations( |
||||||
|
controller: _controller, |
||||||
|
sharedConfigurations: const QuillSharedConfigurations(), |
||||||
|
), |
||||||
|
child: Column( |
||||||
|
children: [ |
||||||
|
QuillToolbarProvider( |
||||||
|
toolbarConfigurations: const QuillToolbarConfigurations(), |
||||||
|
child: QuillBaseToolbar( |
||||||
|
configurations: QuillBaseToolbarConfigurations( |
||||||
|
toolbarSize: 15 * 2, |
||||||
|
multiRowsDisplay: false, |
||||||
|
childrenBuilder: (context) { |
||||||
|
final controller = context.requireQuillController; // new extension which is a little bit shorter to access the quill provider then the controller |
||||||
|
|
||||||
|
// there are many options, feel free to explore them all!! |
||||||
|
return [ |
||||||
|
QuillToolbarHistoryButton( |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarHistoryButtonOptions( |
||||||
|
isUndo: true), |
||||||
|
), |
||||||
|
QuillToolbarHistoryButton( |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarHistoryButtonOptions( |
||||||
|
isUndo: false), |
||||||
|
), |
||||||
|
QuillToolbarToggleStyleButton( |
||||||
|
attribute: Attribute.bold, |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarToggleStyleButtonOptions( |
||||||
|
iconData: Icons.format_bold, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
QuillToolbarToggleStyleButton( |
||||||
|
attribute: Attribute.italic, |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarToggleStyleButtonOptions( |
||||||
|
iconData: Icons.format_italic, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
QuillToolbarToggleStyleButton( |
||||||
|
attribute: Attribute.underline, |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarToggleStyleButtonOptions( |
||||||
|
iconData: Icons.format_underline, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
QuillToolbarClearFormatButton( |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarClearFormatButtonOptions( |
||||||
|
iconData: Icons.format_clear, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
VerticalDivider( |
||||||
|
indent: 12, |
||||||
|
endIndent: 12, |
||||||
|
color: Colors.grey.shade400, |
||||||
|
), |
||||||
|
QuillToolbarSelectHeaderStyleButtons( |
||||||
|
controller: controller, |
||||||
|
options: |
||||||
|
const QuillToolbarSelectHeaderStyleButtonsOptions( |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
QuillToolbarToggleStyleButton( |
||||||
|
attribute: Attribute.ol, |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarToggleStyleButtonOptions( |
||||||
|
iconData: Icons.format_list_numbered, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
QuillToolbarToggleStyleButton( |
||||||
|
attribute: Attribute.ul, |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarToggleStyleButtonOptions( |
||||||
|
iconData: Icons.format_list_bulleted, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
QuillToolbarToggleStyleButton( |
||||||
|
attribute: Attribute.blockQuote, |
||||||
|
controller: controller, |
||||||
|
options: const QuillToolbarToggleStyleButtonOptions( |
||||||
|
iconData: Icons.format_quote, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
VerticalDivider( |
||||||
|
indent: 12, |
||||||
|
endIndent: 12, |
||||||
|
color: Colors.grey.shade400, |
||||||
|
), |
||||||
|
QuillToolbarIndentButton( |
||||||
|
controller: controller, |
||||||
|
isIncrease: true, |
||||||
|
options: const QuillToolbarIndentButtonOptions( |
||||||
|
iconData: Icons.format_indent_increase, |
||||||
|
iconSize: 20, |
||||||
|
)), |
||||||
|
QuillToolbarIndentButton( |
||||||
|
controller: controller, |
||||||
|
isIncrease: false, |
||||||
|
options: const QuillToolbarIndentButtonOptions( |
||||||
|
iconData: Icons.format_indent_decrease, |
||||||
|
iconSize: 20, |
||||||
|
), |
||||||
|
), |
||||||
|
]; |
||||||
|
}, |
||||||
|
), |
||||||
|
), |
||||||
|
), |
||||||
|
Expanded( |
||||||
|
child: QuillEditor.basic( |
||||||
|
configurations: const QuillEditorConfigurations( |
||||||
|
readOnly: false, |
||||||
|
placeholder: 'Write your notes', |
||||||
|
padding: EdgeInsets.all(16), |
||||||
|
), |
||||||
|
), |
||||||
|
) |
||||||
|
], |
||||||
|
), |
||||||
|
) |
||||||
|
``` |
||||||
|
|
||||||
|
4. The `QuillEditor` and `QuillEditor.basic()` |
||||||
|
|
||||||
|
since the `QuillEditor.basic()` is a lighter version than the original `QuillEditor` since it has fewer required configurations we didn't change much, other than the configuration class, but we must inform you if you plan on sending pull request or you are a maintainer and when you add new property or change anything in `QuillEditorConfigurations` please regenerate the `copyWith` (using IDE extension or plugin) otherwise the `QuilEditor.basic()` will not apply some configurations |
||||||
|
|
||||||
|
we have disabled the line numbers in the code block by default, you can enable them again using the following: |
||||||
|
|
||||||
|
```dart |
||||||
|
QuillEditor.basic( |
||||||
|
configurations: const QuillEditorConfigurations( |
||||||
|
elementOptions: QuillEditorElementOptions( |
||||||
|
codeBlock: QuillEditorCodeBlockElementOptions( |
||||||
|
enableLineNumbers: true, |
||||||
|
), |
||||||
|
), |
||||||
|
), |
||||||
|
) |
||||||
|
``` |
||||||
|
|
||||||
|
5. `QuillCustomButton`: |
||||||
|
|
||||||
|
We have renamed the property `icon` to `iconData` to indicate it an icon data and not an icon widget |
||||||
|
```dart |
||||||
|
QuillCustomButton( |
||||||
|
iconData: Icons.ac_unit, |
||||||
|
onTap: () { |
||||||
|
debugPrint('snowflake'); |
||||||
|
} |
||||||
|
), |
||||||
|
``` |
||||||
|
|
||||||
|
6. Using custom local for both `QuillEditor` and `QuillToolbar` |
||||||
|
|
||||||
|
We have added shared configurations property for shared things |
||||||
|
```dart |
||||||
|
QuillProvider( |
||||||
|
configurations: QuillConfigurations( |
||||||
|
controller: _controller, |
||||||
|
sharedConfigurations: const QuillSharedConfigurations( |
||||||
|
locale: Locale('fr'), |
||||||
|
), |
||||||
|
), |
||||||
|
child: Column( |
||||||
|
children: [ |
||||||
|
const QuillToolbar( |
||||||
|
configurations: QuillToolbarConfigurations(), |
||||||
|
), |
||||||
|
Expanded( |
||||||
|
child: QuillEditor.basic( |
||||||
|
configurations: const QuillEditorConfigurations(), |
||||||
|
), |
||||||
|
) |
||||||
|
], |
||||||
|
), |
||||||
|
) |
||||||
|
``` |
||||||
|
|
||||||
|
7. Image size for all platforms |
||||||
|
|
||||||
|
We have added new properties `width`, `height`, `margin`, `alignment` for all platforms other than mobile and web for the images for example |
||||||
|
|
||||||
|
```dart |
||||||
|
{ |
||||||
|
"insert": { |
||||||
|
"image": "https://user-images.githubusercontent.com/122956/72955931-ccc07900-3d52-11ea-89b1-d468a6e2aa2b.png" |
||||||
|
}, |
||||||
|
"attributes":{ |
||||||
|
"style":"width: 50; height: 50; margin: 10; alignment: topLeft" |
||||||
|
} |
||||||
|
} |
||||||
|
``` |
||||||
|
|
||||||
|
8. Other Improvements |
||||||
|
|
||||||
|
You don't need anything to get this done, we have used const more when possible, removed unused events, flutter best practices, converted to stateless widgets when possible, and used better ways to listen for changes example: |
||||||
|
|
||||||
|
instead of |
||||||
|
|
||||||
|
```dart |
||||||
|
MediaQuery.of(context).size; |
||||||
|
``` |
||||||
|
|
||||||
|
we will use |
||||||
|
```dart |
||||||
|
MediaQuery.sizeOf(context); |
||||||
|
``` |
||||||
|
We also minimized the number of rebuilds using more efficient logic and there is more. |
||||||
|
|
||||||
|
9. More options |
||||||
|
|
||||||
|
We have added more options in the extension package, for all the buttons, configurations, animations, enable and disable things |
||||||
|
|
||||||
|
If you are facing any issues or questions feel free to ask us on GitHub issues |
||||||
@ -0,0 +1,83 @@ |
|||||||
|
1. Removing the `QuillProvider` |
||||||
|
|
||||||
|
We got a lot of feedbacks about `QuillProvider`, while the provider help removing duplicate lines for simple usage, for more advance usage it become very messy |
||||||
|
So from now on we will use providers for the `QuillToolbar` and `QuillEditor` only internally, you don't need it anymore |
||||||
|
|
||||||
|
Instead you will need to pass the configurations directly in the `QuillToolbar` and `QuillEditor` |
||||||
|
|
||||||
|
**Old code**: |
||||||
|
|
||||||
|
```dart |
||||||
|
QuillProvider( |
||||||
|
configurations: QuillConfigurations( |
||||||
|
controller: _controller, |
||||||
|
sharedConfigurations: const QuillSharedConfigurations(), |
||||||
|
), |
||||||
|
child: Column( |
||||||
|
children: [ |
||||||
|
const QuillToolbar(), |
||||||
|
Expanded( |
||||||
|
child: QuillEditor.basic( |
||||||
|
configurations: const QuillEditorConfigurations( |
||||||
|
readOnly: false, // true for view only mode |
||||||
|
), |
||||||
|
), |
||||||
|
) |
||||||
|
], |
||||||
|
), |
||||||
|
) |
||||||
|
``` |
||||||
|
|
||||||
|
**New code**: |
||||||
|
|
||||||
|
```dart |
||||||
|
|
||||||
|
Column( |
||||||
|
children: [ |
||||||
|
QuillToolbar.simple( |
||||||
|
QuillSimpleToolbarConfigurations(controller: _controller)), |
||||||
|
Expanded( |
||||||
|
child: QuillEditor.basic( |
||||||
|
configurations: QuillEditorConfigurations(controller: _controller), |
||||||
|
), |
||||||
|
) |
||||||
|
], |
||||||
|
) |
||||||
|
|
||||||
|
``` |
||||||
|
|
||||||
|
2. Refactoring the Base Toolbar |
||||||
|
|
||||||
|
From now on, the `QuillToolbar` will be a widget that only provides the things that the buttons needs like localizations and `QuillToolbarProvider` |
||||||
|
So you can define your own toolbar from scratch just like in Quill JS |
||||||
|
|
||||||
|
The `QuillToolbar` is now accepting only `child` with no configurations so you can customize everything you wants, the `QuillToolbar.simple()` or `QuillSimpleToolbar` implements a simple toolbar that is based on `QuillToolbar`, you are free to use it but it just an example and not standard |
||||||
|
|
||||||
|
1. Source Code Structure |
||||||
|
|
||||||
|
Completly changed the way how the source code structured to more basic and simple way, organize folders and file names, if you use the library |
||||||
|
from `flutter_quill_extensions.dart` then there is nothing you need to do, but if you are using any other import then you need to re-imports |
||||||
|
|
||||||
|
4. Change the version system |
||||||
|
|
||||||
|
For [more details](https://github.com/singerdmx/flutter-quill/discussions/1560) |
||||||
|
|
||||||
|
5. Dependencies changes |
||||||
|
|
||||||
|
1. Add `gal_linux` in `flutter_quill_extensions` |
||||||
|
2. Replace `pasteboard` with `rich_cliboard` |
||||||
|
3. Remove `flutter_animate` |
||||||
|
|
||||||
|
6. Optional options for the buttons |
||||||
|
|
||||||
|
All the buttons from now on, have optional options parameter |
||||||
|
|
||||||
|
7. Improve Flutter Quill Extensions |
||||||
|
|
||||||
|
Bug fixes and new features, the extensions package keep getting better thanks to the community. |
||||||
|
|
||||||
|
8. Migrate to Material 3 |
||||||
|
|
||||||
|
We have migrated all of the buttons to material 3, removed a lot of old parameters, if you want to customize one or all the buttons to replacing it with completly different widget with the same state use the `base` in the button options for all or the button name for one |
||||||
|
|
||||||
|
We have also replaced the header style buttons with one dropdown button as a default, replaced the alignment buttons with less code and a lot more |
||||||
@ -0,0 +1,36 @@ |
|||||||
|
import 'package:flutter/material.dart'; |
||||||
|
import 'package:flutter_quill/flutter_quill.dart'; |
||||||
|
|
||||||
|
class SimpleScreen extends StatefulWidget { |
||||||
|
const SimpleScreen({super.key}); |
||||||
|
|
||||||
|
@override |
||||||
|
State<SimpleScreen> createState() => _SimpleScreenState(); |
||||||
|
} |
||||||
|
|
||||||
|
class _SimpleScreenState extends State<SimpleScreen> { |
||||||
|
final _controller = QuillController.basic(); |
||||||
|
|
||||||
|
@override |
||||||
|
Widget build(BuildContext context) { |
||||||
|
return Scaffold( |
||||||
|
appBar: AppBar(), |
||||||
|
body: Column( |
||||||
|
children: [ |
||||||
|
QuillToolbar.simple( |
||||||
|
configurations: |
||||||
|
QuillSimpleToolbarConfigurations(controller: _controller), |
||||||
|
), |
||||||
|
Expanded( |
||||||
|
child: QuillEditor.basic( |
||||||
|
configurations: QuillEditorConfigurations( |
||||||
|
controller: _controller, |
||||||
|
padding: const EdgeInsets.all(16), |
||||||
|
), |
||||||
|
), |
||||||
|
), |
||||||
|
], |
||||||
|
), |
||||||
|
); |
||||||
|
} |
||||||
|
} |
||||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,17 @@ |
|||||||
|
RegExp base64RegExp = RegExp( |
||||||
|
r'^(?:[A-Za-z0-9+\/]{4})*(?:[A-Za-z0-9+\/]{2}==|[A-Za-z0-9+\/]{3}=|[A-Za-z0-9+\/]{4})$', |
||||||
|
); |
||||||
|
|
||||||
|
final imageRegExp = RegExp( |
||||||
|
r'https?://.*?\.(?:png|jpe?g|gif|bmp|webp|tiff?)', |
||||||
|
caseSensitive: false, |
||||||
|
); |
||||||
|
|
||||||
|
final videoRegExp = RegExp( |
||||||
|
r'\bhttps?://\S+\.(mp4|mov|avi|mkv|flv|wmv|webm)\b', |
||||||
|
caseSensitive: false, |
||||||
|
); |
||||||
|
final youtubeRegExp = RegExp( |
||||||
|
r'^((?:https?:)?\/\/)?((?:www|m)\.)?((?:youtube(-nocookie)?\.com|youtu.be))(\/(?:[\w\-]+\?v=|embed\/|live\/|v\/)?)([\w\-]+)(\S+)?$', |
||||||
|
caseSensitive: false, |
||||||
|
); |
||||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,5 @@ |
|||||||
|
library quill_markdown; |
||||||
|
|
||||||
|
export 'src/packages/quill_markdown/delta_to_markdown.dart'; |
||||||
|
export 'src/packages/quill_markdown/embeddable_table_syntax.dart'; |
||||||
|
export 'src/packages/quill_markdown/markdown_to_delta.dart'; |
||||||
@ -0,0 +1,93 @@ |
|||||||
|
import 'package:flutter/widgets.dart' show BuildContext; |
||||||
|
|
||||||
|
import '../../flutter_quill.dart'; |
||||||
|
|
||||||
|
extension QuillControllerExt on BuildContext { |
||||||
|
/// return nullable [QuillController] |
||||||
|
QuillController? get quilController { |
||||||
|
return quillSimpleToolbarConfigurations?.controller ?? |
||||||
|
quillEditorConfigurations?.controller; |
||||||
|
} |
||||||
|
|
||||||
|
/// return [QuillController] as not null |
||||||
|
QuillController get requireQuillController { |
||||||
|
return quillSimpleToolbarConfigurations?.controller ?? |
||||||
|
quillEditorConfigurations?.controller ?? |
||||||
|
(throw ArgumentError( |
||||||
|
'The quill provider is required, you must only call requireQuillController inside the QuillToolbar and QuillEditor')); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
extension QuillSharedExt on BuildContext { |
||||||
|
/// return nullable [QuillSharedConfigurations] |
||||||
|
QuillSharedConfigurations? get quillSharedConfigurations { |
||||||
|
return quillSimpleToolbarConfigurations?.sharedConfigurations ?? |
||||||
|
quillEditorConfigurations?.sharedConfigurations; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
extension QuillEditorExt on BuildContext { |
||||||
|
/// return [QuillEditorConfigurations] as not null |
||||||
|
QuillEditorConfigurations get requireQuillEditorConfigurations { |
||||||
|
return QuillEditorProvider.of(this).editorConfigurations; |
||||||
|
} |
||||||
|
|
||||||
|
/// return nullable [QuillEditorConfigurations] |
||||||
|
QuillEditorConfigurations? get quillEditorConfigurations { |
||||||
|
return QuillEditorProvider.maybeOf(this)?.editorConfigurations; |
||||||
|
} |
||||||
|
|
||||||
|
/// return nullable [QuillToolbarBaseButtonOptions]. Since the quill |
||||||
|
/// quill editor block options is in the [QuillEditorProvider] then we need to |
||||||
|
/// get the provider widget first and then we will return block options |
||||||
|
/// throw exception if [QuillEditorProvider] is not in the widget tree |
||||||
|
QuillEditorElementOptions? get quillEditorElementOptions { |
||||||
|
return quillEditorConfigurations?.elementOptions; |
||||||
|
} |
||||||
|
|
||||||
|
/// return [QuillToolbarBaseButtonOptions] as not null. Since the quill |
||||||
|
/// quill editor block options is in the [QuillEditorProvider] then we need to |
||||||
|
/// get the provider widget first and then we will return block options |
||||||
|
/// don't throw exception if [QuillEditorProvider] is not in the widget tree |
||||||
|
QuillEditorElementOptions get requireQuillEditorElementOptions { |
||||||
|
return requireQuillEditorConfigurations.elementOptions; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
extension QuillSimpleToolbarExt on BuildContext { |
||||||
|
/// return [QuillSimpleToolbarConfigurations] as not null |
||||||
|
QuillSimpleToolbarConfigurations get requireQuillSimpleToolbarConfigurations { |
||||||
|
return QuillSimpleToolbarProvider.of(this).toolbarConfigurations; |
||||||
|
} |
||||||
|
|
||||||
|
/// return nullable [QuillSimpleToolbarConfigurations] |
||||||
|
QuillSimpleToolbarConfigurations? get quillSimpleToolbarConfigurations { |
||||||
|
return QuillSimpleToolbarProvider.maybeOf(this)?.toolbarConfigurations; |
||||||
|
} |
||||||
|
|
||||||
|
/// return nullable [QuillToolbarBaseButtonOptions]. |
||||||
|
QuillToolbarBaseButtonOptions? get quillToolbarBaseButtonOptions { |
||||||
|
return quillSimpleToolbarConfigurations?.buttonOptions.base; |
||||||
|
} |
||||||
|
|
||||||
|
/// return [QuillToolbarBaseButtonOptions] as not null. |
||||||
|
QuillToolbarBaseButtonOptions get requireQuillToolbarBaseButtonOptions { |
||||||
|
return quillSimpleToolbarConfigurations?.buttonOptions.base ?? |
||||||
|
quillToolbarConfigurations?.buttonOptions.base ?? |
||||||
|
(throw ArgumentError( |
||||||
|
"The buttonOptions is required and it's null because the toolbar configurations is.", |
||||||
|
)); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
extension QuillToolbarExt on BuildContext { |
||||||
|
/// return [QuillToolbarConfigurations] as not null |
||||||
|
QuillToolbarConfigurations get requireQuillToolbarConfigurations { |
||||||
|
return QuillToolbarProvider.of(this).toolbarConfigurations; |
||||||
|
} |
||||||
|
|
||||||
|
/// return nullable [QuillToolbarConfigurations]. |
||||||
|
QuillToolbarConfigurations? get quillToolbarConfigurations { |
||||||
|
return QuillToolbarProvider.maybeOf(this)?.toolbarConfigurations; |
||||||
|
} |
||||||
|
} |
||||||
@ -1,11 +1,11 @@ |
|||||||
import 'package:flutter/widgets.dart' show BuildContext; |
import 'package:flutter/widgets.dart' show BuildContext; |
||||||
|
|
||||||
import '../../flutter_quill.dart' show QuillController, QuillProvider; |
import '../../flutter_quill.dart' show QuillController; |
||||||
import 'quill_provider.dart'; |
import 'quill_configurations_ext.dart'; |
||||||
|
|
||||||
extension QuillControllerNullableExt on QuillController? { |
extension QuillControllerNullableExt on QuillController? { |
||||||
/// Simple logic to use the current passed controller if not null |
/// Simple logic to use the current passed controller if not null |
||||||
/// if null then we will have to use the default one from [QuillProvider] |
/// if null then we will have to use the default one |
||||||
/// using the [context] |
/// using the [context] |
||||||
QuillController notNull(BuildContext context) { |
QuillController notNull(BuildContext context) { |
||||||
final controller = this; |
final controller = this; |
||||||
@ -1,160 +0,0 @@ |
|||||||
import 'package:flutter/widgets.dart' show BuildContext; |
|
||||||
|
|
||||||
import '../../flutter_quill.dart'; |
|
||||||
|
|
||||||
// TODO: The comments of this file is outdated and needs to be updated |
|
||||||
|
|
||||||
/// Public shared extension |
|
||||||
extension QuillProviderExt on BuildContext { |
|
||||||
/// return [QuillProvider] as not null |
|
||||||
/// throw exception if it's not in the widget tree |
|
||||||
QuillProvider get requireQuillProvider { |
|
||||||
return QuillProvider.ofNotNull(this); |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillProvider] |
|
||||||
/// don't throw exception if it's not in the widget tree |
|
||||||
/// instead it will be null |
|
||||||
QuillProvider? get quillProvider { |
|
||||||
return QuillProvider.of(this); |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillController] |
|
||||||
/// since the quill controller is in the [QuillProvider] then we need to get |
|
||||||
/// the provider widget first and then we will return the controller |
|
||||||
/// don't throw exception if [QuillProvider] is not in the widget tree |
|
||||||
/// instead it will be null |
|
||||||
QuillController? get quilController { |
|
||||||
return quillProvider?.configurations.controller; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillController] as not null |
|
||||||
/// since the quill controller is in the [QuillProvider] then we need to get |
|
||||||
/// the provider widget first and then we will return the controller |
|
||||||
/// throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillController get requireQuillController { |
|
||||||
return requireQuillProvider.configurations.controller; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillConfigurations] as not null |
|
||||||
/// since the quill configurations is in the [QuillProvider] then we need to |
|
||||||
/// get the provider widget first and then we will return quill configurations |
|
||||||
/// throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillConfigurations get requireQuillConfigurations { |
|
||||||
return requireQuillProvider.configurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillConfigurations] |
|
||||||
/// since the quill configurations is in the [QuillProvider] then we need to |
|
||||||
/// get the provider widget first and then we will return quill configurations |
|
||||||
/// don't throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillConfigurations? get quillConfigurations { |
|
||||||
return quillProvider?.configurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillSharedConfigurations] as not null. Since the quill |
|
||||||
/// shared configurations is in the [QuillProvider] then we need to get the |
|
||||||
/// provider widget first and then we will return shared configurations |
|
||||||
/// throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillSharedConfigurations get requireQuillSharedConfigurations { |
|
||||||
return requireQuillConfigurations.sharedConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillSharedConfigurations] . Since the quill |
|
||||||
/// shared configurations is in the [QuillProvider] then we need to get the |
|
||||||
/// provider widget first and then we will return shared configurations |
|
||||||
/// don't throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillSharedConfigurations? get quillSharedConfigurations { |
|
||||||
return quillConfigurations?.sharedConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillEditorConfigurations] as not null . Since the quill |
|
||||||
/// editor configurations is in the [QuillEditorProvider] |
|
||||||
/// then we need to get the |
|
||||||
/// provider widget first and then we will return editor configurations |
|
||||||
/// throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillEditorConfigurations get requireQuillEditorConfigurations { |
|
||||||
return QuillEditorProvider.ofNotNull(this).editorConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillEditorConfigurations]. Since the quill |
|
||||||
/// editor configurations is in the [QuillEditorProvider] |
|
||||||
/// then we need to get the |
|
||||||
/// provider widget first and then we will return editor configurations |
|
||||||
/// don't throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillEditorConfigurations? get quillEditorConfigurations { |
|
||||||
return QuillEditorProvider.of(this)?.editorConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillToolbarConfigurations] as not null . Since the quill |
|
||||||
/// toolbar configurations is in the [QuillToolbarProvider] |
|
||||||
/// then we need to get the |
|
||||||
/// provider widget first and then we will return toolbar configurations |
|
||||||
/// throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillToolbarConfigurations get requireQuillToolbarConfigurations { |
|
||||||
return QuillToolbarProvider.ofNotNull(this).toolbarConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillToolbarConfigurations]. Since the quill |
|
||||||
/// toolbar configurations is in the [QuillToolbarProvider] |
|
||||||
/// then we need to get the |
|
||||||
/// provider widget first and then we will return toolbar configurations |
|
||||||
/// don't throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillToolbarConfigurations? get quillToolbarConfigurations { |
|
||||||
return QuillToolbarProvider.of(this)?.toolbarConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillBaseToolbarConfigurations] as not null . Since the quill |
|
||||||
/// toolbar configurations is in the [QuillBaseToolbarProvider] |
|
||||||
/// then we need to get the |
|
||||||
/// provider widget first and then we will return toolbar configurations |
|
||||||
/// throw exception if [QuillBaseToolbarProvider] is not in the widget tree |
|
||||||
QuillBaseToolbarConfigurations get requireQuillBaseToolbarConfigurations { |
|
||||||
return QuillBaseToolbarProvider.ofNotNull(this).toolbarConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillBaseToolbarConfigurations]. Since the quill |
|
||||||
/// toolbar configurations is in the [QuillBaseToolbarProvider] |
|
||||||
/// then we need to get the |
|
||||||
/// provider widget first and then we will return toolbar configurations |
|
||||||
/// don't throw exception if [QuillBaseToolbarProvider] is not in the widget tree |
|
||||||
QuillBaseToolbarConfigurations? get quillBaseToolbarConfigurations { |
|
||||||
return QuillBaseToolbarProvider.of(this)?.toolbarConfigurations; |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillToolbarBaseButtonOptions]. Since the quill |
|
||||||
/// toolbar base button options is in the [QuillProvider] then we need to |
|
||||||
/// get the provider widget first and then we will return base button |
|
||||||
/// don't throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillToolbarBaseButtonOptions? get quillToolbarBaseButtonOptions { |
|
||||||
return quillToolbarConfigurations?.buttonOptions.base; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillToolbarBaseButtonOptions] as not null. Since the quill |
|
||||||
/// toolbar base button options is in the [QuillProvider] then we need to |
|
||||||
/// get the provider widget first and then we will return base button |
|
||||||
/// throw exception if [QuillProvider] is not in the widget tree |
|
||||||
QuillToolbarBaseButtonOptions get requireQuillToolbarBaseButtonOptions { |
|
||||||
return quillToolbarConfigurations?.buttonOptions.base ?? |
|
||||||
quillBaseToolbarConfigurations?.buttonOptions.base ?? |
|
||||||
(throw ArgumentError( |
|
||||||
"The buttonOptions is required and it's null because the toolbar configurations is.", |
|
||||||
)); |
|
||||||
} |
|
||||||
|
|
||||||
/// return nullable [QuillToolbarBaseButtonOptions]. Since the quill |
|
||||||
/// quill editor block options is in the [QuillEditorProvider] then we need to |
|
||||||
/// get the provider widget first and then we will return block options |
|
||||||
/// throw exception if [QuillEditorProvider] is not in the widget tree |
|
||||||
QuillEditorElementOptions? get quillEditorElementOptions { |
|
||||||
return quillEditorConfigurations?.elementOptions; |
|
||||||
} |
|
||||||
|
|
||||||
/// return [QuillToolbarBaseButtonOptions] as not null. Since the quill |
|
||||||
/// quill editor block options is in the [QuillEditorProvider] then we need to |
|
||||||
/// get the provider widget first and then we will return block options |
|
||||||
/// don't throw exception if [QuillEditorProvider] is not in the widget tree |
|
||||||
QuillEditorElementOptions get requireQuillEditorElementOptions { |
|
||||||
return requireQuillEditorConfigurations.elementOptions; |
|
||||||
} |
|
||||||
} |
|
||||||
@ -0,0 +1,11 @@ |
|||||||
|
extension UriExt on Uri { |
||||||
|
bool isHttpBasedUrl() { |
||||||
|
final uri = this; |
||||||
|
return uri.isScheme('HTTP') || uri.isScheme('HTTPS'); |
||||||
|
} |
||||||
|
|
||||||
|
bool isHttpsBasedUrl() { |
||||||
|
final uri = this; |
||||||
|
return uri.isScheme('HTTPS'); |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,14 @@ |
|||||||
|
import 'package:equatable/equatable.dart'; |
||||||
|
import 'package:flutter/foundation.dart' show immutable; |
||||||
|
import 'package:flutter/widgets.dart' show Color; |
||||||
|
|
||||||
|
@immutable |
||||||
|
class QuillEditorOrderedListElementOptions extends Equatable { |
||||||
|
const QuillEditorOrderedListElementOptions( |
||||||
|
{this.backgroundColor, this.fontColor}); |
||||||
|
|
||||||
|
final Color? backgroundColor; |
||||||
|
final Color? fontColor; |
||||||
|
@override |
||||||
|
List<Object?> get props => []; |
||||||
|
} |
||||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue